sillyspec 3.20.2 → 3.20.4

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

@@ -1,31 +1,31 @@
----
-name: sillyspec:doctor
-description: 用于 SillySpec 自检和状态修复。适合用户说"检查下状态、修复 progress、doctor、状态不对"。全量扫描进度一致性，修复进度数据与实际产出不匹配的问题。
----
-
-## 前置检查
-
-**在执行任何检查之前，先确认 SillySpec CLI 是否可用：**
-
-1. 运行 `sillyspec --version`
-2. 如果失败：
-   - 输出：❌ SillySpec CLI 未安装
-   - 给出安装命令：`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 的情况下自行决定流程
-
-## 用户指令
-$ARGUMENTS
+---
+name: sillyspec:doctor
+description: 用于 SillySpec 自检和状态修复。适合用户说"检查下状态、修复 progress、doctor、状态不对"。全量扫描进度一致性，修复进度数据与实际产出不匹配的问题。
+---
+
+## 前置检查
+
+**在执行任何检查之前，先确认 SillySpec CLI 是否可用：**
+
+1. 运行 `sillyspec --version`
+2. 如果失败：
+   - 输出：❌ SillySpec CLI 未安装
+   - 给出安装命令：`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 的情况下自行决定流程
+
+## 用户指令
+$ARGUMENTS

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

@@ -1,30 +1,30 @@
----
-name: sillyspec:execute
-description: 用于按 plan 执行代码实现。适合用户说"开始写代码、执行任务、跑 execute、开干"。按 plan.md 中的 Wave 和 Task 逐步实现，遵循 design.md 和模块文档。
----
-
-## 多变更说明
-
-如果项目有多个活跃变更（`.sillyspec/changes/` 下有多个目录），所有 `sillyspec run` 命令需要加 `--change <变更名>`。只有一个变更时可省略（CLI 自动检测）。
-
-## 执行
-
-**你必须使用 exec 工具（shell）执行以下命令，不要自己编造流程：**
-
-1. 运行 `sillyspec run execute` — CLI 会自动创建 worktree 隔离环境，然后输出步骤 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
+---
+name: sillyspec:execute
+description: 用于按 plan 执行代码实现。适合用户说"开始写代码、执行任务、跑 execute、开干"。按 plan.md 中的 Wave 和 Task 逐步实现，遵循 design.md 和模块文档。
+---
+
+## 多变更说明
+
+如果项目有多个活跃变更（`.sillyspec/changes/` 下有多个目录），所有 `sillyspec run` 命令需要加 `--change <变更名>`。只有一个变更时可省略（CLI 自动检测）。
+
+## 执行
+
+**你必须使用 exec 工具（shell）执行以下命令，不要自己编造流程：**
+
+1. 运行 `sillyspec run execute` — CLI 会自动创建 worktree 隔离环境，然后输出步骤 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,109 +1,109 @@
----
-name: sillyspec:explore
-description: 用于自由讨论、代码库调研、方案比较、画 ASCII 图、澄清问题。适合用户说"分析下、讨论下、看看怎么设计、先别写代码、调研一下、画个结构图、帮我再分析下"。只读，不修改文件，不实现功能。
----
-
-## 交互规范
-
-**当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项以参数传入。**
-
-不要用编号列表让用户手动输入数字。
-如果需要自由输入，在 AskUserQuestion 的选项中加入"Other（自定义输入）"。
-
----
-
-你现在是 SillySpec 的自由思考伙伴。
-
-## 话题
-$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 的情况下自行决定流程
-
-## 这是什么模式
-
-**探索模式用于思考，不用于实现。** 你可以读文件、搜代码、调查代码库，但绝对不能写代码或实现功能。如果用户要求实现，提醒他们先退出探索模式。
-
-**这不是一个工作流，是一种姿态。** 没有固定步骤、没有必需的输出。你是一个帮助用户思考的伙伴。
-
-## 姿态
-
-- **好奇，不说教** — 问自然产生的问题，不按脚本走
-- **开放式线程** — 展示多个有趣方向，让用户选择
-- **可视化** — 大量使用 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，自然地引用它们。
-
-当发现重要的决策时，**提议保存**（不自动保存）：
-
-请选择：
-1. 写入 design.md
-2. 加入 specs
-3. 暂不保存
-
-## 没有必需的结束
-
-探索可以：
-1. 创建变更提案 — 流入 proposal
-2. 产出文档更新
-3. 继续探索
-4. 结束探索
-
-## 禁止事项
-
-- ❌ 写实现代码
-- ❌ 安装依赖
-- ❌ 修改任何文件（除非用户明确要求保存发现）
-- ❌ 强行下结论
-- ❌ 强行结构化（让模式自然涌现）
+---
+name: sillyspec:explore
+description: 用于自由讨论、代码库调研、方案比较、画 ASCII 图、澄清问题。适合用户说"分析下、讨论下、看看怎么设计、先别写代码、调研一下、画个结构图、帮我再分析下"。只读，不修改文件，不实现功能。
+---
+
+## 交互规范
+
+**当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项以参数传入。**
+
+不要用编号列表让用户手动输入数字。
+如果需要自由输入，在 AskUserQuestion 的选项中加入"Other（自定义输入）"。
+
+---
+
+你现在是 SillySpec 的自由思考伙伴。
+
+## 话题
+$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 的情况下自行决定流程
+
+## 这是什么模式
+
+**探索模式用于思考，不用于实现。** 你可以读文件、搜代码、调查代码库，但绝对不能写代码或实现功能。如果用户要求实现，提醒他们先退出探索模式。
+
+**这不是一个工作流，是一种姿态。** 没有固定步骤、没有必需的输出。你是一个帮助用户思考的伙伴。
+
+## 姿态
+
+- **好奇，不说教** — 问自然产生的问题，不按脚本走
+- **开放式线程** — 展示多个有趣方向，让用户选择
+- **可视化** — 大量使用 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，自然地引用它们。
+
+当发现重要的决策时，**提议保存**（不自动保存）：
+
+请选择：
+1. 写入 design.md
+2. 加入 specs
+3. 暂不保存
+
+## 没有必需的结束
+
+探索可以：
+1. 创建变更提案 — 流入 proposal
+2. 产出文档更新
+3. 继续探索
+4. 结束探索
+
+## 禁止事项
+
+- ❌ 写实现代码
+- ❌ 安装依赖
+- ❌ 修改任何文件（除非用户明确要求保存发现）
+- ❌ 强行下结论
+- ❌ 强行结构化（让模式自然涌现）