sillyspec 3.20.2 → 3.20.3

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

@@ -1,12 +1,8 @@
 ---
 name: sillyspec:archive
-description: 用于归档已验证完成的变更。适合用户说"归档、archive、收尾这个变更"。执行模块影响分析 + 同步模块文档 + 移动到 archive 目录 + 更新 ROADMAP。
+description: 归档变更 — 规范沉淀，可追溯
 ---
 
-## 多变更说明
-
-如果项目有多个活跃变更（`.sillyspec/changes/` 下有多个目录），所有 `sillyspec run` 命令需要加 `--change <变更名>`。只有一个变更时可省略（CLI 自动检测）。
-
 ## 执行
 
 **你必须使用 exec 工具（shell）执行以下命令，不要自己编造流程：**

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

@@ -1,5 +1,4 @@
 ---
-name: sillyspec:auto
 description: 自动模式 — 全流程自动推进（通用版）
 argument-hint: "<需求描述>"
 ---
@@ -21,7 +20,6 @@ $ARGUMENTS
 1. 运行 `sillyspec run auto --input "<用户需求>"`
 2. 读取 CLI 输出的 step prompt（包含你的角色描述）
 3. 执行 prompt 中的操作
-4. **记录 CLI 输出中显示的 Change 名称**（如 `Change: 2026-06-02-xxx`）
 
 ### 步骤循环
 重复以下循环直到 CLI 输出"全部流程已完成"：
@@ -32,15 +30,12 @@ $ARGUMENTS
    - 纯内部操作 → **直接执行**
 3. **执行 prompt 要求的操作**
 4. **完成后运行** `sillyspec run auto --done --output "<你的摘要>"`
-   - ⚠️ **必须携带 --change <变更名>**，变更名来自启动时 CLI 输出的 `Change:` 字段
-   - 示例：`sillyspec run auto --done --change 2026-06-02-spec-bootstrap-agent-stream-interaction --output "摘要"`
-   - **绝不使用 `--change default`**，除非 CLI 启动时明确显示的 Change 名称就是 `default`
 5. **读取 CLI 输出的下一步 prompt**，回到步骤 1
 
 ### 阶段审核门控
 
 **brainstorm 完成后：**
-评估需求复杂度（基于 design.md 中的模块拆分、批量操作、多角色交互等特征），根据复杂度决定：
+评估需求复杂度（参考 brainstorm Step 5 的判断结果），根据复杂度决定：
 
 | 复杂度 | 审核策略 |
 |--------|---------|
@@ -68,12 +63,11 @@ $ARGUMENTS
 
 ### 关键规则
 - 不要跳过任何步骤
-- 不要手动修改进度数据（SQLite 数据库）
+- 不要手动修改 progress.json
 - 不要自动 commit，只 git add
 - 不要使用 npx
 - 不要编造不存在的 CLI 子命令
 - 遇到命令报错 → 展示错误，暂停等用户介入
-- **每次调用 `sillyspec run auto --done` 都必须携带 `--change <变更名>`**，变更名 = CLI 首次输出中显示的 Change 名称。如果 CLI 首次运行没有显示 Change 名称，从 progress 或用户输入中确认变更名后再调用
 
 ### 异常处理
 - 命令执行失败 → 展示错误信息，暂停等待用户指示

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

@@ -1,12 +1,8 @@
 ---
 name: sillyspec:brainstorm
-description: 用于正式开始开发前的需求澄清和技术方案设计。适合用户提出新功能、新模块、架构调整、复杂改造，或说"先做需求分析、输出技术方案、创建变更前先梳理、帮我设计下"。产出结构化方案，但不直接写代码。
+description: 需求探索 — 结构化头脑风暴，含技术方案输出（创建性工作前必用）
 ---
 
-## 多变更说明
-
-如果项目有多个活跃变更（`.sillyspec/changes/` 下有多个目录），所有 `sillyspec run` 命令需要加 `--change <变更名>`。只有一个变更时可省略（CLI 自动检测）。
-
 ## 执行
 
 **你必须使用 exec 工具（shell）执行以下命令，不要自己编造流程：**
@@ -17,28 +13,5 @@ description: 用于正式开始开发前的需求澄清和技术方案设计。
 4. 重复 2-3 直到阶段完成
 5. **禁止**在没有运行 CLI 的情况下自行决定流程
 
-## 特殊步骤：requiresWait
-
-某些步骤（如"对话式探索"）需要等待用户输入。AI agent 可以：
-
-- **方式一（推荐）**：通过自己的对话工具与用户交互，完成后直接 `--done --answer "用户回答"` 一步完成
-- **方式二**：先 `--wait` 记录等待状态，再 `--continue --answer "用户回答"`，最后 `--done`
-
-```bash
-# 一步完成 wait + done（AI agent 已自行与用户交互）
-sillyspec run brainstorm --done --change <变更名> --answer "信息够了，进入方案讨论" --output "需求已澄清"
-
-# 分步完成
-sillyspec run brainstorm --wait --change <变更名> --reason "等待用户回答" --output "探索问题"
-sillyspec run brainstorm --continue --answer "用户回答" --change <变更名>
-sillyspec run brainstorm --done --change <变更名> --output "需求已澄清"
-```
-
-## 注意
-- 推荐指定 `--change <变更名>`（格式：`YYYY-MM-DD-<简短描述>`），不指定时自动生成
-- 步骤 prompt 由 CLI 管理，不需要手动读取
-- 依赖 scan 阶段完成，CLI 会自动提醒
-- brainstorm 完成后，运行 `sillyspec run plan --change <变更名>` 进入实现计划
-
 ## 用户指令
 $ARGUMENTS

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

@@ -1,5 +1,4 @@
 ---
-name: sillyspec:commit
 description: 智能提交 — 自动收集变更信息，生成 commit message
 argument-hint: "[可选：自定义 commit message]"
 version: "3.7.32"
@@ -50,7 +49,7 @@ cat "$LATEST/tasks.md" 2>/dev/null
 
 来源 C — 阶段产出（scan/brainstorm/plan/archive 等）：
 检查 .sillyspec/ 下新增或修改的文件，根据路径识别来源阶段：
-- .sillyspec/docs/<project>/scan/*.md → scan 产出
+- docs/<project>/scan/*.md → scan 产出
 - changes/<name>/design.md → brainstorm 产出
 - changes/<name>/proposal.md → brainstorm 产出
 - changes/<name>/tasks.md → plan 产出
@@ -70,7 +69,7 @@ cat "$LATEST/tasks.md" 2>/dev/null
 | 混合来源 | 取最主要的 type | body 里列出所有条目 |
 | 无匹配来源 | — | 展示 diff stat，让用户自己写 |
 
-**如果 $ARGUMENTS 非空**，直接使用用户指定的 message，跳过自动生成，但仍展示 diff stat。
+**如果 $ARGUMENTS 非空**，直接使用用户指定的 message，跳过自动生成。
 
 多条 quick 合并规则：
 - 2 条以内 → 逐条列出
@@ -103,4 +102,4 @@ git commit -m "{确认后的 message}"
 ## 绝对规则
 - ❌ 不要自动提交，必须展示 message 让用户确认
 - ❌ 不要丢弃用户的修改
-- ✅ $ARGUMENTS 非空时展示 diff stat 后直接提交（不需手动确认）
+- ✅ $ARGUMENTS 非空时可跳过确认直接提交

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

@@ -18,15 +18,14 @@ description: 自动判断并执行下一步
    2a. 没有任何文件 → 提示检查 proposal 是否需要完善
    2b. 没有 design.md → 提示补充 design
    2c. 没有 tasks.md → 执行 /sillyspec:propose（补全规范）
-   2d. 有 tasks.md 但没有 plan.md → 执行 /sillyspec:plan
-   2e. tasks.md 有未完成项 + 有计划文件 → 执行 /sillyspec:execute
-   2f. tasks.md 全完成 + 没验证 → 执行 /sillyspec:verify
-   2g. 已验证通过 → 执行 /sillyspec:archive
+   2d. tasks.md 有未完成项 + 有计划文件 → 执行 /sillyspec:execute
+   2e. tasks.md 全完成 + 没验证 → 执行 /sillyspec:verify
+   2f. 已验证通过 → 执行 /sillyspec:archive
 
 3. 有设计文档但没有对应变更？
    → 提示运行 /sillyspec:propose <name>
 
-4. 有 .sillyspec/docs/*/scan/ 但没有进行中的工作？
+4. 有 docs/*/scan/ 但没有进行中的工作？
    → 提示运行 /sillyspec:brainstorm "你的想法"
 
 5. 什么都没有？

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

@@ -1,6 +1,6 @@
 ---
 name: sillyspec:doctor
-description: 用于 SillySpec 自检和状态修复。适合用户说"检查下状态、修复 progress、doctor、状态不对"。全量扫描进度一致性，修复进度数据与实际产出不匹配的问题。
+description: 项目自检 — 检查 CLI、配置、构建环境和外部依赖
 ---
 
 ## 前置检查
@@ -13,19 +13,10 @@ description: 用于 SillySpec 自检和状态修复。适合用户说"检查下
    - 给出安装命令：`npm install -g sillyspec`
    - 停止，不要继续后续步骤
 
-## 多变更说明
-
-如果项目有多个活跃变更（`.sillyspec/changes/` 下有多个目录），所有 `sillyspec run` 命令需要加 `--change <变更名>`。只有一个变更时可省略（CLI 自动检测）。
-
 ## 执行
 
-**CLI 可用后，使用 exec 工具（shell）执行以下命令，不要自己编造流程：**
-
-1. 运行 `sillyspec run doctor` — 读取输出的步骤 prompt
-2. 按照输出的 prompt **严格执行**，不要跳过或自行添加步骤
-3. 步骤完成后，运行 `sillyspec run doctor --done --output "你的摘要"`
-4. 重复 2-3 直到阶段完成
-5. **禁止**在没有运行 CLI 的情况下自行决定流程
+CLI 可用后，运行 `sillyspec run doctor`，按提示逐步执行。
+每步完成后运行 `sillyspec run doctor --done --output "摘要"`。
 
 ## 用户指令
 $ARGUMENTS

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

@@ -1,30 +1,17 @@
 ---
 name: sillyspec:execute
-description: 用于按 plan 执行代码实现。适合用户说"开始写代码、执行任务、跑 execute、开干"。按 plan.md 中的 Wave 和 Task 逐步实现，遵循 design.md 和模块文档。
+description: 波次执行 — 子代理并行 + 强制 TDD + 两阶段审查
 ---
 
-## 多变更说明
-
-如果项目有多个活跃变更（`.sillyspec/changes/` 下有多个目录），所有 `sillyspec run` 命令需要加 `--change <变更名>`。只有一个变更时可省略（CLI 自动检测）。
-
 ## 执行
 
 **你必须使用 exec 工具（shell）执行以下命令，不要自己编造流程：**
 
-1. 运行 `sillyspec run execute` — CLI 会自动创建 worktree 隔离环境，然后输出步骤 prompt
+1. 运行 `sillyspec run execute` — 读取输出的步骤 prompt
 2. 按照输出的 prompt **严格执行**，不要跳过或自行添加步骤
 3. 步骤完成后，运行 `sillyspec run execute --done --output "你的摘要"`
 4. 重复 2-3 直到阶段完成
 5. **禁止**在没有运行 CLI 的情况下自行决定流程
 
-## Worktree 隔离
-
-- CLI 启动 execute 阶段时**自动创建 git worktree**，AI agent 不需要手动创建
-- Worktree 路径在 Step 3（确认 worktree 路径）中输出，后续子代理的 cwd 必须设为该路径
-- **禁止跳过 worktree 或在主仓库直接写代码**
-- 如果 worktree 创建失败，CLI 会报错并退出，需要排查后再重试
-- **未提交的文件、dirty 状态等不影响 worktree 创建和进入，直接按 CLI 输出的 worktree 路径操作即可**
-- 不要自行检查 git 状态来判断是否可以进入 worktree，CLI 会自动处理
-
 ## 用户指令
 $ARGUMENTS

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

@@ -1,6 +1,6 @@
 ---
 name: sillyspec:explore
-description: 用于自由讨论、代码库调研、方案比较、画 ASCII 图、澄清问题。适合用户说"分析下、讨论下、看看怎么设计、先别写代码、调研一下、画个结构图、帮我再分析下"。只读，不修改文件，不实现功能。
+description: 自由思考模式 — 讨论、画图、调研，不写代码
 ---
 
 ## 交互规范
@@ -17,19 +17,6 @@ description: 用于自由讨论、代码库调研、方案比较、画 ASCII 图
 ## 话题
 $ARGUMENTS
 
-## 多变更说明
-
-如果项目有多个活跃变更（`.sillyspec/changes/` 下有多个目录），所有 `sillyspec run` 命令需要加 `--change <变更名>`。只有一个变更时可省略（CLI 自动检测）。
-
-## 执行
-
-**你必须先使用 exec 工具（shell）执行以下命令读取统一 CLI prompt：**
-
-1. 运行 `sillyspec run explore` — 读取输出的探索模式 prompt
-2. 按照输出的 prompt 和本技能约束执行探索
-3. 探索告一段落后，运行 `sillyspec run explore --done --input "<用户原始话题>" --output "你的摘要"`
-4. **禁止**在没有运行 CLI 的情况下自行决定流程
-
 ## 这是什么模式
 
 **探索模式用于思考，不用于实现。** 你可以读文件、搜代码、调查代码库，但绝对不能写代码或实现功能。如果用户要求实现，提醒他们先退出探索模式。

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

@@ -1,12 +1,8 @@
 ---
 name: sillyspec:plan
-description: 用于把 design 拆解为可执行的实现计划。适合用户说"拆任务、做计划、排 wave、规划实现步骤"。产出 plan.md（Wave 分组 + Task 列表 + 依赖关系）。
+description: 编写实现计划 — 2-5 分钟粒度，精确到文件路径和代码
 ---
 
-## 多变更说明
-
-如果项目有多个活跃变更（`.sillyspec/changes/` 下有多个目录），所有 `sillyspec run` 命令需要加 `--change <变更名>`。只有一个变更时可省略（CLI 自动检测）。
-
 ## 执行
 
 **你必须使用 exec 工具（shell）执行以下命令，不要自己编造流程：**
@@ -17,5 +13,40 @@ description: 用于把 design 拆解为可执行的实现计划。适合用户
 4. 重复 2-3 直到阶段完成
 5. **禁止**在没有运行 CLI 的情况下自行决定流程
 
+## 子代理并行优化（可选）
+
+当 CLI 进入"写任务蓝图 task-N.md"步骤时（Step 5 之后），可以用子代理并行加速：
+
+1. 读取 plan.md，统计任务数量
+2. 为每个 task-N.md 启动一个独立子代理
+3. 每个子代理的任务：
+   - 读取 design.md 和 plan.md
+   - 读取相关源文件
+   - 按格式要求写 task-N.md 并保存
+4. 所有子代理完成后，继续 CLI 的下一步（审查一致性）
+
+**子代理 prompt 模板：**
+```
+你是计划编写者。请为以下任务编写详细蓝图。
+
+任务：${taskName}
+变更目录：${changeDir}
+文件路径：${changeDir}/tasks/task-${taskNum}.md
+
+要求：
+1. 读取 design.md 和 plan.md 了解上下文
+2. 读取相关源文件了解现有代码
+3. 按以下格式编写任务蓝图并保存到文件：
+   - 修改文件列表
+   - 实现要求
+   - 接口定义/数据结构
+   - 边界处理
+   - 参考
+   - TDD 步骤
+   - 验收标准（checkbox）
+```
+
+**注意：** 手动跑 plan 时不用子代理（串行即可），auto skill 中建议用子代理并行。
+
 ## 用户指令
 $ARGUMENTS

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

@@ -3,10 +3,6 @@ name: sillyspec:propose
 description: 生成结构化规范 — proposal + design + tasks
 ---
 
-## 多变更说明
-
-如果项目有多个活跃变更（`.sillyspec/changes/` 下有多个目录），所有 `sillyspec run` 命令需要加 `--change <变更名>`。只有一个变更时可省略（CLI 自动检测）。
-
 ## 执行
 
 **你必须使用 exec 工具（shell）执行以下命令，不要自己编造流程：**

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

@@ -1,12 +1,8 @@
 ---
 name: sillyspec:quick
-description: 用于明确、低风险、范围很小的直接任务。适合用户说"直接改、快速修、顺手调整、改个文案、修个小 bug、更新一个文件、不要完整流程"。跳过 brainstorm/plan，但仍按 sillyspec quick 流程执行。
+description: 快速任务 — 跳过完整流程，直接做
 ---
 
-## 多变更说明
-
-如果项目有多个活跃变更（`.sillyspec/changes/` 下有多个目录），所有 `sillyspec run` 命令需要加 `--change <变更名>`。只有一个变更时可省略（CLI 自动检测）。
-
 ## 执行
 
 **你必须使用 exec 工具（shell）执行以下命令，不要自己编造流程：**

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

@@ -5,64 +5,107 @@ description: 恢复工作 — 从中断处继续
 
 ## 交互规范
 
-**当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项传入。**
+**当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项以参数传入。**
 
 不要用编号列表让用户手动输入数字。
 如果需要自由输入，在 AskUserQuestion 的选项中加入"Other（自定义输入）"。
 
----
-
 你现在是 SillySpec 的恢复管理器。
 
 ## 流程
 
-### 1. 读取进度
+### 1. 读取 progress.json
 
 ```bash
-sillyspec progress show
+sillyspec progress show 2>/dev/null
 ```
 
-### 2. 如果有活跃变更
-
-从 `sillyspec progress show` 输出中提取并展示当前状态。
+### 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. 如果没有活跃变更
+### 3. 如果没有 progress.json
 
-自动探测项目状态：
+**不要直接说"没有记录"。** 自动探测项目状态：
 
 ```bash
+# 检查主变更
+ls .sillyspec/changes/*/MASTER.md 2>/dev/null
+
 # 检查活跃变更
-ls -d .sillyspec/changes/*/ | grep -v archive 2>/dev/null
+ls .d .sillyspec/changes/*/ | grep -v archive | grep -v stages | tail -1 2>/dev/null
 
-# 检查大需求拆分
-ls .sillyspec/changes/*/MASTER.md 2>/dev/null
+# 检查子阶段
+ls .sillyspec/changes/*/stages/*/proposal.md 2>/dev/null
+
+# 检查代码库文档
+ls .sillyspec/codebase/*.md 2>/dev/null
 
-# 检查扫描文档
-ls .sillyspec/docs/*/scan/ 2>/dev/null | wc -l
+# 检查计划文件
+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` |
-| 有 docs/ 但缺失文档 | 扫描中断 | `/sillyspec:scan`（断点续扫） |
-| 有 docs/ 7 份齐全但无 changes/ | 已扫描，未开始需求 | `/sillyspec:brainstorm "想法"` |
+| 有 SCAN-RAW.md 但缺失文档 | 扫描中断 | `/sillyspec:scan --deep`（断点续扫） |
+| 有 codebase/ 但文档不全（快扫 3 份缺失） | 快扫中断 | `/sillyspec:scan`（补全缺失文档） |
+| 有 codebase/ 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` |
+| 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. 关键原则
 
-- 进度数据存储在 SQLite 数据库中（`.sillyspec/.runtime/sillyspec.db`），通过 `sillyspec progress show` 命令查看
-- 进度随 `sillyspec run <stage> --done` 自动更新，不需要手动保存
+- **不需要 HANDOFF.json**。progress.json 是唯一的恢复数据源。
+- **progress.json 不需要 Git 提交**（已在 .runtime/ 下，被 .gitignore 忽略）。
+- **每次命令执行完自动更新 progress.json**（通过 `sillyspec progress` CLI），不需要用户手动保存。

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

@@ -1,12 +1,8 @@
 ---
 name: sillyspec:scan
-description: 用于扫描项目代码库，生成架构文档、代码约定、目录结构等。适合用户说"扫描项目、分析代码库、生成文档、scan"。产出 7 份扫描文档 + 模块映射。
+description: 代码扫描 — 分析项目结构、约定和架构
 ---
 
-## 多变更说明
-
-如果项目有多个活跃变更（`.sillyspec/changes/` 下有多个目录），所有 `sillyspec run` 命令需要加 `--change <变更名>`。只有一个变更时可省略（CLI 自动检测）。
-
 ## 执行
 
 **你必须使用 exec 工具（shell）执行以下命令，不要自己编造流程：**

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

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

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

@@ -1,12 +1,8 @@
 ---
 name: sillyspec:status
-description: 用于查看 SillySpec 当前进度和状态。适合用户说"看下状态、当前进度、status"。显示当前阶段、步骤完成度、活跃变更。
+description: 查看项目进度和状态
 ---
 
-## 多变更说明
-
-如果项目有多个活跃变更（`.sillyspec/changes/` 下有多个目录），所有 `sillyspec run` 命令需要加 `--change <变更名>`。只有一个变更时可省略（CLI 自动检测）。
-
 ## 执行
 
 **你必须使用 exec 工具（shell）执行以下命令，不要自己编造流程：**

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

@@ -1,12 +1,8 @@
 ---
 name: sillyspec:verify
-description: 用于验证代码实现是否符合 design 和模块文档。适合用户说"验证下、检查下、跑 verify"。对照 design.md + 模块文档检查任务完成度、设计一致性、运行测试。
+description: 验证实现 — 对照规范检查 + 测试套件
 ---
 
-## 多变更说明
-
-如果项目有多个活跃变更（`.sillyspec/changes/` 下有多个目录），所有 `sillyspec run` 命令需要加 `--change <变更名>`。只有一个变更时可省略（CLI 自动检测）。
-
 ## 执行
 
 **你必须使用 exec 工具（shell）执行以下命令，不要自己编造流程：**

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

@@ -59,9 +59,9 @@ ls .sillyspec/projects/*.yaml 2>/dev/null | grep -q .
    name: <name>
    path: <relative-path>
    status: active
+   role: <description>
+   repo: <repo-url>  # 可选
    ```
-   > ⚠️ `sillyspec init` 只会写入 `name`、`path`、`status` 三个字段。
-   > `role` 和 `repo` 由 `/sillyspec:workspace add` 追加。
 5. 创建 `.sillyspec/shared/` 目录
 
 #### 3b. 添加子项目（`add`）
@@ -95,7 +95,7 @@ for f in .sillyspec/projects/*.yaml; do
   cd "$proj_path"
   ls .sillyspec/ 2>/dev/null
   cat .sillyspec/PROJECT.md 2>/dev/null
-  ls .sillyspec/docs/${proj_name}/scan/ 2>/dev/null | wc -l
+  ls docs/${proj_name}/scan/ 2>/dev/null | wc -l
   cd -
 done
 ```
@@ -129,14 +129,6 @@ done
 
 每个子项目对应 `.sillyspec/projects/<name>.yaml`：
 
-**sillyspec init 创建的格式（3 字段）：**
-```yaml
-name: frontend
-path: ./frontend
-status: active
-```
-
-**workspace add 扩展的格式（最多 5 字段）：**
 ```yaml
 name: frontend
 path: ./frontend