@house365/comate 0.1.0 → 0.1.1

package/skills/comate-hotfix/SKILL.md

@@ -1,115 +1,115 @@
----
-name: comate-hotfix
-description: "comate 预设路径：Bug fix / 热修复。跳过 brainstorming，直接 open → build → verify → archive。适用于行为修复、不涉及新 capability 设计的场景。"
----
-
-# comate 预设路径：Hotfix
-
-快速 bug fix 工作流：open → build → verify → archive。跳过 brainstorming 和完整 plan。
-
-**适用条件**（必须全部满足）：
-1. 修复已有功能 bug，不新增 capability
-2. 不涉及接口变更或架构调整
-3. 改动范围可预估（通常 ≤ 2 文件）
-
-**不适用**：修复过程发现需架构调整时，升级为完整 `/comate`。
-
----
-
-## 流程（5 阶段）
-
-执行链路：open → build → verify → archive。先定位脚本：
-
-```bash
-COMATE="${COMATE:-$(for r in . ./.claude/skills "$HOME"/.claude/skills "$HOME"/.config/skills "$HOME"/.cursor/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
-```
-
-### 1. 快速开启（preset open）
-
-复用 open 能力但用 hotfix 默认值：不执行 `openspec-explore` 长探索，直接精简创建。
-
-**立即执行：** 使用 Skill 工具加载 `openspec-new-change`。按其指引创建精简产物：proposal.md（问题 + 根因 + 修复目标）、design.md（1 个修复方案）、tasks.md（修复任务）。**无需 delta spec**（除非修复改变已有 spec 验收场景）。
-
-```bash
-bash "$COMATE" state <name> init hotfix
-bash "$COMATE" state <name> check open
-bash "$COMATE" guard <name> open --apply
-```
-
-### 2. 直接构建（preset build）
-
-用 hotfix 默认值 `build_mode: direct`。跳过 `superpowers:brainstorming` 和 `superpowers:writing-plans`（除非任务 > 3，则转入 `/comate-build` 的计划与执行方式选择）。
-
-继续或开始修改前，按 `comate/reference/dirty-worktree.md` 处理未提交改动。归因后若发现超出 hotfix，按「升级条件」处理。
-
-**立即执行：** 按 tasks.md 逐个执行：读未完成任务 → 改代码 → 运行格式化命令 → 运行测试 → 勾选 `- [x]` → 提交（`fix: <简述>`）。全部完成后显式运行测试和构建命令。
-
-修复影响已有 spec 验收场景时，在 `specs/<capability>/spec.md` 创建仅含 `## MODIFIED Requirements` 的 delta spec。
-
-### 3. 根因消除检查
-
-**在运行 build guard 之前**：读 proposal.md 的 bug 与根因，搜索验证问题代码不再存在。根因未消除则回 Step 2 继续（仍在 build，无需状态回退）。
-
-升级条件命中（深层架构问题 / 需额外接口变更）→ 停止 hotfix，按升级条件阻塞确认。
-
-根因确认消除后，生成 build 交接包并流转：
-
-```bash
-bash "$COMATE" handoff <name> build --write
-bash "$COMATE" guard <name> build --apply
-```
-
-### 4. 验证（preset verify）
-
-**立即执行：** 使用 Skill 工具加载 `comate-verify`。由其规模评估决定轻量或完整验证。无 delta spec 的小 hotfix 通常走轻量验证。验证通过后按其规则记录 `verify_result: pass`。
-
-### 5. 归档（preset archive）
-
-**立即执行：** 使用 Skill 工具加载 `comate-archive`。归档前必须 `verify_result: pass`。有 delta spec 则同步到 main spec。
-
----
-
-## 连续执行模式
-
-<IMPORTANT>
-Hotfix 为**一次性连续执行**。调用后在自有步骤间自动推进，但以下必须暂停（决策点见 `comate/reference/decision-points.md`）：
-1. 命中升级条件（决策点 6）→ AskUserQuestion 确认升级
-2. 任务 > 3 转入 `/comate-build` 时的隔离和执行方式选择（决策点 3）
-3. comate-verify 的验证失败决策（决策点 4）和分支处理决策（决策点 5）
-
-执行顺序：快速开启 → 直接构建 → 根因消除检查 → 验证 → 归档 → 完成。
-</IMPORTANT>
-
----
-
-## 升级条件（决策阻塞点 6）
-
-满足**任一**即停止 hotfix 升级为完整 `/comate`：
-
-| 条件 | 说明 |
-|------|------|
-| 改动 **3+ 文件** | 超出单点修复 |
-| 架构变更 | 新模块、新接口、新依赖 |
-| 数据库 schema 变更 | 结构性调整 |
-| 引入新 public API | 修复产生新对外接口 |
-| 范围超出单一函数/模块 | 需多处协调 |
-
-**必须使用 AskUserQuestion 工具暂停确认升级**。不得直接进 `/comate-design`，不得自动补 Design Doc。用户确认后**先更新 workflow**：
-
-```bash
-bash "$COMATE" state <name> set workflow full
-```
-
-然后**立即加载 `comate-design` skill** 补 Design Doc，走完整流程。用户不确认则停止 hotfix 并报告超出适用范围。
-
-## 退出条件
-
-- Bug 已修复，测试通过，change 已归档
-- 如有 spec 变更已同步到 main spec
-- **阶段守卫**：build → verify 前 `bash "$COMATE" guard <name> build --apply`，verify → archive 按 `/comate-verify` 规则运行
+---
+name: comate-hotfix
+description: "comate 预设路径：Bug fix / 热修复。跳过 brainstorming，直接 open → build → verify → archive。适用于行为修复、不涉及新 capability 设计的场景。"
+---
+
+# comate 预设路径：Hotfix
+
+快速 bug fix 工作流：open → build → verify → archive。跳过 brainstorming 和完整 plan。
+
+**适用条件**（必须全部满足）：
+1. 修复已有功能 bug，不新增 capability
+2. 不涉及接口变更或架构调整
+3. 改动范围可预估（通常 ≤ 2 文件）
+
+**不适用**：修复过程发现需架构调整时，升级为完整 `/comate`。
+
+---
+
+## 流程（5 阶段）
+
+执行链路：open → build → verify → archive。先定位脚本：
+
+```bash
+COMATE="${COMATE:-$(for r in . ./.claude/skills "$HOME"/.claude/skills "$HOME"/.config/skills "$HOME"/.cursor/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
+```
+
+### 1. 快速开启（preset open）
+
+复用 open 能力但用 hotfix 默认值：不执行 `openspec-explore` 长探索，直接精简创建。
+
+**立即执行：** 使用 Skill 工具加载 `openspec-new-change`。按其指引创建精简产物：proposal.md（问题 + 根因 + 修复目标）、design.md（1 个修复方案）、tasks.md（修复任务）。**无需 delta spec**（除非修复改变已有 spec 验收场景）。
+
+```bash
+bash "$COMATE" state <name> init hotfix
+bash "$COMATE" state <name> check open
+bash "$COMATE" guard <name> open --apply
+```
+
+### 2. 直接构建（preset build）
+
+用 hotfix 默认值 `build_mode: direct`。跳过 `superpowers:brainstorming` 和 `superpowers:writing-plans`（除非任务 > 3，则转入 `/comate-build` 的计划与执行方式选择）。
+
+继续或开始修改前，按 `comate/reference/dirty-worktree.md` 处理未提交改动。归因后若发现超出 hotfix，按「升级条件」处理。
+
+**立即执行：** 按 tasks.md 逐个执行：读未完成任务 → 改代码 → 运行格式化命令 → 运行测试 → 勾选 `- [x]` → 提交（`fix: <简述>`）。全部完成后显式运行测试和构建命令。
+
+修复影响已有 spec 验收场景时，在 `specs/<capability>/spec.md` 创建仅含 `## MODIFIED Requirements` 的 delta spec。
+
+### 3. 根因消除检查
+
+**在运行 build guard 之前**：读 proposal.md 的 bug 与根因，搜索验证问题代码不再存在。根因未消除则回 Step 2 继续（仍在 build，无需状态回退）。
+
+升级条件命中（深层架构问题 / 需额外接口变更）→ 停止 hotfix，按升级条件阻塞确认。
+
+根因确认消除后，生成 build 交接包并流转：
+
+```bash
+bash "$COMATE" handoff <name> build --write
+bash "$COMATE" guard <name> build --apply
+```
+
+### 4. 验证（preset verify）
+
+**立即执行：** 使用 Skill 工具加载 `comate-verify`。由其规模评估决定轻量或完整验证。无 delta spec 的小 hotfix 通常走轻量验证。验证通过后按其规则记录 `verify_result: pass`。
+
+### 5. 归档（preset archive）
+
+**立即执行：** 使用 Skill 工具加载 `comate-archive`。归档前必须 `verify_result: pass`。有 delta spec 则同步到 main spec。
+
+---
+
+## 连续执行模式
+
+<IMPORTANT>
+Hotfix 为**一次性连续执行**。调用后在自有步骤间自动推进，但以下必须暂停（决策点见 `comate/reference/decision-points.md`）：
+1. 命中升级条件（决策点 6）→ AskUserQuestion 确认升级
+2. 任务 > 3 转入 `/comate-build` 时的隔离和执行方式选择（决策点 3）
+3. comate-verify 的验证失败决策（决策点 4）和分支处理决策（决策点 5）
+
+执行顺序：快速开启 → 直接构建 → 根因消除检查 → 验证 → 归档 → 完成。
+</IMPORTANT>
+
+---
+
+## 升级条件（决策阻塞点 6）
+
+满足**任一**即停止 hotfix 升级为完整 `/comate`：
+
+| 条件 | 说明 |
+|------|------|
+| 改动 **3+ 文件** | 超出单点修复 |
+| 架构变更 | 新模块、新接口、新依赖 |
+| 数据库 schema 变更 | 结构性调整 |
+| 引入新 public API | 修复产生新对外接口 |
+| 范围超出单一函数/模块 | 需多处协调 |
+
+**必须使用 AskUserQuestion 工具暂停确认升级**。不得直接进 `/comate-design`，不得自动补 Design Doc。用户确认后**先更新 workflow**：
+
+```bash
+bash "$COMATE" state <name> set workflow full
+```
+
+然后**立即加载 `comate-design` skill** 补 Design Doc，走完整流程。用户不确认则停止 hotfix 并报告超出适用范围。
+
+## 退出条件
+
+- Bug 已修复，测试通过，change 已归档
+- 如有 spec 变更已同步到 main spec
+- **阶段守卫**：build → verify 前 `bash "$COMATE" guard <name> build --apply`，verify → archive 按 `/comate-verify` 规则运行

package/skills/comate-open/SKILL.md

@@ -1,109 +1,109 @@
----
-name: comate-open
-description: "comate 阶段 1：开题。用 /comate-open 调用。通过 OpenSpec 探索想法、创建 change 结构（proposal + design + tasks）并初始化 .comate.yaml。"
----
-
-# comate 阶段 1：开题（Open）
-
-## 前置条件
-
-- 无活跃 change，或用户希望创建新 change
-
-## 步骤
-
-### 1. 探索想法
-
-**立即执行：** 使用 Skill 工具加载 `openspec-explore` 技能。禁止跳过。加载后按其指引自由探索问题空间。
-
-### 2. 创建 Change 结构 + 初始化状态
-
-**立即执行：** 使用 Skill 工具加载 `openspec-new-change` 技能。若用户意图未明确、需先形成建议，改为加载 `openspec-propose`。禁止跳过。
-
-**命名与范围守卫**：change name 必须用用户指定或经 AskUserQuestion 确认的名称，不得自动生成或推断。变更范围必须与用户描述一致，不得自行扩大或缩小。
-
-确认产物已创建：
-
-```
-openspec/changes/<name>/
-├── .openspec.yaml
-├── proposal.md       # Why + What：问题、目标、范围、非目标
-├── design.md         # How（高层）：架构决策、方案选型、数据流
-└── tasks.md          # 任务清单（勾选框）
-```
-
-定位 comate 脚本并初始化 `.comate.yaml`：
-
-```bash
-COMATE="${COMATE:-$(for r in . ./.claude/skills "$HOME"/.claude/skills "$HOME"/.config/skills "$HOME"/.cursor/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> init full
-```
-
-### 2b. 判定需求来源(源文件追踪)
-
-`state init` 默认写入 `source_kind: conversation`、`source_manifest: null`(需求由对话产生)。
-
-若本次需求来自 `docs/knowledge-base/` 下的一份或多份知识库文档,追踪它们以支持后续双向排查:
-
-```bash
-bash "$COMATE" sources <name> track docs/knowledge-base/<path>.md --note "<可选说明>"
-```
-
-- 追踪成功后 `source_kind` 自动改为 `file`,并在 `openspec/changes/<name>/.comate/sources.manifest` 钉住每个文件当时的 sha256 与 commit ref。
-- 仅 `docs/knowledge-base/` 范围内的文件可追踪;范围外文件会被跳过并提示,`source_kind` 保持 `conversation`,不影响流程。
-- 边追踪边产生:若开题时为对话来源、设计中途才拿到知识库文档,后续任意阶段补 `sources <name> track` 即可,无需回到 open。
-
-### 3. 入口状态验证
-
-```bash
-bash "$COMATE" state <name> check open
-```
-
-验证通过后继续 Step 4。失败时脚本输出具体原因。
-
-**幂等性**：open 阶段所有操作可安全重复。若 `.comate.yaml` 已是 `phase: open` 且三件套已存在，跳过已完成步骤，从第一个缺失步骤继续。
-
-### 4. 内容完整性检查
-
-逐个确认三个文件路径存在且非空：
-- **proposal.md**：问题背景、目标、范围、非目标
-- **design.md**：高层架构决策、方案选型、数据流
-- **tasks.md**：任务列表，每个任务有明确描述
-
-任一文件缺失或为空时，不得进入 Step 5 或执行守卫，必须回创建步骤补充。
-
-### 5. 用户审视确认（决策阻塞点 1）
-
-三件套完成且完整性检查通过后，**必须使用 AskUserQuestion 工具暂停等待用户确认**。规则见 `comate/reference/decision-points.md` 第 1 条。
-
-以单选题呈现摘要（proposal 问题/目标/范围、design 架构决策/选型、tasks 数量与关键任务）和选项：
-- 「确认，继续下一阶段」— 执行守卫流转
-- 「需要调整」— 附调整说明，修改后重新请求确认
-
-## 退出条件
-
-- 三件套已创建且内容完整
-- **用户已确认**
-- **阶段守卫**：运行 `bash "$COMATE" guard <name> open --apply`，全 PASS 后自动流转
-
-退出前必须 `--apply`，否则 `.comate.yaml` 停留在 `phase: open`，下阶段入口检查会失败。
-
-```bash
-bash "$COMATE" guard <name> open --apply
-```
-
-full 流程自动更新为 `phase: design`；hotfix/tweak 预设自动更新为 `phase: build`。
-
-## 自动流转
-
-用户确认后退出条件满足，自动流转：
-
-> **REQUIRED NEXT SKILL（完整流程）：** 调用 `comate-design` skill 进入深度设计。
->
-> hotfix/tweak 预设由对应预设 skill 控制后续流转（phase 直接进 build），不经过本节。
+---
+name: comate-open
+description: "comate 阶段 1：开题。用 /comate-open 调用。通过 OpenSpec 探索想法、创建 change 结构（proposal + design + tasks）并初始化 .comate.yaml。"
+---
+
+# comate 阶段 1：开题（Open）
+
+## 前置条件
+
+- 无活跃 change，或用户希望创建新 change
+
+## 步骤
+
+### 1. 探索想法
+
+**立即执行：** 使用 Skill 工具加载 `openspec-explore` 技能。禁止跳过。加载后按其指引自由探索问题空间。
+
+### 2. 创建 Change 结构 + 初始化状态
+
+**立即执行：** 使用 Skill 工具加载 `openspec-new-change` 技能。若用户意图未明确、需先形成建议，改为加载 `openspec-propose`。禁止跳过。
+
+**命名与范围守卫**：change name 必须用用户指定或经 AskUserQuestion 确认的名称，不得自动生成或推断。变更范围必须与用户描述一致，不得自行扩大或缩小。
+
+确认产物已创建：
+
+```
+openspec/changes/<name>/
+├── .openspec.yaml
+├── proposal.md       # Why + What：问题、目标、范围、非目标
+├── design.md         # How（高层）：架构决策、方案选型、数据流
+└── tasks.md          # 任务清单（勾选框）
+```
+
+定位 comate 脚本并初始化 `.comate.yaml`：
+
+```bash
+COMATE="${COMATE:-$(for r in . ./.claude/skills "$HOME"/.claude/skills "$HOME"/.config/skills "$HOME"/.cursor/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> init full
+```
+
+### 2b. 判定需求来源(源文件追踪)
+
+`state init` 默认写入 `source_kind: conversation`、`source_manifest: null`(需求由对话产生)。
+
+若本次需求来自 `docs/knowledge-base/` 下的一份或多份知识库文档,追踪它们以支持后续双向排查:
+
+```bash
+bash "$COMATE" sources <name> track docs/knowledge-base/<path>.md --note "<可选说明>"
+```
+
+- 追踪成功后 `source_kind` 自动改为 `file`,并在 `openspec/changes/<name>/.comate/sources.manifest` 钉住每个文件当时的 sha256 与 commit ref。
+- 仅 `docs/knowledge-base/` 范围内的文件可追踪;范围外文件会被跳过并提示,`source_kind` 保持 `conversation`,不影响流程。
+- 边追踪边产生:若开题时为对话来源、设计中途才拿到知识库文档,后续任意阶段补 `sources <name> track` 即可,无需回到 open。
+
+### 3. 入口状态验证
+
+```bash
+bash "$COMATE" state <name> check open
+```
+
+验证通过后继续 Step 4。失败时脚本输出具体原因。
+
+**幂等性**：open 阶段所有操作可安全重复。若 `.comate.yaml` 已是 `phase: open` 且三件套已存在，跳过已完成步骤，从第一个缺失步骤继续。
+
+### 4. 内容完整性检查
+
+逐个确认三个文件路径存在且非空：
+- **proposal.md**：问题背景、目标、范围、非目标
+- **design.md**：高层架构决策、方案选型、数据流
+- **tasks.md**：任务列表，每个任务有明确描述
+
+任一文件缺失或为空时，不得进入 Step 5 或执行守卫，必须回创建步骤补充。
+
+### 5. 用户审视确认（决策阻塞点 1）
+
+三件套完成且完整性检查通过后，**必须使用 AskUserQuestion 工具暂停等待用户确认**。规则见 `comate/reference/decision-points.md` 第 1 条。
+
+以单选题呈现摘要（proposal 问题/目标/范围、design 架构决策/选型、tasks 数量与关键任务）和选项：
+- 「确认，继续下一阶段」— 执行守卫流转
+- 「需要调整」— 附调整说明，修改后重新请求确认
+
+## 退出条件
+
+- 三件套已创建且内容完整
+- **用户已确认**
+- **阶段守卫**：运行 `bash "$COMATE" guard <name> open --apply`，全 PASS 后自动流转
+
+退出前必须 `--apply`，否则 `.comate.yaml` 停留在 `phase: open`，下阶段入口检查会失败。
+
+```bash
+bash "$COMATE" guard <name> open --apply
+```
+
+full 流程自动更新为 `phase: design`；hotfix/tweak 预设自动更新为 `phase: build`。
+
+## 自动流转
+
+用户确认后退出条件满足，自动流转：
+
+> **REQUIRED NEXT SKILL（完整流程）：** 调用 `comate-design` skill 进入深度设计。
+>
+> hotfix/tweak 预设由对应预设 skill 控制后续流转（phase 直接进 build），不经过本节。