@house365/comate 0.9.1 → 0.9.3

package/skills/comate-design/SKILL.md

@@ -1,106 +1,106 @@
----
-name: comate-design
-description: "comate 阶段 2：深度设计。用 /comate-design 调用。通过 brainstorming 产出 Design Doc 和 delta spec。"
----
-
-# comate 阶段 2：深度设计（Design）
-
-## 前置条件
-
-- 活跃 change 已存在（proposal.md、design.md、tasks.md）
-- 无 Design Doc
-
-## 步骤
-
-### 0. 入口状态验证
-
-```bash
-COMATE="${COMATE:-$(for r in . ./.agents/skills ./.claude/skills ./.cursor/skills ./.codex/skills "$HOME"/.agents/skills "$HOME"/.claude/skills "$HOME"/.config/skills "$HOME"/.cursor/skills "$HOME"/.codex/skills "$HOME"/.gemini/skills; do
-  [ -d "$r" ] && find "$r" -maxdepth 6 -path '*/comate/scripts/comate.sh' -type f -print -quit 2>/dev/null
-done | head -1)}"
-if [ -z "$COMATE" ]; then
-  echo "ERROR: comate.sh 未找到，请确认 comate skill 已安装。" >&2
-  return 1 2>/dev/null || exit 1
-fi
-bash "$COMATE" state <name> check design
-```
-
-**幂等性**：design 阶段操作可安全重试。若 `handoff_context` 和 `handoff_hash` 已存在，先确认与当前产物一致再决定是否重新生成。
-
-### 1a. 生成 OpenSpec → Superpowers 交接包
-
-**必须由脚本生成，不允许 agent 临场手写 summary 代替。**
-
-```bash
-bash "$COMATE" handoff <name> design --write
-```
-
-脚本生成 `openspec/changes/<name>/.comate/handoff/design-context.{json,md}` 并在 `.comate.yaml` 写入 `handoff_context` / `handoff_hash`。默认是 **compact 可追溯摘录**（含脚本标记 `Generated-by: comate`、source path、line range、sha256），不是 agent summary。需全文时加 `--full`。
-
-交接包来源：`proposal.md`、`design.md`、`tasks.md`、`specs/*/spec.md`。
-
-### 1b. 执行 Brainstorming（带上下文）
-
-**立即执行：** 使用 Skill 工具加载 `superpowers:brainstorming`，ARGUMENTS 包含：
-
-```
-Change: <name>
-OpenSpec Context Pack: openspec/changes/<name>/.comate/handoff/design-context.md
-Machine handoff: openspec/changes/<name>/.comate/handoff/design-context.json
-
-OpenSpec 产物是上游事实源，不要重新定义需求，不要重写 proposal/spec。
-基于交接包做深度技术设计：实现方案、技术风险、测试策略、边界条件。
-如发现 delta spec 缺少验收场景，只能提出 Spec Patch 回写 OpenSpec delta spec；不要在 Design Doc 中创建第二份需求 spec。
-
-Design Doc frontmatter 必须最小化，只含：
----
-comate_change: <name>
-role: technical-design
-canonical_spec: openspec
----
-```
-
-禁止跳过；该技能不可用时停止流程并提示安装 Superpowers，不要用普通对话替代。
-
-brainstorming 阶段不写 Design Doc 文件，仅产出方案供 Step 1c 确认。
-
-### 1c. 用户确认设计方案（决策阻塞点 2）
-
-**必须使用 AskUserQuestion 工具暂停等待用户明确确认设计方案**。规则见 `comate/reference/decision-points.md` 第 2 条。确认前不得创建最终 Design Doc、写 `design_doc`、跑 design guard 或进入 build。
-
-展示摘要：采用的技术方案、关键取舍与风险、测试策略、Spec Patch（如有）。用户确认后才继续 Step 2；要求调整则继续迭代。
-
-### 2. 更新 comate 状态
-
-```bash
-# 记录 design_doc 路径
-bash "$COMATE" state <name> set design_doc docs/superpowers/specs/YYYY-MM-DD-topic-design.md
-
-# 如有 delta spec 变更，重新生成 handoff 以更新 hash
-bash "$COMATE" handoff <name> design --write
-
-# 自动流转
-bash "$COMATE" guard <name> design --apply
-```
-
-无 delta spec 变更则跳过 handoff 重新生成。
-
-## 退出条件
-
-- Design Doc 已创建，frontmatter 含 `comate_change`、`role: technical-design`、`canonical_spec: openspec`
-- `handoff_context` / `handoff_hash` 已写入且 hash 与当前产物一致（guard 强制）
-- `design-context.md` 由脚本生成且含可追溯标记（guard 强制）
-- `design_doc` 已写入 `.comate.yaml`
-- **阶段守卫**：`bash "$COMATE" guard <name> design --apply` 全 PASS 后自动流转到 `phase: build`
-
-## 上下文压缩恢复
-
-```bash
-bash "$COMATE" state <name> recover design
-```
-
-脚本输出结构化恢复上下文，按 Recovery action 判断下一步。
-
-## 自动流转
-
-> **REQUIRED NEXT SKILL：** 调用 `comate-build` skill 进入计划与构建。
+---
+name: comate-design
+description: "comate 阶段 2：深度设计。用 /comate-design 调用。通过 brainstorming 产出 Design Doc 和 delta spec。"
+---
+
+# comate 阶段 2：深度设计（Design）
+
+## 前置条件
+
+- 活跃 change 已存在（proposal.md、design.md、tasks.md）
+- 无 Design Doc
+
+## 步骤
+
+### 0. 入口状态验证
+
+```bash
+COMATE="${COMATE:-$(for r in . ./.agents/skills ./.claude/skills ./.cursor/skills ./.codex/skills "$HOME"/.agents/skills "$HOME"/.claude/skills "$HOME"/.config/skills "$HOME"/.cursor/skills "$HOME"/.codex/skills "$HOME"/.gemini/skills; do
+  [ -d "$r" ] && find "$r" -maxdepth 6 -path '*/comate/scripts/comate.sh' -type f -print -quit 2>/dev/null
+done | head -1)}"
+if [ -z "$COMATE" ]; then
+  echo "ERROR: comate.sh 未找到，请确认 comate skill 已安装。" >&2
+  return 1 2>/dev/null || exit 1
+fi
+bash "$COMATE" state <name> check design
+```
+
+**幂等性**：design 阶段操作可安全重试。若 `handoff_context` 和 `handoff_hash` 已存在，先确认与当前产物一致再决定是否重新生成。
+
+### 1a. 生成 OpenSpec → Superpowers 交接包
+
+**必须由脚本生成，不允许 agent 临场手写 summary 代替。**
+
+```bash
+bash "$COMATE" handoff <name> design --write
+```
+
+脚本生成 `openspec/changes/<name>/.comate/handoff/design-context.{json,md}` 并在 `.comate.yaml` 写入 `handoff_context` / `handoff_hash`。默认是 **compact 可追溯摘录**（含脚本标记 `Generated-by: comate`、source path、line range、sha256），不是 agent summary。需全文时加 `--full`。
+
+交接包来源：`proposal.md`、`design.md`、`tasks.md`、`specs/*/spec.md`。
+
+### 1b. 执行 Brainstorming（带上下文）
+
+**立即执行：** 使用 Skill 工具加载 `superpowers:brainstorming`，ARGUMENTS 包含：
+
+```
+Change: <name>
+OpenSpec Context Pack: openspec/changes/<name>/.comate/handoff/design-context.md
+Machine handoff: openspec/changes/<name>/.comate/handoff/design-context.json
+
+OpenSpec 产物是上游事实源，不要重新定义需求，不要重写 proposal/spec。
+基于交接包做深度技术设计：实现方案、技术风险、测试策略、边界条件。
+如发现 delta spec 缺少验收场景，只能提出 Spec Patch 回写 OpenSpec delta spec；不要在 Design Doc 中创建第二份需求 spec。
+
+Design Doc frontmatter 必须最小化，只含：
+---
+comate_change: <name>
+role: technical-design
+canonical_spec: openspec
+---
+```
+
+禁止跳过；该技能不可用时停止流程并提示安装 Superpowers，不要用普通对话替代。
+
+brainstorming 阶段不写 Design Doc 文件，仅产出方案供 Step 1c 确认。
+
+### 1c. 用户确认设计方案（决策阻塞点 2）
+
+**必须使用 AskUserQuestion 工具暂停等待用户明确确认设计方案**。规则见 `comate/reference/decision-points.md` 第 2 条。确认前不得创建最终 Design Doc、写 `design_doc`、跑 design guard 或进入 build。
+
+展示摘要：采用的技术方案、关键取舍与风险、测试策略、Spec Patch（如有）。用户确认后才继续 Step 2；要求调整则继续迭代。
+
+### 2. 更新 comate 状态
+
+```bash
+# 记录 design_doc 路径
+bash "$COMATE" state <name> set design_doc docs/superpowers/specs/YYYY-MM-DD-topic-design.md
+
+# 如有 delta spec 变更，重新生成 handoff 以更新 hash
+bash "$COMATE" handoff <name> design --write
+
+# 自动流转
+bash "$COMATE" guard <name> design --apply
+```
+
+无 delta spec 变更则跳过 handoff 重新生成。
+
+## 退出条件
+
+- Design Doc 已创建，frontmatter 含 `comate_change`、`role: technical-design`、`canonical_spec: openspec`
+- `handoff_context` / `handoff_hash` 已写入且 hash 与当前产物一致（guard 强制）
+- `design-context.md` 由脚本生成且含可追溯标记（guard 强制）
+- `design_doc` 已写入 `.comate.yaml`
+- **阶段守卫**：`bash "$COMATE" guard <name> design --apply` 全 PASS 后自动流转到 `phase: build`
+
+## 上下文压缩恢复
+
+```bash
+bash "$COMATE" state <name> recover design
+```
+
+脚本输出结构化恢复上下文，按 Recovery action 判断下一步。
+
+## 自动流转
+
+> **REQUIRED NEXT SKILL：** 调用 `comate-build` skill 进入计划与构建。

package/skills/comate-fix/SKILL.md

@@ -138,13 +138,15 @@ Fix 为**一次性连续执行**。调用后在自有步骤间自动推进，但
 | 需新增 capability | 超出局部优化 |
 | 需 delta spec | 影响已有规格 |
 
-**必须使用 AskUserQuestion 工具暂停确认升级**。用户确认后**先更新 workflow** 再走完整流程：
+**必须使用 AskUserQuestion 工具暂停确认升级**。用户确认后**先回退到 open 阶段并更新 workflow**，再走完整流程：
 
 ```bash
+bash "$COMATE" state <name> set phase open
 bash "$COMATE" state <name> set workflow full
+bash "$COMATE" state <name> transition open-complete
 ```
 
-然后**立即加载 `comate-design` skill** 补 Design Doc。用户不确认则停止 fix 并报告超出适用范围。
+此时 phase 已转换到 `design`（因为 workflow 是 full），然后**立即加载 `comate-design` skill** 补 Design Doc。用户不确认则停止 fix 并报告超出适用范围。
 
 ## 退出条件