fix(gemini): read GEMINI_MODEL from ~/.gemini/.env (#131 )

When using gemini backend without --model flag, now automatically reads GEMINI_MODEL from ~/.gemini/.env file, consistent with how claude backend reads model from settings.
feat: add feature-dev skill with 7-phase workflow
2026-02-05 02:30:26 +08:00 · 2026-01-23 12:03:50 +08:00 · 2026-01-23 12:01:31 +08:00 · 2026-01-23 12:01:04 +08:00 · 2026-01-23 12:00:55 +08:00 · 2026-01-23 12:00:47 +08:00
15 changed files with 1023 additions and 8 deletions
--- a/.gitignore
+++ b/.gitignore
@@ -7,3 +7,4 @@
 __pycache__
 .coverage
 coverage.out
+references
--- a/codeagent-wrapper/internal/app/cli.go
+++ b/codeagent-wrapper/internal/app/cli.go
@@ -648,6 +648,12 @@ func runSingleMode(cfg *Config, name string) int {
 		return result.ExitCode
 	}

+	// Validate that we got a meaningful output message
+	if strings.TrimSpace(result.Message) == "" {
+		logError(fmt.Sprintf("no output message: backend=%s returned empty result.Message with exit_code=0", cfg.Backend))
+		return 1
+	}
+
 	fmt.Println(result.Message)
 	if result.SessionID != "" {
 		fmt.Printf("\n---\nSESSION_ID: %s\n", result.SessionID)
--- a/codeagent-wrapper/internal/app/main_test.go
+++ b/codeagent-wrapper/internal/app/main_test.go
@@ -1913,6 +1913,37 @@ func TestRun_PassesReasoningEffortToTaskSpec(t *testing.T) {
 	}
 }

+func TestRun_NoOutputMessage_ReturnsExitCode1AndWritesStderr(t *testing.T) {
+	defer resetTestHooks()
+	cleanupLogsFn = func() (CleanupStats, error) { return CleanupStats{}, nil }
+	t.Setenv("TMPDIR", t.TempDir())
+
+	selectBackendFn = func(name string) (Backend, error) {
+		return testBackend{name: name, command: "echo"}, nil
+	}
+
+	runTaskFn = func(task TaskSpec, silent bool, timeout int) TaskResult {
+		return TaskResult{ExitCode: 0, Message: ""}
+	}
+
+	isTerminalFn = func() bool { return true }
+	stdinReader = strings.NewReader("")
+
+	os.Args = []string{"codeagent-wrapper", "task"}
+
+	var code int
+	errOutput := captureStderr(t, func() {
+		code = run()
+	})
+
+	if code != 1 {
+		t.Fatalf("run() exit=%d, want 1", code)
+	}
+	if !strings.Contains(errOutput, "no output message") {
+		t.Fatalf("stderr missing sentinel error text; got:\n%s", errOutput)
+	}
+}
+
 func TestRunBuildCodexArgs_NewMode(t *testing.T) {
 	const key = "CODEX_BYPASS_SANDBOX"
 	t.Setenv(key, "false")
--- a/codeagent-wrapper/internal/executor/executor.go
+++ b/codeagent-wrapper/internal/executor/executor.go
@@ -940,6 +940,11 @@ func RunCodexTaskWithContext(parentCtx context.Context, taskSpec TaskSpec, backe
 	// Load gemini env from ~/.gemini/.env if exists
 	if cfg.Backend == "gemini" {
 		fileEnv = loadGeminiEnv()
+		if cfg.Mode != "resume" && strings.TrimSpace(cfg.Model) == "" {
+			if model := fileEnv["GEMINI_MODEL"]; model != "" {
+				cfg.Model = model
+			}
+		}
 	}

 	useStdin := taskSpec.UseStdin
--- a/config.json
+++ b/config.json
@@ -169,6 +169,18 @@
        }
      ]
    },
+    "feature-dev": {
+      "enabled": false,
+      "description": "7-phase feature development workflow with codeagent orchestration",
+      "operations": [
+        {
+          "type": "copy_dir",
+          "source": "skills/feature-dev",
+          "target": "skills/feature-dev",
+          "description": "Install feature-dev skill with hooks"
+        }
+      ]
+    },
    "course": {
      "enabled": false,
      "description": "课程开发工作流，包含 dev、产品需求和测试用例技能",
--- a/go.work.sum
+++ b/go.work.sum
@@ -0,0 +1,143 @@
+cloud.google.com/go v0.112.1 h1:uJSeirPke5UNZHIb4SxfZklVSiWWVqW4oXlETwZziwM=
+cloud.google.com/go v0.112.1/go.mod h1:+Vbu+Y1UU+I1rjmzeMOb/8RfkKJK2Gyxi1X6jJCZLo4=
+cloud.google.com/go/compute v1.24.0 h1:phWcR2eWzRJaL/kOiJwfFsPs4BaKq1j6vnpZrc1YlVg=
+cloud.google.com/go/compute v1.24.0/go.mod h1:kw1/T+h/+tK2LJK0wiPPx1intgdAM3j/g3hFDlscY40=
+cloud.google.com/go/compute/metadata v0.2.3 h1:mg4jlk7mCAj6xXp9UJ4fjI9VUI5rubuGBW5aJ7UnBMY=
+cloud.google.com/go/compute/metadata v0.2.3/go.mod h1:VAV5nSsACxMJvgaAuX6Pk2AawlZn8kiOGuCv6gTkwuA=
+cloud.google.com/go/firestore v1.15.0 h1:/k8ppuWOtNuDHt2tsRV42yI21uaGnKDEQnRFeBpbFF8=
+cloud.google.com/go/firestore v1.15.0/go.mod h1:GWOxFXcv8GZUtYpWHw/w6IuYNux/BtmeVTMmjrm4yhk=
+cloud.google.com/go/iam v1.1.5 h1:1jTsCu4bcsNsE4iiqNT5SHwrDRCfRmIaaaVFhRveTJI=
+cloud.google.com/go/iam v1.1.5/go.mod h1:rB6P/Ic3mykPbFio+vo7403drjlgvoWfYpJhMXEbzv8=
+cloud.google.com/go/longrunning v0.5.5 h1:GOE6pZFdSrTb4KAiKnXsJBtlE6mEyaW44oKyMILWnOg=
+cloud.google.com/go/longrunning v0.5.5/go.mod h1:WV2LAxD8/rg5Z1cNW6FJ/ZpX4E4VnDnoTk0yawPBB7s=
+cloud.google.com/go/storage v1.35.1 h1:B59ahL//eDfx2IIKFBeT5Atm9wnNmj3+8xG/W4WB//w=
+cloud.google.com/go/storage v1.35.1/go.mod h1:M6M/3V/D3KpzMTJyPOR/HU6n2Si5QdaXYEsng2xgOs8=
+github.com/armon/go-metrics v0.4.1 h1:hR91U9KYmb6bLBYLQjyM+3j+rcd/UhE+G78SFnF8gJA=
+github.com/armon/go-metrics v0.4.1/go.mod h1:E6amYzXo6aW1tqzoZGT755KkbgrJsSdpwZ+3JqfkOG4=
+github.com/coreos/go-semver v0.3.0 h1:wkHLiw0WNATZnSG7epLsujiMCgPAc9xhjJ4tgnAxmfM=
+github.com/coreos/go-semver v0.3.0/go.mod h1:nnelYz7RCh+5ahJtPPxZlU+153eP4D4r3EedlOD2RNk=
+github.com/coreos/go-systemd/v22 v22.5.0 h1:RrqgGjYQKalulkV8NGVIfkXQf6YYmOyiJKk8iXXhfZs=
+github.com/cpuguy83/go-md2man/v2 v2.0.4 h1:wfIWP927BUkWJb2NmU/kNDYIBTh/ziUX91+lVfRxZq4=
+github.com/fatih/color v1.14.1 h1:qfhVLaG5s+nCROl1zJsZRxFeYrHLqWroPOQ8BWiNb4w=
+github.com/fatih/color v1.14.1/go.mod h1:2oHN61fhTpgcxD3TSWCgKDiH1+x4OiDVVGH8WlgGZGg=
+github.com/felixge/httpsnoop v1.0.4 h1:NFTV2Zj1bL4mc9sqWACXbQFVBBg2W3GPvqp8/ESS2Wg=
+github.com/felixge/httpsnoop v1.0.4/go.mod h1:m8KPJKqk1gH5J9DgRY2ASl2lWCfGKXixSwevea8zH2U=
+github.com/go-logr/logr v1.4.1 h1:pKouT5E8xu9zeFC39JXRDukb6JFQPXM5p5I91188VAQ=
+github.com/go-logr/logr v1.4.1/go.mod h1:9T104GzyrTigFIr8wt5mBrctHMim0Nb2HLGrmQ40KvY=
+github.com/go-logr/stdr v1.2.2 h1:hSWxHoqTgW2S2qGc0LTAI563KZ5YKYRhT3MFKZMbjag=
+github.com/go-logr/stdr v1.2.2/go.mod h1:mMo/vtBO5dYbehREoey6XUKy/eSumjCCveDpRre4VKE=
+github.com/godbus/dbus/v5 v5.0.4 h1:9349emZab16e7zQvpmsbtjc18ykshndd8y2PG3sgJbA=
+github.com/gogo/protobuf v1.3.2 h1:Ov1cvc58UF3b5XjBnZv7+opcTcQFZebYjWzi34vdm4Q=
+github.com/gogo/protobuf v1.3.2/go.mod h1:P1XiOD3dCwIKUDQYPy72D8LYyHL2YPYrpS2s69NZV8Q=
+github.com/golang/groupcache v0.0.0-20210331224755-41bb18bfe9da h1:oI5xCqsCo564l8iNU+DwB5epxmsaqB+rhGL0m5jtYqE=
+github.com/golang/groupcache v0.0.0-20210331224755-41bb18bfe9da/go.mod h1:cIg4eruTrX1D+g88fzRXU5OdNfaM+9IcxsU14FzY7Hc=
+github.com/golang/protobuf v1.5.3 h1:KhyjKVUg7Usr/dYsdSqoFveMYd5ko72D+zANwlG1mmg=
+github.com/golang/protobuf v1.5.3/go.mod h1:XVQd3VNwM+JqD3oG2Ue2ip4fOMUkwXdXDdiuN0vRsmY=
+github.com/google/s2a-go v0.1.7 h1:60BLSyTrOV4/haCDW4zb1guZItoSq8foHCXrAnjBo/o=
+github.com/google/s2a-go v0.1.7/go.mod h1:50CgR4k1jNlWBu4UfS4AcfhVe1r6pdZPygJ3R8F0Qdw=
+github.com/google/uuid v1.4.0 h1:MtMxsa51/r9yyhkyLsVeVt0B+BGQZzpQiTQ4eHZ8bc4=
+github.com/google/uuid v1.4.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo=
+github.com/googleapis/enterprise-certificate-proxy v0.3.2 h1:Vie5ybvEvT75RniqhfFxPRy3Bf7vr3h0cechB90XaQs=
+github.com/googleapis/enterprise-certificate-proxy v0.3.2/go.mod h1:VLSiSSBs/ksPL8kq3OBOQ6WRI2QnaFynd1DCjZ62+V0=
+github.com/googleapis/gax-go/v2 v2.12.3 h1:5/zPPDvw8Q1SuXjrqrZslrqT7dL/uJT2CQii/cLCKqA=
+github.com/googleapis/gax-go/v2 v2.12.3/go.mod h1:AKloxT6GtNbaLm8QTNSidHUVsHYcBHwWRvkNFJUQcS4=
+github.com/googleapis/google-cloud-go-testing v0.0.0-20210719221736-1c9a4c676720 h1:zC34cGQu69FG7qzJ3WiKW244WfhDC3xxYMeNOX2gtUQ=
+github.com/googleapis/google-cloud-go-testing v0.0.0-20210719221736-1c9a4c676720/go.mod h1:dvDLG8qkwmyD9a/MJJN3XJcT3xFxOKAvTZGvuZmac9g=
+github.com/hashicorp/consul/api v1.28.2 h1:mXfkRHrpHN4YY3RqL09nXU1eHKLNiuAN4kHvDQ16k/8=
+github.com/hashicorp/consul/api v1.28.2/go.mod h1:KyzqzgMEya+IZPcD65YFoOVAgPpbfERu4I/tzG6/ueE=
+github.com/hashicorp/errwrap v1.1.0 h1:OxrOeh75EUXMY8TBjag2fzXGZ40LB6IKw45YeGUDY2I=
+github.com/hashicorp/errwrap v1.1.0/go.mod h1:YH+1FKiLXxHSkmPseP+kNlulaMuP3n2brvKWEqk/Jc4=
+github.com/hashicorp/go-cleanhttp v0.5.2 h1:035FKYIWjmULyFRBKPs8TBQoi0x6d9G4xc9neXJWAZQ=
+github.com/hashicorp/go-cleanhttp v0.5.2/go.mod h1:kO/YDlP8L1346E6Sodw+PrpBSV4/SoxCXGY6BqNFT48=
+github.com/hashicorp/go-hclog v1.5.0 h1:bI2ocEMgcVlz55Oj1xZNBsVi900c7II+fWDyV9o+13c=
+github.com/hashicorp/go-hclog v1.5.0/go.mod h1:W4Qnvbt70Wk/zYJryRzDRU/4r0kIg0PVHBcfoyhpF5M=
+github.com/hashicorp/go-immutable-radix v1.3.1 h1:DKHmCUm2hRBK510BaiZlwvpD40f8bJFeZnpfm2KLowc=
+github.com/hashicorp/go-immutable-radix v1.3.1/go.mod h1:0y9vanUI8NX6FsYoO3zeMjhV/C5i9g4Q3DwcSNZ4P60=
+github.com/hashicorp/go-multierror v1.1.1 h1:H5DkEtf6CXdFp0N0Em5UCwQpXMWke8IA0+lD48awMYo=
+github.com/hashicorp/go-multierror v1.1.1/go.mod h1:iw975J/qwKPdAO1clOe2L8331t/9/fmwbPZ6JB6eMoM=
+github.com/hashicorp/go-rootcerts v1.0.2 h1:jzhAVGtqPKbwpyCPELlgNWhE1znq+qwJtW5Oi2viEzc=
+github.com/hashicorp/go-rootcerts v1.0.2/go.mod h1:pqUvnprVnM5bf7AOirdbb01K4ccR319Vf4pU3K5EGc8=
+github.com/hashicorp/golang-lru v0.5.4 h1:YDjusn29QI/Das2iO9M0BHnIbxPeyuCHsjMW+lJfyTc=
+github.com/hashicorp/golang-lru v0.5.4/go.mod h1:iADmTwqILo4mZ8BN3D2Q6+9jd8WM5uGBxy+E8yxSoD4=
+github.com/hashicorp/serf v0.10.1 h1:Z1H2J60yRKvfDYAOZLd2MU0ND4AH/WDz7xYHDWQsIPY=
+github.com/hashicorp/serf v0.10.1/go.mod h1:yL2t6BqATOLGc5HF7qbFkTfXoPIY0WZdWHfEvMqbG+4=
+github.com/json-iterator/go v1.1.12 h1:PV8peI4a0ysnczrg+LtxykD8LfKY9ML6u2jnxaEnrnM=
+github.com/json-iterator/go v1.1.12/go.mod h1:e30LSqwooZae/UwlEbR2852Gd8hjQvJoHmT4TnhNGBo=
+github.com/klauspost/compress v1.17.2 h1:RlWWUY/Dr4fL8qk9YG7DTZ7PDgME2V4csBXA8L/ixi4=
+github.com/klauspost/compress v1.17.2/go.mod h1:ntbaceVETuRiXiv4DpjP66DpAtAGkEQskQzEyD//IeE=
+github.com/kr/fs v0.1.0 h1:Jskdu9ieNAYnjxsi0LbQp1ulIKZV1LAFgK1tWhpZgl8=
+github.com/kr/fs v0.1.0/go.mod h1:FFnZGqtBN9Gxj7eW1uZ42v5BccTP0vu6NEaFoC2HwRg=
+github.com/mitchellh/go-homedir v1.1.0 h1:lukF9ziXFxDFPkA1vsr5zpc1XuPDn/wFntq5mG+4E0Y=
+github.com/mitchellh/go-homedir v1.1.0/go.mod h1:SfyaCUpYCn1Vlf4IUYiD9fPX4A5wJrkLzIz1N1q0pr0=
+github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd h1:TRLaZ9cD/w8PVh93nsPXa1VrQ6jlwL5oN8l14QlcNfg=
+github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd/go.mod h1:6dJC0mAP4ikYIbvyc7fijjWJddQyLn8Ig3JB5CqoB9Q=
+github.com/modern-go/reflect2 v1.0.2 h1:xBagoLtFs94CBntxluKeaWgTMpvLxC4ur3nMaC9Gz0M=
+github.com/modern-go/reflect2 v1.0.2/go.mod h1:yWuevngMOJpCy52FWWMvUC8ws7m/LJsjYzDa0/r8luk=
+github.com/nats-io/nats.go v1.34.0 h1:fnxnPCNiwIG5w08rlMcEKTUw4AV/nKyGCOJE8TdhSPk=
+github.com/nats-io/nats.go v1.34.0/go.mod h1:Ubdu4Nh9exXdSz0RVWRFBbRfrbSxOYd26oF0wkWclB8=
+github.com/nats-io/nkeys v0.4.7 h1:RwNJbbIdYCoClSDNY7QVKZlyb/wfT6ugvFCiKy6vDvI=
+github.com/nats-io/nkeys v0.4.7/go.mod h1:kqXRgRDPlGy7nGaEDMuYzmiJCIAAWDK0IMBtDmGD0nc=
+github.com/nats-io/nuid v1.0.1 h1:5iA8DT8V7q8WK2EScv2padNa/rTESc1KdnPw4TC2paw=
+github.com/nats-io/nuid v1.0.1/go.mod h1:19wcPz3Ph3q0Jbyiqsd0kePYG7A95tJPxeL+1OSON2c=
+github.com/pkg/errors v0.9.1 h1:FEBLx1zS214owpjy7qsBeixbURkuhQAwrK5UwLGTwt4=
+github.com/pkg/sftp v1.13.6 h1:JFZT4XbOU7l77xGSpOdW+pwIMqP044IyjXX6FGyEKFo=
+github.com/pkg/sftp v1.13.6/go.mod h1:tz1ryNURKu77RL+GuCzmoJYxQczL3wLNNpPWagdg4Qk=
+github.com/rs/xid v1.6.0 h1:fV591PaemRlL6JfRxGDEPl69wICngIQ3shQtzfy2gxU=
+github.com/russross/blackfriday/v2 v2.1.0 h1:JIOH55/0cWyOuilr9/qlrm0BSXldqnqwMsf35Ld67mk=
+github.com/sagikazarmark/crypt v0.19.0 h1:WMyLTjHBo64UvNcWqpzY3pbZTYgnemZU8FBZigKc42E=
+github.com/sagikazarmark/crypt v0.19.0/go.mod h1:c6vimRziqqERhtSe0MhIvzE1w54FrCHtrXb5NH/ja78=
+github.com/stretchr/objx v0.5.2 h1:xuMeJ0Sdp5ZMRXx/aWO6RZxdr3beISkG5/G/aIRr3pY=
+go.etcd.io/etcd/api/v3 v3.5.12 h1:W4sw5ZoU2Juc9gBWuLk5U6fHfNVyY1WC5g9uiXZio/c=
+go.etcd.io/etcd/api/v3 v3.5.12/go.mod h1:Ot+o0SWSyT6uHhA56al1oCED0JImsRiU9Dc26+C2a+4=
+go.etcd.io/etcd/client/pkg/v3 v3.5.12 h1:EYDL6pWwyOsylrQyLp2w+HkQ46ATiOvoEdMarindU2A=
+go.etcd.io/etcd/client/pkg/v3 v3.5.12/go.mod h1:seTzl2d9APP8R5Y2hFL3NVlD6qC/dOT+3kvrqPyTas4=
+go.etcd.io/etcd/client/v2 v2.305.12 h1:0m4ovXYo1CHaA/Mp3X/Fak5sRNIWf01wk/X1/G3sGKI=
+go.etcd.io/etcd/client/v2 v2.305.12/go.mod h1:aQ/yhsxMu+Oht1FOupSr60oBvcS9cKXHrzBpDsPTf9E=
+go.etcd.io/etcd/client/v3 v3.5.12 h1:v5lCPXn1pf1Uu3M4laUE2hp/geOTc5uPcYYsNe1lDxg=
+go.etcd.io/etcd/client/v3 v3.5.12/go.mod h1:tSbBCakoWmmddL+BKVAJHa9km+O/E+bumDe9mSbPiqw=
+go.opencensus.io v0.24.0 h1:y73uSU6J157QMP2kn2r30vwW1A2W2WFwSCGnAVxeaD0=
+go.opencensus.io v0.24.0/go.mod h1:vNK8G9p7aAivkbmorf4v+7Hgx+Zs0yY+0fOtgBfjQKo=
+go.opentelemetry.io/contrib/instrumentation/google.golang.org/grpc/otelgrpc v0.49.0 h1:4Pp6oUg3+e/6M4C0A/3kJ2VYa++dsWVTtGgLVj5xtHg=
+go.opentelemetry.io/contrib/instrumentation/google.golang.org/grpc/otelgrpc v0.49.0/go.mod h1:Mjt1i1INqiaoZOMGR1RIUJN+i3ChKoFRqzrRQhlkbs0=
+go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp v0.49.0 h1:jq9TW8u3so/bN+JPT166wjOI6/vQPF6Xe7nMNIltagk=
+go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp v0.49.0/go.mod h1:p8pYQP+m5XfbZm9fxtSKAbM6oIllS7s2AfxrChvc7iw=
+go.opentelemetry.io/otel v1.24.0 h1:0LAOdjNmQeSTzGBzduGe/rU4tZhMwL5rWgtp9Ku5Jfo=
+go.opentelemetry.io/otel v1.24.0/go.mod h1:W7b9Ozg4nkF5tWI5zsXkaKKDjdVjpD4oAt9Qi/MArHo=
+go.opentelemetry.io/otel/metric v1.24.0 h1:6EhoGWWK28x1fbpA4tYTOWBkPefTDQnb8WSGXlc88kI=
+go.opentelemetry.io/otel/metric v1.24.0/go.mod h1:VYhLe1rFfxuTXLgj4CBiyz+9WYBA8pNGJgDcSFRKBco=
+go.opentelemetry.io/otel/trace v1.24.0 h1:CsKnnL4dUAr/0llH9FKuc698G04IrpWV0MQA/Y1YELI=
+go.opentelemetry.io/otel/trace v1.24.0/go.mod h1:HPc3Xr/cOApsBI154IU0OI0HJexz+aw5uPdbs3UCjNU=
+go.uber.org/zap v1.21.0 h1:WefMeulhovoZ2sYXz7st6K0sLj7bBhpiFaud4r4zST8=
+go.uber.org/zap v1.21.0/go.mod h1:wjWOCqI0f2ZZrJF/UufIOkiC8ii6tm1iqIsLo76RfJw=
+golang.org/x/crypto v0.21.0 h1:X31++rzVUdKhX5sWmSOFZxx8UW/ldWx55cbf08iNAMA=
+golang.org/x/crypto v0.21.0/go.mod h1:0BP7YvVV9gBbVKyeTG0Gyn+gZm94bibOW5BjDEYAOMs=
+golang.org/x/mod v0.12.0 h1:rmsUpXtvNzj340zd98LZ4KntptpfRHwpFOHG188oHXc=
+golang.org/x/mod v0.12.0/go.mod h1:iBbtSCu2XBx23ZKBPSOrRkjjQPZFPuis4dIYUhu/chs=
+golang.org/x/net v0.23.0 h1:7EYJ93RZ9vYSZAIb2x3lnuvqO5zneoD6IvWjuhfxjTs=
+golang.org/x/net v0.23.0/go.mod h1:JKghWKKOSdJwpW2GEx0Ja7fmaKnMsbu+MWVZTokSYmg=
+golang.org/x/oauth2 v0.18.0 h1:09qnuIAgzdx1XplqJvW6CQqMCtGZykZWcXzPMPUusvI=
+golang.org/x/oauth2 v0.18.0/go.mod h1:Wf7knwG0MPoWIMMBgFlEaSUDaKskp0dCfrlJRJXbBi8=
+golang.org/x/sync v0.6.0 h1:5BMeUDZ7vkXGfEr1x9B4bRcTH4lpkTkpdh0T/J+qjbQ=
+golang.org/x/sync v0.6.0/go.mod h1:Czt+wKu1gCyEFDUtn0jG5QVvpJ6rzVqr5aXyt9drQfk=
+golang.org/x/time v0.5.0 h1:o7cqy6amK/52YcAKIPlM3a+Fpj35zvRj2TP+e1xFSfk=
+golang.org/x/time v0.5.0/go.mod h1:3BpzKBy/shNhVucY/MWOyx10tF3SFh9QdLuxbVysPQM=
+golang.org/x/tools v0.13.0 h1:Iey4qkscZuv0VvIt8E0neZjtPVQFSc870HQ448QgEmQ=
+golang.org/x/tools v0.13.0/go.mod h1:HvlwmtVNQAhOuCjW7xxvovg8wbNq7LwfXh/k7wXUl58=
+golang.org/x/xerrors v0.0.0-20191204190536-9bdfabe68543 h1:E7g+9GITq07hpfrRu66IVDexMakfv52eLZ2CXBWiKr4=
+golang.org/x/xerrors v0.0.0-20220907171357-04be3eba64a2 h1:H2TDz8ibqkAF6YGhCdN3jS9O0/s90v0rJh3X/OLHEUk=
+golang.org/x/xerrors v0.0.0-20220907171357-04be3eba64a2/go.mod h1:K8+ghG5WaK9qNqU5K3HdILfMLy1f3aNYFI/wnl100a8=
+google.golang.org/api v0.171.0 h1:w174hnBPqut76FzW5Qaupt7zY8Kql6fiVjgys4f58sU=
+google.golang.org/api v0.171.0/go.mod h1:Hnq5AHm4OTMt2BUVjael2CWZFD6vksJdWCWiUAmjC9o=
+google.golang.org/appengine v1.6.8 h1:IhEN5q69dyKagZPYMSdIjS2HqprW324FRQZJcGqPAsM=
+google.golang.org/appengine v1.6.8/go.mod h1:1jJ3jBArFh5pcgW8gCtRJnepW8FzD1V44FJffLiz/Ds=
+google.golang.org/genproto v0.0.0-20240213162025-012b6fc9bca9 h1:9+tzLLstTlPTRyJTh+ah5wIMsBW5c4tQwGTN3thOW9Y=
+google.golang.org/genproto v0.0.0-20240213162025-012b6fc9bca9/go.mod h1:mqHbVIp48Muh7Ywss/AD6I5kNVKZMmAa/QEW58Gxp2s=
+google.golang.org/genproto/googleapis/api v0.0.0-20240311132316-a219d84964c2 h1:rIo7ocm2roD9DcFIX67Ym8icoGCKSARAiPljFhh5suQ=
+google.golang.org/genproto/googleapis/api v0.0.0-20240311132316-a219d84964c2/go.mod h1:O1cOfN1Cy6QEYr7VxtjOyP5AdAuR0aJ/MYZaaof623Y=
+google.golang.org/genproto/googleapis/rpc v0.0.0-20240314234333-6e1732d8331c h1:lfpJ/2rWPa/kJgxyyXM8PrNnfCzcmxJ265mADgwmvLI=
+google.golang.org/genproto/googleapis/rpc v0.0.0-20240314234333-6e1732d8331c/go.mod h1:WtryC6hu0hhx87FDGxWCDptyssuo68sk10vYjF+T9fY=
+google.golang.org/grpc v1.62.1 h1:B4n+nfKzOICUXMgyrNd19h/I9oH0L1pizfk1d4zSgTk=
+google.golang.org/grpc v1.62.1/go.mod h1:IWTG0VlJLCh1SkC58F7np9ka9mx/WNkjl4PGJaiq+QE=
+google.golang.org/protobuf v1.33.0 h1:uNO2rsAINq/JlFpSdYEKIZ0uKD/R9cpdv0T+yoGwGmI=
+google.golang.org/protobuf v1.33.0/go.mod h1:c6P6GXX6sHbq/GpV6MGZEdwhWPcYBgnhAHhKbcUYpos=
+gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405 h1:yhCVgyC4o1eVCa2tZl7eS0r+SDo693bJlVdllGtEeKM=
--- a/install.py
+++ b/install.py
@@ -121,8 +121,11 @@ def save_settings(ctx: Dict[str, Any], settings: Dict[str, Any]) -> None:
    _save_json(settings_path, settings)


-def find_module_hooks(module_name: str, cfg: Dict[str, Any], ctx: Dict[str, Any]) -> Optional[Dict[str, Any]]:
-    """Find hooks.json for a module if it exists."""
+def find_module_hooks(module_name: str, cfg: Dict[str, Any], ctx: Dict[str, Any]) -> Optional[tuple]:
+    """Find hooks.json for a module if it exists.
+
+    Returns tuple of (hooks_config, plugin_root_path) or None.
+    """
    # Check for hooks in operations (copy_dir targets)
    for op in cfg.get("operations", []):
        if op.get("type") == "copy_dir":
@@ -130,18 +133,19 @@ def find_module_hooks(module_name: str, cfg: Dict[str, Any], ctx: Dict[str, Any]
            hooks_file = target_dir / "hooks" / "hooks.json"
            if hooks_file.exists():
                try:
-                    return _load_json(hooks_file)
+                    return (_load_json(hooks_file), str(target_dir))
                except (ValueError, FileNotFoundError):
                    pass

    # Also check source directory during install
    for op in cfg.get("operations", []):
        if op.get("type") == "copy_dir":
+            target_dir = ctx["install_dir"] / op["target"]
            source_dir = ctx["config_dir"] / op["source"]
            hooks_file = source_dir / "hooks" / "hooks.json"
            if hooks_file.exists():
                try:
-                    return _load_json(hooks_file)
+                    return (_load_json(hooks_file), str(target_dir))
                except (ValueError, FileNotFoundError):
                    pass

@@ -153,7 +157,18 @@ def _create_hook_marker(module_name: str) -> str:
    return f"__module:{module_name}__"


-def merge_hooks_to_settings(module_name: str, hooks_config: Dict[str, Any], ctx: Dict[str, Any]) -> None:
+def _replace_hook_variables(obj: Any, plugin_root: str) -> Any:
+    """Recursively replace ${CLAUDE_PLUGIN_ROOT} in hook config."""
+    if isinstance(obj, str):
+        return obj.replace("${CLAUDE_PLUGIN_ROOT}", plugin_root)
+    elif isinstance(obj, dict):
+        return {k: _replace_hook_variables(v, plugin_root) for k, v in obj.items()}
+    elif isinstance(obj, list):
+        return [_replace_hook_variables(item, plugin_root) for item in obj]
+    return obj
+
+
+def merge_hooks_to_settings(module_name: str, hooks_config: Dict[str, Any], ctx: Dict[str, Any], plugin_root: str = "") -> None:
    """Merge module hooks into settings.json."""
    settings = load_settings(ctx)
    settings.setdefault("hooks", {})
@@ -161,6 +176,10 @@ def merge_hooks_to_settings(module_name: str, hooks_config: Dict[str, Any], ctx:
    module_hooks = hooks_config.get("hooks", {})
    marker = _create_hook_marker(module_name)

+    # Replace ${CLAUDE_PLUGIN_ROOT} with actual path
+    if plugin_root:
+        module_hooks = _replace_hook_variables(module_hooks, plugin_root)
+
    for hook_type, hook_entries in module_hooks.items():
        settings["hooks"].setdefault(hook_type, [])

@@ -707,10 +726,11 @@ def execute_module(name: str, cfg: Dict[str, Any], ctx: Dict[str, Any]) -> Dict[
            raise

    # Handle hooks: find and merge module hooks into settings.json
-    hooks_config = find_module_hooks(name, cfg, ctx)
-    if hooks_config:
+    hooks_result = find_module_hooks(name, cfg, ctx)
+    if hooks_result:
+        hooks_config, plugin_root = hooks_result
        try:
-            merge_hooks_to_settings(name, hooks_config, ctx)
+            merge_hooks_to_settings(name, hooks_config, ctx, plugin_root)
            result["operations"].append({"type": "merge_hooks", "status": "success"})
            result["has_hooks"] = True
        except Exception as exc:
--- a/skills/feature-dev/README.md
+++ b/skills/feature-dev/README.md
@@ -0,0 +1,86 @@
+# feature-dev
+
+7 阶段功能开发工作流，使用 codeagent-wrapper 编排多个 agent。
+
+## 安装
+
+```bash
+python install.py --module feature-dev
+```
+
+安装内容：
+- `~/.claude/skills/feature-dev/` - skill 文件
+- hooks 自动合并到 `~/.claude/settings.json`
+
+## 使用
+
+```
+/feature-dev <功能描述>
+```
+
+示例：
+```
+/feature-dev 添加用户登录功能
+/feature-dev 实现订单导出 CSV
+```
+
+## 工作流阶段
+
+| 阶段 | 名称 | 目标 |
+|------|------|------|
+| 1 | Discovery | 理解需求 |
+| 2 | Exploration | 探索代码库 |
+| 3 | Clarification | 澄清疑问（必须） |
+| 4 | Architecture | 设计方案 |
+| 5 | Implementation | 实现（需审批） |
+| 6 | Review | 代码审查 |
+| 7 | Summary | 总结文档 |
+
+## Agents
+
+- `code-explorer` - 代码追踪、架构映射
+- `code-architect` - 方案设计、文件规划
+- `code-reviewer` - 代码审查、简化建议
+- `develop` - 实现代码、运行测试
+
+Agent 提示词位于 `agents/` 目录。如需自定义，可在 `~/.codeagent/agents/` 创建同名文件覆盖。
+
+## ~/.codeagent/models.json 配置
+
+可选。默认使用 codeagent-wrapper 内置配置。如需自定义 agent 模型：
+
+```json
+{
+  "agents": {
+    "code-explorer": {
+      "backend": "claude",
+      "model": "claude-sonnet-4-5-20250929"
+    },
+    "code-architect": {
+      "backend": "claude",
+      "model": "claude-sonnet-4-5-20250929"
+    },
+    "code-reviewer": {
+      "backend": "claude",
+      "model": "claude-sonnet-4-5-20250929"
+    }
+  }
+}
+```
+
+## Loop 机制
+
+安装后会注册 Stop hook。当 `/feature-dev` 执行时：
+
+1. 创建 `.claude/feature-dev.local.md` 状态文件
+2. 每阶段更新 `current_phase`
+3. Stop hook 检测状态，未完成时阻止退出
+4. 完成后输出 `<promise>FEATURE_COMPLETE</promise>` 结束
+
+手动退出：将状态文件中 `active` 设为 `false`。
+
+## 卸载
+
+```bash
+python install.py --uninstall --module feature-dev
+```
--- a/skills/feature-dev/SKILL.md
+++ b/skills/feature-dev/SKILL.md
@@ -0,0 +1,331 @@
+---
+name: feature-dev
+description: This skill should be used for structured feature development with codebase understanding. Triggers on /feature-dev command. Provides a 7-phase workflow (Discovery, Exploration, Clarification, Architecture, Implementation, Review, Summary) using codeagent-wrapper to orchestrate code-explorer, code-architect, code-reviewer, and develop agents in parallel.
+allowed-tools: ["Bash(${SKILL_DIR}/scripts/setup-feature-dev.sh:*)"]
+---
+
+# Feature Development Orchestrator
+
+An orchestrator for systematic feature development. Invoke agents via `codeagent-wrapper`, never write code directly.
+
+## Loop Initialization (REQUIRED)
+
+When triggered via `/feature-dev <task>`, **first** initialize the loop state:
+
+```bash
+"${SKILL_DIR}/scripts/setup-feature-dev.sh" "<task description>"
+```
+
+This creates `.claude/feature-dev.local.md` with:
+- `active: true`
+- `current_phase: 1`
+- `max_phases: 7`
+- `completion_promise: "<promise>FEATURE_COMPLETE</promise>"`
+
+## Loop State Management
+
+After each phase, update `.claude/feature-dev.local.md` frontmatter:
+```yaml
+current_phase: <next phase number>
+phase_name: "<next phase name>"
+```
+
+When all 7 phases complete, output the completion signal:
+```
+<promise>FEATURE_COMPLETE</promise>
+```
+
+To abort early, set `active: false` in the state file.
+
+## Hard Constraints
+
+1. **Never write code directly.** Delegate all code changes to `codeagent-wrapper` agents.
+2. **Phase 3 (Clarification) is mandatory.** Do not proceed until questions are answered.
+3. **Phase 5 (Implementation) requires explicit approval.** Stop after Phase 4 if not approved.
+4. **Pass complete context forward.** Every agent invocation includes the Context Pack.
+5. **Parallel-first.** Run independent tasks via `codeagent-wrapper --parallel`.
+6. **Update state after each phase.** Keep `.claude/feature-dev.local.md` current.
+
+## Agents
+
+| Agent | Purpose | Prompt |
+|-------|---------|--------|
+| `code-explorer` | Trace code, map architecture, find patterns | `agents/code-explorer.md` |
+| `code-architect` | Design approaches, file plans, build sequences | `agents/code-architect.md` |
+| `code-reviewer` | Review for bugs, simplicity, conventions | `agents/code-reviewer.md` |
+| `develop` | Implement code, run tests | (uses global config) |
+
+## Context Pack Template
+
+```text
+## Original User Request
+<verbatim request>
+
+## Context Pack
+- Phase: <1-7 name>
+- Decisions: <requirements/constraints/choices>
+- Code-explorer output: <paste or "None">
+- Code-architect output: <paste or "None">
+- Code-reviewer output: <paste or "None">
+- Develop output: <paste or "None">
+- Open questions: <list or "None">
+
+## Current Task
+<specific task>
+
+## Acceptance Criteria
+<checkable outputs>
+```
+
+## 7-Phase Workflow
+
+### Phase 1: Discovery
+
+**Goal:** Understand what to build.
+
+**Actions:**
+1. Use AskUserQuestion for: user-visible behavior, scope, constraints, acceptance criteria
+2. Invoke `code-architect` to draft requirements checklist and clarifying questions
+
+```bash
+codeagent-wrapper --agent code-architect - . <<'EOF'
+## Original User Request
+/feature-dev <request>
+
+## Context Pack
+- Code-explorer output: None
+- Code-architect output: None
+
+## Current Task
+Produce requirements checklist and identify missing information.
+Output: Requirements, Non-goals, Risks, Acceptance criteria, Questions (<= 10)
+
+## Acceptance Criteria
+Concrete, testable checklist; specific questions; no implementation.
+EOF
+```
+
+### Phase 2: Exploration
+
+**Goal:** Map codebase patterns and extension points.
+
+**Actions:** Run 2-3 `code-explorer` tasks in parallel (similar features, architecture, tests/conventions).
+
+```bash
+codeagent-wrapper --parallel <<'EOF'
+---TASK---
+id: p2_similar_features
+agent: code-explorer
+workdir: .
+---CONTENT---
+## Original User Request
+/feature-dev <request>
+
+## Context Pack
+- Code-architect output: <Phase 1 output>
+
+## Current Task
+Find 1-3 similar features, trace end-to-end. Return: key files with line numbers, call flow, extension points.
+
+## Acceptance Criteria
+Concrete file:line map + reuse points.
+
+---TASK---
+id: p2_architecture
+agent: code-explorer
+workdir: .
+---CONTENT---
+## Original User Request
+/feature-dev <request>
+
+## Context Pack
+- Code-architect output: <Phase 1 output>
+
+## Current Task
+Map architecture for relevant subsystem. Return: module map + 5-10 key files.
+
+## Acceptance Criteria
+Clear boundaries; file:line references.
+
+---TASK---
+id: p2_conventions
+agent: code-explorer
+workdir: .
+---CONTENT---
+## Original User Request
+/feature-dev <request>
+
+## Context Pack
+- Code-architect output: <Phase 1 output>
+
+## Current Task
+Identify testing patterns, conventions, config. Return: test commands + file locations.
+
+## Acceptance Criteria
+Test commands + relevant test file paths.
+EOF
+```
+
+### Phase 3: Clarification (MANDATORY)
+
+**Goal:** Resolve all ambiguities before design.
+
+**Actions:**
+1. Invoke `code-architect` to generate prioritized questions from Phase 1+2 outputs
+2. Use AskUserQuestion to present questions and wait for answers
+3. **Do not proceed until answered or defaults accepted**
+
+### Phase 4: Architecture
+
+**Goal:** Produce implementation plan fitting existing patterns.
+
+**Actions:** Run 2 `code-architect` tasks in parallel (minimal-change vs pragmatic-clean).
+
+```bash
+codeagent-wrapper --parallel <<'EOF'
+---TASK---
+id: p4_minimal
+agent: code-architect
+workdir: .
+---CONTENT---
+## Original User Request
+/feature-dev <request>
+
+## Context Pack
+- Code-explorer output: <ALL Phase 2 outputs>
+- Code-architect output: <Phase 1 + Phase 3 answers>
+
+## Current Task
+Propose minimal-change architecture: reuse existing abstractions, minimize new files.
+Output: file touch list, risks, edge cases.
+
+## Acceptance Criteria
+Concrete blueprint; minimal moving parts.
+
+---TASK---
+id: p4_pragmatic
+agent: code-architect
+workdir: .
+---CONTENT---
+## Original User Request
+/feature-dev <request>
+
+## Context Pack
+- Code-explorer output: <ALL Phase 2 outputs>
+- Code-architect output: <Phase 1 + Phase 3 answers>
+
+## Current Task
+Propose pragmatic-clean architecture: introduce seams for testability.
+Output: file touch list, testing plan, risks.
+
+## Acceptance Criteria
+Implementable blueprint with build sequence and tests.
+EOF
+```
+
+Use AskUserQuestion to let user choose approach.
+
+### Phase 5: Implementation (Approval Required)
+
+**Goal:** Build the feature.
+
+**Actions:**
+1. Use AskUserQuestion: "Approve starting implementation?" (Approve / Not yet)
+2. If approved, invoke `develop`:
+
+```bash
+codeagent-wrapper --agent develop - . <<'EOF'
+## Original User Request
+/feature-dev <request>
+
+## Context Pack
+- Code-explorer output: <ALL Phase 2 outputs>
+- Code-architect output: <selected Phase 4 blueprint + Phase 3 answers>
+
+## Current Task
+Implement with minimal change set following chosen architecture.
+- Follow Phase 2 patterns
+- Add/adjust tests per Phase 4 plan
+- Run narrowest relevant tests
+
+## Acceptance Criteria
+Feature works end-to-end; tests pass; diff is minimal.
+EOF
+```
+
+### Phase 6: Review
+
+**Goal:** Catch defects and unnecessary complexity.
+
+**Actions:** Run 2-3 `code-reviewer` tasks in parallel (correctness, simplicity).
+
+```bash
+codeagent-wrapper --parallel <<'EOF'
+---TASK---
+id: p6_correctness
+agent: code-reviewer
+workdir: .
+---CONTENT---
+## Original User Request
+/feature-dev <request>
+
+## Context Pack
+- Code-architect output: <Phase 4 blueprint>
+- Develop output: <Phase 5 output>
+
+## Current Task
+Review for correctness, edge cases, failure modes. Assume adversarial inputs.
+
+## Acceptance Criteria
+Issues with file:line references and concrete fixes.
+
+---TASK---
+id: p6_simplicity
+agent: code-reviewer
+workdir: .
+---CONTENT---
+## Original User Request
+/feature-dev <request>
+
+## Context Pack
+- Code-architect output: <Phase 4 blueprint>
+- Develop output: <Phase 5 output>
+
+## Current Task
+Review for KISS: remove bloat, collapse needless abstractions.
+
+## Acceptance Criteria
+Actionable simplifications with justification.
+EOF
+```
+
+Use AskUserQuestion: Fix now / Fix later / Proceed as-is.
+
+### Phase 7: Summary
+
+**Goal:** Document what was built.
+
+**Actions:** Invoke `code-reviewer` to produce summary:
+
+```bash
+codeagent-wrapper --agent code-reviewer - . <<'EOF'
+## Original User Request
+/feature-dev <request>
+
+## Context Pack
+- Code-architect output: <Phase 4 blueprint>
+- Code-reviewer output: <Phase 6 outcomes>
+- Develop output: <Phase 5 output + fixes>
+
+## Current Task
+Write completion summary:
+- What was built
+- Key decisions/tradeoffs
+- Files modified (paths)
+- How to verify (commands)
+- Follow-ups (optional)
+
+## Acceptance Criteria
+Short, technical, actionable summary.
+EOF
+```
--- a/skills/feature-dev/agents/code-architect.md
+++ b/skills/feature-dev/agents/code-architect.md
@@ -0,0 +1,34 @@
+---
+name: code-architect
+description: Designs feature architectures by analyzing existing codebase patterns and conventions, then providing comprehensive implementation blueprints with specific files to create/modify, component designs, data flows, and build sequences
+tools: Glob, Grep, LS, Read, NotebookRead, WebFetch, TodoWrite, WebSearch, KillShell, BashOutput
+model: sonnet
+color: green
+---
+
+You are a senior software architect who delivers comprehensive, actionable architecture blueprints by deeply understanding codebases and making confident architectural decisions.
+
+## Core Process
+
+**1. Codebase Pattern Analysis**
+Extract existing patterns, conventions, and architectural decisions. Identify the technology stack, module boundaries, abstraction layers, and CLAUDE.md guidelines. Find similar features to understand established approaches.
+
+**2. Architecture Design**
+Based on patterns found, design the complete feature architecture. Make decisive choices - pick one approach and commit. Ensure seamless integration with existing code. Design for testability, performance, and maintainability.
+
+**3. Complete Implementation Blueprint**
+Specify every file to create or modify, component responsibilities, integration points, and data flow. Break implementation into clear phases with specific tasks.
+
+## Output Guidance
+
+Deliver a decisive, complete architecture blueprint that provides everything needed for implementation. Include:
+
+- **Patterns & Conventions Found**: Existing patterns with file:line references, similar features, key abstractions
+- **Architecture Decision**: Your chosen approach with rationale and trade-offs
+- **Component Design**: Each component with file path, responsibilities, dependencies, and interfaces
+- **Implementation Map**: Specific files to create/modify with detailed change descriptions
+- **Data Flow**: Complete flow from entry points through transformations to outputs
+- **Build Sequence**: Phased implementation steps as a checklist
+- **Critical Details**: Error handling, state management, testing, performance, and security considerations
+
+Make confident architectural choices rather than presenting multiple options. Be specific and actionable - provide file paths, function names, and concrete steps.
--- a/skills/feature-dev/agents/code-explorer.md
+++ b/skills/feature-dev/agents/code-explorer.md
@@ -0,0 +1,51 @@
+---
+name: code-explorer
+description: Deeply analyzes existing codebase features by tracing execution paths, mapping architecture layers, understanding patterns and abstractions, and documenting dependencies to inform new development
+tools: Glob, Grep, LS, Read, NotebookRead, WebFetch, TodoWrite, WebSearch, KillShell, BashOutput
+model: sonnet
+color: yellow
+---
+
+You are an expert code analyst specializing in tracing and understanding feature implementations across codebases.
+
+## Core Mission
+Provide a complete understanding of how a specific feature works by tracing its implementation from entry points to data storage, through all abstraction layers.
+
+## Analysis Approach
+
+**1. Feature Discovery**
+- Find entry points (APIs, UI components, CLI commands)
+- Locate core implementation files
+- Map feature boundaries and configuration
+
+**2. Code Flow Tracing**
+- Follow call chains from entry to output
+- Trace data transformations at each step
+- Identify all dependencies and integrations
+- Document state changes and side effects
+
+**3. Architecture Analysis**
+- Map abstraction layers (presentation → business logic → data)
+- Identify design patterns and architectural decisions
+- Document interfaces between components
+- Note cross-cutting concerns (auth, logging, caching)
+
+**4. Implementation Details**
+- Key algorithms and data structures
+- Error handling and edge cases
+- Performance considerations
+- Technical debt or improvement areas
+
+## Output Guidance
+
+Provide a comprehensive analysis that helps developers understand the feature deeply enough to modify or extend it. Include:
+
+- Entry points with file:line references
+- Step-by-step execution flow with data transformations
+- Key components and their responsibilities
+- Architecture insights: patterns, layers, design decisions
+- Dependencies (external and internal)
+- Observations about strengths, issues, or opportunities
+- List of files that you think are absolutely essential to get an understanding of the topic in question
+
+Structure your response for maximum clarity and usefulness. Always include specific file paths and line numbers.
--- a/skills/feature-dev/agents/code-reviewer.md
+++ b/skills/feature-dev/agents/code-reviewer.md
@@ -0,0 +1,46 @@
+---
+name: code-reviewer
+description: Reviews code for bugs, logic errors, security vulnerabilities, code quality issues, and adherence to project conventions, using confidence-based filtering to report only high-priority issues that truly matter
+tools: Glob, Grep, LS, Read, NotebookRead, WebFetch, TodoWrite, WebSearch, KillShell, BashOutput
+model: sonnet
+color: red
+---
+
+You are an expert code reviewer specializing in modern software development across multiple languages and frameworks. Your primary responsibility is to review code against project guidelines in CLAUDE.md with high precision to minimize false positives.
+
+## Review Scope
+
+By default, review unstaged changes from `git diff`. The user may specify different files or scope to review.
+
+## Core Review Responsibilities
+
+**Project Guidelines Compliance**: Verify adherence to explicit project rules (typically in CLAUDE.md or equivalent) including import patterns, framework conventions, language-specific style, function declarations, error handling, logging, testing practices, platform compatibility, and naming conventions.
+
+**Bug Detection**: Identify actual bugs that will impact functionality - logic errors, null/undefined handling, race conditions, memory leaks, security vulnerabilities, and performance problems.
+
+**Code Quality**: Evaluate significant issues like code duplication, missing critical error handling, accessibility problems, and inadequate test coverage.
+
+## Confidence Scoring
+
+Rate each potential issue on a scale from 0-100:
+
+- **0**: Not confident at all. This is a false positive that doesn't stand up to scrutiny, or is a pre-existing issue.
+- **25**: Somewhat confident. This might be a real issue, but may also be a false positive. If stylistic, it wasn't explicitly called out in project guidelines.
+- **50**: Moderately confident. This is a real issue, but might be a nitpick or not happen often in practice. Not very important relative to the rest of the changes.
+- **75**: Highly confident. Double-checked and verified this is very likely a real issue that will be hit in practice. The existing approach is insufficient. Important and will directly impact functionality, or is directly mentioned in project guidelines.
+- **100**: Absolutely certain. Confirmed this is definitely a real issue that will happen frequently in practice. The evidence directly confirms this.
+
+**Only report issues with confidence ≥ 80.** Focus on issues that truly matter - quality over quantity.
+
+## Output Guidance
+
+Start by clearly stating what you're reviewing. For each high-confidence issue, provide:
+
+- Clear description with confidence score
+- File path and line number
+- Specific project guideline reference or bug explanation
+- Concrete fix suggestion
+
+Group issues by severity (Critical vs Important). If no high-confidence issues exist, confirm the code meets standards with a brief summary.
+
+Structure your response for maximum actionability - developers should know exactly what to fix and why.
--- a/skills/feature-dev/hooks/hooks.json
+++ b/skills/feature-dev/hooks/hooks.json
@@ -0,0 +1,15 @@
+{
+  "description": "Feature-dev loop hook for 7-phase workflow",
+  "hooks": {
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/stop-hook.sh"
+          }
+        ]
+      }
+    ]
+  }
+}
--- a/skills/feature-dev/hooks/stop-hook.sh
+++ b/skills/feature-dev/hooks/stop-hook.sh
@@ -0,0 +1,123 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+phase_name_for() {
+	case "${1:-}" in
+	1) echo "Discovery" ;;
+	2) echo "Exploration" ;;
+	3) echo "Clarification" ;;
+	4) echo "Architecture" ;;
+	5) echo "Implementation" ;;
+	6) echo "Review" ;;
+	7) echo "Summary" ;;
+	*) echo "Phase ${1:-unknown}" ;;
+	esac
+}
+
+json_escape() {
+	local s="${1:-}"
+	s=${s//\\/\\\\}
+	s=${s//\"/\\\"}
+	s=${s//$'\n'/\\n}
+	s=${s//$'\r'/\\r}
+	s=${s//$'\t'/\\t}
+	printf "%s" "$s"
+}
+
+project_dir="${CLAUDE_PROJECT_DIR:-$PWD}"
+state_file="${project_dir}/.claude/feature-dev.local.md"
+
+if [ ! -f "$state_file" ]; then
+	exit 0
+fi
+
+stdin_payload=""
+if [ ! -t 0 ]; then
+	stdin_payload="$(cat || true)"
+fi
+
+frontmatter_get() {
+	local key="$1"
+	awk -v k="$key" '
+		BEGIN { in_fm=0 }
+		NR==1 && $0=="---" { in_fm=1; next }
+		in_fm==1 && $0=="---" { exit }
+		in_fm==1 {
+			if ($0 ~ "^"k":[[:space:]]*") {
+				sub("^"k":[[:space:]]*", "", $0)
+				gsub(/^[[:space:]]+|[[:space:]]+$/, "", $0)
+				if ($0 ~ /^".*"$/) { sub(/^"/, "", $0); sub(/"$/, "", $0) }
+				print $0
+				exit
+			}
+		}
+	' "$state_file"
+}
+
+active_raw="$(frontmatter_get active || true)"
+active_lc="$(printf "%s" "$active_raw" | tr '[:upper:]' '[:lower:]')"
+case "$active_lc" in
+true|1|yes|on) ;;
+*) exit 0 ;;
+esac
+
+current_phase_raw="$(frontmatter_get current_phase || true)"
+max_phases_raw="$(frontmatter_get max_phases || true)"
+phase_name="$(frontmatter_get phase_name || true)"
+completion_promise="$(frontmatter_get completion_promise || true)"
+
+current_phase=1
+if [[ "${current_phase_raw:-}" =~ ^[0-9]+$ ]]; then
+	current_phase="$current_phase_raw"
+fi
+
+max_phases=7
+if [[ "${max_phases_raw:-}" =~ ^[0-9]+$ ]]; then
+	max_phases="$max_phases_raw"
+fi
+
+if [ -z "${phase_name:-}" ]; then
+	phase_name="$(phase_name_for "$current_phase")"
+fi
+
+if [ -z "${completion_promise:-}" ]; then
+	completion_promise="<promise>FEATURE_COMPLETE</promise>"
+fi
+
+phases_done=0
+if [ "$current_phase" -ge "$max_phases" ]; then
+	phases_done=1
+fi
+
+promise_met=0
+if [ -n "$completion_promise" ]; then
+	if [ -n "$stdin_payload" ] && printf "%s" "$stdin_payload" | grep -Fq -- "$completion_promise"; then
+		promise_met=1
+	else
+		body="$(
+			awk '
+				BEGIN { in_fm=0; body=0 }
+				NR==1 && $0=="---" { in_fm=1; next }
+				in_fm==1 && $0=="---" { body=1; in_fm=0; next }
+				body==1 { print }
+			' "$state_file"
+		)"
+		if [ -n "$body" ] && printf "%s" "$body" | grep -Fq -- "$completion_promise"; then
+			promise_met=1
+		fi
+	fi
+fi
+
+if [ "$phases_done" -eq 1 ] && [ "$promise_met" -eq 1 ]; then
+	exit 0
+fi
+
+if [ "$phases_done" -eq 0 ]; then
+	reason="feature-dev 循环未完成：当前阶段 ${current_phase}/${max_phases}（${phase_name}）。继续执行剩余阶段；完成每个阶段后更新 ${state_file} 的 current_phase/phase_name。全部完成后在最终输出中包含 completion_promise：${completion_promise}。如需退出，将 active 设为 false。"
+else
+	reason="feature-dev 已到最终阶段（current_phase=${current_phase} / max_phases=${max_phases}，phase_name=${phase_name}），但未检测到 completion_promise：${completion_promise}。请在最终输出中包含该标记（或写入 ${state_file} 正文），然后再结束；如需强制退出，将 active 设为 false。"
+fi
+
+printf '{"decision":"block","reason":"%s"}\n' "$(json_escape "$reason")"
+exit 0
--- a/skills/feature-dev/scripts/setup-feature-dev.sh
+++ b/skills/feature-dev/scripts/setup-feature-dev.sh
@@ -0,0 +1,111 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+usage() {
+	cat <<'EOF'
+Usage: setup-feature-dev.sh [options] PROMPT...
+
+Creates (or overwrites) project state file:
+  .claude/feature-dev.local.md
+
+Options:
+  --max-phases N            Default: 7
+  --completion-promise STR  Default: <promise>FEATURE_COMPLETE</promise>
+  -h, --help                Show this help
+EOF
+}
+
+die() {
+	echo "❌ $*" >&2
+	exit 1
+}
+
+phase_name_for() {
+	case "${1:-}" in
+	1) echo "Discovery" ;;
+	2) echo "Exploration" ;;
+	3) echo "Clarification" ;;
+	4) echo "Architecture" ;;
+	5) echo "Implementation" ;;
+	6) echo "Review" ;;
+	7) echo "Summary" ;;
+	*) echo "Phase ${1:-unknown}" ;;
+	esac
+}
+
+max_phases=7
+completion_promise="<promise>FEATURE_COMPLETE</promise>"
+declare -a prompt_parts=()
+
+while [ $# -gt 0 ]; do
+	case "$1" in
+	-h|--help)
+		usage
+		exit 0
+		;;
+	--max-phases)
+		[ $# -ge 2 ] || die "--max-phases requires a value"
+		max_phases="$2"
+		shift 2
+		;;
+	--completion-promise)
+		[ $# -ge 2 ] || die "--completion-promise requires a value"
+		completion_promise="$2"
+		shift 2
+		;;
+	--)
+		shift
+		while [ $# -gt 0 ]; do
+			prompt_parts+=("$1")
+			shift
+		done
+		break
+		;;
+	-*)
+		die "Unknown argument: $1 (use --help)"
+		;;
+	*)
+		prompt_parts+=("$1")
+		shift
+		;;
+	esac
+done
+
+prompt="${prompt_parts[*]:-}"
+[ -n "$prompt" ] || die "PROMPT is required (use --help)"
+
+if ! [[ "$max_phases" =~ ^[0-9]+$ ]] || [ "$max_phases" -lt 1 ]; then
+	die "--max-phases must be a positive integer"
+fi
+
+project_dir="${CLAUDE_PROJECT_DIR:-$PWD}"
+state_dir="${project_dir}/.claude"
+state_file="${state_dir}/feature-dev.local.md"
+
+mkdir -p "$state_dir"
+
+phase_name="$(phase_name_for 1)"
+
+cat > "$state_file" << EOF
+---
+active: true
+current_phase: 1
+phase_name: "$phase_name"
+max_phases: $max_phases
+completion_promise: "$completion_promise"
+---
+
+# feature-dev loop state
+
+## Prompt
+$prompt
+
+## Notes
+- Update frontmatter current_phase/phase_name as you progress
+- When complete, include the frontmatter completion_promise in your final output
+EOF
+
+echo "Initialized: $state_file"
+echo "phase: 1/$max_phases ($phase_name)"
+echo "completion_promise: $completion_promise"
Author	SHA1	Message	Date
NieiR	669b1d82ce	fix(gemini): read GEMINI_MODEL from ~/.gemini/.env (#131 ) When using gemini backend without --model flag, now automatically reads GEMINI_MODEL from ~/.gemini/.env file, consistent with how claude backend reads model from settings.	2026-01-23 12:03:50 +08:00
cexll	a21c31fd89	feat: add feature-dev skill with 7-phase workflow Structured feature development with codeagent orchestration: - Discovery, Exploration, Clarification, Architecture phases - Implementation, Review, Summary phases - Parallel agent execution via code-explorer, code-architect, etc. - Hook-based workflow automation with validation scripts Generated with SWE-Agent.ai Co-Authored-By: SWE-Agent.ai <noreply@swe-agent.ai>	2026-01-23 12:01:31 +08:00
cexll	773f133111	chore: ignore references directory Generated with SWE-Agent.ai Co-Authored-By: SWE-Agent.ai <noreply@swe-agent.ai>	2026-01-23 12:01:04 +08:00
cexll	4f5d24531c	feat(install): support \${CLAUDE_PLUGIN_ROOT} variable in hooks config - find_module_hooks now returns (hooks_config, plugin_root_path) tuple - Add _replace_hook_variables() for recursive placeholder substitution - Add feature-dev module config to config.json Generated with SWE-Agent.ai Co-Authored-By: SWE-Agent.ai <noreply@swe-agent.ai>	2026-01-23 12:00:55 +08:00
cexll	cc24d43c8b	fix(codeagent): validate non-empty output message before printing Return exit code 1 when backend returns empty result.Message with exit_code=0. Prevents silent failures where no output is produced. Generated with SWE-Agent.ai Co-Authored-By: SWE-Agent.ai <noreply@swe-agent.ai>	2026-01-23 12:00:47 +08:00
cexll	27d4ac8afd	chore: add go.work.sum for workspace dependencies Generated with SWE-Agent.ai Co-Authored-By: SWE-Agent.ai <noreply@swe-agent.ai>	2026-01-23 12:00:38 +08:00