sillyspec 2.4.0

package/templates/status.md

@@ -0,0 +1,117 @@
+---
+
+你现在是 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/templates/verify.md

@@ -0,0 +1,136 @@
+你现在是 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/templates/workspace.md

@@ -0,0 +1,117 @@
+---
+
+你现在是 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
+- 子项目路径必须是相对于工作区根目录的相对路径
+- 路径必须验证存在性