sillyspec 3.26.9 → 3.26.11

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

@@ -1,68 +1,68 @@
----
-name: sillyspec:resume
-description: 恢复工作 — 从中断处继续
----
-
-## 交互规范
-
-**当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项传入。**
-
-不要用编号列表让用户手动输入数字。
-如果需要自由输入，在 AskUserQuestion 的选项中加入"Other（自定义输入）"。
-
----
-
-你现在是 SillySpec 的恢复管理器。
-
-## 流程
-
-### 1. 读取进度
-
-```bash
-sillyspec progress show
-```
-
-### 2. 如果有活跃变更
-
-从 `sillyspec progress show` 输出中提取并展示当前状态。
-
-然后问用户：
-   1. 直接继续执行下一步
-   2. 查看更多细节
-
-### 3. 如果没有活跃变更
-
-自动探测项目状态：
-
-```bash
-# 检查活跃变更
-ls -d .sillyspec/changes/*/ | grep -v archive 2>/dev/null
-
-# 检查大需求拆分
-ls .sillyspec/changes/*/MASTER.md 2>/dev/null
-
-# 检查扫描文档
-ls .sillyspec/docs/*/scan/ 2>/dev/null | wc -l
-
-# 检查需求/路线图
-cat .sillyspec/REQUIREMENTS.md 2>/dev/null
-cat .sillyspec/ROADMAP.md 2>/dev/null
-```
-
-根据探测结果推断：
-
-| 探测到的文件 | 推断阶段 | 建议操作 |
-|---|---|---|
-| 无任何 .sillyspec/ 内容 | 未开始 | `/sillyspec:init` 或 `/sillyspec:scan` |
-| 有 docs/ 但缺失文档 | 扫描中断 | `/sillyspec:scan`（断点续扫） |
-| 有 docs/ 7 份齐全但无 changes/ | 已扫描，未开始需求 | `/sillyspec:brainstorm "想法"` |
-| 有 REQUIREMENTS.md 但无 changes/ | 绿地项目，已有需求 | `/sillyspec:brainstorm "想法"` |
-| changes/ 下有 proposal + design，无 plan.md | 已有规范，待计划 | `/sillyspec:plan` |
-| changes/ 下有 plan.md，tasks 有未完成项 | 执行中 | `/sillyspec:execute` |
-| tasks.md / plan.md 全部 checkbox 已勾选 | 待验证 | `/sillyspec:verify` |
-| 已验证通过 | 待归档 | `/sillyspec:archive` |
-
-### 4. 关键原则
-
-- 进度数据存储在 SQLite 数据库中（`.sillyspec/.runtime/sillyspec.db`），通过 `sillyspec progress show` 命令查看
-- 进度随 `sillyspec run <stage> --done` 自动更新，不需要手动保存
+---
+name: sillyspec:resume
+description: 恢复工作 — 从中断处继续
+---
+
+## 交互规范
+
+**当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项传入。**
+
+不要用编号列表让用户手动输入数字。
+如果需要自由输入，在 AskUserQuestion 的选项中加入"Other（自定义输入）"。
+
+---
+
+你现在是 SillySpec 的恢复管理器。
+
+## 流程
+
+### 1. 读取进度
+
+```bash
+sillyspec progress show
+```
+
+### 2. 如果有活跃变更
+
+从 `sillyspec progress show` 输出中提取并展示当前状态。
+
+然后问用户：
+   1. 直接继续执行下一步
+   2. 查看更多细节
+
+### 3. 如果没有活跃变更
+
+自动探测项目状态：
+
+```bash
+# 检查活跃变更
+ls -d .sillyspec/changes/*/ | grep -v archive 2>/dev/null
+
+# 检查大需求拆分
+ls .sillyspec/changes/*/MASTER.md 2>/dev/null
+
+# 检查扫描文档
+ls .sillyspec/docs/*/scan/ 2>/dev/null | wc -l
+
+# 检查需求/路线图
+cat .sillyspec/REQUIREMENTS.md 2>/dev/null
+cat .sillyspec/ROADMAP.md 2>/dev/null
+```
+
+根据探测结果推断：
+
+| 探测到的文件 | 推断阶段 | 建议操作 |
+|---|---|---|
+| 无任何 .sillyspec/ 内容 | 未开始 | `/sillyspec:init` 或 `/sillyspec:scan` |
+| 有 docs/ 但缺失文档 | 扫描中断 | `/sillyspec:scan`（断点续扫） |
+| 有 docs/ 7 份齐全但无 changes/ | 已扫描，未开始需求 | `/sillyspec:brainstorm "想法"` |
+| 有 REQUIREMENTS.md 但无 changes/ | 绿地项目，已有需求 | `/sillyspec:brainstorm "想法"` |
+| changes/ 下有 proposal + design，无 plan.md | 已有规范，待计划 | `/sillyspec:plan` |
+| changes/ 下有 plan.md，tasks 有未完成项 | 执行中 | `/sillyspec:execute` |
+| tasks.md / plan.md 全部 checkbox 已勾选 | 待验证 | `/sillyspec:verify` |
+| 已验证通过 | 待归档 | `/sillyspec:archive` |
+
+### 4. 关键原则
+
+- 进度数据存储在 SQLite 数据库中（`.sillyspec/.runtime/sillyspec.db`），通过 `sillyspec progress show` 命令查看
+- 进度随 `sillyspec run <stage> --done` 自动更新，不需要手动保存

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

@@ -1,79 +1,79 @@
----
-name: sillyspec:scan
-description: 用于扫描项目代码库，生成架构文档、代码约定、目录结构等。适合用户说"扫描项目、分析代码库、生成文档、scan"。产出 7 份扫描文档 + 模块映射。
----
-
-## 何时使用
-
-- 用户说"扫描项目、分析代码库、生成文档、scan"
-- 棕地项目首次接入 sillyspec，生成架构/约定/结构等基础文档
-- 产出 7 份 scan 文档（PROJECT/ARCHITECTURE/CONVENTIONS/STRUCTURE/INTEGRATIONS/TESTING/CONCERNS）+ 模块映射
-
-## 多变更说明
-
-scan 是辅助阶段，通常不需要 `--change`。但项目有多个活跃变更时，所有 `sillyspec run` 命令加 `--change <变更名>` 可指定操作目标。
-
-## 步骤生命周期（所有阶段通用）
-
-> `sillyspec scan` 是 `sillyspec run scan` 的顶层别名，两者等价。
-
-```bash
-sillyspec run scan                             # 输出当前步骤 prompt
-sillyspec run scan --done --output "摘要"      # 完成当前步骤
-sillyspec run scan --status                    # 查看阶段进度
-sillyspec run scan --skip                      # 跳过可选步骤
-sillyspec run scan --reset                     # 重置阶段（从头开始）
-```
-
-## 通用参数（所有阶段适用）
-
-| 参数 | 说明 |
-|---|---|
-| `--spec-dir <path>` | 指定规范目录（默认 `<项目>/.sillyspec`） |
-| `--non-interactive` | CI/脚本下禁用交互式 prompt |
-| `--skip-approval` | 跳过阶段转换/审批检查（不能跳产物校验 gate——review.json/文档产物硬校验仍在） |
-
-## scan 特有参数
-
-| 参数 | 说明 |
-|---|---|
-| `--quick` | 强制 quick profile（快速接入，仅 4 份核心文档，0 子代理） |
-| `--standard` | 强制 standard profile（压缩步骤，最多 1 子代理） |
-| `--deep` | 强制 deep profile（完整流程，不按规模裁剪） |
-| `--force-rescan` | 覆盖已有 scan 文档的保护（默认覆盖需 source_commit/updated_at 匹配） |
-| `--diff` | 增量漂移清单：`sillyspec scan diff`（或 `--diff` flag）算 source_commit..HEAD 的 A/D/M/R 四分类漂移，按 module-map paths 归模块，agent 据此定点补文档而非全量重扫（2026-08-16） |
-
-### scanProfile（显式选择优先，否则按规模自动裁剪）
-
-可用 `--quick` / `--standard` / `--deep` **显式指定 profile**（三档互斥，优先于自动判定）。
-不带 flag 时 CLI 按源码规模自动选择：
-
-| profile | 触发条件 | 行为 |
-|---|---|---|
-| quick | `--quick` 或 ≤30 文件 且 ≤80KB 且 ≤3 项目 | 3 步，0 子代理，4 份核心文档 |
-| standard | `--standard` 或 ≤200 文件 且 ≤800KB | 压缩步骤，最多 1 子代理 |
-| deep | `--deep` 或 大项目 | 完整流程 |
-
-> **平台快速接入**：对大项目用 `sillyspec run scan --quick`（含平台参数 `--spec-root`/`--workspace-id`/`--scan-run-id`）只生成 4 份核心文档完成接入，后续 `sillyspec run scan --deep` 覆盖升级为完整 7 份。quick 文档 frontmatter 标 `scan_depth: quick`，深度扫描识别后允许覆盖。
-
-### post-check
-
-scan 完成时 CLI **按 profile 校验文档齐全**：quick 模式只要求 4 份核心文档（PROJECT/ARCHITECTURE/CONVENTIONS/STRUCTURE），standard/deep 要求完整 7 份。缺失会设状态为 `failed_post_check`，阻断进入主流程下游（brainstorm/plan 等），需修复后重跑 scan。quick 模式带一条 informational warning（`quick_profile_notice`），状态落 `completed_with_warnings`，不阻断完成。
-
-## 阶段流转
-
-```
-(项目起点) → scan → brainstorm
-```
-
-scan 完成后，运行 `sillyspec run brainstorm "<需求>"` 开始具体变更的设计。
-
-## 铁律
-
-- **必须用 exec 工具（shell）执行 CLI，不要自己编造流程**
-- 只做当前步骤 prompt 描述的操作，不跳过
-- scan 文档写入 `{DOCS_ROOT}/scan/`（平台模式用占位符路径，不写裸 `.sillyspec/`）
-- 完成后立即 `--done`，不跳过
-
-## 用户指令
-$ARGUMENTS
+---
+name: sillyspec:scan
+description: 用于扫描项目代码库，生成架构文档、代码约定、目录结构等。适合用户说"扫描项目、分析代码库、生成文档、scan"。产出 7 份扫描文档 + 模块映射。
+---
+
+## 何时使用
+
+- 用户说"扫描项目、分析代码库、生成文档、scan"
+- 棕地项目首次接入 sillyspec，生成架构/约定/结构等基础文档
+- 产出 7 份 scan 文档（PROJECT/ARCHITECTURE/CONVENTIONS/STRUCTURE/INTEGRATIONS/TESTING/CONCERNS）+ 模块映射
+
+## 多变更说明
+
+scan 是辅助阶段，通常不需要 `--change`。但项目有多个活跃变更时，所有 `sillyspec run` 命令加 `--change <变更名>` 可指定操作目标。
+
+## 步骤生命周期（所有阶段通用）
+
+> `sillyspec scan` 是 `sillyspec run scan` 的顶层别名，两者等价。
+
+```bash
+sillyspec run scan                             # 输出当前步骤 prompt
+sillyspec run scan --done --output "摘要"      # 完成当前步骤
+sillyspec run scan --status                    # 查看阶段进度
+sillyspec run scan --skip                      # 跳过可选步骤
+sillyspec run scan --reset                     # 重置阶段（从头开始）
+```
+
+## 通用参数（所有阶段适用）
+
+| 参数 | 说明 |
+|---|---|
+| `--spec-dir <path>` | 指定规范目录（默认 `<项目>/.sillyspec`） |
+| `--non-interactive` | CI/脚本下禁用交互式 prompt |
+| `--skip-approval` | 跳过阶段转换/审批检查（不能跳产物校验 gate——review.json/文档产物硬校验仍在） |
+
+## scan 特有参数
+
+| 参数 | 说明 |
+|---|---|
+| `--quick` | 强制 quick profile（快速接入，仅 4 份核心文档，0 子代理） |
+| `--standard` | 强制 standard profile（压缩步骤，最多 1 子代理） |
+| `--deep` | 强制 deep profile（完整流程，不按规模裁剪） |
+| `--force-rescan` | 覆盖已有 scan 文档的保护（默认覆盖需 source_commit/updated_at 匹配） |
+| `--diff` | 增量漂移清单：`sillyspec scan diff`（或 `--diff` flag）算 source_commit..HEAD 的 A/D/M/R 四分类漂移，按 module-map paths 归模块，agent 据此定点补文档而非全量重扫（2026-08-16） |
+
+### scanProfile（显式选择优先，否则按规模自动裁剪）
+
+可用 `--quick` / `--standard` / `--deep` **显式指定 profile**（三档互斥，优先于自动判定）。
+不带 flag 时 CLI 按源码规模自动选择：
+
+| profile | 触发条件 | 行为 |
+|---|---|---|
+| quick | `--quick` 或 ≤30 文件 且 ≤80KB 且 ≤3 项目 | 3 步，0 子代理，4 份核心文档 |
+| standard | `--standard` 或 ≤200 文件 且 ≤800KB | 压缩步骤，最多 1 子代理 |
+| deep | `--deep` 或 大项目 | 完整流程 |
+
+> **平台快速接入**：对大项目用 `sillyspec run scan --quick`（含平台参数 `--spec-root`/`--workspace-id`/`--scan-run-id`）只生成 4 份核心文档完成接入，后续 `sillyspec run scan --deep` 覆盖升级为完整 7 份。quick 文档 frontmatter 标 `scan_depth: quick`，深度扫描识别后允许覆盖。
+
+### post-check
+
+scan 完成时 CLI **按 profile 校验文档齐全**：quick 模式只要求 4 份核心文档（PROJECT/ARCHITECTURE/CONVENTIONS/STRUCTURE），standard/deep 要求完整 7 份。缺失会设状态为 `failed_post_check`，阻断进入主流程下游（brainstorm/plan 等），需修复后重跑 scan。quick 模式带一条 informational warning（`quick_profile_notice`），状态落 `completed_with_warnings`，不阻断完成。
+
+## 阶段流转
+
+```
+(项目起点) → scan → brainstorm
+```
+
+scan 完成后，运行 `sillyspec run brainstorm "<需求>"` 开始具体变更的设计。
+
+## 铁律
+
+- **必须用 exec 工具（shell）执行 CLI，不要自己编造流程**
+- 只做当前步骤 prompt 描述的操作，不跳过
+- scan 文档写入 `{DOCS_ROOT}/scan/`（平台模式用占位符路径，不写裸 `.sillyspec/`）
+- 完成后立即 `--done`，不跳过
+
+## 用户指令
+$ARGUMENTS

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

@@ -1,64 +1,64 @@
----
-name: sillyspec:state
-description: 查看当前工作状态 — 显示 SillySpec 进度
----
-
-你现在是 SillySpec 的状态查看器。
-
-## 流程
-
-### 1. 读取进度
-
-```bash
-sillyspec progress show
-```
-
-### 2. 如果有活跃变更
-
-格式化展示当前状态：
-
-> 📊 当前状态
->
-> **变更**：<名称>
-> **阶段**：<当前阶段>
-> **进度**：<具体进度>
-> **下一步**：<命令>
->
-> **阶段进度**（大模块）：
-> （显示各阶段状态表）
->
-> **关键决策**：
-> - xxx
->
-> **阻塞项**：
-> - xxx（如无则省略）
-
-### 3. 如果没有活跃变更
-
-提示用户项目还没有开始：
-
-> 📊 还没有工作记录。
->
-> 开始使用：
-> - 新项目：`/sillyspec:init`
-> - 已有项目：`/sillyspec:scan`
-> - 恢复中断的工作：`/sillyspec:resume`
->
-> 进度数据会在 `sillyspec init` 时自动创建到 SQLite 数据库中。
-
-## progress 完整子命令（只读查询 / 诊断）
-
-```bash
-sillyspec progress show [--change <名>]    # 当前工作状态（本 skill 主命令）
-sillyspec progress check                   # 状态一致性检查（只报告，不修复）
-sillyspec progress repair                  # 修复状态元数据（dry-run，加 --apply 才真改）
-sillyspec progress validate                # 校验并修复
-sillyspec progress reset [--stage <阶段>]  # 重置进度（破坏性，慎用）
-```
-
-### 注意
-
-- 这是只读命令，**不修改任何文件**（repair/validate/reset 除外）
-- `/sillyspec:status` 查看项目整体进度（change 文件级别）
-- `/sillyspec:state` 查看当前工作状态（阶段/步骤级别）
-- 两者互补：status 看"有什么"，state 看"在做什么"
+---
+name: sillyspec:state
+description: 查看当前工作状态 — 显示 SillySpec 进度
+---
+
+你现在是 SillySpec 的状态查看器。
+
+## 流程
+
+### 1. 读取进度
+
+```bash
+sillyspec progress show
+```
+
+### 2. 如果有活跃变更
+
+格式化展示当前状态：
+
+> 📊 当前状态
+>
+> **变更**：<名称>
+> **阶段**：<当前阶段>
+> **进度**：<具体进度>
+> **下一步**：<命令>
+>
+> **阶段进度**（大模块）：
+> （显示各阶段状态表）
+>
+> **关键决策**：
+> - xxx
+>
+> **阻塞项**：
+> - xxx（如无则省略）
+
+### 3. 如果没有活跃变更
+
+提示用户项目还没有开始：
+
+> 📊 还没有工作记录。
+>
+> 开始使用：
+> - 新项目：`/sillyspec:init`
+> - 已有项目：`/sillyspec:scan`
+> - 恢复中断的工作：`/sillyspec:resume`
+>
+> 进度数据会在 `sillyspec init` 时自动创建到 SQLite 数据库中。
+
+## progress 完整子命令（只读查询 / 诊断）
+
+```bash
+sillyspec progress show [--change <名>]    # 当前工作状态（本 skill 主命令）
+sillyspec progress check                   # 状态一致性检查（只报告，不修复）
+sillyspec progress repair                  # 修复状态元数据（dry-run，加 --apply 才真改）
+sillyspec progress validate                # 校验并修复
+sillyspec progress reset [--stage <阶段>]  # 重置进度（破坏性，慎用）
+```
+
+### 注意
+
+- 这是只读命令，**不修改任何文件**（repair/validate/reset 除外）
+- `/sillyspec:status` 查看项目整体进度（change 文件级别）
+- `/sillyspec:state` 查看当前工作状态（阶段/步骤级别）
+- 两者互补：status 看"有什么"，state 看"在做什么"

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

@@ -1,54 +1,54 @@
----
-name: sillyspec:status
-description: 用于查看 SillySpec 当前进度和状态。适合用户说"看下状态、当前进度、status"。显示当前阶段、步骤完成度、活跃变更。
----
-
-## 何时使用
-
-- 用户说"看下状态、当前进度、status"
-- 查看项目整体进度：活跃变更、各阶段状态、步骤完成度
-
-## status vs state 分工
-
-- **`/sillyspec:status`**（本 skill）— 查看项目整体进度（change 文件级别、各阶段状态）。走 `sillyspec run status` 阶段。
-- **`/sillyspec:state`** — 查看当前工作状态（阶段/步骤级别、下一步建议）。走 `sillyspec progress show`。
-
-两者互补：status 看"有什么"，state 看"在做什么"。
-
-## 多变更说明
-
-status 是辅助阶段。项目有多个活跃变更时，加 `--change <变更名>` 查看指定变更的详情；不指定时汇总显示所有变更。
-
-## 步骤生命周期（所有阶段通用）
-
-> `sillyspec status` 是 `sillyspec run status` 的顶层别名，两者等价。status 是辅助阶段，只读。
-
-```bash
-sillyspec run status                           # 输出当前步骤 prompt
-sillyspec run status --done --output "摘要"    # 完成阶段
-sillyspec run status --status                  # 查看阶段状态
-```
-
-## 通用参数（所有阶段适用）
-
-| 参数 | 说明 |
-|---|---|
-| `--change <名>` | 指定变更名（多变更时查看指定变更详情） |
-| `--spec-dir <path>` | 指定规范目录（默认 `<项目>/.sillyspec`） |
-
-## 配套的只读查询命令（不经 run）
-
-```bash
-sillyspec progress show                        # 当前工作状态（阶段/步骤级）
-sillyspec progress show --change <名>          # 指定变更详情
-sillyspec progress check                       # 状态一致性检查
-```
-
-## 铁律
-
-- status 是只读阶段，**不修改任何文件**
-- **必须用 exec 工具（shell）执行 CLI**
-- 完成后立即 `--done`，不跳过
-
-## 用户指令
-$ARGUMENTS
+---
+name: sillyspec:status
+description: 用于查看 SillySpec 当前进度和状态。适合用户说"看下状态、当前进度、status"。显示当前阶段、步骤完成度、活跃变更。
+---
+
+## 何时使用
+
+- 用户说"看下状态、当前进度、status"
+- 查看项目整体进度：活跃变更、各阶段状态、步骤完成度
+
+## status vs state 分工
+
+- **`/sillyspec:status`**（本 skill）— 查看项目整体进度（change 文件级别、各阶段状态）。走 `sillyspec run status` 阶段。
+- **`/sillyspec:state`** — 查看当前工作状态（阶段/步骤级别、下一步建议）。走 `sillyspec progress show`。
+
+两者互补：status 看"有什么"，state 看"在做什么"。
+
+## 多变更说明
+
+status 是辅助阶段。项目有多个活跃变更时，加 `--change <变更名>` 查看指定变更的详情；不指定时汇总显示所有变更。
+
+## 步骤生命周期（所有阶段通用）
+
+> `sillyspec status` 是 `sillyspec run status` 的顶层别名，两者等价。status 是辅助阶段，只读。
+
+```bash
+sillyspec run status                           # 输出当前步骤 prompt
+sillyspec run status --done --output "摘要"    # 完成阶段
+sillyspec run status --status                  # 查看阶段状态
+```
+
+## 通用参数（所有阶段适用）
+
+| 参数 | 说明 |
+|---|---|
+| `--change <名>` | 指定变更名（多变更时查看指定变更详情） |
+| `--spec-dir <path>` | 指定规范目录（默认 `<项目>/.sillyspec`） |
+
+## 配套的只读查询命令（不经 run）
+
+```bash
+sillyspec progress show                        # 当前工作状态（阶段/步骤级）
+sillyspec progress show --change <名>          # 指定变更详情
+sillyspec progress check                       # 状态一致性检查
+```
+
+## 铁律
+
+- status 是只读阶段，**不修改任何文件**
+- **必须用 exec 工具（shell）执行 CLI**
+- 完成后立即 `--done`，不跳过
+
+## 用户指令
+$ARGUMENTS