dsh-gate-agent 0.1.1 → 0.1.2

package/skills/gate-fix-bug/assets/worker-briefs/gate-fix-bug.md

@@ -1,33 +1,33 @@
-# /gate-fix-bug — fix worker
-
-```markdown
-你是 Gate 的 fix-bug worker。使用 gate-fix-bug 完成这次已授权的实现缺陷修复；执行 Process 1-9，返回修复 receipt。独立 review 由主 agent 另派，不要自行完成 Step 10-12。
-
-## 选定失败
-<现象、复现步骤、最新结果>
-
-## 期望行为与合同
-<需求/验收/设计决定引用>
-
-## 证据/诊断
-<日志、失败测试、已有报告>
-
-## 修复范围
-<只修什么；明确不修什么>
-
-## 基线
-<commit、diff、相关文件>
-
-## 约束
-- 只修选定缺陷；不重构、不改产品行为、不加依赖、不做无关清理。
-- 先复现；回归测试应先失败，修复后通过。
-- 不通过削弱/删除有效测试让套件变绿。
-- 若发现是测试/合同/设计/环境问题，停止并报告属主。
-- 只执行 Process 1-9；不自行 review，不提交。
-
-## 验证
-<复现命令、相关测试、类型检查/构建>
-```
+# /gate-fix-bug — fix worker
+
+```markdown
+你是 Gate 的 fix-bug worker。使用 gate-fix-bug 完成这次已授权的实现缺陷修复；执行 Process 1-9，返回修复 receipt。独立 review 由主 agent 另派，不要自行完成 Step 10-12。
+
+## 选定失败
+<现象、复现步骤、最新结果>
+
+## 期望行为与合同
+<需求/验收/设计决定引用>
+
+## 证据/诊断
+<日志、失败测试、已有报告>
+
+## 修复范围
+<只修什么；明确不修什么>
+
+## 基线
+<commit、diff、相关文件>
+
+## 约束
+- 只修选定缺陷；不重构、不改产品行为、不加依赖、不做无关清理。
+- 先复现；回归测试应先失败，修复后通过。
+- 不通过削弱/删除有效测试让套件变绿。
+- 若发现是测试/合同/设计/环境问题，停止并报告属主。
+- 只执行 Process 1-9；不自行 review，不提交。
+
+## 验证
+<复现命令、相关测试、类型检查/构建>
+```
 
 
 

package/skills/gate-implement/SKILL.md

@@ -1,81 +1,81 @@
----
-name: gate-implement
-description: Gate 实现方法：主 agent 读取后提炼任务并派发；subagent worker 不加载技能。
-user-invocable: false
----
-
-## Main agent use
-
-主 agent 在派发前自行读取本方法，给 subagent worker 一份自包含任务：已接受的范围、约束、验收检查和实现规则。subagent worker 不应加载本技能或其他 gate 方法文件。
-
-任务模板：本技能 `assets/worker-briefs/gate-enter-implement.md`。
-
-## 实现
-
-## 1. 入口条件
-
-实现已接受工作项（proposed Agent Note）的选定范围。编码前读取其范围、验收条件与引用的设计章节。
-
-实现前检查范围、验收条件、必需决定、批准证据、未解决 blocker，以及该范围的执行授权。复用有效证据，不重复确认。把已确认的范围和决定同步给各自属主；未解决的重要决定按项目的讨论、授权和 gate 规则返回 discuss。仅记录状态或位置不构成就绪或授权。
-
-## 2. 按需拆分
-
-通过 Implementation Gate 后，只在确实需要拆分时创建 implementation ticket。ticket 的存在不是进入实现的前提。
-
-工作适合一个连贯执行单元时直接实现。
-
-工作过大、存在有意义的独立切片或依赖时，读取 [tickets.md](./tickets.md) 。
-
-不要为了枚举编码步骤而创建 ticket。
-
-## 3. 执行
-
-按工作项的范围、验收条件、引用要求、已接受设计和架构决定实现。
-
-使用既有架构、约定、接口和领域语言，除非权威设计明确改变。
-
-如果实现暴露出未解决的产品、领域、架构、接口、兼容性或其他合同决定，停止受影响实现，并向主 agent 返回 receipt 和该决定。主 agent 调用 `gate_record({node:'implement', requiresDiscussion:true, discussionReason})`；worker 不得调用 `gate_record` 或 slash command。决定未解决前先讨论，不做新的 planning/implement 授权，也不继续受影响代码。
-
-### 实现期测试
-
-按改动需要编写或更新测试。测试优先能改善反馈或明确行为时使用；采用时加载 `gate-tdd` 技能并遵循其流程。
-
-工作时运行聚焦测试和相关静态检查。
-
-### 实现 findings
-
-gate 可能返回实质 findings。按属主处理：
-
-| Finding | 路由 |
-| --- | --- |
-| 当前实现缺失或违反已同意合同 | 在当前实现中修复 |
-| 同一已同意工作需要额外执行单元 | 增加或更新 implementation ticket |
-| 产品或技术合同必须改变或从未解决 | 停止受影响工作，把决定 blocker 返回主 agent；主 agent 调 `gate_record` 带 `requiresDiscussion:true`；新 planning 需要授权 |
-| 与已同意工作无关 | 不自动扩大范围 |
-
-没有“顺手修一下”的无关工作路径。
-
-对属于本实现的 findings，在当前实现中修复，重跑受影响测试和静态检查，并在下一次 receipt 报告每项处置。没有证据不要标记已解决。
-
-## 4. Receipt 与交接
-
-实现完成的条件：
-
-- 授权范围已实现
-- 必需 ticket 已完成
-- 相关实现期检查通过
-- 实质 findings 已解决或明确报告为 blocked
-- 改动已准备好进入 `gate-verify`
-
-返回 receipt，包含：
-
-- 改动文件与覆盖范围
-- 运行的测试和静态检查及结果
-- 每项 finding 的处置
-- 剩余风险、blocker 或需要决定的点
-
-不要执行 `gate-verify`、不要把工作项标完成、不要推进 gate。verify 节点和最终完成由 gate 负责。
-
+---
+name: gate-implement
+description: Gate 实现方法：主 agent 读取后提炼任务并派发；subagent worker 不加载技能。
+user-invocable: false
+---
+
+## Main agent use
+
+主 agent 在派发前自行读取本方法，给 subagent worker 一份自包含任务：已接受的范围、约束、验收检查和实现规则。subagent worker 不应加载本技能或其他 gate 方法文件。
+
+任务模板：本技能 `assets/worker-briefs/gate-enter-implement.md`。
+
+## 实现
+
+## 1. 入口条件
+
+实现已接受工作项（proposed Agent Note）的选定范围。编码前读取其范围、验收条件与引用的设计章节。
+
+实现前检查范围、验收条件、必需决定、批准证据、未解决 blocker，以及该范围的执行授权。复用有效证据，不重复确认。把已确认的范围和决定同步给各自属主；未解决的重要决定按项目的讨论、授权和 gate 规则返回 discuss。仅记录状态或位置不构成就绪或授权。
+
+## 2. 按需拆分
+
+通过 Implementation Gate 后，只在确实需要拆分时创建 implementation ticket。ticket 的存在不是进入实现的前提。
+
+工作适合一个连贯执行单元时直接实现。
+
+工作过大、存在有意义的独立切片或依赖时，读取 [tickets.md](./tickets.md) 。
+
+不要为了枚举编码步骤而创建 ticket。
+
+## 3. 执行
+
+按工作项的范围、验收条件、引用要求、已接受设计和架构决定实现。
+
+使用既有架构、约定、接口和领域语言，除非权威设计明确改变。
+
+如果实现暴露出未解决的产品、领域、架构、接口、兼容性或其他合同决定，停止受影响实现，并向主 agent 返回 receipt 和该决定。主 agent 调用 `gate_record({node:'implement', requiresDiscussion:true, discussionReason})`；worker 不得调用 `gate_record` 或 slash command。决定未解决前先讨论，不做新的 planning/implement 授权，也不继续受影响代码。
+
+### 实现期测试
+
+按改动需要编写或更新测试。测试优先能改善反馈或明确行为时使用；采用时加载 `gate-tdd` 技能并遵循其流程。
+
+工作时运行聚焦测试和相关静态检查。
+
+### 实现 findings
+
+gate 可能返回实质 findings。按属主处理：
+
+| Finding | 路由 |
+| --- | --- |
+| 当前实现缺失或违反已同意合同 | 在当前实现中修复 |
+| 同一已同意工作需要额外执行单元 | 增加或更新 implementation ticket |
+| 产品或技术合同必须改变或从未解决 | 停止受影响工作，把决定 blocker 返回主 agent；主 agent 调 `gate_record` 带 `requiresDiscussion:true`；新 planning 需要授权 |
+| 与已同意工作无关 | 不自动扩大范围 |
+
+没有“顺手修一下”的无关工作路径。
+
+对属于本实现的 findings，在当前实现中修复，重跑受影响测试和静态检查，并在下一次 receipt 报告每项处置。没有证据不要标记已解决。
+
+## 4. Receipt 与交接
+
+实现完成的条件：
+
+- 授权范围已实现
+- 必需 ticket 已完成
+- 相关实现期检查通过
+- 实质 findings 已解决或明确报告为 blocked
+- 改动已准备好进入 `gate-verify`
+
+返回 receipt，包含：
+
+- 改动文件与覆盖范围
+- 运行的测试和静态检查及结果
+- 每项 finding 的处置
+- 剩余风险、blocker 或需要决定的点
+
+不要执行 `gate-verify`、不要把工作项标完成、不要推进 gate。verify 节点和最终完成由 gate 负责。
+
 
 
 

package/skills/gate-implement/assets/worker-briefs/gate-enter-implement.md

@@ -1,24 +1,24 @@
-# /gate-enter-implement — implement worker
-
-```markdown
-你是 Gate 的 implement worker。按已确认方案实施；不 review，不 verify，不推进 gate。
-
-## 工作项
-<task / 用户简述>
-
-## 合同与范围
-<验收条件、设计约束、本次要做 / 明确不做>
-
-## 基线
-<固定点、相关文件、已有改动>
-
-## 实施要求
-- 按现有架构和测试策略做最小完整实现。
-- 不扩大范围，不引入无关依赖，不修改产品合同。
-- 需要时补测试；记录实际运行的命令和结果。
-
-## 交付
-返回：改动文件、测试/命令结果、偏差、遗留风险。
-```
+# /gate-enter-implement — implement worker
+
+```markdown
+你是 Gate 的 implement worker。按已确认方案实施；不 review，不 verify，不推进 gate。
+
+## 工作项
+<task / 用户简述>
+
+## 合同与范围
+<验收条件、设计约束、本次要做 / 明确不做>
+
+## 基线
+<固定点、相关文件、已有改动>
+
+## 实施要求
+- 按现有架构和测试策略做最小完整实现。
+- 不扩大范围，不引入无关依赖，不修改产品合同。
+- 需要时补测试；记录实际运行的命令和结果。
+
+## 交付
+返回：改动文件、测试/命令结果、偏差、遗留风险。
+```
 
 

package/skills/gate-plan-review/assets/worker-briefs/plan-review.md

@@ -1,19 +1,19 @@
-# Plan / Proposal Review worker
-
-```markdown
-你是 Gate 的只读 Plan Review worker。只评审计划、提案或 Note，不修改、不写代码。
-
-## 评审对象
-<工作项 / 提案 / Note 路径、固定点>
-
-## 合同
-<需求、验收条件、适用设计决定>
-
-## 评审三轴
-Standards / Spec / Architecture。每轴只报 findings，注明证据与严重度。
-
-## 输出
-返回 standards、spec、architecture 三组 findings；不要合并三轴，不要修复。
-```
+# Plan / Proposal Review worker
+
+```markdown
+你是 Gate 的只读 Plan Review worker。只评审计划、提案或 Note，不修改、不写代码。
+
+## 评审对象
+<工作项 / 提案 / Note 路径、固定点>
+
+## 合同
+<需求、验收条件、适用设计决定>
+
+## 评审三轴
+Standards / Spec / Architecture。每轴只报 findings，注明证据与严重度。
+
+## 输出
+返回 standards、spec、architecture 三组 findings；不要合并三轴，不要修复。
+```
 
 

package/skills/gate-planning/assets/worker-briefs/gate-enter-plan.md

@@ -1,24 +1,24 @@
-# /gate-enter-plan — planning worker
-
-```markdown
-你是 Gate 的 planning worker。完成规划并写 Note；不写代码，不实现。
-
-## 需求/约束
-<用户简述、已确认约束、范围>
-
-## 项目上下文
-<相关代码、文档、历史 Note 的关键事实；不要附环境 smoke>
-
-## Design 检查项
-<按 gate-planning/rfc.md 的适用检查点填写；worker 不加载技能，root 必须转交>
-
-## Note 要求
-- 先按 §3 检索历史，再按 §4 判定归属与 class。
-- 新建时用 gate_note_write 写 proposed Note；原地同步 implemented Note 时写 implemented/<class>/...。
-- 内容包含 problem / proposal / design / alternatives / acceptance / risks。
-
-## 交付
-返回：Note 路径、class、lifecycle、noteDecision、检索结论、主要设计取舍、未决问题。
-```
-
-
+# /gate-enter-plan — planning worker
+
+```markdown
+你是 Gate 的 planning worker。完成规划并写 Note；不写代码，不实现。
+
+## 需求/约束
+<用户简述、已确认约束、范围>
+
+## 项目上下文
+<相关代码、文档、历史 Note 的关键事实；不要附环境 smoke>
+
+## Design 检查项
+<按 gate-planning/rfc.md 的适用检查点填写；worker 不加载技能，root 必须转交>
+
+## Note 要求
+- 先按 §3 检索历史，再按 §4 判定归属与 class。
+- 新建时用 gate_note_write 写 proposed Note；原地同步 implemented Note 时写 implemented/<class>/...。
+- 内容包含 problem / proposal / design / alternatives / acceptance / risks。
+
+## 交付
+返回：Note 路径、class、lifecycle、noteDecision、检索结论、主要设计取舍、未决问题。
+```
+
+

package/skills/gate-planning/proposal.md

@@ -1,51 +1,51 @@
-# Proposal
-
-工作项与技术设计由同一份 proposed Agent Note 承接；工作项负责为什么要改、本次范围、产品行为与验收、评审与批准证据及就绪状态；技术设计写在同一 Note 的 Design 节，不另设设计属主。
-
-## 配置与存放
-
-- 唯一载体：`proposed/<class>/YYYY-MM-DD-topic.md`；
-- 不创建独立 Proposal 文件；
-- 模板使用 `<skills-root>/write-agent-notes/templates/proposed.md`；
-- 路径、分类、格式与生命周期由 `write-agent-notes` Skill 管。
-
-## 内容
-
-同一份 Note 中，工作项部分必须包含：
-
-```text
-## Problem
-why、背景、约束
-
-## Proposal
-### 范围与非目标
-### 产品行为与验收
-### 决定与未决问题
-### 评审与批准证据
-
-## Design
-技术设计、边界、关键决定
-
-## Alternatives considered
-真实备选、最强理由、为什么不选
-
-## Acceptance criteria
-可观察、可判定的验收
-
-## Risks
-风险与未决问题
-```
-
-- `## Proposal` 的子项是内容要求，不是新增模板；
-- `## Design` 是自由节，由 `rfc.md` 检查；
-- `## Alternatives considered`、`## Acceptance criteria`、`## Risks` 保持 Agent Note 模板结构；
-- 工作项内容与设计写在同一份 Note，不复制到第二份文件。
-
-## 状态更新
-
-- Plan Review 结果、批准与就绪状态记录在 Note 的工作项部分；
-- 评审通过、批准、执行授权是三件事；
-- 只有规划内容通过、所需批准齐备且没有阻塞时，才标记为就绪；
-- proposed → implemented 由 `write-agent-notes` 在实现与验证完成后处理，planning 不提前转换。
+# Proposal
+
+工作项与技术设计由同一份 proposed Agent Note 承接；工作项负责为什么要改、本次范围、产品行为与验收、评审与批准证据及就绪状态；技术设计写在同一 Note 的 Design 节，不另设设计属主。
+
+## 配置与存放
+
+- 唯一载体：`proposed/<class>/YYYY-MM-DD-topic.md`；
+- 不创建独立 Proposal 文件；
+- 模板使用 `<skills-root>/write-agent-notes/templates/proposed.md`；
+- 路径、分类、格式与生命周期由 `write-agent-notes` Skill 管。
+
+## 内容
+
+同一份 Note 中，工作项部分必须包含：
+
+```text
+## Problem
+why、背景、约束
+
+## Proposal
+### 范围与非目标
+### 产品行为与验收
+### 决定与未决问题
+### 评审与批准证据
+
+## Design
+技术设计、边界、关键决定
+
+## Alternatives considered
+真实备选、最强理由、为什么不选
+
+## Acceptance criteria
+可观察、可判定的验收
+
+## Risks
+风险与未决问题
+```
+
+- `## Proposal` 的子项是内容要求，不是新增模板；
+- `## Design` 是自由节，由 `rfc.md` 检查；
+- `## Alternatives considered`、`## Acceptance criteria`、`## Risks` 保持 Agent Note 模板结构；
+- 工作项内容与设计写在同一份 Note，不复制到第二份文件。
+
+## 状态更新
+
+- Plan Review 结果、批准与就绪状态记录在 Note 的工作项部分；
+- 评审通过、批准、执行授权是三件事；
+- 只有规划内容通过、所需批准齐备且没有阻塞时，才标记为就绪；
+- proposed → implemented 由 `write-agent-notes` 在实现与验证完成后处理，planning 不提前转换。
 
 

package/skills/gate-user-verify/assets/worker-briefs/gate-code-verify.md

@@ -1,32 +1,32 @@
-# /gate-code-verify worker brief
-
-```markdown
-你是 Gate 的独立验收 worker。使用 gate-user-verify 执行验收，并按该技能 Step 6 汇报。
-
-## 验收对象
-<交付、范围、固定点>
-
-## 验收合同
-<需求、验收条件、兼容性/设计约束>
-
-## 证据要求
-- 用可观察 seam 验证，不只依赖测试通过。
-- 可运行测试/命令作为证据；不得修改产品代码、测试、需求或设计。
-- 无法可靠判断时报告 BLOCKED，不猜 PASS。
-
-## 输出
-按 gate-user-verify Step 6 返回：
-- Result
-- Failures
-- Blockers
-- Acceptance Results
-- Regression Checks
-- Verification Limits
-- Overall Result
-- Tool result callId 列表（实际使用的 `call_...`，供 root 填 `verification.toolResults`）
-
-主 agent 负责把结果汇总给用户。
-```
-
-
-
+# /gate-code-verify worker brief
+
+```markdown
+你是 Gate 的独立验收 worker。使用 gate-user-verify 执行验收，并按该技能 Step 6 汇报。
+
+## 验收对象
+<交付、范围、固定点>
+
+## 验收合同
+<需求、验收条件、兼容性/设计约束>
+
+## 证据要求
+- 用可观察 seam 验证，不只依赖测试通过。
+- 可运行测试/命令作为证据；不得修改产品代码、测试、需求或设计。
+- 无法可靠判断时报告 BLOCKED，不猜 PASS。
+
+## 输出
+按 gate-user-verify Step 6 返回：
+- Result
+- Failures
+- Blockers
+- Acceptance Results
+- Regression Checks
+- Verification Limits
+- Overall Result
+- Tool result callId 列表（实际使用的 `call_...`，供 root 填 `verification.toolResults`）
+
+主 agent 负责把结果汇总给用户。
+```
+
+
+