sillyspec 3.24.5 → 3.24.6

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

@@ -1,86 +1,86 @@
----
-name: sillyspec:archive
-description: 用于归档已验证完成的变更。适合用户说"归档、archive、收尾这个变更"。执行模块影响分析 + 同步模块文档 + 移动到 archive 目录 + 更新 ROADMAP。
----
-
-## 何时使用
-
-- 用户说"归档、archive、收尾这个变更"
-- verify 已通过，把变更包归档沉淀
-- 5 步：任务完成度检查 → 模块影响分析 → 同步模块文档 → 确认归档 → 更新路线图
-
-## 多变更说明
-
-项目有多个活跃变更（`.sillyspec/changes/` 下有多个目录）时，所有 `sillyspec run` 命令需加 `--change <变更名>` 指定操作目标；只有一个变更时可省略（CLI 自动检测）。
-
-## 步骤生命周期（所有阶段通用）
-
-> `sillyspec archive` 是 `sillyspec run archive` 的顶层别名，两者等价。
-
-```bash
-sillyspec run archive                          # 输出当前步骤 prompt
-sillyspec run archive --done --output "摘要"   # 完成当前步骤
-sillyspec run archive --status                 # 查看阶段进度
-sillyspec run archive --skip                   # 跳过可选步骤
-sillyspec run archive --reset                  # 重置阶段（从头开始）
-sillyspec run archive --reopen --from-step N   # 重新打开已完成阶段修订（N=序号或名称）
-```
-
-## 通用参数（所有阶段适用）
-
-| 参数 | 说明 |
-|---|---|
-| `--change <名>` | 指定变更名（多活跃变更必填，单变更可省略自动检测） |
-| `--spec-dir <path>` | 指定规范目录（默认 `<项目>/.sillyspec`） |
-| `--non-interactive` | CI/脚本下禁用交互式 prompt |
-| `--skip-approval` | 跳过审批/校验门控（需明确意图） |
-| `--json` | 输出 JSON（程序化读取） |
-
-## archive 特有
-
-### `--confirm`（确认归档步骤必填）
-
-第 4 步「确认归档」由 CLI 执行目录移动，**必须带 `--confirm`**：
-
-```bash
-sillyspec run archive --done --confirm --output "确认归档"
-```
-
-不带 `--confirm` 时 CLI 回退步骤为 pending 并提示，不会误归档。
-
-### 归档前硬校验
-
-CLI 移动目录前会校验 `plan.md` 存在——缺失则 `exit(1)` 阻断（目录尚未移动，可补全后重试）。移动后校验 `design.md` / `module-impact.md`（缺失只告警，因目录已移动）。
-
-### 模块文档同步（第 3 步）
-
-第 3 步「sync-module-docs」会更新 `_module-map.yaml` + 模块卡片，**必须暂停等用户确认**：
-
-```bash
-sillyspec run archive --wait --reason "等待用户确认模块文档同步" --options "确认写入,跳过同步" --output "diff 摘要"
-sillyspec run archive --continue --answer "确认写入"
-```
-
-只有用户 `--continue --answer "确认写入"` 后才写入文件。
-
-### 归档结果
-
-归档后变更目录从 `changes/<名>/` 移到 `changes/archive/YYYY-MM-DD-<名>/`，并从活跃列表注销。后续用 `/sillyspec:commit` 提交。
-
-## 阶段流转
-
-```
-verify → archive → git commit
-```
-
-archive 完成后，运行 `/sillyspec:commit` 提交归档结果（`git add .sillyspec/changes/`）。
-
-## 铁律
-
-- **必须用 exec 工具（shell）执行 CLI，不要自己编造流程**
-- 不要用 `mv`/`rename` 重命名变更目录，必须由 CLI 的「确认归档」步骤移动
-- 归档不可逆——确认前核对变更名、文件列表、module-impact.md
-- 完成后立即 `--done`，不跳过
-
-## 用户指令
-$ARGUMENTS
+---
+name: sillyspec:archive
+description: 归档已验证完成的变更：模块影响分析 + 同步模块文档 + 移动到 archive + 更新 ROADMAP。
+---
+
+## 何时使用
+
+- 用户说"归档、archive、收尾这个变更"
+- verify 已通过，把变更包归档沉淀
+- 5 步：任务完成度检查 → 模块影响分析 → 同步模块文档 → 确认归档 → 更新路线图
+
+## 多变更说明
+
+项目有多个活跃变更（`.sillyspec/changes/` 下有多个目录）时，所有 `sillyspec run` 命令需加 `--change <变更名>` 指定操作目标；只有一个变更时可省略（CLI 自动检测）。
+
+## 步骤生命周期（所有阶段通用）
+
+> `sillyspec archive` 是 `sillyspec run archive` 的顶层别名，两者等价。
+
+```bash
+sillyspec run archive                          # 输出当前步骤 prompt
+sillyspec run archive --done --output "摘要"   # 完成当前步骤
+sillyspec run archive --status                 # 查看阶段进度
+sillyspec run archive --skip                   # 跳过可选步骤
+sillyspec run archive --reset                  # 重置阶段（从头开始）
+sillyspec run archive --reopen --from-step N   # 重新打开已完成阶段修订（N=序号或名称）
+```
+
+## 通用参数（所有阶段适用）
+
+| 参数 | 说明 |
+|---|---|
+| `--change <名>` | 指定变更名（多活跃变更必填，单变更可省略自动检测） |
+| `--spec-dir <path>` | 指定规范目录（默认 `<项目>/.sillyspec`） |
+| `--non-interactive` | CI/脚本下禁用交互式 prompt |
+| `--skip-approval` | 跳过审批/校验门控（需明确意图） |
+| `--json` | 输出 JSON（程序化读取） |
+
+## archive 特有
+
+### `--confirm`（确认归档步骤必填）
+
+第 4 步「确认归档」由 CLI 执行目录移动，**必须带 `--confirm`**：
+
+```bash
+sillyspec run archive --done --confirm --output "确认归档"
+```
+
+不带 `--confirm` 时 CLI 回退步骤为 pending 并提示，不会误归档。
+
+### 归档前硬校验
+
+CLI 移动目录前会校验 `plan.md` 存在——缺失则 `exit(1)` 阻断（目录尚未移动，可补全后重试）。移动后校验 `design.md` / `module-impact.md`（缺失只告警，因目录已移动）。
+
+### 模块文档同步（第 3 步）
+
+第 3 步「sync-module-docs」会更新 `_module-map.yaml` + 模块卡片，**必须暂停等用户确认**：
+
+```bash
+sillyspec run archive --wait --reason "等待用户确认模块文档同步" --options "确认写入,跳过同步" --output "diff 摘要"
+sillyspec run archive --continue --answer "确认写入"
+```
+
+只有用户 `--continue --answer "确认写入"` 后才写入文件。
+
+### 归档结果
+
+归档后变更目录从 `changes/<名>/` 移到 `changes/archive/YYYY-MM-DD-<名>/`，并从活跃列表注销。后续用 `/sillyspec:commit` 提交。
+
+## 阶段流转
+
+```
+verify → archive → git commit
+```
+
+archive 完成后，运行 `/sillyspec:commit` 提交归档结果（`git add .sillyspec/changes/`）。
+
+## 铁律
+
+- **必须用 exec 工具（shell）执行 CLI，不要自己编造流程**
+- 不要用 `mv`/`rename` 重命名变更目录，必须由 CLI 的「确认归档」步骤移动
+- 归档不可逆——确认前核对变更名、文件列表、module-impact.md
+- 完成后立即 `--done`，不跳过
+
+## 用户指令
+$ARGUMENTS

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

@@ -1,6 +1,6 @@
 ---
 name: sillyspec:brainstorm
-description: 用于正式开始开发前的需求澄清和技术方案设计。适合用户提出新功能、新模块、架构调整、复杂改造，或说"先做需求分析、输出技术方案、创建变更前先梳理、帮我设计下"。产出结构化方案（design/proposal/requirements/tasks 四件套），但不直接写代码。
+description: 正式开发前的需求澄清与技术方案设计。产出结构化方案（design/proposal/requirements/tasks 四件套），不直接写代码。
 ---
 
 ## 交互规范

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

@@ -1,6 +1,6 @@
 ---
 name: sillyspec:doctor
-description: 用于 SillySpec 自检和状态修复。适合用户说"检查下状态、修复 progress、doctor、状态不对"。全量扫描进度一致性，修复进度数据与实际产出不匹配的问题。
+description: SillySpec 自检与状态修复：全量扫描进度一致性，修复进度数据与实际产出不匹配。
 ---
 
 ## 何时使用

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

@@ -1,91 +1,91 @@
----
-name: sillyspec:execute
-description: 用于按 plan 执行代码实现。适合用户说"开始写代码、执行任务、跑 execute、开干"。按 plan.md 中的 Wave 和 Task 逐步实现，遵循 design.md 和模块文档。
----
-
-## 何时使用
-
-- 用户说"开始写代码、执行任务、跑 execute、开干"
-- 按 plan.md 的 Wave 分组和 Task 逐步实现代码
-- 遵循 design.md + 模块文档 + CONVENTIONS.md
-
-## 多变更说明
-
-项目有多个活跃变更（`.sillyspec/changes/` 下有多个目录）时，所有 `sillyspec run` 命令需加 `--change <变更名>` 指定操作目标；只有一个变更时可省略（CLI 自动检测）。
-
-## 步骤生命周期（所有阶段通用）
-
-> `sillyspec execute` 是 `sillyspec run execute` 的顶层别名，两者等价。
-
-```bash
-sillyspec run execute                          # 输出当前步骤 prompt（首次自动创建 worktree）
-sillyspec run execute --done --output "摘要"   # 完成当前步骤（--input "用户原话" 记录输入）
-sillyspec run execute --status                 # 查看阶段进度
-sillyspec run execute --skip                   # 跳过可选步骤
-sillyspec run execute --reset                  # 重置阶段（从头开始）
-sillyspec run execute --reopen --from-step N   # 重新打开已完成阶段修订（N=序号或名称）
-```
-
-## 通用参数（所有阶段适用）
-
-| 参数 | 说明 |
-|---|---|
-| `--change <名>` | 指定变更名（多活跃变更必填，单变更可省略自动检测） |
-| `--spec-dir <path>` | 指定规范目录（默认 `<项目>/.sillyspec`） |
-| `--non-interactive` | CI/脚本下禁用交互式 prompt |
-| `--skip-approval` | 跳过审批/校验门控（需明确意图） |
-| `--json` | 输出 JSON（程序化读取） |
-
-## execute 特有：Worktree 隔离
-
-- CLI 启动 execute 阶段时**自动创建 git worktree**，AI 不需要手动创建
-- worktree 路径在步骤 prompt 中输出（`worktreePath`），后续子代理的 cwd 必须设为该路径
-- **禁止跳过 worktree 或在主仓库直接写代码**
-- worktree 创建失败时 CLI 报错退出，排查后重试
-- dirty 状态/未提交文件**不影响** worktree 创建和进入，直接按 CLI 输出的路径操作，不要自行检查 git 状态
-- create 时若检测到 base 落后/分叉 `origin/<默认分支>`，CLI 会醒目报告（⚠️「落后 N 个 commit」+ 对齐命令），**不阻断** execute。看到此报告时评估是否提示用户先对齐 main，但**不要自行 fetch/ff**——对齐是用户/主仓库的显式动作
-
-### 依赖门控（depsStatus）
-
-`--done` 时 CLI 校验 worktree 的依赖状态（`depsStatus`）。不达标会阻断完成并提示：
-
-```bash
-# 修复依赖供给
-sillyspec worktree doctor --fix --change <变更名>
-```
-
-`linked / installed / n/a` 放行；`missing / stale / failed / unknown` 阻断。Wave 内所有 task 声明 `no_deps_verify: true` 时可 opt-out。
-
-### Task Review Gate
-
-execute 完成时，每个 task 必须有 `review.json` 且 verdict 通过，否则阻断完成。**例外**：task 在 `tasks/task-XX.md` frontmatter 声明 `low_risk: true`（type-only / 机械迁移等低逻辑风险）时，缺 review.json 只发 warning 不阻断。`cannot_verify` 的 task 会写入 `verify-required-evidence.json`，由 verify 阶段消费。
-
-## worktree 子命令（execute 相关）
-
-```bash
-sillyspec worktree apply <变更名>              # 校验并应用 worktree 变更到主工作区
-sillyspec worktree apply <变更名> --check-only # 只检查不应用
-sillyspec worktree assess <变更名>             # 风险审计 + 自动 apply
-sillyspec worktree list                        # 列出所有活跃 worktree
-sillyspec worktree meta <变更名>               # 读取 worktree meta.json
-sillyspec worktree cleanup <变更名>            # 清理 worktree
-sillyspec worktree doctor [--fix]              # 健康检查 + 修复
-```
-
-## 阶段流转
-
-```
-plan → execute → verify
-```
-
-execute 完成后（所有 Wave/task 完成 + Task Review Gate 通过），运行 `sillyspec run verify --change <变更名>` 验证。
-
-## 铁律
-
-- **必须用 exec 工具（shell）执行 CLI，不要自己编造流程**
-- 你是执行者不是设计师——按 plan 搬砖，发现 plan 不合理就停下来反馈，不自己改方案
-- 子代理 cwd 必须用 CLI 输出的 worktreePath
-- 完成后立即 `--done`，不跳过
-
-## 用户指令
-$ARGUMENTS
+---
+name: sillyspec:execute
+description: 按 plan 执行代码实现：依 plan.md 的 Wave/Task 逐步实现，遵循 design.md 与模块文档。
+---
+
+## 何时使用
+
+- 用户说"开始写代码、执行任务、跑 execute、开干"
+- 按 plan.md 的 Wave 分组和 Task 逐步实现代码
+- 遵循 design.md + 模块文档 + CONVENTIONS.md
+
+## 多变更说明
+
+项目有多个活跃变更（`.sillyspec/changes/` 下有多个目录）时，所有 `sillyspec run` 命令需加 `--change <变更名>` 指定操作目标；只有一个变更时可省略（CLI 自动检测）。
+
+## 步骤生命周期（所有阶段通用）
+
+> `sillyspec execute` 是 `sillyspec run execute` 的顶层别名，两者等价。
+
+```bash
+sillyspec run execute                          # 输出当前步骤 prompt（首次自动创建 worktree）
+sillyspec run execute --done --output "摘要"   # 完成当前步骤（--input "用户原话" 记录输入）
+sillyspec run execute --status                 # 查看阶段进度
+sillyspec run execute --skip                   # 跳过可选步骤
+sillyspec run execute --reset                  # 重置阶段（从头开始）
+sillyspec run execute --reopen --from-step N   # 重新打开已完成阶段修订（N=序号或名称）
+```
+
+## 通用参数（所有阶段适用）
+
+| 参数 | 说明 |
+|---|---|
+| `--change <名>` | 指定变更名（多活跃变更必填，单变更可省略自动检测） |
+| `--spec-dir <path>` | 指定规范目录（默认 `<项目>/.sillyspec`） |
+| `--non-interactive` | CI/脚本下禁用交互式 prompt |
+| `--skip-approval` | 跳过审批/校验门控（需明确意图） |
+| `--json` | 输出 JSON（程序化读取） |
+
+## execute 特有：Worktree 隔离
+
+- CLI 启动 execute 阶段时**自动创建 git worktree**，AI 不需要手动创建
+- worktree 路径在步骤 prompt 中输出（`worktreePath`），后续子代理的 cwd 必须设为该路径
+- **禁止跳过 worktree 或在主仓库直接写代码**
+- worktree 创建失败时 CLI 报错退出，排查后重试
+- dirty 状态/未提交文件**不影响** worktree 创建和进入，直接按 CLI 输出的路径操作，不要自行检查 git 状态
+- create 时若检测到 base 落后/分叉 `origin/<默认分支>`，CLI 会醒目报告（⚠️「落后 N 个 commit」+ 对齐命令），**不阻断** execute。看到此报告时评估是否提示用户先对齐 main，但**不要自行 fetch/ff**——对齐是用户/主仓库的显式动作
+
+### 依赖门控（depsStatus）
+
+`--done` 时 CLI 校验 worktree 的依赖状态（`depsStatus`）。不达标会阻断完成并提示：
+
+```bash
+# 修复依赖供给
+sillyspec worktree doctor --fix --change <变更名>
+```
+
+`linked / installed / n/a` 放行；`missing / stale / failed / unknown` 阻断。Wave 内所有 task 声明 `no_deps_verify: true` 时可 opt-out。
+
+### Task Review Gate
+
+execute 完成时，每个 task 必须有 `review.json` 且 verdict 通过，否则阻断完成。**例外**：task 在 `tasks/task-XX.md` frontmatter 声明 `low_risk: true`（type-only / 机械迁移等低逻辑风险）时，缺 review.json 只发 warning 不阻断。`cannot_verify` 的 task 会写入 `verify-required-evidence.json`，由 verify 阶段消费。
+
+## worktree 子命令（execute 相关）
+
+```bash
+sillyspec worktree apply <变更名>              # 校验并应用 worktree 变更到主工作区
+sillyspec worktree apply <变更名> --check-only # 只检查不应用
+sillyspec worktree assess <变更名>             # 风险审计 + 自动 apply
+sillyspec worktree list                        # 列出所有活跃 worktree
+sillyspec worktree meta <变更名>               # 读取 worktree meta.json
+sillyspec worktree cleanup <变更名>            # 清理 worktree
+sillyspec worktree doctor [--fix]              # 健康检查 + 修复
+```
+
+## 阶段流转
+
+```
+plan → execute → verify
+```
+
+execute 完成后（所有 Wave/task 完成 + Task Review Gate 通过），运行 `sillyspec run verify --change <变更名>` 验证。
+
+## 铁律
+
+- **必须用 exec 工具（shell）执行 CLI，不要自己编造流程**
+- 你是执行者不是设计师——按 plan 搬砖，发现 plan 不合理就停下来反馈，不自己改方案
+- 子代理 cwd 必须用 CLI 输出的 worktreePath
+- 完成后立即 `--done`，不跳过
+
+## 用户指令
+$ARGUMENTS

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

@@ -1,96 +1,96 @@
----
-name: sillyspec:explore
-description: 用于自由讨论、代码库调研、方案比较、画 ASCII 图、澄清问题。适合用户说"分析下、讨论下、看看怎么设计、先别写代码、调研一下、画个结构图、帮我再分析下"。只读，不修改文件，不实现功能。
----
-
-## 交互规范
-
-**当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项以参数传入。** 不要用编号列表让用户手动输入数字。
-
-## 话题
-$ARGUMENTS
-
----
-
-你现在是 SillySpec 的自由思考伙伴。
-
-## 步骤生命周期（所有阶段通用）
-
-> `sillyspec explore` 是 `sillyspec run explore` 的顶层别名，两者等价。explore 是 1 步只读阶段。
-
-```bash
-sillyspec run explore                              # 输出探索模式 prompt
-sillyspec run explore --done --input "<用户话题>" --output "你的摘要"   # 结束探索
-sillyspec run explore --status                     # 查看阶段状态
-```
-
-## 通用参数（所有阶段适用）
-
-| 参数 | 说明 |
-|---|---|
-| `--change <名>` | 指定变更名（多活跃变更时） |
-| `--spec-dir <path>` | 指定规范目录（默认 `<项目>/.sillyspec`） |
-| `--json` | 输出 JSON（程序化读取） |
-
-## 这是什么模式
-
-**探索模式用于思考，不用于实现。** 你可以读文件、搜代码、调查代码库，但绝对不能写代码或实现功能。如果用户要求实现，提醒他们先退出探索模式。
-
-**这不是一个工作流，是一种姿态。** 没有固定步骤、没有必需的输出。你是一个帮助用户思考的伙伴。
-
-## 姿态
-
-- **好奇，不说教** — 问自然产生的问题，不按脚本走
-- **开放式线程** — 展示多个有趣方向，让用户选择
-- **可视化** — 大量使用 ASCII 图表
-- **自适应** — 追随有趣的线索，随时转向
-- **耐心** — 不急着下结论
-- **务实** — 探索实际代码库，不只纸上谈兵
-
-## 你可以做的事
-
-**探索问题空间**：问澄清问题、挑战假设、重新定义问题
-
-**调查代码库**：映射相关架构、找集成点、识别已有模式、暴露隐藏复杂性
-
-**比较选项**：头脑风暴多种方案、建对比表、画权衡分析
-
-**画图**：
-```
-┌─────────────────────────────────┐
-│     用 ASCII 图自由表达          │
-├─────────────────────────────────┤
-│   ┌────────┐       ┌────────┐  │
-│   │ State  │──────▶│ State  │  │
-│   │   A    │       │   B    │  │
-│   └────────┘       └────────┘  │
-└─────────────────────────────────┘
-```
-
-**暴露风险**：识别可能出错的地方、发现理解空白
-
-## OpenSpec 上下文感知
-
-### 检查已有上下文
-
-```bash
-ls .sillyspec/changes/ 2>/dev/null | grep -v archive   # 进行中的变更
-cat .sillyspec/REQUIREMENTS.md 2>/dev/null
-cat .sillyspec/ROADMAP.md 2>/dev/null
-```
-
-### 当有进行中的变更时
-
-读取变更的 proposal、design、tasks，自然地引用它们。发现重要决策时**提议保存**（不自动保存）。
-
-## 没有必需的结束
-
-探索可以：创建变更提案 → 流入 proposal / 产出文档更新 / 继续探索 / 结束探索。
-
-## 禁止事项
-
-- ❌ 写实现代码
-- ❌ 安装依赖
-- ❌ 修改任何文件（除非用户明确要求保存发现）
-- ❌ 强行下结论
-- ❌ 强行结构化（让模式自然涌现）
+---
+name: sillyspec:explore
+description: 用于自由讨论、代码库调研、方案比较、画 ASCII 图。只读，不写代码不实现功能。
+---
+
+## 交互规范
+
+**当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项以参数传入。** 不要用编号列表让用户手动输入数字。
+
+## 话题
+$ARGUMENTS
+
+---
+
+你现在是 SillySpec 的自由思考伙伴。
+
+## 步骤生命周期（所有阶段通用）
+
+> `sillyspec explore` 是 `sillyspec run explore` 的顶层别名，两者等价。explore 是 1 步只读阶段。
+
+```bash
+sillyspec run explore                              # 输出探索模式 prompt
+sillyspec run explore --done --input "<用户话题>" --output "你的摘要"   # 结束探索
+sillyspec run explore --status                     # 查看阶段状态
+```
+
+## 通用参数（所有阶段适用）
+
+| 参数 | 说明 |
+|---|---|
+| `--change <名>` | 指定变更名（多活跃变更时） |
+| `--spec-dir <path>` | 指定规范目录（默认 `<项目>/.sillyspec`） |
+| `--json` | 输出 JSON（程序化读取） |
+
+## 这是什么模式
+
+**探索模式用于思考，不用于实现。** 你可以读文件、搜代码、调查代码库，但绝对不能写代码或实现功能。如果用户要求实现，提醒他们先退出探索模式。
+
+**这不是一个工作流，是一种姿态。** 没有固定步骤、没有必需的输出。你是一个帮助用户思考的伙伴。
+
+## 姿态
+
+- **好奇，不说教** — 问自然产生的问题，不按脚本走
+- **开放式线程** — 展示多个有趣方向，让用户选择
+- **可视化** — 大量使用 ASCII 图表
+- **自适应** — 追随有趣的线索，随时转向
+- **耐心** — 不急着下结论
+- **务实** — 探索实际代码库，不只纸上谈兵
+
+## 你可以做的事
+
+**探索问题空间**：问澄清问题、挑战假设、重新定义问题
+
+**调查代码库**：映射相关架构、找集成点、识别已有模式、暴露隐藏复杂性
+
+**比较选项**：头脑风暴多种方案、建对比表、画权衡分析
+
+**画图**：
+```
+┌─────────────────────────────────┐
+│     用 ASCII 图自由表达          │
+├─────────────────────────────────┤
+│   ┌────────┐       ┌────────┐  │
+│   │ State  │──────▶│ State  │  │
+│   │   A    │       │   B    │  │
+│   └────────┘       └────────┘  │
+└─────────────────────────────────┘
+```
+
+**暴露风险**：识别可能出错的地方、发现理解空白
+
+## OpenSpec 上下文感知
+
+### 检查已有上下文
+
+```bash
+ls .sillyspec/changes/ 2>/dev/null | grep -v archive   # 进行中的变更
+cat .sillyspec/REQUIREMENTS.md 2>/dev/null
+cat .sillyspec/ROADMAP.md 2>/dev/null
+```
+
+### 当有进行中的变更时
+
+读取变更的 proposal、design、tasks，自然地引用它们。发现重要决策时**提议保存**（不自动保存）。
+
+## 没有必需的结束
+
+探索可以：创建变更提案 → 流入 proposal / 产出文档更新 / 继续探索 / 结束探索。
+
+## 禁止事项
+
+- ❌ 写实现代码
+- ❌ 安装依赖
+- ❌ 修改任何文件（除非用户明确要求保存发现）
+- ❌ 强行下结论
+- ❌ 强行结构化（让模式自然涌现）

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

@@ -1,6 +1,6 @@
 ---
 name: sillyspec:plan
-description: 用于把 design 拆解为可执行的实现计划。适合用户说"拆任务、做计划、排 wave、规划实现步骤"。产出 plan.md（Wave 分组 + Task 列表 + 依赖关系）。
+description: 把 design 拆解为可执行的实现计划。产出 plan.md（Wave 分组 + Task 列表 + 依赖关系）。
 ---
 
 ## 何时使用

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

@@ -1,6 +1,6 @@
 ---
 name: sillyspec:propose
-description: 生成结构化规范 — proposal + design + tasks。适合用户说"生成规范、补全四件套、propose"。产出 proposal.md + design.md + tasks.md（+ 可能的 requirements.md）。
+description: 生成结构化规范：proposal.md + design.md + tasks.md（+ 可能 requirements.md）。
 ---
 
 ## 何时使用

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

@@ -1,6 +1,6 @@
 ---
 name: sillyspec:quick
-description: 用于明确、低风险、范围很小的直接任务。适合用户说"直接改、快速修、顺手调整、改个文案、修个小 bug、更新一个文件、不要完整流程"。跳过 brainstorm/plan，但仍按 sillyspec quick 流程执行。
+description: 用于明确、低风险、小范围的直接修改（改文案/修小 bug/更新单文件）。跳过 brainstorm/plan，仍走 quick 流程。
 ---
 
 ## 何时使用