sillyspec 3.8.7 → 3.9.1

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

@@ -0,0 +1,17 @@
+---
+name: sillyspec:archive
+description: 归档变更 — 规范沉淀，可追溯
+---
+
+## 执行
+
+**你必须使用 exec 工具（shell）执行以下命令，不要自己编造流程：**
+
+1. 运行 `sillyspec run archive` — 读取输出的步骤 prompt
+2. 按照输出的 prompt **严格执行**，不要跳过或自行添加步骤
+3. 步骤完成后，运行 `sillyspec run archive --done --output "你的摘要"`
+4. 重复 2-3 直到阶段完成
+5. **禁止**在没有运行 CLI 的情况下自行决定流程
+
+## 用户指令
+$ARGUMENTS

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

@@ -0,0 +1,78 @@
+---
+name: sillyspec:auto
+description: 自动模式 — 全流程自动推进（通用版）
+argument-hint: "<需求描述>"
+---
+
+## 用法
+- /sillyspec:auto 实现用户登录功能
+- /sillyspec:auto 修复搜索结果的排序问题
+
+## 任务
+$ARGUMENTS
+
+---
+
+## 执行流程
+
+你是全流程编排器，按 brainstorm → plan → execute → verify 顺序自动推进。
+
+### 启动
+1. 运行 `sillyspec run auto --input "<用户需求>"`
+2. 读取 CLI 输出的 step prompt（包含你的角色描述）
+3. 执行 prompt 中的操作
+
+### 步骤循环
+重复以下循环直到 CLI 输出"全部流程已完成"：
+
+1. **读取 CLI 输出的 step prompt**
+2. **判断是否需要用户确认：**
+   - prompt 中包含"请用户选择""等待用户回答""展示给用户""用户确认" → **暂停，等用户回复**
+   - 纯内部操作 → **直接执行**
+3. **执行 prompt 要求的操作**
+4. **完成后运行** `sillyspec run auto --done --output "<你的摘要>"`
+5. **读取 CLI 输出的下一步 prompt**，回到步骤 1
+
+### 阶段审核门控
+
+**brainstorm 完成后：**
+评估需求复杂度（基于 design.md 中的模块拆分、批量操作、多角色交互等特征），根据复杂度决定：
+
+| 复杂度 | 审核策略 |
+|--------|---------|
+| 简单（无拆分、无批量） | 不审核，直接进入 plan |
+| 中等（有拆分或批量） | 启动 1 个审核子代理（QA 视角）审查 design.md |
+| 复杂（拆分 + 批量/多角色） | 启动 2-3 个审核子代理多角度审查 |
+
+多角度审核子代理分工：
+- **架构师** — 审查设计合理性、技术选型 trade-off、模块划分
+- **安全专家** — 审查安全隐患、权限设计、数据校验
+- **QA 专家** — 审查需求覆盖率、边界场景遗漏、验收标准
+
+审核流程：
+1. 暂停，提示用户当前复杂度等级和建议审核策略
+2. 用户确认后，启动审核子代理（读取 design.md + requirements.md + tasks.md）
+3. 子代理输出问题清单
+4. 汇总问题，询问用户"是否需要修改后再继续"
+5. 需要修改 → 修复后重新审核；不需要 → 进入下一阶段
+
+**plan 完成后：**
+同样评估复杂度，启动审核子代理审查 plan.md：
+- **项目经理** — 审查任务拆解粒度、依赖关系、优先级
+- **工程师** — 审查任务可行性、工作量评估是否合理
+- **QA** — 审查验收标准是否具体可测试
+
+### 关键规则
+- 不要跳过任何步骤
+- 不要手动修改 progress.json
+- 不要自动 commit，只 git add
+- 不要使用 npx
+- 不要编造不存在的 CLI 子命令
+- 遇到命令报错 → 展示错误，暂停等用户介入
+
+### 异常处理
+- 命令执行失败 → 展示错误信息，暂停等待用户指示
+- 用户说"停止"或"暂停" → 立即停止，报告当前进度
+
+### 完成条件
+CLI 输出"全部流程已完成"后，输出完整流程总结，提示用户提交改动。

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

@@ -0,0 +1,17 @@
+---
+name: sillyspec:brainstorm
+description: 需求探索 — 结构化头脑风暴，含技术方案输出（创建性工作前必用）
+---
+
+## 执行
+
+**你必须使用 exec 工具（shell）执行以下命令，不要自己编造流程：**
+
+1. 运行 `sillyspec run brainstorm` — 读取输出的步骤 prompt
+2. 按照输出的 prompt **严格执行**，不要跳过或自行添加步骤
+3. 步骤完成后，运行 `sillyspec run brainstorm --done --output "你的摘要"`
+4. 重复 2-3 直到阶段完成
+5. **禁止**在没有运行 CLI 的情况下自行决定流程
+
+## 用户指令
+$ARGUMENTS

package/{templates/commit.md → .claude/skills/sillyspec-commit/SKILL.md}

@@ -1,9 +1,16 @@
+---
+name: sillyspec:commit
+description: 智能提交 — 自动收集变更信息，生成 commit message
+argument-hint: "[可选：自定义 commit message]"
+version: "3.7.32"
+---
+
 ## 交互规范
-**当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项以参数传入。**
+当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项以参数传入。
 
 ## 用法
-- `/sillyspec:commit` — 智能提交：自动收集变更信息，生成 commit message
-- `/sillyspec:commit "自定义 message"` — 使用指定 message 直接提交
+- /sillyspec:commit — 智能提交：自动收集变更信息，生成 commit message
+- /sillyspec:commit "自定义 message" — 使用指定 message 直接提交
 
 ## 任务
 $ARGUMENTS
@@ -13,53 +20,43 @@ $ARGUMENTS
 ## 流程
 
 ### 1. 检查是否有未提交的修改
-
-```bash
 git diff --quiet 2>/dev/null; UNSTAGED=$?
 git diff --cached --quiet 2>/dev/null; STAGED=$?
-```
 
 两者都为 0（无修改）→ 提示"没有需要提交的修改"，结束。
 
 ### 2. 暂存所有修改
-
-```bash
 git add -A
-```
 
 ### 3. 收集变更语义信息
-
-```bash
 # 上次 commit 时间
 LAST_COMMIT_TIME=$(git log -1 --format=%ci 2>/dev/null)
 
 # 修改的文件列表
 git diff --cached --stat
-```
 
 从以下来源收集语义信息（筛选时间戳 > LAST_COMMIT_TIME 的条目）：
 
-**来源 A — QUICKLOG（quick 产生的修改）：**
-```bash
+来源 A — QUICKLOG（quick 产生的修改）：
 USER=$(git config user.name 2>/dev/null || echo "default")
 cat .sillyspec/quicklog/QUICKLOG-${USER}.md 2>/dev/null
 # 同时扫描活跃变更目录下的归属 quicklog
 for dir in .sillyspec/changes/*/quicklog/*.md; do [ -f "$dir" ] && cat "$dir"; done 2>/dev/null
-```
 
-**来源 B — tasks.md（execute 产生的修改）：**
-```bash
+来源 B — tasks.md（execute 产生的修改）：
 LATEST=$(ls -d .sillyspec/changes/*/ 2>/dev/null | grep -v archive | tail -1)
 cat "$LATEST/tasks.md" 2>/dev/null
-```
 筛选时间戳 > LAST_COMMIT_TIME 的已勾选 task。
 
-检查 `.sillyspec/` 下新增或修改的文件，根据路径识别来源阶段：
-- `docs/*/scan/*.md` → scan 产出
-- `changes/<name>/design.md` 或 `tasks.md` → plan 产出
-- `changes/archive/` → archive 产出
-- `specs/*.md` → brainstorm 产出
-- `knowledge/*.md` → 知识库更新
+来源 C — 阶段产出（scan/brainstorm/plan/archive 等）：
+检查 .sillyspec/ 下新增或修改的文件，根据路径识别来源阶段：
+- docs/<project>/scan/*.md → scan 产出
+- changes/<name>/design.md → brainstorm 产出
+- changes/<name>/proposal.md → brainstorm 产出
+- changes/<name>/tasks.md → plan 产出
+- changes/<name>/plan.md → plan 产出
+- changes/archive/ → archive 产出
+- knowledge/*.md → 知识库更新
 
 ### 4. 自动生成 commit message
 
@@ -67,55 +64,43 @@ cat "$LATEST/tasks.md" 2>/dev/null
 
 | 来源 | type | 示例 |
 |---|---|---|
-| 只有 quick 条目 | fix/refactor | `fix: 手机号校验修复（含正则修正）` |
-| 只有 execute 条目 | feat | `feat(user): 用户模块 task 1~3` |
-| 只有阶段产出 | docs | `docs: sillyspec scan 完成` |
+| 只有 quick 条目 | fix/refactor | fix: 手机号校验修复（含正则修正） |
+| 只有 execute 条目 | feat | feat(user): 用户模块 task 1~3 |
+| 只有阶段产出 | docs | docs: sillyspec scan 完成 |
 | 混合来源 | 取最主要的 type | body 里列出所有条目 |
 | 无匹配来源 | — | 展示 diff stat，让用户自己写 |
 
-**如果 $ARGUMENTS 非空**，直接使用用户指定的 message，跳过自动生成。
+**如果 $ARGUMENTS 非空**，直接使用用户指定的 message，跳过自动生成，但仍展示 diff stat。
 
-**多条 quick 合并规则：**
+多条 quick 合并规则：
 - 2 条以内 → 逐条列出
 - 3 条以上 → 摘要 + body 详情
 
 ### 5. 展示确认
 
 用 AskUserQuestion 展示：
-
-```
 📝 建议的 commit message：
-  fix: 手机号校验修复（含正则修正）
+ fix: 手机号校验修复（含正则修正）
 
 📁 修改文件（N 个）：
-  src/UserService.java (+15 -3)
-  src/PhoneValidator.java (+28 -0)
+ src/UserService.java (+15 -3)
+ src/PhoneValidator.java (+28 -0)
 
 选择：确认提交 / 编辑 message / 取消
-```
 
 用户选择编辑 → 让用户输入新 message → 再次确认。
 
 ### 6. 执行提交
-
-```bash
 git commit -m "{确认后的 message}"
-```
 
 提交成功后展示 commit hash + 文件数 + 行数统计。
 
-## 工作区模式
-
-```bash
-ls .sillyspec/projects/*.yaml 2>/dev/null | grep -q .
-```
-
-有子项目配置时：
-- 检查修改的文件分别属于哪个子项目
+## 多项目
+检查修改的文件分别属于哪个子项目：
 - 修改集中在一个子项目 → 在该子项目目录中 commit
 - 修改跨多个子项目 → 用 AskUserQuestion 让用户选择：分开提交（每个子项目一个 commit）/ 合并提交
 
 ## 绝对规则
 - ❌ 不要自动提交，必须展示 message 让用户确认
 - ❌ 不要丢弃用户的修改
-- ✅ $ARGUMENTS 非空时可跳过确认直接提交
+- ✅ $ARGUMENTS 非空时展示 diff stat 后直接提交（不需手动确认）

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

@@ -0,0 +1,45 @@
+---
+name: sillyspec:continue
+description: 自动判断并执行下一步
+---
+
+---
+
+你现在是 SillySpec 的自动推进器。
+
+## 判断逻辑
+
+按顺序检查，第一个未完成的就执行：
+
+```
+1. 有 HANDOFF.json？→ 执行 /sillyspec:resume
+
+2. .sillyspec/changes/ 有进行中的变更？
+   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
+
+3. 有设计文档但没有对应变更？
+   → 提示运行 /sillyspec:propose <name>
+
+4. 有 docs/*/scan/ 但没有进行中的工作？
+   → 提示运行 /sillyspec:brainstorm "你的想法"
+
+5. 什么都没有？
+   → 提示运行 /sillyspec:init（新项目）或 /sillyspec:scan（棕地项目）
+```
+
+## 输出
+
+先报告检测结果，再执行：
+
+> 🤖 SillySpec 自动检测
+> 
+> 当前状态：[描述]
+> 下一步：[执行的命令]
+> 
+> [开始执行...]

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

@@ -0,0 +1,27 @@
+---
+name: sillyspec:doctor
+description: 项目自检 — 检查 CLI、配置、构建环境和外部依赖
+---
+
+## 前置检查
+
+**在执行任何检查之前，先确认 SillySpec CLI 是否可用：**
+
+1. 运行 `sillyspec --version`
+2. 如果失败：
+   - 输出：❌ SillySpec CLI 未安装
+   - 给出安装命令：`npm install -g sillyspec`
+   - 停止，不要继续后续步骤
+
+## 执行
+
+**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

@@ -0,0 +1,17 @@
+---
+name: sillyspec:execute
+description: 波次执行 — 子代理并行 + 强制 TDD + 两阶段审查
+---
+
+## 执行
+
+**你必须使用 exec 工具（shell）执行以下命令，不要自己编造流程：**
+
+1. 运行 `sillyspec run execute` — 读取输出的步骤 prompt
+2. 按照输出的 prompt **严格执行**，不要跳过或自行添加步骤
+3. 步骤完成后，运行 `sillyspec run execute --done --output "你的摘要"`
+4. 重复 2-3 直到阶段完成
+5. **禁止**在没有运行 CLI 的情况下自行决定流程
+
+## 用户指令
+$ARGUMENTS

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

@@ -0,0 +1,96 @@
+---
+name: sillyspec:explore
+description: 自由思考模式 — 讨论、画图、调研，不写代码
+---
+
+## 交互规范
+
+**当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项以参数传入。**
+
+不要用编号列表让用户手动输入数字。
+如果需要自由输入，在 AskUserQuestion 的选项中加入"Other（自定义输入）"。
+
+---
+
+你现在是 SillySpec 的自由思考伙伴。
+
+## 话题
+$ARGUMENTS
+
+## 这是什么模式
+
+**探索模式用于思考，不用于实现。** 你可以读文件、搜代码、调查代码库，但绝对不能写代码或实现功能。如果用户要求实现，提醒他们先退出探索模式。
+
+**这不是一个工作流，是一种姿态。** 没有固定步骤、没有必需的输出。你是一个帮助用户思考的伙伴。
+
+## 姿态
+
+- **好奇，不说教** — 问自然产生的问题，不按脚本走
+- **开放式线程** — 展示多个有趣方向，让用户选择
+- **可视化** — 大量使用 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. 结束探索
+
+## 禁止事项
+
+- ❌ 写实现代码
+- ❌ 安装依赖
+- ❌ 修改任何文件（除非用户明确要求保存发现）
+- ❌ 强行下结论
+- ❌ 强行结构化（让模式自然涌现）

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

@@ -0,0 +1,53 @@
+---
+name: sillyspec:export
+description: 导出成功方案为可复用模板
+---
+
+---
+
+你现在是 SillySpec 的模板导出器。
+
+## 参数解析
+
+解析 `$ARGUMENTS`：
+- 第一个参数为变更名（如 `user-auth`）
+- `--to` 指定输出路径（默认 `~/.sillyspec/templates/<change-name>/`）
+
+## 流程
+
+### 1. 读取变更文件
+
+```bash
+CHANGE_DIR=".sillyspec/changes/$ARGUMENTS"
+cat "$CHANGE_DIR/proposal.md"
+cat "$CHANGE_DIR/design.md"
+cat "$CHANGE_DIR/specs/requirements.md" 2>/dev/null
+```
+
+如果变更不存在 → 告诉用户"变更不存在，请确认变更名"
+
+### 2. 清理为通用模板
+
+读取文件后，进行清理：
+- 移除项目特定的信息（具体类名、路径、端口号）
+- 保留通用的设计方案、架构决策、需求场景
+- 添加一个 `notes.md`，记录使用建议和适配要点
+
+### 3. 导出到模板目录
+
+```bash
+mkdir -p ~/.sillyspec/templates/<change-name>
+cp 清理后的文件到该目录
+```
+
+### 4. 确认
+
+展示导出内容摘要，告知模板路径。
+
+### 最后说：
+
+> ✅ 方案已导出到 `~/.sillyspec/templates/<change-name>/`
+>
+> 其他项目使用：`/sillyspec:brainstorm "你的想法"` → AI 会自动发现并建议复用此模板
+>
+> 手动查看：`ls ~/.sillyspec/templates/<change-name>/`

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

@@ -0,0 +1,170 @@
+---
+name: sillyspec:init
+description: 绿地项目初始化 — 深度提问、调研、需求文档、路线图
+---
+
+## 交互规范
+
+**当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项以参数传入。**
+
+不要用编号列表让用户手动输入数字。
+如果需要自由输入，在 AskUserQuestion 的选项中加入"Other（自定义输入）"。
+
+---
+
+你现在是 SillySpec 的项目初始化器。
+
+## 用户输入
+$ARGUMENTS
+
+## 核心流程
+
+这是一个从零开始创建新项目的完整流程。你的目标是：**在开始写任何代码之前，把需求彻底搞清楚。**
+
+### Step 1: 检查工作区模式
+
+```bash
+ls .sillyspec/projects/*.yaml 2>/dev/null | grep -q .
+```
+
+如果 projects/ 目录存在且包含 .yaml 文件 → 工作区模式：
+1. 列出所有子项目（读取 projects/*.yaml）：
+   检测到工作区模式，请选择要初始化的子项目：
+   > 1. frontend — 前端 - Vue3 + TypeScript
+   > 2. backend — 后端 - Node.js + PostgreSQL
+   > 3. 新建子项目（先运行 /sillyspec:workspace add）
+2. 用户选择后，**切换到该子项目目录**执行后续所有步骤
+3. 后续步骤中的所有文件路径相对于子项目目录
+
+否则 → 单项目模式，继续。
+
+### Step 2: 检查项目状态
+
+```bash
+ls -la
+```
+
+如果目录已经有代码/配置文件 → 提示用 `/sillyspec:scan` 代替。
+如果是空目录 → 继续。
+
+### Step 3: 深度提问
+
+**一次只问一个问题**，按以下顺序探索：
+
+1. **项目本质** — 这个项目要解决什么问题？给谁用？
+2. **核心功能** — 用户能做的最重要的事情是什么？
+3. **技术偏好** — 有偏好的语言/框架吗？还是让我建议？
+4. **非功能需求** — 性能要求？安全要求？离线支持？多语言？
+5. **设计偏好** — 有参考产品吗？喜欢什么风格？
+6. **约束** — 预算？时间？团队规模？
+7. **不在范围内** — 明确什么不做
+
+### Step 4: 技术选型（如需要）
+
+如果用户没有明确偏好，基于项目需求推荐 2-3 套技术栈，列出优劣：
+- 语言 + 框架 + 数据库 + 部署方案
+- 给出推荐和理由
+
+### Step 5: 可选调研
+
+如果用户同意，对关键技术选型做快速调研：
+- 选定框架的当前版本和生态状态
+- 已知的坑和替代方案
+- 依赖的第三方服务的稳定性
+
+### Step 6: 生成需求文档
+
+保存到 `.sillyspec/REQUIREMENTS.md`：
+
+```markdown
+# 需求文档
+
+## 项目概述
+[一句话描述]
+
+## 目标用户
+[谁在用、在什么场景下用]
+
+## 功能需求
+### P0 — 必须有
+- [ ] 需求 1
+- [ ] 需求 2
+
+### P1 — 应该有
+- [ ] 需求 3
+
+### P2 — 有了更好
+- [ ] 需求 4
+
+## 非功能需求
+- 性能：xxx
+- 安全：xxx
+- 部署：xxx
+
+## 不在范围内
+- xxx
+- xxx
+
+## 技术选型
+| 层 | 选择 | 理由 |
+|---|---|---|
+| 前端 | React + TypeScript | xxx |
+| 后端 | xxx | xxx |
+| 数据库 | xxx | xxx |
+```
+
+### Step 7: 生成路线图：
+
+```markdown
+# 项目路线图
+
+## Phase 1: 基础骨架
+- 目标：可运行的最小版本
+- 交付物：项目结构 + 基础配置 + 首个可运行页面/接口
+
+## Phase 2: 核心功能
+- 目标：P0 功能全部可用
+- 交付物：xxx
+
+## Phase 3: 完善
+- 目标：P1 + 测试 + 打磨
+- 交付物：xxx
+```
+
+### Step 8: 生成 PROJECT.md
+
+保存到 `.sillyspec/PROJECT.md`：
+
+```markdown
+# PROJECT.md
+
+## 项目名：xxx
+## 一句话：xxx
+## 状态：已初始化，等待规划
+```
+
+### Step 9: Git 初始化
+
+```bash
+git init
+git add .
+```
+
+### 最后说：
+
+> ✅ 项目初始化完成！
+>
+> 生成文件：
+> - `.sillyspec/PROJECT.md` — 项目概述
+> - `.sillyspec/REQUIREMENTS.md` — 需求文档
+> - `.sillyspec/ROADMAP.md` — 路线图
+>
+> 下一步：
+> - 开始第一个功能：`/sillyspec:brainstorm "Phase 1: xxx"`
+> - 或修改需求：直接告诉我改什么
+
+## 绝对规则
+- 不写任何实现代码
+- 不安装任何依赖
+- 提问阶段一次一个问题
+- 需求必须具体，不能模糊（❌"好用" → ✅"首屏加载 < 2 秒"）