sillyspec 3.27.6 → 3.27.7

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

@@ -1,67 +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 后直接提交（不需手动确认）
+---
+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/skills/sillyspec-continue/SKILL.md

@@ -1,47 +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 自动检测
-> 
-> 当前状态：[描述]
-> 下一步：[执行的命令]
-> 
-> [开始执行...]
+---
+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/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