@house365/comate 0.5.0 → 0.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@house365/comate",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "description": "comate —— OpenSpec + Superpowers 规约驱动的 AI 开发编排器（Agent Skills）",
   "type": "module",
   "license": "MIT",
@@ -41,11 +41,12 @@
     "node": ">=20"
   },
   "dependencies": {
+    "ccusage": "^20.0.19",
     "skills": "^1.5.21"
   },
   "scripts": {
     "postinstall": "node bin/postinstall.mjs",
-    "test": "node bin/init.test.mjs && bash skills/comate/tests/run.sh",
+    "test": "node bin/init.test.mjs && node bin/usage.test.mjs && bash skills/comate/tests/run.sh",
     "doctor": "cd skills && bash comate/scripts/comate.sh doctor",
     "prepublish-check": "node scripts/prepublish-check.mjs",
     "pack-check": "node scripts/pack-check.mjs",

package/skills/comate/SKILL.md

@@ -6,7 +6,7 @@ description: "comate —— OpenSpec + Superpowers 规格驱动开发编排器
 # comate —— OpenSpec + Superpowers 规格驱动开发流
 
 
-**核心原则：brainstorming 不可跳过。每个变更都必须经过深度设计（hotfix 和 tweak 预设除外）。**
+**核心原则：brainstorming 不可跳过。每个变更都必须经过深度设计（fix 预设除外）。**
 
 ---
 
@@ -18,18 +18,17 @@ agent 做决策只需读本节，其余参见末尾「参考附录」。决策
 
 **Step 0：活跃 change 发现 + 意图探测**
 
-1. 先探测预设；命中 hotfix/tweak 条件则直接调用对应预设 skill，不进入普通 open 分支。
+1. 先探测预设；命中 fix 条件则直接调用 `/comate-fix`，不进入普通 open 分支。
 2. 无预设命中时，运行 `openspec list --json` 获取所有活跃 change。
 
 **预设探测优先级最高**：
-- 用户明确描述 bug 修复/热修 + 满足 hotfix 条件 → 直接调用 `/comate-hotfix`
-- 用户明确描述文案/配置/文档/prompt 小调整 + 满足 tweak 条件 → 直接调用 `/comate-tweak`
-- **用户输入指向一份原始 PRD**（给了 PRD 路径/编号，或明确说「这是 PRD / 从这份需求文档开始」，典型路径 `docs/knowledge-base/**/PRD-*.md`）**且无对应活跃 change** → 直接调用 `/comate-intake`（阶段 0：先过门禁，再拆分建 change）。不要直接调 `/comate-open`——PRD 必须先过质量门禁。
+- 用户明确描述 bug 修复或文案/配置/文档/prompt 小调整 + 满足 fix 条件 → 直接调用 `/comate-fix`
+- **用户输入指向一份原始 PRD**（给了 PRD 路径/编号，或明确说「这是 PRD / 从这份需求文档开始」，典型路径 `docs/knowledge-base/**/PRD-*.md`）**且无对应活跃 change** → 直接调用 `/comate-gate`（阶段 0：先过门禁，再拆分建 change）。不要直接调 `/comate-open`——PRD 必须先过质量门禁。
 - 无预设命中 → 按下表处理
 
 | 活跃 change | 用户输入 | 行为 |
 |-------------|----------|------|
-| 无 | 指向原始 PRD | → 调用 `/comate-intake` |
+| 无 | 指向原始 PRD | → 调用 `/comate-gate` |
 | 无 | 非预设输入 | → 调用 `/comate-open` |
 | 恰好 1 个 | `/comate <描述>` | → **询问**：继续该 change 还是新建 |
 | 多个 | `/comate <描述>` | → **询问**：继续已有还是新建；继续则列出供选择 |
@@ -60,7 +59,7 @@ agent 做决策只需读本节，其余参见末尾「参考附录」。决策
 2. `verify_result: pass` 且 `archived` 非 `true` → 调用 `/comate-archive`
 3. `verify_result: fail` → 验证失败决策阻塞点（决策点 4）
 4. `phase: verify` 或 tasks.md 全勾 → 调用 `/comate-verify`
-5. `phase: build` 或有 Design Doc 但 plan/执行未完成 → 按 workflow 路由：`hotfix`→`/comate-hotfix`，`tweak`→`/comate-tweak`，`full`→`/comate-build`
+5. `phase: build` 或有 Design Doc 但 plan/执行未完成 → 按 workflow 路由：`fix`→`/comate-fix`，`full`→`/comate-build`
 6. `phase: design` 或有 change 但无 Design Doc → 调用 `/comate-design`
 7. `phase: open` 或有活跃 change 但 `.comate.yaml` 缺失 → 调用 `/comate-open`
 8. 无活跃 change → 调用 `/comate-open`
@@ -69,9 +68,7 @@ agent 做决策只需读本节，其余参见末尾「参考附录」。决策
 
 ### 预设升级判定
 
-**hotfix → full**（任一满足即升级）：改动 ≥ 3 文件 / 架构变更（新模块、新接口、新依赖）/ 数据库 schema 变更 / 引入新 public API / 范围超出单一函数模块。
-
-**tweak → full**（任一满足即升级）：改动 ≥ 5 文件 / 跨模块协调 / 需新增 ≥ 5 测试用例 / 配置项增删（非值修改）。
+**fix → full**：见 `/comate-fix` 的两种模式升级条件（bug 模式 3+ 文件 / 架构变更 / schema 变更 / 新 API / 跨模块；调整模式 5+ 文件 / 多模块协调 / 5+ 测试 / 配置项增删 / 新 capability / delta spec）。
 
 ### 错误处理速查
 
@@ -101,17 +98,17 @@ agent 做决策只需读本节，其余参见末尾「参考附录」。决策
 
 | 命令 | 阶段 | Owner | 产物 |
 |------|------|-------|------|
-| `/comate-intake` | 0. PRD 门禁与拆分 | Claude | `<PRD>.gate.yaml`, 评审报告, N 个 change |
+| `/comate-gate` | 0. PRD 门禁与拆分 | Claude | `<PRD>.gate.yaml`, 评审报告, N 个 change |
 | `/comate-open` | 1. 开题 | OpenSpec | proposal.md, design.md, tasks.md |
 | `/comate-design` | 2. 深度设计 | Superpowers | Design Doc, delta spec |
 | `/comate-build` | 3. 计划与构建 | Superpowers | 实施计划, 代码提交 |
 | `/comate-verify` | 4. 验证收尾 | 双方 | 验证报告, 分支处理 |
 | `/comate-archive` | 5. 归档 | OpenSpec | delta→main spec 同步, design doc 标注, 归档 |
-| `/comate-hotfix` | 预设 | 双方 | 快速修复（跳过 brainstorming） |
-| `/comate-tweak` | 预设 | 双方 | 小调整（跳过 brainstorming + 完整 plan） |
+| `/comate-fix` | 预设 | 双方 | 快速小改动（bug 修复 + 非 bug 调整，跳过 brainstorming） |
+| `/comate-kb-integration` | 工具 | Claude | 第三方对接档案(从官方文档 URL 生成 integrations 目录档案) |
 
 ```
-[原始 PRD] ──→ /comate-intake ──┐  (门禁+拆分，扇出 N 个 change)
+[原始 PRD] ──→ /comate-gate ──┐  (门禁+拆分，扇出 N 个 change)
                   (Claude)        │
 /comate                           ▼
   ↓ 自动探测
@@ -119,7 +116,7 @@ agent 做决策只需读本节，其余参见末尾「参考附录」。决策
   (OpenSpec)      (Superpowers)      (Superpowers)      (双方)            (OpenSpec)
 ```
 
-需求来自对话时从 `/comate-open` 起步；来自原始 PRD 时先过 `/comate-intake` 门禁再拆分。
+需求来自对话时从 `/comate-open` 起步；来自原始 PRD 时先过 `/comate-gate` 门禁再拆分。
 
 ---
 
@@ -142,7 +139,7 @@ fi
 之后全程复用 `$COMATE`：
 
 ```bash
-bash "$COMATE" state   <name> init <full|hotfix|tweak>
+bash "$COMATE" state   <name> init <full|fix>
 bash "$COMATE" state   <name> transition <event>
 bash "$COMATE" state   <name> check <phase> [--json]
 bash "$COMATE" state   <name> recover <phase>
@@ -167,10 +164,10 @@ bash "$COMATE" doctor
 | 字段 | 含义 |
 |------|------|
 | `schema_version` | 状态文件格式版本（当前 1） |
-| `workflow` | `full` / `hotfix` / `tweak` |
+| `workflow` | `full` / `fix` |
 | `phase` | `open` / `design` / `build` / `verify` / `archive` |
 | `build_mode` | `subagent-driven-development` / `executing-plans` / `direct` |
-| `tdd_mode` | `tdd` / `direct`（build→verify 前必须已选；hotfix/tweak 默认 `direct`） |
+| `tdd_mode` | `tdd` / `direct`（build→verify 前必须已选；fix 默认 `direct`） |
 | `isolation` | `branch` / `worktree`（build→verify 前必须已选） |
 | `verify_mode` | `light` / `full`（由 scale 评估写入） |
 | `verify_result` | `pending` / `pass` / `fail` |
@@ -187,7 +184,7 @@ bash "$COMATE" doctor
 - `build → verify` 前 `isolation` 必须为 `branch` 或 `worktree`
 - `build → verify` 前 `build_mode` 必须已选
 - `build → verify` 前 `tdd_mode` 必须为 `tdd` 或 `direct`
-- `build_mode: direct` 默认仅 hotfix/tweak；full 流程需 `direct_override: true`
+- `build_mode: direct` 默认仅 fix；full 流程需 `direct_override: true`
 - `verify → archive` 前 `verification_report` 指向真实文件、`branch_status: handled`、`impl_hash` 与当前 plan+tasks 一致
 
 ### 文件结构
@@ -212,7 +209,7 @@ docs/superpowers/                      # Superpowers —— HOW
 
 ### 最佳实践
 
-1. brainstorming 不可跳过（hotfix/tweak 除外）
+1. brainstorming 不可跳过（fix 除外）
 2. delta spec 是活文档，build 阶段随时改，归档时同步
 3. 交接包由脚本生成（`handoff`），guard 校验 source/hash/mode
 4. tasks.md 实时同步，每完成一个任务勾选并提交

package/skills/comate/reference/decision-points.md

@@ -55,9 +55,9 @@
    暂停请用户选择：本地合并 / 推送建 PR / 保持分支 / 丢弃工作。仅在用户选择且对应操作完成后，才写 `branch_status: handled`。
    引用：`comate-verify` Step 3。
 
-6. **预设升级确认**（hotfix / tweak → full）
-   命中升级条件（见各 preset SKILL 的「升级条件」表）时，暂停请用户确认升级为完整 `/comate`。不得直接进入 `/comate-design`，不得自动补 Design Doc。用户确认后先 `state set <name> workflow full` 再进入完整流程。
-   引用：`comate-hotfix` / `comate-tweak`「升级条件」。
+6. **预设升级确认**（fix → full）
+   命中升级条件（见 `comate-fix` SKILL 的「升级条件」，bug 模式与调整模式各有阈值）时，暂停请用户确认升级为完整 `/comate`。不得直接进入 `/comate-design`，不得自动补 Design Doc。用户确认后先 `state set <name> workflow full` 再进入完整流程。
+   引用：`comate-fix`「升级条件」。
 
 7. **构建期范围扩张**（build）
    实施中发现需要重新设计或拆分新 change 时暂停。判定基准：以 tasks.md 初始任务总数为准，新增任务超过总数一半（50% 阈值）即视为超范围，请用户决定是否拆分。中等规模（接口变更、新增组件）确认后加载 `superpowers:brainstorming` 更新设计；大规模（全新 capability）确认后用 `/comate-open` 拆独立 change。

package/skills/comate/reference/prerequisites.md

@@ -81,8 +81,7 @@ skills/
 ├── comate-build/SKILL.md   # 阶段 3
 ├── comate-verify/SKILL.md  # 阶段 4
 ├── comate-archive/SKILL.md # 阶段 5
-├── comate-hotfix/SKILL.md  # 预设
-└── comate-tweak/SKILL.md   # 预设
+├── comate-fix/SKILL.md     # 预设(bug + 调整)
 ```
 
 各 phase skill 通过 `*/comate/scripts/comate.sh` glob 定位脚本，共享 `comate/reference/*` 和 `comate/scripts/*`。若目标平台支持嵌套 skill 发现，也可改回 `comate/<phase>/SKILL.md` 子目录布局，纯命名调整，不影响脚本。

package/skills/comate/scripts/comate-lib.sh

@@ -4,7 +4,7 @@
 # Single source of truth for: YAML flat read/write, field-order template + enums,
 # hashing, logging, exit-code contract. Other scripts `source` this file.
 #
-# - all YAML logic lives here (Comet duplicated it across 4 scripts).
+# - all YAML logic lives here
 # - .comate.yaml is a declared flat `key: value` subset; validate_flat_yaml enforces it.
 # - yaml_set does full-rewrite + atomic mv + write-back verification.
 # - stable exit codes — 0 OK | 1 BLOCK | 2 USAGE | 3 ENV | 4 CORRUPT.
@@ -81,7 +81,7 @@ readonly COMATE_SCHEMA_VERSION=1
 # --- Enum table: key -> space-separated legal values ---
 declare -A ENUMS=(
   [schema_version]="1"
-  [workflow]="full hotfix tweak"
+  [workflow]="full fix"
   [phase]="open design build verify archive"
   [build_mode]="subagent-driven-development executing-plans direct"
   [tdd_mode]="tdd direct"
@@ -460,23 +460,40 @@ declare -A GATE_ENUMS=(
   [gate_status]="reviewing blocked passed passed-with-tbd stale"
 )
 
+# gate_stem_for <prd> — derive the short stem used to name a PRD's gate.yaml
+# and review report. A conforming PRD file is `PRD-<NNN>-<title>.md`, whose
+# gate/report drop the title and key off `PRD-<NNN>` (so one dir with
+# PRD-001/PRD-002 gets PRD-001.gate.yaml / PRD-002.gate.yaml). Non-conforming
+# names (no PRD-NNN prefix) fall back to the full basename so callers still get
+# a stable, collision-free stem instead of an error.
+gate_stem_for() {
+  local base
+  base=$(basename "$1")
+  base="${base%.markdown}"
+  base="${base%.md}"
+  if [[ "$base" =~ ^([Pp][Rr][Dd]-[0-9]+) ]]; then
+    echo "${BASH_REMATCH[1]}"
+  else
+    echo "$base"
+  fi
+}
+
 # gate_path_for <prd> — echo the gate.yaml path adjacent to the PRD.
-# Strips a trailing .md/.markdown and appends .gate.yaml.
+# Named `<stem>.gate.yaml` where stem is PRD-<NNN> (see gate_stem_for).
 gate_path_for() {
-  local prd="$1" base
-  base="${prd%.markdown}"
-  base="${base%.md}"
-  echo "${base}.gate.yaml"
+  local prd="$1" dir stem
+  dir=$(dirname "$prd")
+  stem=$(gate_stem_for "$prd")
+  echo "${dir}/${stem}.gate.yaml"
 }
 
 # gate_report_for <prd> — echo the review report path (PRD same dir).
+# Named `<stem>-REVIEW.md` where stem is PRD-<NNN> (see gate_stem_for).
 gate_report_for() {
-  local prd="$1" dir base
+  local prd="$1" dir stem
   dir=$(dirname "$prd")
-  base=$(basename "$prd")
-  base="${base%.markdown}"
-  base="${base%.md}"
-  echo "${dir}/PRD-REVIEW-${base}.md"
+  stem=$(gate_stem_for "$prd")
+  echo "${dir}/${stem}-REVIEW.md"
 }
 
 # gate_yaml_set <file> <key> <value> — gate-file analogue of yaml_set: validate

package/skills/comate/scripts/comate.sh

@@ -57,7 +57,7 @@ usage_top() {
   cat >&2 <<'EOF'
 Usage: comate.sh <command> ...
 
-  state   <name> init <workflow>            full | hotfix | tweak
+  state   <name> init <workflow>            full | fix
   state   <name> get <field>
   state   <name> set <field> <value>
   state   <name> transition <event>         open-complete|design-complete|build-complete|verify-pass|verify-fail|archived
@@ -102,7 +102,7 @@ state_init() {
   local name="$1" workflow="${2:-}"
   validate_change_name "$name"
   validate_enum workflow "$workflow"
-  [ -n "$workflow" ] || die "$COMATE_USAGE" "Usage: comate.sh state <name> init <full|hotfix|tweak>"
+  [ -n "$workflow" ] || die "$COMATE_USAGE" "Usage: comate.sh state <name> init <full|fix>"
 
   local dir yaml
   dir=$(comate_change_dir "$name")
@@ -128,7 +128,7 @@ state_init() {
   # Workflow defaults: full leaves decisions null; presets prefill.
   local build_mode="null" tdd_mode="null" isolation="null" verify_mode="null"
   case "$workflow" in
-    hotfix|tweak)
+    fix)
       build_mode="direct"; tdd_mode="direct"; isolation="branch"; verify_mode="light" ;;
   esac
 
@@ -212,8 +212,8 @@ _require_build_decisions() {
     subagent-driven-development|executing-plans|direct) ;;
     *) die "$COMATE_BLOCK" "ERROR: build_mode must be selected, got '${build_mode:-null}'" ;;
   esac
-  if [ "$build_mode" = "direct" ] && [ "$workflow" != "hotfix" ] && [ "$workflow" != "tweak" ] && [ "$direct_override" != "true" ]; then
-    die "$COMATE_BLOCK" "ERROR: build_mode=direct is only allowed for hotfix/tweak unless direct_override=true"
+  if [ "$build_mode" = "direct" ] && [ "$workflow" != "fix" ] && [ "$direct_override" != "true" ]; then
+    die "$COMATE_BLOCK" "ERROR: build_mode=direct is only allowed for fix unless direct_override=true"
   fi
   case "$tdd_mode" in
     tdd|direct) ;;
@@ -561,7 +561,7 @@ state_recover() {
       _field_status "isolation" "$isolation"
       _field_status "build_mode" "$build_mode"
       _field_status "tdd_mode" "$tdd_mode"
-      if [ "$build_mode" = "direct" ] && [ "$workflow" != "hotfix" ] && [ "$workflow" != "tweak" ]; then
+      if [ "$build_mode" = "direct" ] && [ "$workflow" != "fix" ]; then
         _field_status "direct_override" "$direct_override"
       fi
       echo ""
@@ -790,9 +790,9 @@ _g_build_mode_allowed() {
   build_mode=$(yaml_get "$G_YAML" build_mode)
   direct_override=$(yaml_get "$G_YAML" direct_override)
   [ "$build_mode" != "direct" ] && return 0
-  case "$workflow" in hotfix|tweak) return 0 ;; esac
+  case "$workflow" in fix) return 0 ;; esac
   [ "$direct_override" = "true" ] && return 0
-  echo "build_mode=direct only allowed for hotfix/tweak unless direct_override=true"
+  echo "build_mode=direct only allowed for fix unless direct_override=true"
   return 1
 }
 _g_tdd_mode_selected() {
@@ -1508,7 +1508,7 @@ gate_check() {
   local prd; prd=$(require_prd "$1")
   local gate; gate=$(gate_path_for "$prd")
   if [ ! -f "$gate" ]; then
-    die "$COMATE_BLOCK" "BLOCK: no gate for $prd — run /comate-intake to review the PRD before creating a change"
+    die "$COMATE_BLOCK" "BLOCK: no gate for $prd — run /comate-gate to review the PRD before creating a change"
   fi
   local st; st=$(yaml_get "$gate" gate_status)
   case "$st" in
@@ -1516,7 +1516,7 @@ gate_check() {
     *) die "$COMATE_BLOCK" "BLOCK: gate_status='$st' (not passed) — a change cannot be spawned until the PRD gate passes" ;;
   esac
   if _gate_is_stale "$gate" "$prd"; then
-    die "$COMATE_BLOCK" "BLOCK: PRD changed since it passed the gate (hash mismatch) — re-run /comate-intake to re-gate before spawning a change"
+    die "$COMATE_BLOCK" "BLOCK: PRD changed since it passed the gate (hash mismatch) — re-run /comate-gate to re-gate before spawning a change"
   fi
   log_pass "[GATE] check PASS ($st) — $prd"
   return "$COMATE_OK"

package/skills/comate/tests/comate.bats

@@ -50,21 +50,14 @@ seed_open() {
   [ "$(comate state demo get isolation)" = "null" ]
 }
 
-@test "init hotfix prefills preset defaults" {
-  comate state demo init hotfix
+@test "init fix prefills preset defaults" {
+  comate state demo init fix
   [ "$(comate state demo get build_mode)" = "direct" ]
   [ "$(comate state demo get tdd_mode)" = "direct" ]
   [ "$(comate state demo get isolation)" = "branch" ]
   [ "$(comate state demo get verify_mode)" = "light" ]
 }
 
-@test "init tweak prefills tdd direct" {
-  comate state demo init tweak
-  [ "$(comate state demo get build_mode)" = "direct" ]
-  [ "$(comate state demo get tdd_mode)" = "direct" ]
-  [ "$(comate state demo get isolation)" = "branch" ]
-}
-
 @test "init records base_ref and base_branch" {
   comate state demo init full
   run comate state demo get base_ref
@@ -155,14 +148,14 @@ seed_open() {
   [ "$(comate state demo get phase)" = "design" ]
 }
 
-@test "open-complete routes hotfix to build" {
-  comate state demo init hotfix
+@test "open-complete routes fix to build" {
+  comate state demo init fix
   comate state demo transition open-complete
   [ "$(comate state demo get phase)" = "build" ]
 }
 
 @test "build-complete blocked without isolation" {
-  comate state demo init hotfix
+  comate state demo init fix
   comate state demo transition open-complete
   comate state demo set isolation null >/dev/null
   run comate state demo transition build-complete
@@ -248,7 +241,7 @@ seed_open() {
 # --- build->verify drift ---
 
 @test "verify guard blocks when tasks change after build handoff" {
-  comate state demo init hotfix
+  comate state demo init fix
   local d="openspec/changes/demo"
   printf '# p\n' > "$d/proposal.md"; printf '# d\n' > "$d/design.md"; printf -- '- [x] t1\n' > "$d/tasks.md"
   comate guard demo open --apply >/dev/null 2>&1
@@ -422,7 +415,7 @@ SH
 }
 
 @test "build guard blocks when tracked source drifts" {
-  comate state demo init hotfix
+  comate state demo init fix
   local d="openspec/changes/demo"
   printf '# p\n' > "$d/proposal.md"; printf '# d\n' > "$d/design.md"; printf -- '- [x] t1\n' > "$d/tasks.md"
   mkdir -p docs/knowledge-base/cb
@@ -461,13 +454,25 @@ seed_prd() {
   local prd; prd=$(seed_prd)
   run comate gate "$prd" review
   [ "$status" -eq 0 ]
-  [ -f "docs/knowledge-base/requirements/test/PRD-001-demo.gate.yaml" ]
+  [ -f "docs/knowledge-base/requirements/test/PRD-001.gate.yaml" ]
+}
+
+@test "gate names key off PRD-NNN stem, dropping title" {
+  local prd; prd=$(seed_prd)
+  run comate gate "$prd" review
+  [ "$status" -eq 0 ]
+  # gate.yaml and review report drop the -demo title, key off PRD-001
+  [ -f "docs/knowledge-base/requirements/test/PRD-001.gate.yaml" ]
+  [ ! -f "docs/knowledge-base/requirements/test/PRD-001-demo.gate.yaml" ]
+  [[ "$output" == *"PRD-001-REVIEW.md"* ]]
+  grep -q "review_report: docs/knowledge-base/requirements/test/PRD-001-REVIEW.md" \
+    "docs/knowledge-base/requirements/test/PRD-001.gate.yaml"
 }
 
 @test "gate review writes reviewing status and pins prd_hash" {
   local prd; prd=$(seed_prd)
   comate gate "$prd" review >/dev/null
-  local gate="docs/knowledge-base/requirements/test/PRD-001-demo.gate.yaml"
+  local gate="docs/knowledge-base/requirements/test/PRD-001.gate.yaml"
   run comate gate "$prd" status
   [ "$status" -eq 0 ]
   [[ "$output" == *"reviewing"* ]]
@@ -509,7 +514,7 @@ seed_prd() {
   comate gate "$prd" set score 90 >/dev/null
   comate gate "$prd" set blocking_open 0 >/dev/null
   printf '# 评审报告\n' > \
-    "docs/knowledge-base/requirements/test/PRD-REVIEW-PRD-001-demo.md"
+    "docs/knowledge-base/requirements/test/PRD-001-REVIEW.md"
   run comate gate "$prd" pass
   [ "$status" -eq 0 ]
   run comate gate "$prd" check
@@ -522,7 +527,7 @@ seed_prd() {
   comate gate "$prd" set score 65 >/dev/null
   comate gate "$prd" set blocking_open 0 >/dev/null
   printf '# 评审报告\n' > \
-    "docs/knowledge-base/requirements/test/PRD-REVIEW-PRD-001-demo.md"
+    "docs/knowledge-base/requirements/test/PRD-001-REVIEW.md"
   run comate gate "$prd" pass --tbd
   [ "$status" -eq 0 ]
   run comate gate "$prd" status
@@ -535,7 +540,7 @@ seed_prd() {
   comate gate "$prd" set score 90 >/dev/null
   comate gate "$prd" set blocking_open 0 >/dev/null
   printf '# 评审报告\n' > \
-    "docs/knowledge-base/requirements/test/PRD-REVIEW-PRD-001-demo.md"
+    "docs/knowledge-base/requirements/test/PRD-001-REVIEW.md"
   comate gate "$prd" pass >/dev/null
   # mutate PRD after passing
   printf '\n额外内容\n' >> "$prd"
@@ -550,14 +555,14 @@ seed_prd() {
   comate gate "$prd" set score 90 >/dev/null
   comate gate "$prd" set blocking_open 0 >/dev/null
   printf '# 评审报告\n' > \
-    "docs/knowledge-base/requirements/test/PRD-REVIEW-PRD-001-demo.md"
+    "docs/knowledge-base/requirements/test/PRD-001-REVIEW.md"
   comate gate "$prd" pass >/dev/null
   printf '\n改动\n' >> "$prd"
   run comate gate "$prd" status
   [ "$status" -eq 0 ]
   [[ "$output" == *"stale"* ]]
   # gate.yaml should still say passed (status is computed, not written by status cmd)
-  local gate="docs/knowledge-base/requirements/test/PRD-001-demo.gate.yaml"
+  local gate="docs/knowledge-base/requirements/test/PRD-001.gate.yaml"
   local stored; stored=$(grep '^gate_status:' "$gate" | awk '{print $2}')
   [ "$stored" = "passed" ]
 }
@@ -568,11 +573,11 @@ seed_prd() {
   comate gate "$prd" set score 90 >/dev/null
   comate gate "$prd" set blocking_open 0 >/dev/null
   printf '# 报告\n' > \
-    "docs/knowledge-base/requirements/test/PRD-REVIEW-PRD-001-demo.md"
+    "docs/knowledge-base/requirements/test/PRD-001-REVIEW.md"
   comate gate "$prd" pass >/dev/null
   run comate gate "$prd" spawned login-flow
   [ "$status" -eq 0 ]
-  local gate="docs/knowledge-base/requirements/test/PRD-001-demo.gate.yaml"
+  local gate="docs/knowledge-base/requirements/test/PRD-001.gate.yaml"
   local sc; sc=$(grep '^spawned_changes:' "$gate" | sed 's/spawned_changes: //')
   [[ "$sc" == *"login-flow"* ]]
 }
@@ -583,11 +588,11 @@ seed_prd() {
   comate gate "$prd" set score 90 >/dev/null
   comate gate "$prd" set blocking_open 0 >/dev/null
   printf '# 报告\n' > \
-    "docs/knowledge-base/requirements/test/PRD-REVIEW-PRD-001-demo.md"
+    "docs/knowledge-base/requirements/test/PRD-001-REVIEW.md"
   comate gate "$prd" pass >/dev/null
   comate gate "$prd" spawned login-flow >/dev/null
   comate gate "$prd" spawned logout-flow >/dev/null
-  local gate="docs/knowledge-base/requirements/test/PRD-001-demo.gate.yaml"
+  local gate="docs/knowledge-base/requirements/test/PRD-001.gate.yaml"
   local sc; sc=$(grep '^spawned_changes:' "$gate" | sed 's/spawned_changes: //')
   [[ "$sc" == *"login-flow"* ]]
   [[ "$sc" == *"logout-flow"* ]]
@@ -612,7 +617,7 @@ seed_prd() {
   comate gate "$prd" set score 90 >/dev/null
   comate gate "$prd" set blocking_open 0 >/dev/null
   printf '# 报告\n' > \
-    "docs/knowledge-base/requirements/test/PRD-REVIEW-PRD-001-demo.md"
+    "docs/knowledge-base/requirements/test/PRD-001-REVIEW.md"
   comate gate "$prd" pass >/dev/null
   printf '\n改动\n' >> "$prd"
   # re-run review after PRD change — should reset to reviewing

package/skills/comate-build/SKILL.md

@@ -82,7 +82,7 @@ bash "$COMATE" state <name> set plan docs/superpowers/plans/YYYY-MM-DD-feature.m
 对仍有多个有效选项的维度，**一次 AskUserQuestion 问清全部**，选 `branch` 时**分支名也在同一次确认**，不得先问是否继续再二次追问配置或命名。已在 3b 自动写入的维度不再列入问题。每个选项附推荐理由（推荐只说明倾向，不代替用户拍板）：
 
 - **工作区隔离**：`branch` 新建分支（简单快速，≤3 文件推荐）/ `worktree` 独立工作区（需并行或当前分支有未提交工作时推荐）。
-- **执行方式**：`subagent-driven-development`（任务 ≥3、独立、需双阶段审查）/ `executing-plans`（任务 ≤2 且无跨模块依赖，或来自 hotfix）。
+- **执行方式**：`subagent-driven-development`（任务 ≥3、独立、需双阶段审查）/ `executing-plans`（任务 ≤2 且无跨模块依赖，或来自 fix 预设）。
 - **TDD 模式**：`tdd`（涉及业务逻辑/新功能/API，推荐）/ `direct`（无需测试覆盖或用户明确跳过）。
 
 用户选择后（连同 3b 已自动应用的维度）写入：
@@ -95,7 +95,7 @@ bash "$COMATE" state <name> set tdd_mode <tdd|direct>
 
 `isolation` 是脚本级硬约束，保持 `null` 时 `build → verify` 的 guard 和 `state transition build-complete` 都会失败。
 
-`build_mode: direct` 默认仅 hotfix/tweak 预设使用。full 流程只有用户明确要求跳过计划执行技能、且已记录显式 override 时才允许：
+`build_mode: direct` 默认仅 fix 预设使用。full 流程只有用户明确要求跳过计划执行技能、且已记录显式 override 时才允许：
 
 ```bash
 bash "$COMATE" state <name> set direct_override true
@@ -109,7 +109,7 @@ bash "$COMATE" state <name> set build_mode direct
 | 选项 | 含义 | 适用场景 |
 |------|------|---------|
 | `tdd` | 每个任务先写失败测试再实现 | 推荐。涉及业务逻辑、新功能、API 的改动 |
-| `direct` | 直接实现，不强制 TDD 流程 | 不需要测试覆盖的改动，或用户选择跳过测试直接写代码。hotfix/tweak 预设默认 `direct` |
+| `direct` | 直接实现，不强制 TDD 流程 | 不需要测试覆盖的改动，或用户选择跳过测试直接写代码。fix 预设默认 `direct` |
 
 `tdd_mode` 是脚本级硬约束，full 流程在离开 build 阶段前必须选择 `tdd` 或 `direct`，否则 guard 和 `state transition build-complete` 都会失败。