sillyspec 3.8.5 → 3.8.6

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

@@ -1,17 +0,0 @@
----
-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

@@ -1,96 +0,0 @@
----
-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

@@ -1,53 +0,0 @@
----
-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

@@ -1,170 +0,0 @@
----
-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 秒"）

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

@@ -1,52 +0,0 @@
----
-name: sillyspec:plan
-description: 编写实现计划 — 2-5 分钟粒度，精确到文件路径和代码
----
-
-## 执行
-
-**你必须使用 exec 工具（shell）执行以下命令，不要自己编造流程：**
-
-1. 运行 `sillyspec run plan` — 读取输出的步骤 prompt
-2. 按照输出的 prompt **严格执行**，不要跳过或自行添加步骤
-3. 步骤完成后，运行 `sillyspec run plan --done --output "你的摘要"`
-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

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

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

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

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

@@ -1,111 +0,0 @@
----
-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），不需要用户手动保存。

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

@@ -1,17 +0,0 @@
----
-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

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

@@ -1,54 +0,0 @@
----
-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 看"在做什么"

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

@@ -1,17 +0,0 @@
----
-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

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

@@ -1,17 +0,0 @@
----
-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