sillyspec 3.20.3 → 3.20.5

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

@@ -1,111 +1,68 @@
----
-name: sillyspec:resume
-description: 恢复工作 — 从中断处继续
----
-
-## 交互规范
-
-**当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项以参数传入。**
-
-不要用编号列表让用户手动输入数字。
-如果需要自由输入，在 AskUserQuestion 的选项中加入"Other（自定义输入）"。
-
-你现在是 SillySpec 的恢复管理器。
-
-## 流程
-
-### 1. 读取 progress.json
-
-```bash
-sillyspec progress show 2>/dev/null
-```
-
-### 2. 如果有 progress.json
-
-直接从 progress.json 中提取并展示：
-
-> 🔄 工作状态恢复
->
-> **当前变更**：<名称>
-> **当前阶段**：<阶段名> <状态>
-> **下一步**：<命令>
->
-> **阶段进度**（大模块）：
-> | 阶段 | 状态 |
-> |---|---|
-> | stage-1 列表页 | ✅ |
-> | stage-2 表单页 | 🔄 execute (2/6) |
-> | stage-3 详情页 | ⬜ |
->
-> **关键决策**：
-> - xxx
->
-> **下一步命令**：
-> `/sillyspec:execute reward-punishment/stage-2`
-
-**不需要执行 Git 操作或文件探测。** progress.json 已经包含所有信息。
-
-使用 `sillyspec progress show` 查看。
-
-然后问用户：
-   1. 直接继续执行下一步
-   2. 查看更多细节
-
-### 3. 如果没有 progress.json
-
-**不要直接说"没有记录"。** 自动探测项目状态：
-
-```bash
-# 检查主变更
-ls .sillyspec/changes/*/MASTER.md 2>/dev/null
-
-# 检查活跃变更
-ls .d .sillyspec/changes/*/ | grep -v archive | grep -v stages | tail -1 2>/dev/null
-
-# 检查子阶段
-ls .sillyspec/changes/*/stages/*/proposal.md 2>/dev/null
-
-# 检查代码库文档
-ls .sillyspec/codebase/*.md 2>/dev/null
-
-# 检查计划文件
-ls -t .sillyspec/plans/*.md | head -1 2>/dev/null
-
-# 检查需求/路线图
-cat .sillyspec/REQUIREMENTS.md 2>/dev/null
-cat .sillyspec/ROADMAP.md 2>/dev/null
-```
-
-#### 如果检测到 MASTER.md（大模块）
-
-检查各阶段状态并输出阶段进度表（同步骤 2 格式）。
-
-同时**运行 `sillyspec progress init`**，将探测到的信息写入 progress.json，后续命令执行时会自动更新。
-
-#### 如果是普通变更（无 MASTER.md）
-
-根据探测结果推断：
-
-| 探测到的文件 | 推断阶段 | 建议操作 |
-|---|---|---|
-| 无任何 .sillyspec/ 内容 | 未开始 | `/sillyspec:init` 或 `/sillyspec:scan` |
-| 有 SCAN-RAW.md 但缺失文档 | 扫描中断 | `/sillyspec:scan --deep`（断点续扫） |
-| 有 codebase/ 但文档不全（快扫 3 份缺失） | 快扫中断 | `/sillyspec:scan`（补全缺失文档） |
-| 有 codebase/ 7 份齐全但无 changes/ | 已扫描，未开始需求 | `/sillyspec:brainstorm "想法"` |
-| 有 REQUIREMENTS.md 但无 changes/ | 绿地项目，已有需求 | `/sillyspec:brainstorm "想法"` |
-| changes/ 下有 proposal，无 tasks | 已有规范，待计划 | `/sillyspec:plan` |
-| changes/ 下有 tasks，有未完成 checkbox | 执行中 | `/sillyspec:execute` |
-| tasks.md 全部完成 | 待验证 | `/sillyspec:verify` |
-
-**扫描中断检测逻辑：**
-- 有 `SCAN-RAW.md` → 说明深度扫描预处理已完成，检查 7 份文档缺哪些
-- 有部分 codebase 文档（如只有 STACK 和 STRUCTURE）→ 说明快扫或深扫中断
-- 缺失的文档列表直接展示给用户，告知 `/sillyspec:scan` 会自动跳过已存在的文档
-
-**同时运行 `sillyspec progress init`** 记录推断的状态。
-
-### 4. 关键原则
-
-- **不需要 HANDOFF.json**。progress.json 是唯一的恢复数据源。
-- **progress.json 不需要 Git 提交**（已在 .runtime/ 下，被 .gitignore 忽略）。
-- **每次命令执行完自动更新 progress.json**（通过 `sillyspec progress` CLI），不需要用户手动保存。
+---
+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,17 +1,21 @@
----
-name: sillyspec:scan
-description: 代码扫描 — 分析项目结构、约定和架构
----
-
-## 执行
-
-**你必须使用 exec 工具（shell）执行以下命令，不要自己编造流程：**
-
-1. 运行 `sillyspec run scan` — 读取输出的步骤 prompt
-2. 按照输出的 prompt **严格执行**，不要跳过或自行添加步骤
-3. 步骤完成后，运行 `sillyspec run scan --done --output "你的摘要"`
-4. 重复 2-3 直到阶段完成
-5. **禁止**在没有运行 CLI 的情况下自行决定流程
-
-## 用户指令
-$ARGUMENTS
+---
+name: sillyspec:scan
+description: 用于扫描项目代码库，生成架构文档、代码约定、目录结构等。适合用户说"扫描项目、分析代码库、生成文档、scan"。产出 7 份扫描文档 + 模块映射。
+---
+
+## 多变更说明
+
+如果项目有多个活跃变更（`.sillyspec/changes/` 下有多个目录），所有 `sillyspec run` 命令需要加 `--change <变更名>`。只有一个变更时可省略（CLI 自动检测）。
+
+## 执行
+
+**你必须使用 exec 工具（shell）执行以下命令，不要自己编造流程：**
+
+1. 运行 `sillyspec run scan` — 读取输出的步骤 prompt
+2. 按照输出的 prompt **严格执行**，不要跳过或自行添加步骤
+3. 步骤完成后，运行 `sillyspec run scan --done --output "你的摘要"`
+4. 重复 2-3 直到阶段完成
+5. **禁止**在没有运行 CLI 的情况下自行决定流程
+
+## 用户指令
+$ARGUMENTS

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

@@ -1,54 +1,54 @@
----
-name: sillyspec:state
-description: 查看当前工作状态 — 显示 progress.json 内容
----
-
-你现在是 SillySpec 的状态查看器。
-
-## 流程
-
-### 1. 读取 progress.json
-
-```bash
-sillyspec progress show 2>/dev/null
-```
-
-### 2. 如果有 progress.json
-
-格式化展示当前状态：
-
-> 📊 当前状态
->
-> **变更**：<名称>
-> **阶段**：<当前阶段>
-> **进度**：<具体进度>
-> **下一步**：<命令>
->
-> **阶段进度**（大模块）：
-> （显示各阶段状态表）
->
-> **关键决策**：
-> - xxx
->
-> **阻塞项**：
-> - xxx（如无则省略）
-
-### 3. 如果没有 progress.json
-
-提示用户项目还没有开始，或 progress.json 尚未生成：
-
-> 📊 还没有工作记录。
->
-> 开始使用：
-> - 新项目：`/sillyspec:init`
-> - 已有项目：`/sillyspec:scan`
-> - 恢复中断的工作：`/sillyspec:resume`
->
-> progress.json 会在 `sillyspec init` 时自动创建。
-
-### 注意
-
-- 这是只读命令，**不修改任何文件**
-- `/sillyspec:status` 查看项目整体进度（change 文件级别）
-- `/sillyspec:state` 查看当前工作状态（progress.json 级别）
-- 两者互补：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 数据库中。
+
+### 注意
+
+- 这是只读命令，**不修改任何文件**
+- `/sillyspec:status` 查看项目整体进度（change 文件级别）
+- `/sillyspec:state` 查看当前工作状态（阶段/步骤级别）
+- 两者互补：status 看"有什么"，state 看"在做什么"

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

@@ -1,17 +1,21 @@
----
-name: sillyspec:status
-description: 查看项目进度和状态
----
-
-## 执行
-
-**你必须使用 exec 工具（shell）执行以下命令，不要自己编造流程：**
-
-1. 运行 `sillyspec run status` — 读取输出的步骤 prompt
-2. 按照输出的 prompt **严格执行**，不要跳过或自行添加步骤
-3. 步骤完成后，运行 `sillyspec run status --done --output "你的摘要"`
-4. 重复 2-3 直到阶段完成
-5. **禁止**在没有运行 CLI 的情况下自行决定流程
-
-## 用户指令
-$ARGUMENTS
+---
+name: sillyspec:status
+description: 用于查看 SillySpec 当前进度和状态。适合用户说"看下状态、当前进度、status"。显示当前阶段、步骤完成度、活跃变更。
+---
+
+## 多变更说明
+
+如果项目有多个活跃变更（`.sillyspec/changes/` 下有多个目录），所有 `sillyspec run` 命令需要加 `--change <变更名>`。只有一个变更时可省略（CLI 自动检测）。
+
+## 执行
+
+**你必须使用 exec 工具（shell）执行以下命令，不要自己编造流程：**
+
+1. 运行 `sillyspec run status` — 读取输出的步骤 prompt
+2. 按照输出的 prompt **严格执行**，不要跳过或自行添加步骤
+3. 步骤完成后，运行 `sillyspec run status --done --output "你的摘要"`
+4. 重复 2-3 直到阶段完成
+5. **禁止**在没有运行 CLI 的情况下自行决定流程
+
+## 用户指令
+$ARGUMENTS

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

@@ -1,17 +1,21 @@
----
-name: sillyspec:verify
-description: 验证实现 — 对照规范检查 + 测试套件
----
-
-## 执行
-
-**你必须使用 exec 工具（shell）执行以下命令，不要自己编造流程：**
-
-1. 运行 `sillyspec run verify` — 读取输出的步骤 prompt
-2. 按照输出的 prompt **严格执行**，不要跳过或自行添加步骤
-3. 步骤完成后，运行 `sillyspec run verify --done --output "你的摘要"`
-4. 重复 2-3 直到阶段完成
-5. **禁止**在没有运行 CLI 的情况下自行决定流程
-
-## 用户指令
-$ARGUMENTS
+---
+name: sillyspec:verify
+description: 用于验证代码实现是否符合 design 和模块文档。适合用户说"验证下、检查下、跑 verify"。对照 design.md + 模块文档检查任务完成度、设计一致性、运行测试。
+---
+
+## 多变更说明
+
+如果项目有多个活跃变更（`.sillyspec/changes/` 下有多个目录），所有 `sillyspec run` 命令需要加 `--change <变更名>`。只有一个变更时可省略（CLI 自动检测）。
+
+## 执行
+
+**你必须使用 exec 工具（shell）执行以下命令，不要自己编造流程：**
+
+1. 运行 `sillyspec run verify` — 读取输出的步骤 prompt
+2. 按照输出的 prompt **严格执行**，不要跳过或自行添加步骤
+3. 步骤完成后，运行 `sillyspec run verify --done --output "你的摘要"`
+4. 重复 2-3 直到阶段完成
+5. **禁止**在没有运行 CLI 的情况下自行决定流程
+
+## 用户指令
+$ARGUMENTS