sillyspec 2.4.0

package/.claude/commands/sillyspec/status.md

@@ -0,0 +1,122 @@
+---
+description: 查看项目进度和状态
+argument-hint: ""
+---
+
+---
+
+你现在是 SillySpec 的状态检查器。
+
+## 流程
+
+### 0: 检查工作区模式
+
+```bash
+cat .sillyspec/config.yaml 2>/dev/null
+```
+
+**如果是工作区模式：**
+
+1. 读取 config.yaml 获取子项目列表
+2. 对每个子项目执行 Step 1-5 的检查（在子项目目录下）
+3. 检查共享规范：
+   ```bash
+   ls .sillyspec/shared/ 2>/dev/null
+   ```
+4. 检查工作区概览：
+   ```bash
+   ls .sillyspec/workspace/ 2>/dev/null
+   ```
+5. 输出汇总：
+
+```
+🏢 工作区状态
+
+📦 子项目：
+
+  ✅ frontend  ./frontend
+     📋 项目：已初始化
+     📂 代码库：已扫描（7 份文档）
+     🔄 进行中：1 个变更
+        - [user-auth] Phase 3 (Execute) — tasks 5/8
+     ✅ 已归档：3 个变更
+
+  ⚠️ backend   ./backend
+     📋 项目：已初始化
+     📂 代码库：未扫描
+     🔄 进行中：0 个变更
+
+📄 共享规范：2 份
+  - api-contract.md
+  - data-models.md
+
+💡 下一步：
+  - 扫描 backend：/sillyspec:scan backend
+  - 继续开发：/sillyspec:continue
+```
+
+然后结束，不执行下面的单项目流程。
+
+**如果不是工作区模式：** 继续下面的单项目流程。
+
+### 1. 项目基础
+
+```bash
+cat .sillyspec/PROJECT.md 2>/dev/null || echo "未初始化"
+ls .sillyspec/codebase/ 2>/dev/null | head -10
+cat .sillyspec/REQUIREMENTS.md 2>/dev/null | head -20
+cat .sillyspec/ROADMAP.md 2>/dev/null
+```
+
+### 2. 进行中的变更
+
+```bash
+ls .sillyspec/changes/ 2>/dev/null | grep -v archive
+```
+
+对每个进行中的变更，检查文件完成度：
+- proposal.md ✅/❌
+- design.md ✅/❌
+- specs/requirements.md ✅/❌
+- tasks.md — X/Y 完成
+- 对应计划 .sillyspec/plans/ ✅/❌
+
+### 3. 归档历史
+
+```bash
+ls .sillyspec/changes/archive/ 2>/dev/null | wc -l
+```
+
+### 4. 中断状态
+
+```bash
+cat .sillyspec/HANDOFF.json 2>/dev/null
+```
+
+### 5. 代码库文档
+
+```bash
+ls .sillyspec/codebase/ 2>/dev/null
+```
+
+### 6. 输出
+
+```
+📊 SillySpec 状态
+
+📋 项目：xxx（已初始化 / 未初始化）
+📂 代码库：已扫描（7 份文档）/ 未扫描
+
+🔄 进行中：N 个变更
+  - [change-1] Phase 3 (Execute) — tasks 5/8
+  - [change-2] Phase 2 (Propose) — 缺少 design.md
+
+✅ 已归档：N 个变更
+📝 设计文档：N 份
+📝 实现计划：N 份
+
+💡 下一步：/sillyspec:continue
+```
+
+## 绝对规则
+- 不修改任何文件

package/.claude/commands/sillyspec/verify.md

@@ -0,0 +1,141 @@
+---
+description: 验证实现 — 对照规范检查 + 测试套件
+argument-hint: "[可选：指定验证范围]"
+---
+
+你现在是 SillySpec 的验证器。
+
+## 🛑 流程控制（必须先执行）
+
+**在开始任何工作之前，先调用 SillySpec CLI 检查当前状态：**
+
+```bash
+sillyspec status --json
+```
+
+**根据 CLI 返回的 phase 决定是否允许执行 verify：**
+- `phase: "verify"` → ✅ 可以继续
+- 其他 phase → ❌ 不允许跳步，提示用户运行 `sillyspec next` 获取正确步骤
+
+**不要跳过状态检查。不要自己推断阶段。以 CLI 为准。**
+
+## 流程
+
+### 1. 加载规范
+
+```bash
+LATEST=$(ls -d .sillyspec/changes/*/ | grep -v archive | tail -1)
+cat "$LATEST/proposal.md"
+cat "$LATEST/design.md"
+cat "$LATEST/tasks.md"
+cat "$LATEST/specs/requirements.md" 2>/dev/null
+```
+
+### 1.5 锚定确认（必须完成）
+
+读取相关规范文件。对于存在的文件，确认理解；对于不存在的文件，标注跳过：
+
+```
+已读取并理解：
+- [x] proposal.md — 变更动机和范围（如果存在）
+- [x] design.md — 技术方案和文件变更（如果存在）
+- [x] tasks.md — 实现清单（如果存在）
+- [x] specs/requirements.md — 需求和场景（如果存在）
+
+所有可用上下文已加载，开始验证。
+```
+
+**文件不存在不是错误**。只确认实际存在的文件。不准跳过此步骤。
+
+### 2. 逐项检查 tasks.md
+
+对每个 checkbox 报告状态：
+- ✅ 已完成 / ❌ 未完成 / ⚠️ 部分完成
+
+### 3. 对照 design.md
+
+- 架构决策是否遵循？
+- 文件变更清单是否一致？
+- 数据模型是否符合？
+- API 设计是否符合？
+
+### 4. 运行完整测试套件（fresh run）
+
+```bash
+# 根据项目技术栈运行
+pnpm test 2>/dev/null || npm test 2>/dev/null || pytest 2>/dev/null || go test ./... 2>/dev/null
+```
+
+记录通过/失败数量。如有失败，分析原因。
+
+### 5. 代码质量扫描
+
+```bash
+# 搜索技术债务标记
+grep -r "TODO\|FIXME\|HACK\|XXX" src/ lib/ app/ --include="*.ts" --include="*.tsx" --include="*.py" --include="*.js" 2>/dev/null | head -20
+```
+
+### 6. 输出验证报告
+
+```markdown
+# SillySpec 验证报告
+
+## 任务完成度
+- [x] Task 1: xxx ✅
+- [x] Task 2: xxx ✅
+- [ ] Task 3: xxx ❌ 未实现
+完成度：2/3
+
+## 设计一致性
+- ✅ 架构决策遵循
+- ⚠️ API 返回格式与 design.md 略有差异（缺少 error 字段）
+
+## 测试结果
+- passed: 42, failed: 3
+
+## 技术债务标记
+- src/auth/login.ts:15 // TODO: add rate limiting
+- src/auth/login.ts:45 // FIXME: token expiry
+
+## 结论
+⚠️ PASS WITH NOTES
+```
+
+## 脚本校验（硬验证）
+
+在输出验证报告之前，运行综合校验脚本：
+
+```bash
+bash scripts/validate-all.sh
+```
+
+将脚本输出纳入验证报告中的"设计一致性"部分。
+
+### 7. 最后说：
+
+**用 CLI 验证并获取下一步：**
+
+```bash
+sillyspec status --json
+```
+
+展示结果给用户，然后：
+
+```bash
+sillyspec next
+```
+
+将 CLI 返回的命令推荐给用户。**不要自己编建议。**
+
+### 8. 更新 STATE.md
+
+verify 完成后，**必须自动更新** `.sillyspec/STATE.md`：
+
+- 当前阶段改为 `verify ✅` 或 `verify ⚠️`
+- 下一步改为 `/sillyspec:archive`（PASS 时）或 `修复后重新 /sillyspec:verify`
+- 如果是子阶段，更新阶段进度；如果全部阶段完成，下一步改为 `/sillyspec:archive`
+- 历史记录追加时间 + 验证结果
+
+## 绝对规则
+- 不修改任何代码
+- 只做检查和报告

package/.claude/commands/sillyspec/workspace.md

@@ -0,0 +1,122 @@
+---
+description: 工作区管理 — 初始化、管理多项目工作区，查看子项目状态
+argument-hint: "[可选：add/remove/status/info]"
+---
+
+---
+
+你现在是 SillySpec 的工作区管理器。
+
+## 用户指令
+$ARGUMENTS
+
+## 核心流程
+
+### Step 1: 检查工作区配置
+
+```bash
+cat .sillyspec/config.yaml 2>/dev/null
+```
+
+如果不存在 → 这是一个尚未配置工作区的项目。询问用户是否要初始化工作区。
+
+### Step 2: 解析指令
+
+根据 `$ARGUMENTS` 或默认行为：
+
+- **无参数 / `status`** → 显示工作区状态
+- **`add`** → 添加子项目
+- **`remove`** → 移除子项目
+- **`info`** → 显示某个子项目详情
+- 无参数且 config.yaml 不存在 → 初始化工作区
+
+### Step 3: 执行对应操作
+
+#### 3a. 初始化工作区（config.yaml 不存在时）
+
+1. 询问工作区名称（默认用当前目录名）
+2. 逐个添加子项目：
+   - 询问子项目名称（如 `frontend`、`backend`）
+   - 询问子项目路径（相对于工作区根目录，如 `./frontend`）
+   - 询问子项目角色描述（如 `前端 - Vue3 + TypeScript`）
+   - 验证路径存在
+   - 问是否继续添加
+3. 询问共享规范文件
+4. 生成 `.sillyspec/config.yaml`
+5. 创建 `.sillyspec/shared/` 目录
+
+#### 3b. 添加子项目（`add`）
+
+1. 询问名称、路径、角色
+2. 验证路径存在
+3. 更新 `.sillyspec/config.yaml` 中的 `projects` 字段
+4. Git 提交
+
+#### 3c. 移除子项目（`remove`）
+
+1. 显示当前所有子项目列表
+2. 询问要移除哪个
+3. 从 config.yaml 中删除对应条目
+4. Git 提交
+
+#### 3d. 工作区状态（`status`，默认）
+
+读取 config.yaml，对每个子项目检查：
+
+```bash
+# 对每个子项目
+cd <子项目路径>
+ls .sillyspec/ 2>/dev/null
+cat .sillyspec/PROJECT.md 2>/dev/null
+ls .sillyspec/codebase/ 2>/dev/null | wc -l
+```
+
+输出格式：
+
+```
+🏢 工作区：<workspace-name>
+
+📦 子项目（N 个）：
+  ✅ frontend  ./frontend       前端 - Vue3 + TypeScript    已扫描（7 份文档）
+  ⚠️ backend   ./backend        后端 - Node.js              已初始化（未扫描）
+  ❌ miniprogram  ./miniprogram  小程序 - Taro               未初始化
+
+📄 共享规范：2 份
+  - api-contract.md
+  - data-models.md
+
+💡 操作：
+  /sillyspec:workspace add        — 添加子项目
+  /sillyspec:workspace remove     — 移除子项目
+  /sillyspec:init                 — 初始化子项目
+  /sillyspec:scan                 — 扫描子项目
+```
+
+#### 3e. 子项目详情（`info <name>`）
+
+显示指定子项目的详细信息，包括 PROJECT.md、REQUIREMENTS.md 内容摘要、代码库文档列表。
+
+### Step 4: config.yaml 格式
+
+保持标准格式：
+
+```yaml
+projects:
+  <name>:
+    path: <relative-path>
+    role: <description>
+
+shared:
+  - <filename.md>
+```
+
+### 最后说：
+
+> 工作区已更新。
+> 下一步：对子项目运行 `/sillyspec:init` 或 `/sillyspec:scan`。
+
+## 绝对规则
+- 不修改子项目目录下的任何文件
+- config.yaml 必须是合法 YAML
+- 子项目路径必须是相对于工作区根目录的相对路径
+- 路径必须验证存在性

package/README.md

@@ -0,0 +1,158 @@
+# SillySpec v2.3 — 规范驱动开发工具包
+
+> 融合 Superpowers + OpenSpec + GSD，从"你说要啥"到"代码能跑"的完整流程。
+> Claude Code / Cursor / Codex / OpenCode / OpenClaw 都能用。
+>
+> 📖 **在线文档**：https://sillyspec.ppdmq.top/
+
+## 安装
+
+需要 Node.js >= 18。所有平台一条命令：
+
+```bash
+npx sillyspec init
+```
+
+> 📦 首次运行自动安装 CLI，之后 `sillyspec status`/`sillyspec next` 等命令也可直接使用。
+
+**指定工具：**
+```bash
+npx sillyspec init --tool claude
+npx sillyspec init --tool cursor
+npx sillyspec init --tool openclaw
+```
+
+**工作区模式（多项目）：**
+```bash
+npx sillyspec init --workspace
+```
+
+**指定目录：**
+```bash
+npx sillyspec init --dir /path/to/project
+```
+
+### 支持的 AI 工具
+
+| 工具 | `--tool` 参数 | 输出目录 | 格式 |
+|---|---|---|---|
+| Claude Code (commands) | `claude` | `.claude/commands/sillyspec/` | slash commands |
+| Claude Code (skills) | `claude_skills` | `.claude/skills/sillyspec-<name>/` | SKILL.md |
+| Cursor | `cursor` | `.cursor/commands/` | custom commands |
+| Codex | `codex` | `~/.agents/skills/sillyspec-<name>/` | SKILL.md |
+| OpenCode | `opencode` | `.opencode/skills/sillyspec-<name>/` | SKILL.md |
+| OpenClaw | `openclaw` | `.openclaw/skills/sillyspec-<name>/` | SKILL.md |
+
+安装后重新打开终端，启动 Claude Code：
+
+```bash
+claude --dangerously-skip-permissions
+```
+
+> 💡 **推荐使用跳过权限模式。** SillySpec 的命令会频繁执行 `git commit`、文件读写、校验脚本等操作，停下来 50 次批准会失去意义。这是 GSD 和 OpenSpec 的预期使用方式。
+
+## 入口选择
+
+```
+绿地项目（空目录）：/sillyspec:init
+棕地项目（有代码）：/sillyspec:scan
+随时自由思考：      /sillyspec:explore "想法"
+大模块（多页面）：  /sillyspec:brainstorm（直接贴原型图）
+```
+
+## 完整工作流
+
+```
+绿地：init → brainstorm → propose → plan → execute → verify → archive
+棕地：scan → brainstorm → propose → plan → execute → verify → archive
+大模块：brainstorm(多图) → 拆分 → MASTER.md → stage-1 全流程 → stage-2 全流程 → ... → archive
+```
+
+### 也可以跳过
+
+- 小 bug：`/sillyspec:quick "修复 xxx"`
+- 不确定要做什么：`/sillyspec:explore "想法"`
+- 中断恢复：`/sillyspec:resume`
+- 不知道下一步：`/sillyspec:continue`
+
+## 命令列表
+
+### 核心流程
+
+| 命令 | 用途 |
+|---|---|
+| `/sillyspec:init` | 绿地项目：深度提问→需求→路线图 |
+| `/sillyspec:scan` | 棕地项目：交互式引导扫描，生成代码库文档 |
+| `/sillyspec:brainstorm` | 需求探索：支持原型图分析，大模块自动拆分 |
+| `/sillyspec:propose` | 生成规范：proposal+design+tasks |
+| `/sillyspec:plan` | 实现计划：精确文件路径+代码 |
+| `/sillyspec:execute` | TDD 执行：子代理并行+两阶段审查 |
+| `/sillyspec:verify` | 验证：对照规范+测试套件 |
+| `/sillyspec:archive` | 归档：规范沉淀 |
+
+### 辅助工具
+
+| 命令 | 用途 |
+|---|---|
+| `/sillyspec:status` | 查看进度 |
+| `/sillyspec:continue` | 自动下一步 |
+| `/sillyspec:explore` | 自由思考：画图、讨论、调研 |
+| `/sillyspec:quick` | 快速模式：跳过完整流程 |
+| `/sillyspec:handoff` | 保存状态，下班走人 |
+| `/sillyspec:resume` | 恢复工作：支持大模块阶段进度 |
+| `/sillyspec:workspace` | 工作区管理：多项目子项目 |
+| `/sillyspec:export` | 导出成功方案为可复用模板 |
+
+## 可靠性保障
+
+SillySpec 不仅仅是 prompt，还有硬校验：
+
+- **锚定确认** — propose/plan/execute/verify 执行前必须逐个确认读过规范文件
+- **Hard Gate 自检** — 关键命令生成文件后强制自检格式，不通过则修正
+- **校验脚本** — shell 脚本可自动化验证 AI 输出（validate-proposal/plan/scan/all）
+- **框架隐形规则扫描** — scan 阶段自动检测多租户/逻辑删除/审计字段/实体基类，写入 CONVENTIONS.md
+- **实体继承规范扫描** — 新建表时必须包含基类所有字段，防止 Unknown column
+- **归档确认** — archive 操作前展示内容等待用户确认
+
+## 防幻觉机制
+
+| 环节 | 机制 |
+|---|---|
+| scan | 强制扫描数据库 schema + 框架隐形规则 + 实体基类字段 |
+| brainstorm | 必须读 ARCHITECTURE.md 数据模型，支持原型图分析 |
+| execute | 写代码前强制读现有源码，禁止编造方法调用 |
+| 全流程 | shell 校验脚本兜底 |
+
+## 目录结构
+
+```
+sillyspec/
+├── cli/                              # Node.js CLI（npx sillyspec）
+│   ├── bin/sillyspec.js              # 入口
+│   ├── src/
+│   │   ├── index.js                  # status/next/check/init 命令
+│   │   └── init.js                   # init 逻辑 + 工具适配器
+│   └── templates/                    # 内置命令模板
+├── commands/sillyspec/              # slash commands（Claude Code）
+├── templates/                       # 纯 prompt 模板（工具无关）
+├── adapters/
+│   └── adapters.sh                  # 多工具格式转换函数（bash 版，已废弃）
+├── scripts/
+│   ├── init.sh                      # init 入口（转发给 CLI）
+│   ├── validate-proposal.sh         # 校验 propose 输出
+│   ├── validate-plan.sh             # 校验 plan 输出
+│   ├── validate-scan.sh             # 校验 scan 输出
+│   └── validate-all.sh              # 综合校验
+├── 操作文档.md                       # 详细操作指南
+└── README.md
+```
+
+## 致谢
+
+- [Superpowers](https://github.com/obra/superpowers) — 工程纪律
+- [OpenSpec](https://github.com/Fission-AI/OpenSpec) — 需求管理
+- [GSD](https://github.com/gsd-build/get-shit-done) — 上下文工程
+
+## License
+
+MIT

package/SKILL.md

@@ -0,0 +1,46 @@
+---
+name: sillyspec
+description: "规范驱动开发工具包。绿地项目用 /sillyspec:init，棕地项目用 /sillyspec:scan。可用命令：init、scan、explore、brainstorm、propose、plan、execute、verify、archive、status、handoff、resume、continue、quick、workspace。"
+version: "2.0.0"
+---
+
+# SillySpec v2.0
+
+融合 Superpowers + OpenSpec + GSD，14 个真实 slash commands。
+
+## 入口选择
+
+| 项目类型 | 首选命令 |
+|---|---|
+| 全新项目（空目录） | `/sillyspec:init` |
+| 已有代码的项目 | `/sillyspec:scan` |
+| 多项目工作区 | `/sillyspec:workspace` |
+| 随时自由思考 | `/sillyspec:explore` |
+
+## 完整工作流
+
+```
+绿地：init → brainstorm → propose → plan → execute → verify → archive
+棕地：scan → brainstorm → propose → plan → execute → verify → archive
+工作区：workspace → (init/scan per project) → brainstorm → ...
+```
+
+## 15 个命令
+
+| 命令 | 用途 |
+|---|---|
+| `/sillyspec:init` | 绿地项目初始化 |
+| `/sillyspec:scan` | 棕地项目扫描（7 份文档） |
+| `/sillyspec:explore` | 自由思考模式 |
+| `/sillyspec:brainstorm` | 需求探索 |
+| `/sillyspec:propose` | 生成规范 |
+| `/sillyspec:plan` | 实现计划 |
+| `/sillyspec:execute` | TDD 执行 |
+| `/sillyspec:verify` | 验证 |
+| `/sillyspec:archive` | 归档 |
+| `/sillyspec:status` | 查看进度 |
+| `/sillyspec:continue` | 自动下一步 |
+| `/sillyspec:handoff` | 保存状态 |
+| `/sillyspec:resume` | 恢复工作 |
+| `/sillyspec:quick` | 快速模式 |
+| `/sillyspec:workspace` | 多项目工作区管理（add/remove/status） |