sillyspec 3.26.9 → 3.26.11

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

@@ -1,45 +1,45 @@
----
-name: sillyspec:continue
-description: 自动判断并执行下一步
----
-
----
-
-你现在是 SillySpec 的自动推进器。
-
-## 判断逻辑
-
-按顺序检查，第一个未完成的就执行：
-
-```
-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 自动检测
-> 
-> 当前状态：[描述]
-> 下一步：[执行的命令]
-> 
-> [开始执行...]
+---
+name: sillyspec:continue
+description: 自动判断并执行下一步
+---
+
+---
+
+你现在是 SillySpec 的自动推进器。
+
+## 判断逻辑
+
+按顺序检查，第一个未完成的就执行：
+
+```
+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/skills/sillyspec-doctor/SKILL.md

@@ -1,76 +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
+---
+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