sillyspec 2.4.4 → 2.5.0

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

@@ -1,117 +1,37 @@
----
+## 交互规范
+**当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项以参数传入。**
+
+## 核心约束（必须遵守）
+- ❌ 修改任何文件（只读）
 
-你现在是 SillySpec 的状态检查器。
+---
 
 ## 流程
 
-### 0: 检查工作区模式
+### Step 1: 检查工作区模式
 
 ```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. 输出汇总：
-
-```
-🏢 工作区状态
+**工作区模式：** 读取 config.yaml 子项目列表，对每个子项目检查 PROJECT.md、codebase 文档数、进行中变更、归档数。检查共享规范和工作区概览。输出汇总后结束，不执行单项目流程。
 
-📦 子项目：
+**单项目模式：** 继续 Step 2。
 
-  ✅ frontend  ./frontend
-     📋 项目：已初始化
-     📂 代码库：已扫描（7 份文档）
-     🔄 进行中：1 个变更
-        - [user-auth] Phase 3 (Execute) — tasks 5/8
-     ✅ 已归档：3 个变更
+### Step 2-5: 单项目检查
 
-  ⚠️ backend   ./backend
-     📋 项目：已初始化
-     📂 代码库：未扫描
-     🔄 进行中：0 个变更
+1. **项目基础：** PROJECT.md、codebase 文档、REQUIREMENTS.md、ROADMAP.md
+2. **进行中变更：** 对每个变更检查 proposal/design/requirements/tasks 完成度
+3. **归档历史：** `ls .sillyspec/changes/archive/ | wc -l`
+4. **代码库文档：** `ls .sillyspec/codebase/`
 
-📄 共享规范：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. 输出
+### Step 6: 输出
 
 ```
 📊 SillySpec 状态
-
-📋 项目：xxx（已初始化 / 未初始化）
+📋 项目：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

@@ -1,18 +1,21 @@
-你现在是 SillySpec 的验证器。
+## 交互规范
+**当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项以参数传入。**
 
-## 🛑 流程控制（必须先执行）
+## 核心约束（必须遵守）
+- ❌ 修改任何代码（只做检查和报告）
+- ❌ 跳过状态检查
+- ❌ 自行推进到下一阶段
 
-**在开始任何工作之前，先调用 SillySpec CLI 检查当前状态：**
+## 状态检查（必须先执行）
 
 ```bash
 sillyspec status --json
 ```
 
-**根据 CLI 返回的 phase 决定是否允许执行 verify：**
-- `phase: "verify"` → ✅ 可以继续
-- 其他 phase → ❌ 不允许跳步，提示用户运行 `sillyspec next` 获取正确步骤
+- `phase: "verify"` → ✅ 继续
+- 其他 phase → 提示 `sillyspec next`
 
-**不要跳过状态检查。不要自己推断阶段。以 CLI 为准。**
+---
 
 ## 流程
 
@@ -20,53 +23,28 @@ sillyspec status --json
 
 ```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
+cat "$LATEST"/{proposal,design,tasks}.md "$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 报告状态：
-- ✅ 已完成 / ❌ 未完成 / ⚠️ 部分完成
+对每个 checkbox 报告：✅ 已完成 / ❌ 未完成 / ⚠️ 部分完成
 
 ### 3. 对照 design.md
 
-- 架构决策是否遵循？
-- 文件变更清单是否一致？
-- 数据模型是否符合？
-- API 设计是否符合？
+架构决策？文件变更一致性？数据模型？API 设计？
 
-### 4. 运行完整测试套件（fresh run）
+### 4. 运行测试套件
 
 ```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
 ```
 
@@ -74,63 +52,21 @@ grep -r "TODO\|FIXME\|HACK\|XXX" src/ lib/ app/ --include="*.ts" --include="*.ts
 
 ```markdown
 # SillySpec 验证报告
-
-## 任务完成度
-- [x] Task 1: xxx ✅
-- [x] Task 2: xxx ✅
-- [ ] Task 3: xxx ❌ 未实现
-完成度：2/3
-
+## 任务完成度：X/Y
 ## 设计一致性
-- ✅ 架构决策遵循
-- ⚠️ API 返回格式与 design.md 略有差异（缺少 error 字段）
-
-## 测试结果
-- passed: 42, failed: 3
-
+## 测试结果：passed N, failed N
 ## 技术债务标记
-- src/auth/login.ts:15 // TODO: add rate limiting
-- src/auth/login.ts:45 // FIXME: token expiry
-
-## 结论
-⚠️ PASS WITH NOTES
+## 结论：✅ PASS / ⚠️ PASS WITH NOTES / ❌ FAIL
 ```
 
-## 脚本校验（硬验证）
-
-在输出验证报告之前，运行综合校验脚本：
-
-```bash
-bash scripts/validate-all.sh
-```
-
-将脚本输出纳入验证报告中的"设计一致性"部分。
-
-### 7. 最后说：
-
-**用 CLI 验证并获取下一步：**
-
 ```bash
-sillyspec status --json
+bash scripts/validate-all.sh 2>/dev/null
 ```
 
-展示结果给用户，然后：
+### 7. 完成
 
 ```bash
-sillyspec next
+sillyspec status --json && sillyspec next
 ```
 
-将 CLI 返回的命令推荐给用户。**不要自己编建议。**
-
-### 8. 更新 STATE.md
-
-verify 完成后，**必须自动更新** `.sillyspec/STATE.md`：
-
-- 当前阶段改为 `verify ✅` 或 `verify ⚠️`
-- 下一步改为 `/sillyspec:archive`（PASS 时）或 `修复后重新 /sillyspec:verify`
-- 如果是子阶段，更新阶段进度；如果全部阶段完成，下一步改为 `/sillyspec:archive`
-- 历史记录追加时间 + 验证结果
-
-## 绝对规则
-- 不修改任何代码
-- 只做检查和报告
+更新 `.sillyspec/STATE.md`：阶段改为 `verify ✅` 或 `verify ⚠️`。

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

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

package/.sillyspec/config.yaml

@@ -0,0 +1,13 @@
+# SillySpec 工作区配置
+# 修改此文件后运行 /sillyspec:workspace 更新
+
+projects: {}
+  # 示例：
+  # frontend:
+  #   path: ./frontend
+  #   role: 前端 - Vue3 + TypeScript
+  # backend:
+  #   path: ./backend
+  #   role: 后端 - Node.js + PostgreSQL
+
+shared: []

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sillyspec",
-  "version": "2.4.4",
+  "version": "2.5.0",
   "description": "SillySpec CLI — 流程状态机，让 AI 严格按步骤来",
   "type": "module",
   "bin": {
@@ -16,5 +16,10 @@
     "cursor",
     "spec-driven"
   ],
-  "license": "MIT"
+  "license": "MIT",
+  "dependencies": {
+    "@inquirer/prompts": "^7.10.1",
+    "chalk": "^5.6.2",
+    "ora": "^9.3.0"
+  }
 }

package/src/index.js

@@ -498,7 +498,7 @@ SillySpec CLI — 流程状态机
 `);
 }
 
-function main() {
+async function main() {
   const args = process.argv.slice(2);
   
   if (args.length === 0 || args[0] === 'help' || args[0] === '--help' || args[0] === '-h') {
@@ -548,7 +548,7 @@ function main() {
       cmdCheck(dir, { json });
       break;
     case 'init':
-      cmdInit(dir, { tool, workspace });
+      await cmdInit(dir, { tool, workspace });
       break;
     default:
       console.error(`❌ 未知命令: ${command}`);