dsh-gate-agent 0.1.3 → 0.1.4

package/README.md

@@ -73,7 +73,7 @@ Host 插件：用 phase/node 门禁组织讨论、规划、实施、评审、验
 | `reviewing/proposal-review` | 单独提案评审 | review worker；`gate-plan-review` |
 | `reviewing/verify-standalone` | 单独只读验收 | verify worker；`gate-user-verify` |
 | `docs` | 文档治理 | root；不调用 gate 技能 |
-| `blocked` | 冻结写入/派 worker，等待用户决定 | root；`/gate-resume` 或 `/gate-return-discuss` |
+| `blocked` | 冻结写入/派 worker，等待用户决定 | root；`/gate-resume` |
 | `complete` | 工作完成 | root；可重新进入 plan/implement |
 
 进入阶段不等于执行。主代理按当前 procedure 加载技能、派 worker，再用 `gate_record` 推进节点。
@@ -109,23 +109,23 @@ Host 插件：用 phase/node 门禁组织讨论、规划、实施、评审、验
 | 命令 | 参数 | 作用 |
 |---|---|---|
 | `/gate-init` | 无 | 初始化 notes、AGENTS.md、`verify-notes`、CI、git 与基础 `.gitignore`，保持 `discuss` |
-| `/gate-enter-plan [简单需求]` | 可选 | 进入 `orchestrating/plan` |
-| `/gate-enter-implement [简单说明]` | 可选 | 进入 `orchestrating/implement`；复用已通过的 task，或直接用简述 |
-| `/gate-docs` | 无 | 文档治理，不调用技能 |
-| `/gate-implement-review [范围]` | 可选 | 单独只读 code review，只输出 findings |
-| `/gate-code-verify [范围]` | 可选 | 单独只读验收；子代理使用 `gate-user-verify` |
-| `/gate-fix-bug [缺陷简述]` | 可选 | 派 fix worker 修复已授权缺陷，完成后回 discuss |
-| `/gate-propose-review [提案]` | 可选 | 单独提案评审，走 `gate-plan-review` 三轴 |
+| `/gate-enter-plan [具体工作事项或上下文语义]` | 可选 | 基于讨论共识、既有决策与用户输入进入 `orchestrating/plan` |
+| `/gate-enter-implement [具体工作事项或上下文语义]` | 可选 | 基于已确认计划或讨论后的实施说明进入 `orchestrating/implement` |
+| `/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、移动、封印、报告入站链接 |
 | `/gate-note-board [输出路径] [标题]` | 可选 | 生成决策看板 `board.html` |
 | `/gate-note-seal` | 无 | 只给 `archived/` 中已有 Note 补写 `manifest.json` 的 SHA-256 封印 |
 | `/gate-block [原因]` | 可选 | 手动暂停，保留当前节点 |
 | `/gate-resume` | 无 | 解冻 blocked，回到 block 前的节点；轮次耗尽回 discuss |
-| `/gate-return-discuss` | 无 | 回到 discuss |
-| `/gate-status` | 无 | 只读显示当前 phase/node 与 procedure |
+| `/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/plan-revise 手动选择 `mechanical` 时也不要求前缀，只需 `notePaths: []`。
 
 离开 discuss 的授权可来自对话（包括要求用户再输入 slash command）或 `ask_user_question`；明确授权后，主代理可调用 `gate_start_phase({node:'plan'|'implement', brief})`。
 
@@ -190,7 +190,7 @@ gate 不自动 `git add`/`git commit`；完成 note-lifecycle 后由用户或主
 ### 单独 code review
 
 ```text
-/gate-implement-review [范围]
+/gate-implement-review [具体工作事项或上下文语义]
 ```
 
 只读 review，不修改被评审对象；findings 直接输出。
@@ -198,7 +198,7 @@ gate 不自动 `git add`/`git commit`；完成 note-lifecycle 后由用户或主
 ### 单独验收
 
 ```text
-/gate-code-verify [范围]
+/gate-code-verify [具体工作事项或上下文语义]
 ```
 
 主代理派只读 verify worker，使用 `gate-user-verify`；PASS 后 `gate_record({node:'verify-standalone', verification, workerSessionIds})` 回 discuss。
@@ -252,17 +252,20 @@ review worker 使用 `gate-plan-review` 做 Standards/Spec/Architecture 三轴
 ```text
 /gate-block 等待产品决定
 /gate-resume
-/gate-return-discuss
 /gate-status
 ```
 
 - `/gate-block`：保留当前节点，冻结写入与 worker 派发，对话仍可继续。
-- `/gate-resume`：回到 block 前的节点；review 轮次耗尽时回 discuss。
-- `/gate-return-discuss`：放弃当前节点，回 discuss。
+- `/gate-resume`：唯一的 blocked 恢复入口；回到 block 前的节点，review 轮次耗尽时回 discuss。
+- `/gate-return-discuss`：放弃当前节点回 discuss；blocked 时不可直接用，先 `/gate-resume`。
 - `/gate-status`：只读查看当前 phase/node 和 procedure。
 
 ## 工具
 
+### gate_help
+
+只读，root-only。列出全部 `/gate-*` 命令、`gate_*` 工具用途和当前 phase/node，并说明命令由用户执行、工具由模型调用。不确定命令名或工具用途时使用。
+
 ### gate_start_phase
 
 只允许 root 调用，在用户已授权时从 `discuss`/`complete` 进入 `plan` 或 `implement`：
@@ -297,7 +300,7 @@ gate_record({
 
 ### gate_status
 
-只读，root 和 worker 可调用。root 返回当前 procedure 与状态；worker 只返回状态，不返回 root procedure。
+只读，root 和 worker 可调用。root 返回当前 procedure、状态和 nextCommands；worker 只返回状态，不返回 root procedure。
 
 ```text
 gate_status()

package/lib/index.js

@@ -189,43 +189,80 @@ var NODE_PROCEDURES = {
   "proposal-review": REVIEWING_PROPOSAL_PROCEDURE,
   "verify-standalone": REVIEWING_VERIFY_PROCEDURE
 };
+var METHODOLOGY_KEYS = [
+  "discuss",
+  "orchestrating/plan",
+  "orchestrating/plan-review",
+  "orchestrating/plan-revise",
+  "orchestrating/implement",
+  "orchestrating/code-review",
+  "orchestrating/implement-revise",
+  "orchestrating/verify",
+  "orchestrating/note-lifecycle",
+  "orchestrating/fix-bug",
+  "docs",
+  "reviewing/code-review-standalone",
+  "reviewing/proposal-review",
+  "reviewing/verify-standalone",
+  "blocked",
+  "complete",
+  "orchestrating",
+  "reviewing"
+];
+var METHODOLOGY_KEY_SET = new Set(METHODOLOGY_KEYS);
+function methodologyKeyFor(state) {
+  if (state.phase === "orchestrating" || state.phase === "reviewing") {
+    const key = state.node === null ? state.phase : `${state.phase}/${state.node}`;
+    return METHODOLOGY_KEY_SET.has(key) ? key : state.phase;
+  }
+  return state.phase;
+}
 var GATE_METHODOLOGY = `## Gate \u65B9\u6CD5\u8BBA
-\u672C\u6BB5\u53EA\u5B9A\u4E49\u5404\u9636\u6BB5\u7684\u5DE5\u4F5C\u65B9\u6CD5\u4E0E\u8D28\u91CF\u6807\u51C6\u3002\u5F53\u524D phase/node\u3001procedure \u548C\u8981\u52A0\u8F7D\u7684\u6280\u80FD\u6765\u81EA\u6700\u8FD1\u4E00\u6B21 gate_status\u3001gate_record \u6216\u547D\u4EE4\u7ED3\u679C\uFF1B\u53EA\u6267\u884C\u5F53\u524D phase \u7684 procedure\uFF0C\u5176\u4ED6\u9636\u6BB5\u7684\u65B9\u6CD5\u8BBA\u4EC5\u4F5C\u80CC\u666F\u53C2\u8003\uFF1Bcompaction \u540E\u5FC5\u987B\u91CD\u65B0\u83B7\u53D6 procedure\uFF0C\u5E76\u786E\u8BA4\u6280\u80FD\u5185\u5BB9\u662F\u5426\u4ECD\u5728\u4E0A\u4E0B\u6587\uFF1A\u9996\u6B21\u9700\u8981\u65F6\u52A0\u8F7D\uFF0C\u5DF2\u5728\u4E0A\u6587\u5219\u590D\u7528\uFF0C\u4E0D\u8981\u56E0 procedure \u66F4\u65B0\u91CD\u590D\u52A0\u8F7D\u3002
+\u672C\u6BB5\u53EA\u5B9A\u4E49\u5404\u9636\u6BB5\u7684\u5DE5\u4F5C\u65B9\u6CD5\u4E0E\u8D28\u91CF\u6807\u51C6\u3002\u5F53\u524D phase/node\u3001procedure \u548C\u8981\u52A0\u8F7D\u7684\u6280\u80FD\u6765\u81EA\u6700\u8FD1\u4E00\u6B21 gate_status\u3001gate_record \u6216\u547D\u4EE4\u7ED3\u679C\uFF1B\u53EA\u6267\u884C\u5F53\u524D phase \u7684 procedure\uFF0C\u5176\u4ED6\u9636\u6BB5\u7684\u65B9\u6CD5\u8BBA\u4EC5\u4F5C\u80CC\u666F\u53C2\u8003\uFF1Bcompaction \u540E\u5FC5\u987B\u91CD\u65B0\u83B7\u53D6 procedure\uFF0C\u5E76\u786E\u8BA4\u6280\u80FD\u5185\u5BB9\u662F\u5426\u4ECD\u5728\u4E0A\u4E0B\u6587\uFF1A\u9996\u6B21\u9700\u8981\u65F6\u52A0\u8F7D\uFF0C\u5DF2\u5728\u4E0A\u6587\u5219\u590D\u7528\uFF0C\u4E0D\u8981\u56E0 procedure \u66F4\u65B0\u91CD\u590D\u52A0\u8F7D\u3002\u4E0D\u786E\u5B9A\u6709\u54EA\u4E9B /gate-* \u547D\u4EE4\u6216\u5DE5\u5177\u7528\u9014\u65F6\uFF0C\u8C03\u7528\u53EA\u8BFB gate_help\u3002
 
 ${DISCUSS_ORCHESTRATION}
 
-## plan
-\u628A\u7528\u6237\u7B80\u8FF0\u6536\u655B\u6210\u53EF\u5B9E\u65BD\u8BA1\u5212\u4E0E proposed Note\uFF1B\u8BA1\u5212\u5FC5\u987B\u5199\u6E05\u8303\u56F4\u3001\u9A8C\u6536\u3001\u5907\u9009\u4E0E\u98CE\u9669\u3002Plan Review \u72EC\u7ACB\u5224\u65AD\uFF1Bfindings \u5148\u8BB0\u5F55\u518D revise\uFF1Breview \u901A\u8FC7\u540E\u56DE discuss\u3002\u4E0D\u8981\u5728\u89C4\u5212\u91CC\u5F00\u59CB\u5B9E\u73B0\u3002
+## orchestrating/plan \xB7 orchestrating/plan-review \xB7 orchestrating/plan-revise
+\u628A\u8BA8\u8BBA\u5171\u8BC6\u3001\u65E2\u6709\u51B3\u7B56\u4E0E\u7528\u6237\u9700\u6C42\u6536\u655B\u6210\u53EF\u5B9E\u65BD\u8BA1\u5212\u4E0E proposed Note\uFF1B\u8BA1\u5212\u5FC5\u987B\u5199\u6E05\u8303\u56F4\u3001\u9A8C\u6536\u3001\u5907\u9009\u4E0E\u98CE\u9669\u3002Plan Review \u72EC\u7ACB\u5224\u65AD\uFF1Bfindings \u5148\u8BB0\u5F55\u518D revise\uFF1Breview \u901A\u8FC7\u540E\u56DE discuss\u3002\u4E0D\u8981\u5728\u89C4\u5212\u91CC\u5F00\u59CB\u5B9E\u73B0\u3002
 
-## implement
-\u6309\u5DF2\u786E\u8BA4\u7684\u8BA1\u5212\u5B9E\u65BD\u5E76\u5B8C\u6210\u6D4B\u8BD5\uFF1B\u5B9E\u73B0\u540E\u505A\u72EC\u7ACB review\uFF0C\u518D\u7528\u53EF\u6267\u884C\u8BC1\u636E verify\uFF1B\u6700\u540E\u5B8C\u6210 Note lifecycle\u3002\u4E0D\u6269\u5927\u8303\u56F4\uFF0C\u4E0D\u5728\u5B9E\u73B0\u4E2D\u91CD\u65B0\u89C4\u5212\u3002
+## orchestrating/implement \xB7 orchestrating/implement-revise
+\u6309\u5DF2\u786E\u8BA4\u7684\u8BA1\u5212\u6216\u8BA8\u8BBA\u540E\u7684\u5B9E\u65BD\u8BF4\u660E\u5B9E\u65BD\u5E76\u5B8C\u6210\u6D4B\u8BD5\uFF1B\u5B9E\u73B0\u540E\u505A\u72EC\u7ACB review\uFF0C\u518D\u7528\u53EF\u6267\u884C\u8BC1\u636E verify\uFF1B\u6700\u540E\u5B8C\u6210 Note lifecycle\u3002\u4E0D\u6269\u5927\u8303\u56F4\uFF0C\u4E0D\u5728\u5B9E\u73B0\u4E2D\u91CD\u65B0\u89C4\u5212\u3002
 
-## code-review
+## orchestrating/code-review
 \u72EC\u7ACB\u5224\u65AD\u6539\u52A8\u662F\u5426\u6EE1\u8DB3\u5408\u540C\u4E0E\u6807\u51C6\uFF1B\u53EA\u62A5 findings\uFF0C\u4E0D\u4FEE\u4EE3\u7801\u3001\u4E0D\u66FF\u4EE3 verify\uFF1Bfindings \u8BB0\u5F55\u540E\u518D\u8FDB\u5165 revise\u3002
 
-## verify
+## orchestrating/verify
 \u7528\u53EF\u6267\u884C\u8BC1\u636E\u5224\u5B9A PASS/FAIL\uFF1B\u4E0D\u4FEE\u6539\u4EA7\u54C1/\u6D4B\u8BD5\u8BA9\u7ED3\u679C\u53D8\u7EFF\uFF1BFAIL \u56DE implement-revise\u3002
 
-## note-lifecycle
+## orchestrating/note-lifecycle
 \u5B8C\u6210 Note \u7684 finalize \u4E0E\u6821\u9A8C\uFF1B\u4E0D\u5199\u4E1A\u52A1\u4EE3\u7801\uFF1B\u68C0\u67E5\u662F\u5426\u4EA7\u751F\u5F52\u6863\u5019\u9009\uFF1B\u5B8C\u6210\u540E\u56DE discuss\u3002
 
-## fix-bug
+## orchestrating/fix-bug
 \u5BF9\u5DF2\u6388\u6743\u7684\u5B9E\u73B0\u7F3A\u9677\uFF1A\u590D\u73B0\u3001\u56DE\u5F52\u8986\u76D6\u3001\u6839\u56E0\u3001\u6700\u5C0F\u4FEE\u590D\u3001\u72EC\u7ACB review\uFF1B\u4E0D\u505A\u65B0\u529F\u80FD\u3001\u4E0D\u6269\u5927\u8303\u56F4\uFF1B\u5B8C\u6210\u540E\u56DE discuss\u3002
 
 ## docs
 \u6587\u6863\u6CBB\u7406\uFF1B\u4E0D\u6539\u53D8\u529F\u80FD\u884C\u4E3A\uFF1B\u8303\u56F4\u7531\u6A21\u578B\u6309\u9879\u76EE\u5B9E\u9645\u6587\u6863\u9700\u8981\u5224\u65AD\uFF1B\u5B8C\u6210\u540E\u56DE discuss\u3002
 
-## reviewing-code
+## reviewing/code-review-standalone
 \u53EA\u8BFB code review\uFF1A\u72EC\u7ACB\u5224\u65AD Standards \u4E0E Spec \u4E24\u8F74\uFF0C\u53EA\u8F93\u51FA findings\uFF0C\u4E0D\u4FEE\u4EE3\u7801\u3001\u4E0D\u66FF\u4EE3 verify\u3002
 
-## reviewing-proposal
+## reviewing/proposal-review
 \u53EA\u8BFB\u63D0\u6848\u8BC4\u5BA1\uFF1A\u8986\u76D6 Standards\u3001Spec\u3001Architecture \u4E09\u8F74\uFF0C\u53EA\u8F93\u51FA\u5224\u65AD\uFF0C\u4E0D\u4FEE\u6539\u89C4\u5212\u3001\u4E0D\u81EA\u52A8 revise\u3002
 
-## reviewing-verify
+## reviewing/verify-standalone
 \u53EA\u8BFB\u72EC\u7ACB\u9A8C\u6536\uFF1A\u4E0D\u6539\u4EE3\u7801\u3001\u4E0D\u66FF\u4EE3 implement\uFF0C\u53EA\u8F93\u51FA PASS/FAIL \u4E0E\u8BC1\u636E\u5224\u65AD\u3002
 
-## blocked / complete
-blocked \u8868\u793A\u51BB\u7ED3\uFF1A\u7B49\u5F85 /gate-resume \u6216 /gate-return-discuss\u3002complete \u8868\u793A\u5F53\u524D\u4EFB\u52A1\u5B8C\u6210\uFF0C\u65B0\u4EFB\u52A1\u9700\u8981\u91CD\u65B0\u6388\u6743\u3002`;
+## blocked
+blocked \u8868\u793A\u51BB\u7ED3\uFF1A\u7B49\u5F85 /gate-resume\u3002
+
+## complete
+complete \u8868\u793A\u5F53\u524D\u4EFB\u52A1\u5B8C\u6210\uFF0C\u65B0\u4EFB\u52A1\u9700\u8981\u91CD\u65B0\u6388\u6743\u3002
+
+## orchestrating
+\u5F53\u524D\u5904\u4E8E orchestrating \u4F46\u6CA1\u6709\u5339\u914D node\uFF1B\u8C03\u7528 gate_status \u91CD\u65B0\u8BFB\u53D6\uFF1B\u82E5\u4ECD\u4E0D\u4E00\u81F4\uFF0C\u56DE discuss \u4FEE\u590D Gate \u72B6\u6001\u3002
+
+## reviewing
+\u5F53\u524D\u5904\u4E8E reviewing \u4F46\u6CA1\u6709\u5339\u914D node\uFF1B\u8C03\u7528 gate_status \u91CD\u65B0\u8BFB\u53D6\uFF1B\u82E5\u4ECD\u4E0D\u4E00\u81F4\uFF0C\u56DE discuss \u4FEE\u590D Gate \u72B6\u6001\u3002`;
 function protocolVariant(state) {
   if (state.phase === "orchestrating") return NODE_INFO[state.node ?? ""]?.variant ?? state.phase;
   if (state.phase === "reviewing") return NODE_INFO[state.node ?? ""]?.variant ?? "reviewing-code";
@@ -238,7 +275,7 @@ function procedureFor(state, { reviewLimit = DEFAULT_REVIEW_LIMIT } = {}) {
   if (variant === "discuss") {
     text = "discuss \u4E0D\u6D3E worker\uFF1B\u6587\u4EF6\u9ED8\u8BA4\u53EA\u8BFB\uFF0C\u63D0\u4EA4\u5DF2\u6709\u6539\u52A8\u4E0D\u53D7\u5F71\u54CD\uFF1B\u7528\u6237\u6388\u6743\u540E\u8C03\u7528 gate_start_phase \u8FDB\u5165 plan/implement\u3002";
   } else if (variant === "blocked") {
-    text = `Gate \u5DF2\u51BB\u7ED3\uFF1A${state.blockReason ?? "unknown"}\uFF1B\u89E3\u51BB\u540E\u56DE ${state.blockedFrom?.phase ?? "discuss"} / ${state.blockedFrom?.node ?? "\u65E0"}\uFF1B\u7528 /gate-resume \u6216 /gate-return-discuss\u3002`;
+    text = `Gate \u5DF2\u51BB\u7ED3\uFF1A${state.blockReason ?? "unknown"}\uFF1B\u89E3\u51BB\u540E\u56DE ${state.blockedFrom?.phase ?? "discuss"} / ${state.blockedFrom?.node ?? "\u65E0"}\uFF1B\u7528 /gate-resume\u3002`;
   } else if (variant === "complete") {
     text = "Gate \u5DF2\u5B8C\u6210\uFF1B\u65B0\u4EFB\u52A1\u9700\u8981\u91CD\u65B0\u6388\u6743\u3002";
   } else if (variant === "docs") {
@@ -256,7 +293,7 @@ function procedureFor(state, { reviewLimit = DEFAULT_REVIEW_LIMIT } = {}) {
     text = [text, `## \u5F53\u524D\u8F6E\u6B21
 ${roundsText(state, reviewLimit)}`].filter(Boolean).join("\n\n");
   }
-  return { phase: state.phase, node: state.node, method, text, hasRounds: variant === "plan" || variant === "implement" };
+  return { phase: state.phase, node: state.node, methodologyKey: methodologyKeyFor(state), method, text, hasRounds: variant === "plan" || variant === "implement" };
 }
 function procedureFailure(state, reviewLimit, fields) {
   const procedure = procedureFor(state, { reviewLimit });
@@ -301,6 +338,7 @@ function statusText(state, reviewLimit = DEFAULT_REVIEW_LIMIT, { includeRounds =
 }
 function procedureBlock(procedure) {
   return `\u5F53\u524D phase/node\uFF1A${procedure.phase} / ${procedure.node ?? "\u65E0"}
+\u65B9\u6CD5\u8BBA\uFF1A${procedure.methodologyKey}
 \u65B9\u6CD5\uFF1A${procedure.method}
 
 ${procedure.text}`;
@@ -910,9 +948,9 @@ function classifyPath(root, value, cwd = root) {
 var GIT_VALUE_OPTIONS = /* @__PURE__ */ new Set(["-C", "-c", "--git-dir", "--work-tree", "--namespace", "--config-env"]);
 var GIT_FILE_WRITE = /* @__PURE__ */ new Set(["checkout", "switch", "reset", "clean", "restore", "stash", "merge", "rebase", "cherry-pick", "apply", "pull"]);
 var GIT_NON_WRITE = /* @__PURE__ */ new Set(["status", "add", "commit", "push"]);
-function gitSubcommands(command) {
+function gitSubcommands(command2) {
   const subcommands = /* @__PURE__ */ new Set();
-  for (const segment of String(command).split(/&&|\|\||;|\r?\n|\|/u)) {
+  for (const segment of String(command2).split(/&&|\|\||;|\r?\n|\|/u)) {
     const tokens = [...segment.matchAll(/"([^"]*)"|'([^']*)'|(\S+)/gu)].map((match) => match[1] ?? match[2] ?? match[3] ?? "");
     const gitIndex = tokens.findIndex((token) => /^git(?:\.exe)?$/iu.test(token));
     if (gitIndex < 0) continue;
@@ -975,8 +1013,8 @@ function addTarget(targets, token, map) {
 }
 function segmentAccess(text, root, cwd, map) {
   const git = gitSubcommands(text);
-  if ([...git].some((command) => GIT_FILE_WRITE.has(command))) return { write: true, outsideTargets: [] };
-  if ([...git].some((command) => GIT_NON_WRITE.has(command))) return { write: false, outsideTargets: [] };
+  if ([...git].some((command2) => GIT_FILE_WRITE.has(command2))) return { write: true, outsideTargets: [] };
+  if ([...git].some((command2) => GIT_NON_WRITE.has(command2))) return { write: false, outsideTargets: [] };
   const raw = [];
   const verb = WRITE_VERB.exec(text);
   if (verb !== null) {
@@ -995,9 +1033,9 @@ function segmentAccess(text, root, cwd, map) {
 function segments(text) {
   return String(text).split(/&&|\|\||;|\r?\n/u).map((part) => part.trim()).filter(Boolean);
 }
-function shellAccess(command, root, cwd = root) {
-  const map = assignments(command);
-  const parts = segments(command).map((part) => segmentAccess(part, root, cwd, map)).filter((item) => item.write);
+function shellAccess(command2, root, cwd = root) {
+  const map = assignments(command2);
+  const parts = segments(command2).map((part) => segmentAccess(part, root, cwd, map)).filter((item) => item.write);
   return {
     write: parts.length > 0,
     outsideTargets: parts.flatMap((item) => item.outsideTargets ?? [])
@@ -1032,9 +1070,9 @@ function accessFor(state, worker) {
 function accessText(access) {
   return `\u6743\u9650\uFF1Aread=${access.read ? "yes" : "no"} write=${access.write} noteWrite=${access.noteWrite ? "yes" : "no"} shell=${access.shell} repoWrite=${access.repoWrite}`;
 }
-function repoCommands(command) {
+function repoCommands(command2) {
   const commands = /* @__PURE__ */ new Set();
-  for (const subcommand of gitSubcommands(command)) {
+  for (const subcommand of gitSubcommands(command2)) {
     if (subcommand === "add" || subcommand === "commit" || subcommand === "push") commands.add(subcommand);
   }
   return commands;
@@ -1085,7 +1123,7 @@ function enterPhase(ctx, agent, node, reviewLimit, store, current) {
   store.write(gate.root, agent, state);
   return { gate, state, reviewLimit };
 }
-function wakeGateAgent(invocation, text, command) {
+function wakeGateAgent(invocation, text, command2) {
   const followup = invocation?.agent?.followup;
   if (typeof followup !== "function") return;
   try {
@@ -1093,19 +1131,19 @@ function wakeGateAgent(invocation, text, command) {
       id: randomUUID2(),
       role: "user",
       content: [{ type: "text", text }],
-      source: { kind: "gate-command", command }
+      source: { kind: "gate-command", command: command2 }
     });
   } catch {
   }
 }
 function makeWake(reviewLimit) {
-  return (invocation, state, text, command) => {
+  return (invocation, state, text, command2) => {
     const procedure = procedureFor(state, { reviewLimit });
     wakeGateAgent(invocation, `${procedureBlock(procedure)}
 
 ${accessText(accessFor(state, false))}
 
-${text}`, command);
+${text}`, command2);
   };
 }
 
@@ -1249,7 +1287,7 @@ function targetList(name, args) {
   if (name !== "apply_patch") return [args?.file_path];
   return [...String(args?.input ?? "").matchAll(/^\*\*\* (?:Add File|Update File|Delete File|Move to):\s*(.+)$/gmu)].map((match) => String(match[1] ?? "").trim());
 }
-var GATE_FROZEN_REASON = "Gate \u5DF2\u51BB\u7ED3\uFF1A\u5148 /gate-resume \u6216 /gate-return-discuss";
+var GATE_FROZEN_REASON = "Gate \u5DF2\u51BB\u7ED3\uFF1A\u5148 /gate-resume";
 function fileWriteDenied(state, effective) {
   if (state.phase === "blocked") return GATE_FROZEN_REASON;
   if (!effective.worker && state.phase === "discuss") return DISCUSS_READ_ONLY;
@@ -1303,10 +1341,10 @@ function gateDenyReason(ctx, exec, store) {
     const base = sessionCwd(ctx, exec.agent, gate.workspace);
     const requested = exec.arguments?.workdir;
     const cwd = typeof requested === "string" && requested !== "" ? path7.resolve(base, requested) : base;
-    const command = String(exec.arguments?.command ?? "");
-    const repos = repoCommands(command);
+    const command2 = String(exec.arguments?.command ?? "");
+    const repos = repoCommands(command2);
     if (repos.size > 0 && access.repoWrite === "none") return repoDenied(state, effective, [...repos].join("/"));
-    const shell = shellAccess(command, gate.workspace, cwd);
+    const shell = shellAccess(command2, gate.workspace, cwd);
     if (!shell.write) return void 0;
     if (shell.outsideTargets.length > 0) return "\u5DE5\u4F5C\u533A\u5916\u5199\u5165\u88AB\u62D2\u7EDD";
     if (access.write === "none") return shellWriteDenied(state, effective);
@@ -1380,15 +1418,15 @@ function provisionProjectScripts(root) {
     if (pkg === null || typeof pkg !== "object" || Array.isArray(pkg)) throw new Error("package.json \u5FC5\u987B\u662F\u5BF9\u8C61");
   }
   pkg.scripts = pkg.scripts !== null && typeof pkg.scripts === "object" && !Array.isArray(pkg.scripts) ? pkg.scripts : {};
-  const command = "node .agents/gate/verify-notes.mjs";
+  const command2 = "node .agents/gate/verify-notes.mjs";
   const existing = pkg.scripts["verify-notes"];
-  if (existing === void 0) pkg.scripts["verify-notes"] = command;
+  if (existing === void 0) pkg.scripts["verify-notes"] = command2;
   writeFileSync3(packagePath, `${JSON.stringify(pkg, null, 2)}
 `);
   return {
     launcher: path8.relative(root, launcher).replaceAll("\\", "/"),
     package: path8.relative(root, packagePath).replaceAll("\\", "/"),
-    command: existing === void 0 ? command : String(existing),
+    command: existing === void 0 ? command2 : String(existing),
     changed: existing === void 0
   };
 }
@@ -1450,16 +1488,70 @@ function provisionCi(root) {
 
 // src/commands.ts
 import { execFileSync as execFileSync3 } from "node:child_process";
+
+// src/command-catalog.ts
+var GATE_COMMANDS = [
+  { name: "gate-init", description: "\u521D\u59CB\u5316 notes\u3001AGENTS.md\u3001verify-notes\u3001CI\u3001git \u4E0E\u57FA\u7840 .gitignore", hint: null, when: "any" },
+  { name: "gate-enter-plan", description: "\u57FA\u4E8E\u8BA8\u8BBA\u5171\u8BC6\u3001\u65E2\u6709\u51B3\u7B56\u4E0E\u7528\u6237\u8F93\u5165\u8FDB\u5165 planning", hint: "<\u5177\u4F53\u5DE5\u4F5C\u4E8B\u9879\u6216\u4E0A\u4E0B\u6587\u8BED\u4E49>", when: "discuss/complete" },
+  { name: "gate-enter-implement", description: "\u57FA\u4E8E\u5DF2\u786E\u8BA4\u8BA1\u5212\u6216\u8BA8\u8BBA\u540E\u7684\u5B9E\u65BD\u8BF4\u660E\u8FDB\u5165 implementation", hint: "<\u5177\u4F53\u5DE5\u4F5C\u4E8B\u9879\u6216\u4E0A\u4E0B\u6587\u8BED\u4E49>", when: "discuss/complete" },
+  { name: "gate-fix-bug", description: "\u4E3A\u5DF2\u6388\u6743\u7F3A\u9677\u6D3E\u53D1 fix worker\uFF0C\u57FA\u4E8E\u63CF\u8FF0\u6216\u5F53\u524D\u4E0A\u4E0B\u6587\u4FEE\u590D", hint: "<\u5177\u4F53\u5DE5\u4F5C\u4E8B\u9879\u6216\u4E0A\u4E0B\u6587\u8BED\u4E49>", when: "discuss/complete" },
+  { name: "gate-docs", description: "\u8FDB\u5165\u6587\u6863\u6CBB\u7406\uFF0C\u6309\u9879\u76EE\u6587\u6863\u89C4\u8303\u5904\u7406", hint: null, when: "discuss/complete" },
+  { name: "gate-implement-review", description: "\u5BF9\u5F53\u524D\u6539\u52A8\u505A\u72EC\u7ACB\u53EA\u8BFB code review", hint: "<\u5177\u4F53\u5DE5\u4F5C\u4E8B\u9879\u6216\u4E0A\u4E0B\u6587\u8BED\u4E49>", when: "discuss/complete" },
+  { name: "gate-code-verify", description: "\u5BF9\u5F53\u524D\u6539\u52A8\u505A\u72EC\u7ACB\u53EA\u8BFB\u9A8C\u6536\uFF08gate-user-verify\uFF09", hint: "<\u5177\u4F53\u5DE5\u4F5C\u4E8B\u9879\u6216\u4E0A\u4E0B\u6587\u8BED\u4E49>", when: "discuss/complete" },
+  { name: "gate-propose-review", description: "\u5BF9\u63D0\u6848\u505A\u72EC\u7ACB\u53EA\u8BFB\u4E09\u8F74\u8BC4\u5BA1", hint: "<\u5177\u4F53\u5DE5\u4F5C\u4E8B\u9879\u6216\u4E0A\u4E0B\u6587\u8BED\u4E49>", when: "discuss/complete" },
+  { name: "gate-block", description: "\u624B\u52A8\u6682\u505C\uFF1A\u4FDD\u7559\u5F53\u524D\u8282\u70B9\u5E76\u505C\u6B62\u5199\u5165/\u6D3E worker\uFF1B\u5BF9\u8BDD\u4ECD\u53EF\u7EE7\u7EED", hint: "[\u539F\u56E0]", when: "any" },
+  { name: "gate-resume", description: "\u89E3\u51BB blocked\uFF1A\u56DE\u5230 block \u524D\u7684\u8282\u70B9\uFF1B\u8F6E\u6B21\u8017\u5C3D\u56DE discuss", hint: null, when: "blocked" },
+  { name: "gate-return-discuss", description: "\u653E\u5F03\u5F53\u524D\u8282\u70B9\uFF0C\u56DE\u5230 discuss", hint: null, when: "non-blocked" },
+  { name: "gate-status", description: "\u67E5\u770B\u5F53\u524D phase/node\u3001procedure\u3001access \u4E0E\u4E0B\u4E00\u6B65\u547D\u4EE4", hint: null, when: "any" },
+  { name: "gate-note-verify", description: "\u53EA\u8BFB\u68C0\u67E5 notes tree/format/lifecycle/archived", hint: null, when: "any" },
+  { name: "gate-note-archive", description: "\u5C06 implemented Note \u5F52\u6863\u5230 archived/\uFF1A\u52A0 Archived\u3001\u79FB\u52A8\u3001\u5C01\u5370\u5E76\u62A5\u544A\u5165\u7AD9\u94FE\u63A5", hint: "<implemented-note> [--superseded-by <new-note>]", when: "any" },
+  { name: "gate-note-board", description: "\u751F\u6210\u51B3\u7B56\u770B\u677F board.html\uFF08\u8F7B\u91CF\u6A21\u5F0F\uFF0C\u8FDE\u63A5\u672C\u5730 notes \u76EE\u5F55\uFF09", hint: "[\u8F93\u51FA\u8DEF\u5F84] [\u6807\u9898]", when: "any" },
+  { name: "gate-note-seal", description: "\u53EA\u7ED9 archived/ \u4E2D\u5DF2\u6709 Note \u8865\u5199 manifest.json \u7684 SHA-256 \u5C01\u5370\uFF1B\u4E0D\u5F52\u6863\u3001\u4E0D\u6539 Note \u5185\u5BB9", hint: null, when: "any" }
+];
+function commandSpec(name) {
+  return GATE_COMMANDS.find((command2) => command2.name === name);
+}
+function commandLabel(spec) {
+  return `/${spec.name}`;
+}
+
+// src/command-next.ts
+function command(name, reason) {
+  const spec = commandSpec(name);
+  return { command: spec === void 0 ? `/${name}` : commandLabel(spec), reason };
+}
+function nextCommandsFor(state) {
+  if (state.phase === "blocked") {
+    return [command("gate-resume", "\u89E3\u51BB\u540E\u56DE\u5230\u6682\u505C\u524D\u8282\u70B9\uFF1B\u8F6E\u6B21\u8017\u5C3D\u65F6\u56DE discuss\u3002")];
+  }
+  if (state.phase === "discuss" || state.phase === "complete") {
+    return [
+      command("gate-enter-plan", "\u9700\u8981\u7528\u6237\u6388\u6743\u540E\u8FDB\u5165 planning\u3002"),
+      command("gate-enter-implement", "\u9700\u8981\u7528\u6237\u6388\u6743\u540E\u8FDB\u5165\u5B9E\u65BD\uFF1B\u590D\u7528\u5DF2\u901A\u8FC7\u7684 plan task\uFF0C\u6216\u76F4\u63A5\u4ECE\u7528\u6237\u7B80\u8FF0\u5B9E\u65BD\u3002")
+    ];
+  }
+  return [];
+}
+function nextCommandsText(commands) {
+  if (commands.length === 0) return "";
+  return `\u4E0B\u4E00\u6B65\u547D\u4EE4\uFF1A${commands.map((item) => `${item.command}\uFF08${item.reason}\uFF09`).join("\uFF1B")}`;
+}
+
+// src/commands.ts
 function registerCommands(ctx, deps) {
   const { store, reviewLimit, wake } = deps;
   ctx.inject(["commands"], (scope) => {
-    const register = (name, description, handler, input = { hint: "<\u5DE5\u4F5C\u9879>" }) => scope.commands.register({
-      name,
-      description,
-      ...input === null ? {} : { input },
-      handler
-    });
-    register("gate-init", "\u521D\u59CB\u5316 notes\u3001AGENTS.md\u3001verify-notes \u4E0E GitHub Actions CI", async (invocation) => {
+    const command2 = (name, handler) => {
+      const spec = commandSpec(name);
+      if (spec === void 0) throw new Error(`unknown gate command: ${name}`);
+      scope.commands.register({
+        name: spec.name,
+        description: spec.description,
+        ...spec.hint === null ? {} : { input: { hint: spec.hint } },
+        handler
+      });
+    };
+    command2("gate-init", async (invocation) => {
       const workspace = workspaceBoundary(ctx, invocation.agent);
       if (workspace === void 0) return { kind: "error", text: "\u65E0\u6CD5\u786E\u5B9A\u5F53\u524D\u4F1A\u8BDD\u5DE5\u4F5C\u533A" };
       const root = path9.resolve(workspace);
@@ -1483,15 +1575,15 @@ verify-notes\uFF1A${projectScripts.command}
 CI\uFF1A${projectCi.workflow}
 git\uFF1A${projectGit.git}${projectGit.gitError === null ? "" : `\uFF08${projectGit.gitError}\uFF09`}
 ignore\uFF1A${projectGit.ignore}` };
-    }, null);
-    register("gate-enter-plan", "\u6309\u7528\u6237\u7B80\u8FF0\u8FDB\u5165 planning", async (invocation) => {
+    });
+    command2("gate-enter-plan", async (invocation) => {
       const result = enterPhase(ctx, invocation.agent, "plan", reviewLimit, store, void 0);
       if (result.kind === "error") return result;
       const brief = String(invocation.rawInput ?? "").trim();
       wake(invocation, result.state, `Gate \u5DF2\u8FDB\u5165 plan\u3002\u7528\u6237\u89C4\u5212\u8F93\u5165\uFF1A${brief === "" ? "\uFF08\u672A\u63D0\u4F9B\u989D\u5916\u8F93\u5165\uFF09" : brief}\u3002`, "gate-enter-plan");
       return { kind: "success", text: "\u8FDB\u5165 planning\u3002" };
-    }, { hint: "[\u7B80\u5355\u9700\u6C42]" });
-    register("gate-enter-implement", "\u4ECE\u5DF2\u786E\u8BA4\u89C4\u5212\u6216\u7528\u6237\u7B80\u8FF0\u8FDB\u5165 implementation", async (invocation) => {
+    });
+    command2("gate-enter-implement", async (invocation) => {
       const brief = String(invocation.rawInput ?? "").trim();
       const gate = resolveGate(ctx, invocation.agent);
       const state = store.read(gate.root, invocation.agent);
@@ -1513,8 +1605,8 @@ ignore\uFF1A${projectGit.ignore}` };
       const constraints = direct ? "\uFF08\u672C\u53E5\u5373\u5DE5\u4F5C\u9879\u7B80\u8FF0\uFF09" : brief === "" ? "\uFF08\u65E0\u989D\u5916\u7EA6\u675F\uFF09" : brief;
       wake(invocation, result.state, `Gate \u5DF2\u8FDB\u5165 implement\uFF1A${result.state.task ?? ""}${direct ? "\uFF08\u76F4\u63A5\u5B9E\u65BD\uFF0C\u672A\u8D70 planning\uFF09" : ""}\u3002\u7528\u6237\u8BF4\u660E\uFF1A${constraints}\u3002`, "gate-enter-implement");
       return { kind: "success", text: `\u8FDB\u5165 implement\uFF1A${result.state.task}${direct ? "\uFF08\u76F4\u63A5\u5B9E\u65BD\uFF09" : ""}` };
-    }, { hint: "[\u7B80\u5355\u8BF4\u660E]" });
-    register("gate-fix-bug", "\u4E3A\u5DF2\u6388\u6743\u7684\u5B9E\u73B0\u7F3A\u9677\u6D3E\u53D1 fix worker", async (invocation) => {
+    });
+    command2("gate-fix-bug", async (invocation) => {
       const brief = String(invocation.rawInput ?? "").trim();
       const gate = resolveGate(ctx, invocation.agent);
       const state = store.read(gate.root, invocation.agent);
@@ -1530,8 +1622,8 @@ ignore\uFF1A${projectGit.ignore}` };
       store.write(gate.root, invocation.agent, state);
       wake(invocation, state, `Gate \u5DF2\u8FDB\u5165 fix-bug\uFF1A${scope2}\u3002`, "gate-fix-bug");
       return { kind: "success", text: `\u8FDB\u5165 fix-bug\uFF1A${scope2}` };
-    }, { hint: "[\u7F3A\u9677\u7B80\u8FF0]" });
-    register("gate-docs", "\u5F00\u59CB\u6587\u6863\u6CBB\u7406", async (invocation) => {
+    });
+    command2("gate-docs", async (invocation) => {
       const gate = resolveGate(ctx, invocation.agent);
       const state = store.read(gate.root, invocation.agent);
       if (state.phase !== "discuss" && state.phase !== "complete") return { kind: "error", text: `\u5F53\u524D phase \u662F ${state.phase}` };
@@ -1545,8 +1637,8 @@ ignore\uFF1A${projectGit.ignore}` };
       store.write(gate.root, invocation.agent, state);
       wake(invocation, state, "Gate \u5DF2\u8FDB\u5165 docs\u3002", "gate-docs");
       return { kind: "success", text: "\u8FDB\u5165 docs\uFF1A\u6587\u6863\u6CBB\u7406" };
-    }, null);
-    register("gate-implement-review", "\u5F00\u59CB\u72EC\u7ACB\u53EA\u8BFB code review", async (invocation) => {
+    });
+    command2("gate-implement-review", async (invocation) => {
       const brief = String(invocation.rawInput ?? "").trim();
       const gate = resolveGate(ctx, invocation.agent);
       const state = store.read(gate.root, invocation.agent);
@@ -1563,7 +1655,7 @@ ignore\uFF1A${projectGit.ignore}` };
       wake(invocation, state, `Gate \u5DF2\u8FDB\u5165\u53EA\u8BFB code review\uFF1A${scope2}\u3002`, "gate-implement-review");
       return { kind: "success", text: `\u8FDB\u5165\u53EA\u8BFB code review\uFF1A${scope2}` };
     });
-    register("gate-code-verify", "\u5F00\u59CB\u72EC\u7ACB\u53EA\u8BFB\u9A8C\u6536", async (invocation) => {
+    command2("gate-code-verify", async (invocation) => {
       const brief = String(invocation.rawInput ?? "").trim();
       const gate = resolveGate(ctx, invocation.agent);
       const state = store.read(gate.root, invocation.agent);
@@ -1580,7 +1672,7 @@ ignore\uFF1A${projectGit.ignore}` };
       wake(invocation, state, `Gate \u5DF2\u8FDB\u5165\u72EC\u7ACB\u9A8C\u6536\uFF1A${scope2}\u3002`, "gate-code-verify");
       return { kind: "success", text: `\u8FDB\u5165\u72EC\u7ACB\u9A8C\u6536\uFF1A${scope2}` };
     });
-    register("gate-propose-review", "\u5F00\u59CB\u72EC\u7ACB\u63D0\u6848\u8BC4\u5BA1", async (invocation) => {
+    command2("gate-propose-review", async (invocation) => {
       const brief = String(invocation.rawInput ?? "").trim();
       const gate = resolveGate(ctx, invocation.agent);
       const state = store.read(gate.root, invocation.agent);
@@ -1597,7 +1689,7 @@ ignore\uFF1A${projectGit.ignore}` };
       wake(invocation, state, `Gate \u5DF2\u8FDB\u5165\u63D0\u6848\u8BC4\u5BA1\uFF1A${scope2}\u3002`, "gate-propose-review");
       return { kind: "success", text: `\u8FDB\u5165\u63D0\u6848\u8BC4\u5BA1\uFF1A${scope2}` };
     });
-    register("gate-block", "\u624B\u52A8\u6682\u505C\uFF1A\u4FDD\u7559\u5F53\u524D\u8282\u70B9\u5E76\u505C\u6B62\u5199\u5165/\u6D3E worker\uFF1B\u5BF9\u8BDD\u4ECD\u53EF\u7EE7\u7EED", async (invocation) => {
+    command2("gate-block", async (invocation) => {
       const gate = resolveGate(ctx, invocation.agent);
       const state = store.read(gate.root, invocation.agent);
       if (state.phase === "blocked") return { kind: "success", text: "\u5DF2\u7ECF\u662F blocked" };
@@ -1609,9 +1701,9 @@ ignore\uFF1A${projectGit.ignore}` };
       store.write(gate.root, invocation.agent, state);
       return { kind: "success", text: `\u5DF2\u6682\u505C\uFF1A${state.blockReason}
 \u89E3\u51BB\u540E\uFF1A${state.blockedFrom?.phase ?? "discuss"}${state.blockedFrom?.node === null || state.blockedFrom?.node === void 0 ? "" : ` / ${state.blockedFrom.node}`}
-\u540C\u4E00\u4E8B\u9879\uFF1A/gate-resume \u56DE\u5230\u8BE5\u8282\u70B9\uFF1B\u6539\u53D8\u65B9\u6848\uFF1A/gate-return-discuss\u3002` };
-    }, { hint: "[\u539F\u56E0]" });
-    register("gate-resume", "\u89E3\u51BB blocked\uFF1A\u56DE\u5230 block \u524D\u7684\u8282\u70B9\uFF1B\u8F6E\u6B21\u8017\u5C3D\u56DE discuss", async (invocation) => {
+\u540C\u4E00\u4E8B\u9879\uFF1A/gate-resume \u56DE\u5230\u8BE5\u8282\u70B9\uFF1B\u6539\u53D8\u65B9\u6848\uFF1A\u5148 /gate-resume\uFF0C\u518D /gate-return-discuss\u3002` };
+    });
+    command2("gate-resume", async (invocation) => {
       const gate = resolveGate(ctx, invocation.agent);
       const state = store.read(gate.root, invocation.agent);
       if (state.phase !== "blocked") return { kind: "error", text: "\u5F53\u524D\u4E0D\u662F blocked" };
@@ -1628,8 +1720,8 @@ ignore\uFF1A${projectGit.ignore}` };
       }
       const exhausted = reason === "plan-review-rounds-exhausted" || reason === "code-review-rounds-exhausted";
       return { kind: "success", text: `\u5DF2\u89E3\u9664 blocked\uFF1A${state.phase}${state.node === null ? "" : ` / ${state.node}`}${exhausted ? "\nreview \u8F6E\u6B21\u5DF2\u8017\u5C3D\uFF0C\u4E0D\u80FD\u7EE7\u7EED\u539F\u8282\u70B9\uFF1B\u7528 /gate-enter-plan \u91CD\u65B0\u89C4\u5212\u3002" : "\n\u5DF2\u56DE\u5230\u6682\u505C\u524D\u8282\u70B9\uFF0C\u6309\u5F53\u524D procedure \u7EE7\u7EED\u3002"}` };
-    }, null);
-    register("gate-return-discuss", "\u56DE\u5230 discuss", async (invocation) => {
+    });
+    command2("gate-return-discuss", async (invocation) => {
       const gate = resolveGate(ctx, invocation.agent);
       const state = store.read(gate.root, invocation.agent);
       if (state.phase === "blocked") return { kind: "error", text: `\u5F53\u524D blocked\uFF1A${state.blockReason ?? "unknown"}\uFF1B\u5148 /gate-resume` };
@@ -1651,21 +1743,22 @@ ignore\uFF1A${projectGit.ignore}` };
       state.pending = {};
       store.write(gate.root, invocation.agent, state);
       return { kind: "success", text: "\u5DF2\u56DE\u5230 discuss" };
-    }, null);
-    register("gate-status", "\u67E5\u770B\u5F53\u524D gate \u72B6\u6001", async (invocation) => {
+    });
+    command2("gate-status", async (invocation) => {
       const gate = resolveGate(ctx, invocation.agent);
       const root = rootAgentOf(ctx, invocation.agent);
       const state = store.read(gate.root, root);
       const worker = root?.id !== invocation.agent?.id;
-      return { kind: "success", text: [accessText(accessFor(state, worker)), statusText(state, reviewLimit)].join("\n\n") };
-    }, null);
-    register("gate-note-verify", "\u53EA\u8BFB\u68C0\u67E5 notes tree/format/lifecycle/archived", async (invocation) => {
+      const next = worker ? "" : nextCommandsText(nextCommandsFor(state));
+      return { kind: "success", text: [accessText(accessFor(state, worker)), statusText(state, reviewLimit), next].filter(Boolean).join("\n\n") };
+    });
+    command2("gate-note-verify", async (invocation) => {
       const gate = resolveGate(ctx, invocation.agent);
       const check = runNotesScripts(gate.root);
       return check.ok ? { kind: "success", text: check.results.map((item) => `${item.name}: ok`).join("\n") } : { kind: "error", text: `notes \u6821\u9A8C\u5931\u8D25\uFF1A
 ${JSON.stringify(check.results, null, 2)}` };
-    }, null);
-    register("gate-note-archive", "\u5C06 implemented Note \u5F52\u6863\u5230 archived/\uFF1A\u52A0 Archived\u3001\u79FB\u52A8\u3001\u5C01\u5370\u5E76\u62A5\u544A\u5165\u7AD9\u94FE\u63A5", async (invocation) => {
+    });
+    command2("gate-note-archive", async (invocation) => {
       const gate = resolveGate(ctx, invocation.agent);
       const raw = String(invocation.rawInput ?? "").trim();
       const args = raw === "" ? [] : raw.split(/\s+/u);
@@ -1679,8 +1772,8 @@ ${JSON.stringify(check.results, null, 2)}` };
       } catch (error) {
         return { kind: "error", text: String(error?.stderr ?? error?.message ?? error).trim() };
       }
-    }, { hint: "<implemented-note> [--superseded-by <new-note>]" });
-    register("gate-note-board", "\u751F\u6210\u51B3\u7B56\u770B\u677F board.html\uFF08\u8F7B\u91CF\u6A21\u5F0F\uFF0C\u8FDE\u63A5\u672C\u5730 notes \u76EE\u5F55\uFF09", async (invocation) => {
+    });
+    command2("gate-note-board", async (invocation) => {
       const gate = resolveGate(ctx, invocation.agent);
       const raw = String(invocation.rawInput ?? "").trim();
       const args = raw === "" ? [] : raw.split(/\s+/u);
@@ -1695,8 +1788,8 @@ ${JSON.stringify(check.results, null, 2)}` };
       } catch (error) {
         return { kind: "error", text: String(error?.stderr ?? error?.message ?? error).trim() };
       }
-    }, { hint: "[\u8F93\u51FA\u8DEF\u5F84] [\u6807\u9898]" });
-    register("gate-note-seal", "\u53EA\u7ED9 archived/ \u4E2D\u5DF2\u6709 Note \u8865\u5199 manifest.json \u7684 SHA-256 \u5C01\u5370\uFF1B\u4E0D\u5F52\u6863\u3001\u4E0D\u6539 Note \u5185\u5BB9", async (invocation) => {
+    });
+    command2("gate-note-seal", async (invocation) => {
       const gate = resolveGate(ctx, invocation.agent);
       const node = resolveNodeBinary();
       if (node === void 0) return { kind: "error", text: "notes-runtime-unavailable" };
@@ -1707,7 +1800,7 @@ ${JSON.stringify(check.results, null, 2)}` };
       } catch (error) {
         return { kind: "error", text: String(error?.stderr ?? error?.message ?? error).trim() };
       }
-    }, null);
+    });
   });
 }
 
@@ -2081,8 +2174,10 @@ function registerStatus(ctx, deps) {
       const worker = root?.id !== exec.agent?.id;
       const access = accessFor(state, worker);
       if (worker) {
-        return { ok: true, procedure: null, method: null, access, text: [accessText(access), statusText(state, reviewLimit)].join("\n\n") };
+        return { ok: true, procedure: null, method: null, access, nextCommands: [], text: [accessText(access), statusText(state, reviewLimit)].join("\n\n") };
       }
+      const nextCommands = nextCommandsFor(state);
+      const nextText = nextCommandsText(nextCommands);
       const procedure = procedureFor(state, { reviewLimit });
       const includeRounds = !procedure.hasRounds;
       return {
@@ -2090,7 +2185,8 @@ function registerStatus(ctx, deps) {
         procedure,
         method: procedure.method,
         access,
-        text: procedureResultText(procedure, [statusText(state, reviewLimit, { includeRounds }), accessText(access)].join("\n\n"))
+        nextCommands,
+        text: procedureResultText(procedure, [statusText(state, reviewLimit, { includeRounds }), nextText, accessText(access)].filter(Boolean).join("\n\n"))
       };
     }
   });
@@ -2251,12 +2347,73 @@ function registerNoteTools(ctx, deps) {
   });
 }
 
+// src/tools/catalog.ts
+var GATE_TOOLS = [
+  { name: "gate_status", summary: "\u8BFB\u53D6\u5F53\u524D phase/node\u3001procedure\u3001access \u548C nextCommands\uFF1Broot/worker \u5747\u53EF\u8C03\u7528\u3002" },
+  { name: "gate_record", summary: "\u8BB0\u5F55 worker \u7ED3\u679C\u5E76\u63A8\u8FDB gate\uFF1B\u4EC5 root \u53EF\u8C03\u7528\u3002" },
+  { name: "gate_start_phase", summary: "\u5728\u7528\u6237\u6388\u6743\u540E\u8FDB\u5165 plan/implement\uFF1Bplan \u57FA\u4E8E\u8BA8\u8BBA\u5171\u8BC6\uFF0Cimplement \u57FA\u4E8E\u5DF2\u786E\u8BA4\u8BA1\u5212\u6216\u5B9E\u65BD\u8BF4\u660E\uFF1B\u4EC5 root \u53EF\u8C03\u7528\u3002" },
+  { name: "gate_note_write", summary: "planning worker \u5199 proposed Note \u6216\u539F\u5730\u66F4\u65B0 implemented Note\u3002" },
+  { name: "gate_note_verify", summary: "\u5728 note-lifecycle \u4E2D\u8FD0\u884C notes \u6821\u9A8C\uFF1Broot-only\u3002" },
+  { name: "gate_note_finalize", summary: "\u628A proposed Note \u79FB\u5230 implemented \u5E76\u66F4\u65B0\u5934\u5757\uFF1Broot-only\u3002" },
+  { name: "gate_help", summary: "\u5217\u51FA gate \u547D\u4EE4\u3001\u5DE5\u5177\u548C\u5F53\u524D phase/node\uFF1B\u53EA\u8BFB\uFF0Croot-only\u3002" }
+];
+
+// src/tools/help.ts
+function commandLine(spec) {
+  const hint = spec.hint === null ? "" : ` ${spec.hint}`;
+  return `- ${commandLabel(spec)}${hint} \u2014 ${spec.description}\uFF08${spec.when}\uFF09`;
+}
+function helpText(phase, node) {
+  return [
+    "## Gate help",
+    `\u5F53\u524D phase/node\uFF1A${phase} / ${node ?? "\u65E0"}`,
+    "",
+    "\u547D\u4EE4\uFF08\u7531\u7528\u6237\u6267\u884C\uFF09\uFF1A",
+    ...GATE_COMMANDS.map(commandLine),
+    "",
+    "\u5DE5\u5177\uFF08\u7531\u6A21\u578B\u8C03\u7528\uFF09\uFF1A",
+    ...GATE_TOOLS.map((tool) => `- ${tool.name} \u2014 ${tool.summary}`),
+    "",
+    "\u547D\u4EE4\u7531\u7528\u6237\u6267\u884C\uFF1B\u5DE5\u5177\u7531\u6A21\u578B\u8C03\u7528\u3002\u547D\u4EE4\u4E0D\u4F1A\u4F5C\u4E3A tool \u51FA\u73B0\u5728\u5DE5\u5177\u76EE\u5F55\u3002"
+  ].join("\n");
+}
+function registerHelp(ctx, deps) {
+  const { store } = deps;
+  ctx.tools.register({
+    name: "gate_help",
+    description: "\u53EA\u8BFB\u5217\u51FA gate \u547D\u4EE4\u3001\u5DE5\u5177\u7528\u9014\u548C\u5F53\u524D phase/node\u3002\u4EC5 root agent\uFF1B\u53EA\u5728\u4E0D\u786E\u5B9A\u547D\u4EE4\u540D/\u5DE5\u5177\u7528\u9014\u65F6\u4F7F\u7528\u3002",
+    parameters: { type: "object", additionalProperties: false, properties: {} },
+    output: {
+      schema: { type: "object", additionalProperties: true },
+      render: (_args, value) => [{ type: "text", text: typeof value?.text === "string" ? value.text : JSON.stringify(value) }]
+    },
+    async execute(_args, exec) {
+      const root = rootAgentOf(ctx, exec.agent);
+      if (root?.id !== exec.agent?.id) return { ok: false, code: "root-only", reason: "gate_help \u53EA\u80FD\u7531 root agent \u8C03\u7528\u3002" };
+      const gate = resolveGate(ctx, exec.agent);
+      if (gate.root === void 0) return { ok: false, code: "state-unavailable", reason: "\u65E0\u6CD5\u786E\u5B9A\u5DE5\u4F5C\u533A\u3002" };
+      const state = store.read(gate.root, root);
+      return {
+        ok: true,
+        phase: state.phase,
+        node: state.node,
+        current: { phase: state.phase, node: state.node },
+        note: "\u547D\u4EE4\u7531\u7528\u6237\u6267\u884C\uFF1B\u5DE5\u5177\u7531\u6A21\u578B\u8C03\u7528\u3002",
+        commands: GATE_COMMANDS.map((spec) => ({ ...spec, command: commandLabel(spec) })),
+        tools: GATE_TOOLS,
+        text: helpText(state.phase, state.node)
+      };
+    }
+  });
+}
+
 // src/tools/index.ts
 function registerTools(ctx, deps) {
   registerStartPhase(ctx, deps);
   registerRecord(ctx, deps);
   registerStatus(ctx, deps);
   registerNoteTools(ctx, deps);
+  registerHelp(ctx, deps);
 }
 
 // src/index.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-gate-agent",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "type": "module",
   "description": "Phase/node workflow gate with built-in commands, tools, and skills.",
   "exports": {

package/skills/gate-plan-review/SKILL.md

@@ -56,11 +56,10 @@ user-invocable: false
 - 产品范围、行为与验收问题报告给工作项；
 - 本次规划的技术设计问题报告给 Agent Note；引用输入的问题按项目配置反馈其属主；
 - 状态、评审与批准证据报告给工作项；
-- 领域术语问题报告给 技能`gate-domain-modeling` 的属主，技术决定报告给相关 Agent Note。
 
 由 planning worker 决定并执行修正；本 worker 不更新工作项、Note 或就绪状态。
 
-仅当提议为架构决定单独建档时，使用 技能`adr`  的准入条件检查反悔成本与真实权衡。其他 Agent Note 按项目部署后的 README 判断是否有长期设计价值。纯行为规则归产品合同；普通实现细节不因“重要”就自动生成 Note。
+纯行为规则归产品合同；普通实现细节不因“重要”就自动生成 Note。
 
 设计仍依赖临时产品假设时保持非权威。修订产品合同后，检查所有承接同一产品合同的设计，不只修改最先暴露问题的那一份。
 

package/skills/gate-planning/SKILL.md

@@ -64,8 +64,6 @@ user-invocable: false
 
 设计定稿遵循 技术设计规则（[rfc.md](./rfc.md) ） 的合同稳定性与评审条件。Note 的 proposed/implemented 表示交付生命周期，不代替评审和批准证据。
 
-使用项目既有领域语言和适用架构约束。领域术语与模型变化使用 `gate-domain-modeling`；需要为架构决定单独建档时，使用 `adr` 的准入条件判断，在相关 Agent Note 中记录决定。
-
 ### 决定权限
 
 在已同意的产品合同、既有架构和项目约束内，自主解决普通技术选择。

package/skills/gate-planning/rfc.md

@@ -54,8 +54,6 @@
 
 需要产品、业务、兼容性、成本、风险、持久架构方向或其他价值判断时，交给相应决定权限，不把问题伪装成纯技术选择。
 
-接受的决定形成或改变领域语言时，使用 `gate-domain-modeling` SKILL 维护领域资料。需要为架构决定单独建档时，使用 `adr` SKILL 的准入条件判断；决定属于本设计时在同一 Note 中维护，可独立判断的新决定按项目 Note 规则记录。
-
 ## 定稿与评审条件
 
 技术设计可以进入 Plan Review，需要满足：

package/skills/gate-research/SKILL.md

@@ -12,6 +12,3 @@ Its job:
 2. Write the findings to a single Markdown file, citing each claim's source.
 3. Save it where the repo already keeps such notes; match the existing convention, and if there is none, put it somewhere sensible and say where.
 
-
-
-

package/skills/gate-domain-modeling/CONTEXT-FORMAT.md

@@ -1,64 +0,0 @@
-# CONTEXT.md Format
-
-## Structure
-
-```md
-# {Context Name}
-
-{One or two sentence description of what this context is and why it exists.}
-
-## Language
-
-**Order**:
-{A one or two sentence description of the term}
-_Avoid_: Purchase, transaction
-
-**Invoice**:
-A request for payment sent to a customer after delivery.
-_Avoid_: Bill, payment request
-
-**Customer**:
-A person or organization that places orders.
-_Avoid_: Client, buyer, account
-```
-
-## Rules
-
-- **Be opinionated.** When multiple words exist for the same concept, pick the best one and list the others under `_Avoid_`.
-- **Keep definitions tight.** One or two sentences max. Define what it IS, not what it does.
-- **Only include terms specific to this project's context.** General programming concepts (timeouts, error types, utility patterns) don't belong even if the project uses them extensively. Before adding a term, ask: is this a concept unique to this context, or a general programming concept? Only the former belongs.
-- **Group terms under subheadings** when natural clusters emerge. If all terms belong to a single cohesive area, a flat list is fine.
-
-## Single vs multi-context repos
-
-**Single context (most repos):** One `CONTEXT.md` at the repo root.
-
-**Multiple contexts:** A `CONTEXT-MAP.md` at the repo root lists the contexts, where they live, and how they relate to each other:
-
-```md
-# Context Map
-
-## Contexts
-
-- [Ordering](./src/ordering/CONTEXT.md): receives and tracks customer orders
-- [Billing](./src/billing/CONTEXT.md): generates invoices and processes payments
-- [Fulfillment](./src/fulfillment/CONTEXT.md): manages warehouse picking and shipping
-
-## Relationships
-
-- **Ordering → Fulfillment**: Ordering emits `OrderPlaced` events; Fulfillment consumes them to start picking
-- **Fulfillment → Billing**: Fulfillment emits `ShipmentDispatched` events; Billing consumes them to generate invoices
-- **Ordering ↔ Billing**: Shared types for `CustomerId` and `Money`
-```
-
-The skill infers which structure applies:
-
-Resolve the root from project instructions before these checks; the current working directory may be a subproject. Use the project documentation hierarchy for ownership; the context map does not create separate record categories. Paths shown in the map are Markdown links relative to the map file.
-
-- If `CONTEXT-MAP.md` exists, read it to find contexts
-- If only a root `CONTEXT.md` exists, single context
-- If neither exists, create a root `CONTEXT.md` lazily when the first term is resolved
-
-When multiple contexts exist, infer which one the current topic relates to. If unclear, ask.
-
-

package/skills/gate-domain-modeling/GLOSSARY-FORMAT.md

@@ -1,64 +0,0 @@
-# GLOSSARY.md Format
-
-## Structure
-
-```md
-# {Context Name}
-
-{One or two sentence description of what this context is and why it exists.}
-
-## Language
-
-**Order**:
-{A one or two sentence description of the term}
-_Avoid_: Purchase, transaction
-
-**Invoice**:
-A request for payment sent to a customer after delivery.
-_Avoid_: Bill, payment request
-
-**Customer**:
-A person or organization that places orders.
-_Avoid_: Client, buyer, account
-```
-
-## Rules
-
-- **Be opinionated.** When multiple words exist for the same concept, pick the best one and list the others under `_Avoid_`.
-- **Keep definitions tight.** One or two sentences max. Define what it IS, not what it does.
-- **Only include terms specific to this project's context.** General programming concepts (timeouts, error types, utility patterns) don't belong even if the project uses them extensively. Before adding a term, ask: is this a concept unique to this context, or a general programming concept? Only the former belongs.
-- **Group terms under subheadings** when natural clusters emerge. If all terms belong to a single cohesive area, a flat list is fine.
-
-## Single vs multi-context repos
-
-**Single context (most repos):** One `GLOSSARY.md` at the repo root.
-
-**Multiple contexts:** A `GLOSSARY-MAP.md` at the repo root lists the contexts, where they live, and how they relate to each other:
-
-```md
-# Glossary Map
-
-## Contexts
-
-- [Ordering](./src/ordering/GLOSSARY.md): receives and tracks customer orders
-- [Billing](./src/billing/GLOSSARY.md): generates invoices and processes payments
-- [Fulfillment](./src/fulfillment/GLOSSARY.md): manages warehouse picking and shipping
-
-## Relationships
-
-- **Ordering → Fulfillment**: Ordering emits `OrderPlaced` events; Fulfillment consumes them to start picking
-- **Fulfillment → Billing**: Fulfillment emits `ShipmentDispatched` events; Billing consumes them to generate invoices
-- **Ordering ↔ Billing**: Shared types for `CustomerId` and `Money`
-```
-
-The skill infers which structure applies:
-
-Resolve the root from project instructions before these checks; the current working directory may be a subproject. Use the project documentation hierarchy for ownership; the context map does not create separate record categories. Paths shown in the map are Markdown links relative to the map file.
-
-- If `GLOSSARY-MAP.md` exists, read it to find contexts
-- If only a root `GLOSSARY.md` exists, single context
-- If neither exists, create a root `GLOSSARY.md` lazily when the first term is resolved
-
-When multiple contexts exist, infer which one the current topic relates to. If unclear, ask.
-
-

package/skills/gate-domain-modeling/SKILL.md

@@ -1,47 +0,0 @@
----
-name: gate-domain-modeling
-description: Build and sharpen a project's domain model. Use when discussing codebase terminology, writing or editing a GLOSSARY.md, or recording a durable decision in its selected owner.
-user-invocable: false
----
-
-# Domain Modeling
-
-Actively build and sharpen the project's domain model as you design. This is the *active* discipline: challenging terms, inventing edge-case scenarios, and writing the glossary and decisions down the moment they crystallise. (Merely *reading* `GLOSSARY.md` for vocabulary is not this skill: that's a one-line habit any skill can do. This skill is for when you're changing the model, not just consuming it.)
-
-## File structure
-
-Follow the document ownership entry referenced by project instructions for glossary paths and decisions applicable to the model being discussed. If a required input's owner or scope is unclear, report the configuration gap.
-
-Resolve the repository management root from project instructions, using the Git top-level only as a fallback. Working inside a subproject does not change it. A root `GLOSSARY-MAP.md` selects domain documents when the repository has multiple contexts. Do not create a separate record system per context or derive record categories automatically from contexts.
-
-A single-context project may use a root `GLOSSARY.md`. A root `GLOSSARY-MAP.md`, when present, points to the selected contexts' glossaries; context paths need not be under `src/`. Resolve decision paths separately from the document ownership entry and, for Agent Notes, its configured record roots. Create a glossary or decision record only when there is content for its selected owner. Use the `adr` skill when a separate architecture decision record is warranted.
-
-## During the session
-
-### Challenge against the glossary
-
-When the user uses a term that conflicts with the existing language in `GLOSSARY.md`, call it out immediately. "Your glossary defines 'cancellation' as X, but you seem to mean Y. Which is it?"
-
-### Sharpen fuzzy language
-
-When the user uses vague or overloaded terms, propose a precise canonical term. "You're saying 'account': do you mean the Customer or the User? Those are different things."
-
-### Discuss concrete scenarios
-
-When domain relationships are being discussed, stress-test them with specific scenarios. Invent scenarios that probe edge cases and force the user to be precise about the boundaries between concepts.
-
-### Cross-reference with code
-
-When the user states how something works, check whether the code agrees. If you find a contradiction, surface it: "Your code cancels entire Orders, but you just said partial cancellation is possible. Which is right?"
-
-### Update GLOSSARY.md inline
-
-When a term is resolved, update `GLOSSARY.md` right there. Don't batch these up: capture them as they happen. Use the format in [GLOSSARY-FORMAT.md](./GLOSSARY-FORMAT.md).
-
-`GLOSSARY.md` should be totally devoid of implementation details. Do not treat `GLOSSARY.md` as a spec, a scratch pad, or a repository for implementation decisions. It is a glossary and nothing else.
-
-
-
-
-
-