dsh-gate-agent 0.1.5 → 0.1.7

package/README.md

@@ -60,15 +60,12 @@ Host 插件：用 phase/node 门禁组织讨论、规划、实施、评审、验
 | phase / node | 用途 | 主代理/worker 与技能 |
 |---|---|---|
 | `discuss` | 理解需求、讨论方案、确认授权 | root；不派 worker；文件只读，可提交已有改动 |
-| `orchestrating/plan` | 把工作项整理成规划工件 | planning worker（文件只读、只读 shell、`gate_note_write`）；`gate-planning` + `gate-write-agent-notes` |
+| `orchestrating/plan` | 规划，或 review findings 后修订 | planning worker（文件只读、只读 shell、`gate_note_write`）；`gate-planning` + `gate-write-agent-notes` |
 | `orchestrating/plan-review` | Plan Review 三轴评审 | review worker；`gate-plan-review` |
-| `orchestrating/plan-revise` | 按 findings 修计划 | planning worker；`gate-planning` |
-| `orchestrating/implement` | 按已确认计划实施 | implement worker；`gate-implement` |
+| `orchestrating/implement` | 实施，或 review/verify findings 后修正 | implement worker；`gate-implement` |
 | `orchestrating/code-review` | 实现 review（Standards/Spec） | review worker；`gate-code-review` |
-| `orchestrating/implement-revise` | 按 review findings 修正 | implement worker；`gate-implement` |
 | `orchestrating/verify` | 最终验收与证据绑定 | verify worker；`gate-verify` |
 | `orchestrating/note-lifecycle` | 把 proposed Note 转 implemented、跑 notes 校验 | root；`gate-write-agent-notes` lifecycle 工具 |
-| `orchestrating/fix-bug` | 修复已授权缺陷并复核 | fix worker + review worker；`gate-fix-bug` + `gate-code-review` |
 | `reviewing/code-review-standalone` | 单独只读 code review | review worker；`gate-code-review` |
 | `reviewing/proposal-review` | 单独提案评审 | review worker；`gate-plan-review` |
 | `reviewing/verify-standalone` | 单独只读验收 | verify worker；`gate-user-verify` |
@@ -78,6 +75,16 @@ Host 插件：用 phase/node 门禁组织讨论、规划、实施、评审、验
 
 进入阶段不等于执行。主代理按当前 procedure 加载技能、派 worker，再用 `gate_record` 推进节点。
 
+review findings 后不进入独立的 revise 节点：
+
+```text
+plan-review findings → plan → plan-review
+code-review findings → implement → code-review
+verify FAIL → implement → code-review
+```
+
+`plan` / `implement` 修订记录可省略 `workerSessionIds`；谁执行修订、是否复用或新开子代理由主代理判断，procedure 不规定。review 仍必须由独立 worker 完成。
+
 ## 权限
 
 | 阶段/角色 | 文件写 | Note 写 | shell | 仓库写 |
@@ -85,7 +92,6 @@ Host 插件：用 phase/node 门禁组织讨论、规划、实施、评审、验
 | discuss root | ❌ | ❌ | 只读 | add/commit/push |
 | planning worker | ❌ | ✅ gate_note_write | 只读 | ❌ |
 | plan-review / code-review / code-review-standalone / proposal-review worker | ❌ | ❌ | 只读 | ❌ |
-| implement / implement-revise / fix-bug worker | ✅ | ❌ | 可写 | add/commit/push |
 | verify / verify-standalone worker | ❌ | ❌ | 只读 | ❌ |
 | note-lifecycle root | ✅ | ✅ lifecycle 工具 | 可写 | add/commit/push |
 | docs root | ✅ | ❌ | 可写 | add/commit/push |
@@ -95,7 +101,7 @@ Host 插件：用 phase/node 门禁组织讨论、规划、实施、评审、验
 
 - discuss 文件只读；要改文件先进入 plan/implement。提交已有改动用 git add/commit/push，不受文件只读影响。
 - planning worker 的 shell 只读；产品文件和仓库写拒绝。
-- implement/fix worker 保留 push。
+- implement worker 保留 push。
 - access 会显示在 gate_status、/gate-status、gate_record、gate_start_phase、命令 follow-up 和 worker prompt：
 
 ```text
@@ -109,13 +115,12 @@ Host 插件：用 phase/node 门禁组织讨论、规划、实施、评审、验
 | 命令 | 参数 | 作用 |
 |---|---|---|
 | `/gate-init` | 无 | 初始化 notes、AGENTS.md、`verify-notes`、CI、git 与基础 `.gitignore`，保持 `discuss` |
-| `/gate-enter-plan [具体工作事项或上下文语义]` | 可选 | 基于讨论共识、既有决策与用户输入进入 `orchestrating/plan` |
-| `/gate-enter-implement [具体工作事项或上下文语义]` | 可选 | 基于已确认计划或讨论后的实施说明进入 `orchestrating/implement` |
+| `/gate-enter-plan [具体工作事项或上下文语义]` | 可选 | 进入 plan：planning worker 写/改 Note → plan-review 三轴评审；findings 回 plan 修订，通过后回 discuss |
+| `/gate-enter-implement [具体工作事项或上下文语义]` | 可选 | 进入 implement：implement worker 实施 → code-review → verify；findings 回 implement；通过后 note-lifecycle 或 mechanical 回 discuss |
 | `/gate-prd [主题或上下文语义]` | 可选 | 用户级创建/更新 PRD；仅 discuss |
 | `/gate-docs [文档范围或上下文语义]` | 可选 | 进入文档治理，按项目文档规范处理 |
 | `/gate-implement-review [具体工作事项或上下文语义]` | 可选 | 对当前改动做独立只读 code review，只输出 findings |
 | `/gate-code-verify [具体工作事项或上下文语义]` | 可选 | 对当前改动做独立只读验收（gate-user-verify） |
-| `/gate-fix-bug [具体工作事项或上下文语义]` | 可选 | 基于描述或当前上下文派 fix worker 修复已授权缺陷 |
 | `/gate-propose-review [具体工作事项或上下文语义]` | 可选 | 对提案做独立只读三轴评审 |
 | `/gate-note-verify` | 无 | 只读检查 notes tree/format/lifecycle/archived |
 | `/gate-note-archive <note> [--superseded-by <new>]` | 必需 Note 路径 | 归档 implemented Note，写 Archived、移动、封印、报告入站链接 |
@@ -126,7 +131,7 @@ Host 插件：用 phase/node 门禁组织讨论、规划、实施、评审、验
 | `/gate-return-discuss` | 无 | 放弃当前节点，回到 discuss |
 | `/gate-status` | 无 | 只读显示当前 phase/node、procedure、access 与下一步命令 |
 
-直接 implement（`/gate-enter-implement [具体工作事项或上下文语义]` 或 `gate_start_phase({node:'implement',brief})`）会自动标记 `mechanical`，跳过 Note lifecycle；不需要 `mechanical:` 前缀。plan/plan-revise 手动选择 `mechanical` 时也不要求前缀，只需 `notePaths: []`。
+直接 implement（`/gate-enter-implement [具体工作事项或上下文语义]` 或 `gate_start_phase({node:'implement',brief})`）会自动标记 `mechanical`，跳过 Note lifecycle；不需要 `mechanical:` 前缀。plan 手动选择 `mechanical` 时也不要求前缀，只需 `notePaths: []`。
 
 离开 discuss 的授权可来自对话（包括要求用户再输入 slash command）或 `ask_user_question`；明确授权后，主代理可调用 `gate_start_phase({node:'plan'|'implement', brief})`。
 
@@ -136,11 +141,10 @@ Host 插件：用 phase/node 门禁组织讨论、规划、实施、评审、验
 |---|---|---|
 | `gate-planning` | planning worker | 生成/更新规划 Note，组织工作项、验收和设计 |
 | `gate-plan-review` | plan/proposal review worker | Standards/Spec/Architecture 三轴评审 |
-| `gate-implement` | implement/fix worker | 按计划实施并返回改动/验证结果 |
+| `gate-implement` | implement worker | 按计划实施并返回改动/验证结果 |
 | `gate-code-review` | code review worker | 对实现做 Standards/Spec 两轴 review |
 | `gate-verify` | verify worker | 最终验收、证据收集与汇报 |
 | `gate-user-verify` | standalone verify worker | 独立只读验收 |
-| `gate-fix-bug` | fix worker | 已授权缺陷修复流程 |
 | `gate-write-agent-notes` | planning worker / root note lifecycle | Note 检索、格式、finalize/verify |
 
 ## 典型用法
@@ -153,6 +157,36 @@ Host 插件：用 phase/node 门禁组织讨论、规划、实施、评审、验
 
 从 `discuss` 开始，不进入 planning/implement。
 
+初始化会生成：
+
+- `.agents/gate/verify-notes.mjs`
+- `.agents/gate/ci/*.ts`
+- `.agents/gate/artifact-policy.json`
+- `.agents/gate/init-manifest.json`
+
+`init-manifest.json` 记录生成物 hash、artifact-policy hash、AGENTS managed block、verify-notes script 和 notes 目录结构。它被 git 跟踪；同内容重跑 init 时字节稳定。
+
+只读核对：
+
+```text
+gate_init_verify
+```
+
+它会检查：
+
+- 5 个 CI 脚本 + launcher 的 SHA-256；
+- `artifact-policy.json` 的 schema；用户修改后有效则显示 `customized`；
+- AGENTS managed block；
+- `scripts.verify-notes`；
+- workflow 是否存在；
+- notes 四目录结构。
+
+不检查 Note 内容；Note 内容继续用：
+
+```text
+npm run verify-notes
+```
+
 ### Planning
 
 ```text
@@ -170,7 +204,7 @@ gate_record({
 })
 ```
 
-进入 `plan-review`，由 review worker 做三轴评审；findings 交回 `plan-revise`，直到通过后回 `discuss`，`planReady=true`。
+进入 `plan-review`，由 review worker 做三轴评审；findings 记录后回到 `plan`；修订完成后可再次 review，直到通过后回 `discuss`，`planReady=true`。
 
 ### Implementation
 
@@ -178,7 +212,7 @@ gate_record({
 /gate-enter-implement
 ```
 
-主代理派 `gate-implement` worker 实施；完成后 `gate_record({node:'implement', workerSessionIds})` 进入 `code-review`。review 通过后进入 `verify`；verify PASS 后：非 mechanical 进入 `note-lifecycle`，mechanical 直接回 discuss 并提示提交。
+主代理派 `gate-implement` worker 实施；完成后 `gate_record({node:'implement', workerSessionIds})` 进入 `code-review`。review findings 回到 `implement`，修复后再次 review；review 通过后进入 `verify`；verify PASS 后：非 mechanical 进入 `note-lifecycle`，mechanical 直接回 discuss 并提示提交。
 
 Note lifecycle：
 
@@ -204,14 +238,6 @@ gate 不自动 `git add`/`git commit`；完成 note-lifecycle 后由用户或主
 
 主代理派只读 verify worker，使用 `gate-user-verify`；PASS 后 `gate_record({node:'verify-standalone', verification, workerSessionIds})` 回 discuss。
 
-### 缺陷修复
-
-```text
-/gate-fix-bug 修复空指针异常
-```
-
-主代理派 fix worker 执行修复，再派独立 review worker 复核；完成后 `gate_record({node:'fix-bug', workerSessionIds})`。
-
 ### 提案评审
 
 ```text
@@ -292,9 +318,10 @@ gate_record({
 })
 ```
 
-- `node`：`plan`、`plan-review`、`proposal-review`、`plan-revise`、`implement`、`code-review`、`implement-revise`、`verify`、`verify-standalone`、`code-review-standalone`、`fix-bug`、`note-lifecycle`、`docs`。
-- `plan` 必须带 `task`。
-- worker 节点必须带当前 root 的、已 settled 的 child `workerSessionIds`。
+- `node`：`plan`、`plan-review`、`proposal-review`、`implement`、`code-review`、`verify`、`verify-standalone`、`code-review-standalone`、`note-lifecycle`、`docs`。
+- 首次 `plan` 必须带 `task`；review findings 后的修订记录不重置 task。
+- 首次 plan/implement、review、verify 等 worker 节点必须带当前 root 的、已 settled 的 child `workerSessionIds`。
+- plan/implement 修订记录可省略 workerSessionIds；root 自己修订时直接记录。
 - `plan-review`/`proposal-review` 需要 Standards/Spec/Architecture 三轴；`code-review`/`code-review-standalone` 需要 Standards/Spec 两轴。
 - `requiresDiscussion=true` 进入 blocked，等待用户决定。
 - review 达到 `reviewLimit` 仍有 findings 时 blocked，不能靠重新进入 implement 绕过。
@@ -315,6 +342,20 @@ gate_status()
 
 root-only；在 discuss 或 `orchestrating/plan` 派 research worker。worker 只能通过 artifact policy 写 research 文档，不获得通用 workspace 写。
 
+### gate_init_verify
+
+root-only 只读校验 `/gate-init` 产物：
+
+- `.agents/gate/init-manifest.json` 是否存在且有效；
+- 5 个 CI 脚本 + `verify-notes.mjs` 的 hash；
+- `artifact-policy.json` schema（custom 有效也通过）；
+- AGENTS managed block；
+- `scripts.verify-notes`；
+- workflow 存在性；
+- notes 四目录。
+
+不修改文件，不运行 `verify-notes`；Note 内容校验仍用 `npm run verify-notes`。
+
 ### Note 工具
 
 - `gate_note_write`：planning worker 写 proposed Note，或原地更新 implemented Note；通用 `write`/`edit`/`apply_patch` 和仓库写被拒绝，只读 shell 可用。
@@ -402,17 +443,16 @@ discuss 和 plan 默认不允许普通文件写。`handoff`、PRD、research 等
 - `complete`
 - `orchestrating/plan`
 - `orchestrating/plan-review`
-- `orchestrating/plan-revise`
 - `orchestrating/implement`
 - `orchestrating/code-review`
-- `orchestrating/implement-revise`
 - `orchestrating/verify`
 - `orchestrating/note-lifecycle`
-- `orchestrating/fix-bug`
 - `reviewing/code-review-standalone`
 - `reviewing/proposal-review`
 - `reviewing/verify-standalone`
 
+旧 artifact policy 中的 `orchestrating/plan-revise` / `orchestrating/implement-revise` 仍可解析，但当前状态不会再产生这些 key；可删除。
+
 `*` 表示任意**非 blocked** 状态。`blocked` 始终拒绝，即使规则写了 `*`。
 
 #### roles
@@ -527,6 +567,27 @@ discuss 和 plan 默认不允许普通文件写。`handoff`、PRD、research 等
 
 `reviewLimit` 是每个 review 节点的最大轮次；默认 5，范围 1–20。达到上限仍有 findings 时进入 blocked。
 
+它**不是项目文件**，而是 DSH profile 的插件 Config。当前 profile 的覆盖文件是：
+
+```text
+%USERPROFILE%\.dsh\profiles\<profile>\cordis.patch.yml
+```
+
+在 profile patch 中按 bundle 的 `id: gate` 覆盖：
+
+```yaml
+- id: gate
+  config:
+    reviewLimit: 8
+```
+
+- 没有 `gate` 条目时使用默认值 5；
+- 修改后重启 DSH 才生效；
+- 不要修改 `packages/gate/cordis.patch.yml` 来配置已有 profile；那是 bundle 默认层，profile patch 会覆盖它；
+- 如果使用自定义 Agent Preset，配置应放在该 preset 中对应的 `dsh-gate-agent` 条目。
+
+`.agents/gate/artifact-policy.json` 是项目级 artifact 白名单，与这里的插件 Config 是两套配置。
+
 
 ## 使用边界