sillyspec 3.27.2 → 3.27.5

package/.claude/skills/sillyspec-execute/SKILL.md

@@ -176,6 +176,7 @@ execute 还有**第二道**独立的 stage 级审查：除逐 task review.json
 ```bash
 sillyspec worktree apply <变更名>              # 校验并应用 worktree 变更到主工作区
 sillyspec worktree apply <变更名> --check-only # 只检查不应用
+sillyspec worktree apply <变更名> --skip-overlap # 主仓有并行在途变更时：跳过重叠文件，只应用非重叠子集
 sillyspec worktree assess <变更名>             # 风险审计 + 自动 apply
 sillyspec worktree list                        # 列出所有活跃 worktree
 sillyspec worktree meta <变更名>               # 读取 worktree meta.json
@@ -183,6 +184,13 @@ sillyspec worktree cleanup <变更名>            # 清理 worktree
 sillyspec worktree doctor [--fix]              # 健康检查 + 修复
 ```
 
+**apply 并发要点（多 agent 仓库）**：
+- **主仓互斥锁**：apply / worktree cleanup / 归档收尾共用主仓级互斥锁（`.sillyspec/.runtime/main-repo.lock`，10 分钟 stale）——两会话并发对主仓的写操作会报「主仓互斥锁被占用（持有者: pid=…, change=…, 操作=…）」并退出，等对方完成重试即可；确认持有进程已崩溃时按报错里的路径删锁。等待时长可用 env `SILLYSPEC_MAIN_REPO_LOCK_TIMEOUT_MS` 调短。
+- **`--skip-overlap`**：主仓有与本次变更**同文件**的未提交改动（并行会话在途变更）时，默认整批拦截；带 `--skip-overlap` 则只应用非重叠子集，重叠文件安全留在 worktree（不覆盖主仓在途改动），输出后续指引——主仓提交/stash 后重新 apply 只补剩余文件，或确认放弃后 `cleanup --force`。优先用这条路，别再走 rescue 手动 cp。
+- **`--merge` 冲突保留现场**：--merge 遇真冲突不再直接 abort——主仓保留 merge-in-progress（冲突标记 + MERGE_HEAD），按提示编辑冲突文件 → `git add` → `git commit` 完成合并即可（无需重跑 apply）；`git merge --abort` 可放弃。若主仓有未提交改动会被合并覆盖，git 会拒绝启动合并（无现场），按提示先 commit/stash 或改用 `--skip-overlap`。
+- **派生产物基线漂移提示**：apply 输出若警告「N 个变更文件在 worktree 基线后主仓已有新提交」——多 agent 并发仓中并行变更可能已把新内容合入主仓，你 worktree 里生成的产物（api-types/generated 等）是旧基线版本，apply 会覆盖已合入内容；**apply 后必须在新基线重跑一次生成命令**（如 gen:types）再验证。
+- **worktree 目录残留清理**：apply/cleanup 输出若提示「部分清理残留」——Windows 下**勿直接 rm -rf**（会穿透 node_modules junction 删主仓依赖）：先 `cmd /c rmdir "<worktree>\node_modules"` 解链（含子模块 junction）再删目录，或跑 `sillyspec worktree doctor --fix`。
+
 ## 阶段流转
 
 ```

package/.claude/skills/sillyspec-quick/SKILL.md

@@ -60,7 +60,7 @@ sillyspec run quick --done --change quick-<hash> --output "…"  # 完成该会
 | 参数 | 说明 |
 |---|---|
 | `--linked-changes none\|a,b` | **显式关联变更（取代 `--change`，推荐）**。none=不关联，a,b=关联列表 |
-| `--files a.js,b.js` | 显式声明本次允许修改的文件（边界保护 + 声明即归属：多 agent 并发仓防他者窗口文件混入 QUICKLOG 文件行，未声明窗口文件进「审计：」行追溯）。**中途可追加**：发现要改声明外文件（如新写的测试）时，带新增文件恢复会话即并入边界（追加不替换）——`sillyspec run quick --files <新增> --change <sessionId>`；不带 `--files` 恢复则边界原样保留 |
+| `--files a.js,b.js` | 显式声明本次允许修改的文件（边界保护 + 声明即归属：多 agent 并发仓防他者窗口文件混入 QUICKLOG 文件行，未声明窗口文件进「审计：」行追溯；**他向亦然**——其他 active 会话已声明的文件在你的 `--done` 审计中自动剔除归该会话，不再误拦、无需 `--force-baseline`）。**中途可追加**：发现要改声明外文件（如新写的测试）时，带新增文件恢复会话即并入边界（追加不替换）——`sillyspec run quick --files <新增> --change <sessionId>`；不带 `--files` 恢复则边界原样保留 |
 | `--file-notes "p::注 \|\| p::注"` | quick `--done` 用：QUICKLOG「文件：」行落盘为多行带括注 bullet（省事后手改文件行）。格式 `path::括注`，`\|\|` 分隔多条；**只随 step3 --done 同命令传**（CLI 短进程，step1/step2 传无效，不带到 step3） |
 | `--allow-new` | 允许新增文件（默认禁止，防意外创建） |
 | `--allow-delete` | 允许删除文件（默认 fail-closed，删除是破坏性操作；确认删除带此 flag 显式解锁） |
@@ -72,6 +72,7 @@ sillyspec run quick --done --change quick-<hash> --output "…"  # 完成该会
 `--done` 收尾时对比 step1 baseline 与当前 `git status`，拦「危险文件 / 新增文件 / 覆盖 baseline」。要点：
 
 - **并发其他会话的 `.sillyspec/changes/<非关联变更>/` 不再被本 quick 拦截**。quick 自己没有 `changes/` 目录，该路径下非关联内容视为并发会话的工作，整体放行（确定性审计无法区分「并发工作」与「本 quick 偷建变更」，后者这类意图软判定留给 sillyhub）。
+- **其他 active 会话已声明的文件自动豁免（`--files` 的他向语义）**。多 agent 并发时，并行 quick 会话 `--files` 显式声明的文件（如它的 `daemon/router.py`）出现在你的窗口内（它在你启动后改的、不在你的 baseline）——`--done` 审计自动剔除归该会话边界管，不再判危险 BLOCK、无需 `--force-baseline`。放行可见：输出 🔗 软警告逐文件列归属会话；若确系你的改动，恢复会话时 `--files` 追加声明；超 7 天未收尾的僵尸会话声明自动失效（`sillyspec run quick --cancel --change <他者会话ID>` 清理）。豁免只认他者**显式声明**——未声明的他者文件照旧走各门判定（漏声明的补 `--files`，危险文件仍需 `--force-baseline`）。
 - **关联变更的文件仍走审计**：reverse-sync 改自己关联变更的 `design.md` 会被拦，需 `--force-baseline` 显式确认。
 - **baseline 折叠目录前缀匹配**：step1 启动时整片 `changes/` 未跟踪会被 git 折叠成 `?? .sillyspec/changes/`（带尾斜杠 token）；审计时若该目录下文件被并发会话跟踪而展开成文件级路径，按尾斜杠 token 前缀放行其下所有文件，不误判。
 - **同文件并发 warn（advisory，不阻断）**：step1 启动时若你的某个 `allowedFile` 已在他者脏文件列表里（他者也改了这文件），--done 时 CLI 会比对当前内容 hash 与启动时录入的 hash——不一致（你也改了它）即判「同文件并发」并 warn：整文件 pathspec 提交会夹带他者 hunk。warn 给出分离指引（`git add -p <file>` 交互选你自己的 hunk，或 `git diff <file> > mine.patch` 编辑后 `git apply --cached mine.patch` 再 commit）。这**不阻断** --done（你可能有意整文件提交），看 warn 后自行决定是否分离。

package/.claude/worktrees/sillyspec-data-model-research/.claude/skills/sillyspec-archive/SKILL.md

@@ -0,0 +1,87 @@
+---
+name: sillyspec:archive
+description: 用于归档已验证完成的变更。适合用户说"归档、archive、收尾这个变更"。执行模块影响分析 + 同步模块文档 + 移动到 archive 目录 + 更新 ROADMAP。
+---
+
+## 何时使用
+
+- 用户说"归档、archive、收尾这个变更"
+- verify 已通过，把变更包归档沉淀
+- 5 步：任务完成度检查 → 模块影响分析 → 同步模块文档 → 确认归档 → 更新路线图
+
+> 🔧 模块影响分析步：先跑 `sillyspec module-impact --change <变更名>` 生成 module-impact.md 骨架——文件×模块归属按 `_module-map.yaml` paths 前缀匹配预填 + 未匹配文件清单，你只需逐行填「影响类型」与 review 标记（以 git diff 为准，真实 > 声明）；已存在不覆盖。
+
+## 多变更说明
+
+项目有多个活跃变更（`.sillyspec/changes/` 下有多个目录）时，所有 `sillyspec run` 命令需加 `--change <变更名>` 指定操作目标；只有一个变更时可省略（CLI 自动检测）。
+
+## 步骤生命周期（所有阶段通用）
+
+> `sillyspec archive` 是 `sillyspec run archive` 的顶层别名，两者等价。
+
+```bash
+sillyspec run archive                          # 输出当前步骤 prompt
+sillyspec run archive --done --output "摘要"   # 完成当前步骤
+sillyspec run archive --status                 # 查看阶段进度
+sillyspec run archive --skip                   # 跳过可选步骤
+sillyspec run archive --reset                  # 重置阶段（从头开始）
+sillyspec run archive --reopen --from-step N   # 重新打开已完成阶段修订（N=序号或名称）
+```
+
+## 通用参数（所有阶段适用）
+
+| 参数 | 说明 |
+|---|---|
+| `--change <名>` | 指定变更名（多活跃变更必填，单变更可省略自动检测） |
+| `--spec-dir <path>` | 指定规范目录（默认 `<项目>/.sillyspec`） |
+| `--non-interactive` | CI/脚本下禁用交互式 prompt |
+| `--skip-approval` | 跳过阶段转换/审批检查（不能跳产物校验 gate——review.json/文档产物硬校验仍在） |
+
+## archive 特有
+
+### `--confirm`（确认归档步骤必填）
+
+第 4 步「确认归档」由 CLI 执行目录移动，**必须带 `--confirm`**：
+
+```bash
+sillyspec run archive --done --confirm --output "确认归档"
+```
+
+不带 `--confirm` 时 CLI 回退步骤为 pending 并提示，不会误归档。
+
+### 归档前硬校验
+
+CLI 移动目录前会校验 `plan.md` 存在——缺失则 `exit(1)` 阻断（目录尚未移动，可补全后重试）。移动后校验 `design.md` / `module-impact.md`（缺失只告警，因目录已移动）。
+
+### 模块文档同步（第 3 步）
+
+第 3 步「sync-module-docs」会更新 `_module-map.yaml` + 模块卡片，**必须暂停等用户确认**：
+
+```bash
+sillyspec run archive --wait --reason "等待用户确认模块文档同步" --options "确认写入,跳过同步" --output "diff 摘要"
+sillyspec run archive --continue --answer "确认写入"
+```
+
+只有用户 `--continue --answer "确认写入"` 后才写入文件。
+
+### 归档结果
+
+归档后变更目录从 `changes/<名>/` 移到 `changes/archive/<名>/`，并从活跃列表注销。后续用 `/sillyspec:commit` 提交。
+
+## 阶段流转
+
+```
+verify → archive → git commit
+```
+
+archive 完成后，运行 `/sillyspec:commit` 提交归档结果（`git add .sillyspec/changes/`）。
+
+## 铁律
+
+- **必须用 exec 工具（shell）执行 CLI，不要自己编造流程**
+- 不要用 `mv`/`rename` 重命名变更目录，必须由 CLI 的「确认归档」步骤移动
+- 归档不可逆——确认前核对变更名、文件列表、module-impact.md
+- 完成后立即 `--done`，不跳过
+
+## 用户指令
+$ARGUMENTS

package/.claude/worktrees/sillyspec-data-model-research/.claude/skills/sillyspec-auto/SKILL.md

@@ -0,0 +1,93 @@
+---
+name: sillyspec:auto
+description: 自动模式 — 全流程自动推进（通用版）
+argument-hint: "<需求描述>"
+---
+
+## 交互规范
+
+**当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项以参数传入。** 不要用编号列表让用户手动输入数字。
+
+## 用法
+
+- `/sillyspec:auto 实现用户登录功能`
+- `/sillyspec:auto 修复搜索结果的排序问题`
+
+## 任务
+$ARGUMENTS
+
+---
+
+## 执行流程
+
+你是全流程编排器，按 brainstorm → plan → execute → verify 顺序自动推进。
+
+### 启动
+
+```bash
+sillyspec run auto --input "<用户需求>" [--mode <模式>]
+```
+
+2. 读取 CLI 输出的 step prompt（含角色描述）
+3. 执行 prompt 中的操作
+4. **记录 CLI 输出中显示的 Change 名称**（如 `Change: 2026-06-02-xxx`）
+
+### 步骤循环
+
+重复以下循环直到 CLI 输出"全部流程已完成"：
+
+1. **读取 CLI 输出的 step prompt**
+2. **判断是否需要用户确认：**
+   - prompt 含"请用户选择 / 等待用户回答 / 展示给用户 / 用户确认" → **暂停，等用户回复**
+   - 纯内部操作 → **直接执行**
+3. **执行 prompt 要求的操作**
+4. **完成后运行：**
+   ```bash
+   sillyspec run auto --done --change <变更名> --output "<你的摘要>"
+   ```
+   - ⚠️ **必须携带 `--change <变更名>`**，变更名来自启动时 CLI 输出的 `Change:` 字段
+   - **绝不使用 `--change default`**，除非 CLI 启动时明确显示的 Change 名称就是 `default`
+5. **读取 CLI 输出的下一步 prompt**，回到步骤 1
+
+### auto 参数
+
+| 参数 | 说明 |
+|---|---|
+| `--input "<需求>"` | 启动时传入用户需求 |
+| `--mode <模式>` | 显式指定流程模式（默认按复杂度自动分类） |
+| `--done --change <名> --output "..."` | 完成当前步骤（必带 --change） |
+| `--spec-dir <path>` | 指定规范目录 |
+| `--non-interactive` | CI/脚本下禁用交互 |
+
+## 阶段审核门控（Stage Review Gate）
+
+审核发生在 brainstorm / plan / execute 各阶段的 review 步骤，**分级由 CLI 按变更规模自动判定**（不是 agent 凭关键词或复杂度启发式判断）：
+
+- **tier=self**（变更 ≤3 文件）：当前 agent 自审，直接产 review.json。
+- **tier=independent**（变更 >3 文件）：必须派发**独立 QA 子代理**（独立上下文，不共享实现者分析）产 review.json。
+
+CLI 会在 review 步骤注入：完整 JSON schema 表 + 示例 + docHash 算法 + 自动决策 checklist（AC-001 起，逐条核验公共 API / schema / 鉴权 / 文件边界 / 依赖 / 核心模块 / 兼容性 / 业务等维度）。你按**实际注入的契约与 tier 指令**执行：
+
+- checklist 全 ✅ 且方案唯一合理 → AUTO_DECIDED，推进下一阶段
+- checklist 有 ❌（影响架构/数据/接口/权限/兼容性/业务）→ 暂停，用 AskUserQuestion 让用户选择
+
+**不要**自行编造"简单/中等/复杂 → N 个审核子代理"规则——审核子代理数量由 tier 决定（self=0 额外子代理，independent=1 个独立 QA），不是复杂度启发式；以 CLI 实际注入的 tier 与 checklist 为准。
+
+## 关键规则
+
+- 不要跳过任何步骤
+- 不要手动修改进度数据（SQLite 数据库）
+- 不要自动 commit，只 `git add`
+- 不要使用 npx
+- 不要编造不存在的 CLI 子命令
+- 遇到命令报错 → 展示错误，暂停等用户介入
+- **每次 `sillyspec run auto --done` 都必须携带 `--change <变更名>`**（= CLI 首次输出的 Change 名）
+
+## 异常处理
+
+- 命令执行失败 → 展示错误信息，暂停等待用户指示
+- 用户说"停止"/"暂停" → 立即停止，报告当前进度
+
+## 完成条件
+
+CLI 输出"全部流程已完成"后，输出完整流程总结，提示用户提交改动（`/sillyspec:commit`）。

package/.claude/worktrees/sillyspec-data-model-research/.claude/skills/sillyspec-brainstorm/SKILL.md

@@ -0,0 +1,114 @@
+---
+name: sillyspec:brainstorm
+description: 用于正式开始开发前的需求澄清和技术方案设计。适合用户提出新功能、新模块、架构调整、复杂改造，或说"先做需求分析、输出技术方案、创建变更前先梳理、帮我设计下"。产出结构化方案（design/proposal/requirements/tasks 四件套），但不直接写代码。
+---
+
+## 交互规范
+
+**当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项以参数传入。** 不要用编号列表让用户手动输入数字。
+
+## 何时使用
+
+- 用户提出新功能、新模块、架构调整、复杂改造
+- 用户说"先做需求分析、输出技术方案、创建变更前先梳理、帮我设计下"
+- 产出：`design.md` + `proposal.md` + `requirements.md` + `tasks.md`（四件套），不写代码
+
+## 多变更说明
+
+项目有多个活跃变更（`.sillyspec/changes/` 下有多个目录）时，所有 `sillyspec run` 命令需加 `--change <变更名>` 指定操作目标；只有一个变更时可省略（CLI 自动检测）。建议变更名格式：`YYYY-MM-DD-<简短描述>`。
+
+## 步骤生命周期（所有阶段通用）
+
+> `sillyspec brainstorm` 是 `sillyspec run brainstorm` 的顶层别名，两者等价。
+
+```bash
+sillyspec run brainstorm                       # 输出当前步骤 prompt
+sillyspec run brainstorm --done --output "摘要"     # 完成当前步骤（--input "用户原话" 记录输入）
+sillyspec run brainstorm --status              # 查看阶段进度
+sillyspec run brainstorm --skip                # 跳过可选步骤
+sillyspec run brainstorm --reset               # 重置阶段（从头开始）
+sillyspec run brainstorm --reopen --from-step N     # 重新打开已完成阶段修订（N=序号或名称）
+sillyspec run brainstorm --wait --reason "..." --options "A,B"   # 暂停等用户决策
+sillyspec run brainstorm --continue --answer "..."               # 恢复等待中的步骤
+sillyspec run brainstorm --done --answer "..." --output "..."    # 一步完成 wait+done
+```
+
+## 通用参数（所有阶段适用）
+
+| 参数 | 说明 |
+|---|---|
+| `--change <名>` | 指定变更名（多活跃变更必填，单变更可省略自动检测） |
+| `--spec-dir <path>` | 指定规范目录（默认 `<项目>/.sillyspec`） |
+| `--non-interactive` | CI/脚本下禁用交互式 prompt |
+| `--interactive` | 强制交互（即便 stdin 非 TTY） |
+| `--skip-approval` | 跳过阶段转换/审批检查（不能跳产物校验 gate——review.json/文档产物硬校验仍在） |
+
+## brainstorm 特有：requiresWait 步骤
+
+某些步骤（如"对话式探索与需求澄清"）需要用户输入。两种方式：
+
+> 自动去重：若前置 step 已对同一问题（waitReason 归一化后相同）确认过，后续重复 wait 会自动跳过，无需再 `--wait`。
+
+- **方式一（推荐）**：分步——先 `--wait` 记录等待，让用户亲眼看到 CLI 打出的选项再作答，再 `--continue --answer`，最后 `--done`：
+  ```bash
+  sillyspec run brainstorm --wait --change <名> --reason "等待用户回答" --output "探索问题"
+  sillyspec run brainstorm --continue --answer "用户回答" --change <名>
+  sillyspec run brainstorm --done --change <名> --output "需求已澄清"
+  ```
+- **方式二**：AI 自行与用户交互后，一步完成（仅在用户已在对话中明确给出答案、无需再走 CLI 等待展示时用）：
+  ```bash
+  sillyspec run brainstorm --done --change <名> --answer "用户回答" --output "需求已澄清"
+  ```
+
+> ⚠️ 两种方式都要求 `--answer` 是**用户真实的回答**，不是你替用户编的回答。`requiresWait` 门只校验 `--answer` 非空，挡不住「AI 伪造用户回答」——所以对方案选择/设计确认这类关键决策，优先用方式一让用户亲手作答，而不是 AI 中继一句话带过。
+
+## 阶段流转
+
+```
+                ┌─ scale=large → plan（四件套齐）
+scan → brainstorm ┤
+                └─ scale=small → quick --linked-changes（仅 design.md）
+```
+
+brainstorm 完成时按 design.md frontmatter 的 `scale` 分叉：
+- **large**（多文件/跨模块/有状态机或 schema 变更）：四件套齐 + Design Grill 审查通过（tier=independent 时由独立审查子代理产出 stage review.json）→ `sillyspec run plan --change <变更名>`
+- **small**（≤2 文件、单模块、无跨模块依赖）：仅生成 design.md → `sillyspec run quick --linked-changes <变更名>`
+
+> 规模由 AI 在 brainstorm 最后一步评估并写入 design.md frontmatter。判错可手动改 `scale` 后再跑相应阶段。
+
+### Stage Review Gate（brainstorm 末尾的 design review.json）
+
+brainstorm 在 `tier=independent` 规模下除 design.md 等四件套外，还需产出一个 stage 级 `review.json`，CLI `Stage Review Gate` 硬校验其 schema 与 `docHash` 真实性。
+
+- 路径：`.sillyspec/.runtime/stage-reviews/brainstorm-review-<stage-review-run-id>/review.json`（目录可能不存在需手建；run-id 由该步 `--done` prompt 输出指定）。marker 文件 `.runtime/current-stage-review-run-id-brainstorm-<变更名>`。
+- **run-id / marker 由 CLI 自动生成注入**（review step prompt 渲染时 echo 完整目录路径 + 写 marker；撞 gate 报缺 review.json 时 gate 也 echo 完整路径 + 写 marker）。直接用 CLI 给的路径写 review.json，**勿手算 run-id（必须 `review-` 前缀）、勿手写 marker**。卡住时用 `sillyspec register-stage-review --change <名> --stage brainstorm` 一步生成。
+- 字段（`schemaVersion:1`，`reviewType=design` —— 区别于 execute 的 `acceptance`）：
+
+  ```json
+  {
+    "schemaVersion": 1,
+    "reviewType": "design",
+    "reviewedFiles": ["changes/<变更名>/design.md"],   // [0] 为主文档
+    "docHash": "<sha256(reviewedFiles[0] 文件内容，hex)>",
+    "specVerdict": "pass",       // pass | fail | cannot_verify
+    "qualityVerdict": "pass",    // pass | fail | cannot_verify
+    "checklist": [               // 扁平数组，逐条对照 design 章节核验
+      { "item": "背景与目标", "result": "pass", "note": "..." }   // result: pass | gap | fail
+    ],
+    "requiredEvidence": [],      // cannot_verify 时必填非空
+    "reviewerNotes": "..."
+  }
+  ```
+
+- `docHash` = `sha256(主审查文档内容)`（hex）—— brainstorm 主文档是 `design.md`（即 `reviewedFiles[0]`）。CLI 重算 sha256 比对，不符判伪造（fail-closed）。docHash 可先占位（如 "TODO"）；改 design.md 后勿手算 sha256——跑 `sillyspec register-stage-review --change <变更名> --stage brainstorm --refresh-hash` 一键重算代填（verdict 保留；design 改版多阶段联动加 --all）。`tier=self`（≤3 文件）降级为当前 agent 自审，不强制独立子代理。
+- 运行时 CLI 会把精确 schema 表 + 完整 JSON 示例 + docHash 算法注入到该步 prompt，以你实际收到的注入版契约为权威逐字模板。
+
+## 铁律
+
+- **必须用 exec 工具（shell）执行 CLI，不要自己编造流程**
+- 只做当前步骤 prompt 描述的操作，不跳过、不自行扩展
+- 产物写入 CLI 输出的 `changeDir` 目录（如 `<changeDir>/design.md`），不要自己拼路径
+- 完成后立即 `--done`，不跳过
+
+## 用户指令
+$ARGUMENTS

package/.claude/worktrees/sillyspec-data-model-research/.claude/skills/sillyspec-commit/SKILL.md

@@ -0,0 +1,67 @@
+---
+name: sillyspec:commit
+description: 智能提交 — 自动收集变更信息，生成 commit message
+argument-hint: "[可选：自定义 commit message]"
+version: "3.7.32"
+---
+
+## 交互规范
+当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项以参数传入。
+
+## 用法
+- /sillyspec:commit — 智能提交：自动收集变更信息，生成 commit message
+- /sillyspec:commit "自定义 message" — 使用指定 message 直接提交
+
+## 任务
+$ARGUMENTS
+
+---
+
+## 流程
+
+### 1. 收集变更上下文 + 建议 message（一条命令）
+
+```bash
+sillyspec commit
+```
+
+CLI 已接管全部手工收集（上次 commit 时间过滤 QUICKLOG 条目、活跃变更已勾 task、按路径模式归类阶段产出、diff stat），并按下方 type 表生成建议 message + 可照抄的 `git add -A && git commit -m ...` 命令。**它只建议不提交。**
+
+- 命令输出「没有需要提交的修改」→ 结束。
+- 无语义来源匹配（输出会明说）→ 展示 diff stat，让用户自己写。
+
+### 2. 展示确认
+
+把 `sillyspec commit` 的建议 message + 文件统计原样展示给用户（AskUserQuestion）：
+
+选择：确认提交 / 编辑 message / 取消
+
+用户选择编辑 → 让用户输入新 message → 再次确认。
+
+### 3. 执行提交
+
+用户确认后执行 `git add -A` + 输出里给出的 `git commit` 命令（或用户编辑后的 message）。
+
+提交成功后展示 commit hash + 文件数 + 行数统计。
+
+### 参考：message 生成口径（CLI 同源实现，src/commit-suggest.js）
+
+| 来源 | type | 示例 |
+|---|---|---|
+| 只有 quick 条目 | fix | fix: 手机号校验修复（含正则修正） |
+| 只有 execute 已勾 task | feat | feat: <变更名> 完成 task ×N |
+| 只有阶段产出 | docs | docs: sillyspec scan 完成 |
+| 混合来源 | 取最主要的 type | body 里列出所有条目 |
+| 无匹配来源 | — | 展示 diff stat，让用户自己写 |
+
+**如果 $ARGUMENTS 非空**，直接使用用户指定的 message，跳过自动生成，但仍展示 diff stat。
+
+## 多项目
+检查修改的文件分别属于哪个子项目：
+- 修改集中在一个子项目 → 在该子项目目录中 commit
+- 修改跨多个子项目 → 用 AskUserQuestion 让用户选择：分开提交（每个子项目一个 commit）/ 合并提交
+
+## 绝对规则
+- ❌ 不要自动提交，必须展示 message 让用户确认
+- ❌ 不要丢弃用户的修改
+- ✅ $ARGUMENTS 非空时展示 diff stat 后直接提交（不需手动确认）

package/.claude/worktrees/sillyspec-data-model-research/.claude/skills/sillyspec-continue/SKILL.md

@@ -0,0 +1,47 @@
+---
+name: sillyspec:continue
+description: 自动判断并执行下一步
+---
+
+---
+
+你现在是 SillySpec 的自动推进器。
+
+## 判断逻辑
+
+> 🔧 **先跑 `sillyspec next`**——CLI 已内置下方探测表（含活跃变更逐个推断 + task 勾选进度），输出「状态 + 下一步命令 + 依据」。直接按输出的建议命令执行；CLI 异常/输出与实际不符时才按下方手工表兜底。
+
+按顺序检查，第一个未完成的就执行：
+
+```
+1. 有 HANDOFF.json？→ 执行 /sillyspec:resume
+
+2. .sillyspec/changes/ 有进行中的变更？
+   2a. 没有任何文件 → 提示检查 proposal 是否需要完善
+   2b. 没有 design.md → 提示补充 design（运行 /sillyspec:brainstorm 推进到设计产物步）
+   2c. 没有 tasks.md → 执行 /sillyspec:brainstorm（规范文件 proposal/requirements/tasks 由 brainstorm 末步生成）
+   2d. 有 tasks.md 但没有 plan.md → 执行 /sillyspec:plan
+   2e. tasks.md 有未完成项 + 有计划文件 → 执行 /sillyspec:execute
+   2f. tasks.md 全完成 + 没验证 → 执行 /sillyspec:verify
+   2g. 已验证通过 → 执行 /sillyspec:archive
+
+3. 有设计文档但没有对应变更？
+   → 提示运行 /sillyspec:brainstorm（基于设计文档建立变更并生成规范文件）
+
+4. 有 .sillyspec/docs/*/scan/ 但没有进行中的工作？
+   → 提示运行 /sillyspec:brainstorm "你的想法"
+
+5. 什么都没有？
+   → 提示运行 /sillyspec:init（新项目）或 /sillyspec:scan（棕地项目）
+```
+
+## 输出
+
+先报告检测结果，再执行：
+
+> 🤖 SillySpec 自动检测
+> 
+> 当前状态：[描述]
+> 下一步：[执行的命令]
+> 
+> [开始执行...]

package/.claude/worktrees/sillyspec-data-model-research/.claude/skills/sillyspec-doctor/SKILL.md

@@ -0,0 +1,76 @@
+---
+name: sillyspec:doctor
+description: 用于 SillySpec 自检和状态修复。适合用户说"检查下状态、修复 progress、doctor、状态不对"。全量扫描进度一致性，修复进度数据与实际产出不匹配的问题。
+---
+
+## 何时使用
+
+- 用户说"检查下状态、修复 progress、doctor、状态不对"
+- 进度数据与实际产出不匹配时自检修复
+- 5 步：环境检查 → 项目配置 → 数据库完整性 → 状态一致性 → 修复建议
+
+## 前置检查
+
+**执行任何步骤前，先确认 SillySpec CLI 可用：**
+
+```bash
+sillyspec --version
+```
+
+失败则提示 `❌ SillySpec CLI 未安装` + 安装命令 `npm install -g sillyspec`，停止。
+
+## 步骤生命周期（所有阶段通用）
+
+> `sillyspec doctor` 是 `sillyspec run doctor` 的顶层别名，两者等价。
+
+```bash
+sillyspec run doctor                           # 输出当前步骤 prompt
+sillyspec run doctor --done --output "摘要"    # 完成当前步骤
+sillyspec run doctor --status                  # 查看阶段进度
+sillyspec run doctor --reset                   # 重置阶段（从头开始）
+```
+
+## 通用参数（所有阶段适用）
+
+| 参数 | 说明 |
+|---|---|
+| `--spec-dir <path>` | 指定规范目录（默认 `<项目>/.sillyspec`） |
+| `--non-interactive` | CI/脚本下禁用交互式 prompt |
+| `--json` | 输出 JSON（程序化读取） |
+
+## doctor 特有
+
+doctor 是辅助阶段，用于诊断而非推进流程。配套的轻量诊断命令（不经 run）：
+
+```bash
+sillyspec progress show                        # 查看当前进度
+sillyspec progress check                       # 状态一致性检查（只报告，不修复）
+sillyspec progress repair                      # 修复状态元数据（dry-run）
+sillyspec progress repair --apply              # 真正修复
+sillyspec progress validate                    # 校验并修复
+sillyspec worktree doctor [--fix]              # worktree 健康检查 + 修复
+sillyspec doctor --align-execute-progress --change <name>          # 按 plan.md 声明对齐 execute 派生戳（dry-run，只报告将补哪些 step）
+sillyspec doctor --align-execute-progress --change <name> --confirm # 实际落盘：补 step 戳 + 置 execute stage status=completed
+sillyspec doctor --cleanup-remnant                                  # 扫描并报告 0 字节空占位 db（dry-run）
+sillyspec doctor --cleanup-remnant --confirm                        # 实际删除空占位 db（仅删 0 字节，不动有内容的 db）
+sillyspec doctor --dump-db --path <db 路径>                         # dump 指定 db 内容到文件（取证，查 stages/steps/changes 表）
+sillyspec doctor --json                                             # 结构化诊断 + 落盘 .sillyspec/.runtime/doctor-diagnosis.json
+sillyspec runtime list                                              # 枚举 .sillyspec/.runtime/ 下所有运行时产物（只读，看手上有哪些证据/状态文件）
+```
+
+> `--align-execute-progress` 仅当 `plan.md` 所有 task checkbox 全勾时才对齐 execute 阶段进度戳。典型用于 worktree 已 cleanup（终态）但 execute 派生戳未盖上的死锁。默认 dry-run，加 `--confirm` 才写盘。doctor 信任 `plan.md` 声明、不复核代码，verify 阶段兜底。`--change` 缺省时按单活跃变更自动兜底。
+>
+> `--cleanup-remnant` 清理 init/平台切换残留的 0 字节空 db（占位但无数据）。默认 dry-run 只报告，`--confirm` 才删。绝不删有内容的 db。
+>
+> `runtime list` 是只读枚举：列出 `.sillyspec/.runtime/` 下的 db、doctor-diagnosis.json、workflow-runs/、user-inputs.md 等产物及用途。多会话/压缩后想知道「我手上有哪些证据文件」时用。加 `--json` 程序化读取。
+>
+> `doctor --json` 的 pointer_health 维度含 `pointer_missing_but_managed` 信号：项目根存在平台接管声明（`.sillyspec-platform-managed`）但恢复指针缺失——此状态下裸调命令会 fail-closed 拒绝静默落本地。恢复路径见信号文案：重跑平台 scan 重建指针 / `sillyspec platform disconnect` 彻底脱离 / 显式 `--spec-dir` 临时指定。
+
+## 铁律
+
+- **必须用 exec 工具（shell）执行 CLI，不要自己编造流程**
+- doctor 只诊断和建议，修复操作要让用户确认
+- 完成后立即 `--done`，不跳过
+
+## 用户指令
+$ARGUMENTS