sillyspec 3.8.4 → 3.8.6

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

@@ -1,149 +0,0 @@
----
-name: sillyspec:workspace
-description: 工作区管理 — 初始化、管理多项目工作区，查看子项目状态
----
-
-## 交互规范
-
-**当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项以参数传入。**
-
-不要用编号列表让用户手动输入数字。
-如果需要自由输入，在 AskUserQuestion 的选项中加入"Other（自定义输入）"。
-
----
-
-你现在是 SillySpec 的工作区管理器。
-
-## 用户指令
-$ARGUMENTS
-
-## 核心流程
-
-### Step 1: 检查工作区配置
-
-```bash
-ls .sillyspec/projects/*.yaml 2>/dev/null | grep -q .
-```
-
-如果不存在 → 这是一个尚未配置工作区的项目。询问用户：
-   1. 初始化工作区
-   2. 跳过
-
-### Step 2: 解析指令
-
-根据 `$ARGUMENTS` 或默认行为：
-
-- **无参数 / `status`** → 显示工作区状态
-- **`add`** → 添加子项目
-- **`remove`** → 移除子项目
-- **`info`** → 显示某个子项目详情
-- 无参数且 projects/*.yaml 不存在 → 初始化工作区
-
-### Step 3: 执行对应操作
-
-#### 3a. 初始化工作区（projects/ 不存在时）
-
-1. 询问工作区名称（默认用当前目录名）
-2. 逐个添加子项目：
-   - 询问子项目名称（如 `frontend`、`backend`）
-   - 询问子项目路径（相对于工作区根目录，如 `./frontend`）
-   - 询问子项目角色描述（如 `前端 - Vue3 + TypeScript`）
-   - 询问仓库地址（可选）
-   - 验证路径存在
-   添加完后询问：
-   > 1. 继续添加子项目
-   > 2. 完成，配置共享规范
-3. 询问共享规范文件
-4. 为每个子项目创建 `.sillyspec/projects/<name>.yaml`：
-   ```yaml
-   name: <name>
-   path: <relative-path>
-   status: active
-   role: <description>
-   repo: <repo-url>  # 可选
-   ```
-5. 创建 `.sillyspec/shared/` 目录
-
-#### 3b. 添加子项目（`add`）
-
-1. 询问名称、路径、角色
-2. 验证路径存在
-3. 创建/更新 `.sillyspec/projects/<name>.yaml`
-4. Git 提交
-
-#### 3c. 移除子项目（`remove`）
-
-1. 显示当前所有子项目列表
-2. 询问要移除哪个：
-   > 1. （列出子项目名称）
-   > 2. 取消
-3. 删除 `.sillyspec/projects/<name>.yaml`
-4. Git 提交
-
-#### 3d. 工作区状态（`status`，默认）
-
-读取所有 `projects/*.yaml`，对每个子项目检查：
-
-```bash
-# 读取子项目列表
-for f in .sillyspec/projects/*.yaml; do
-  [ -f "$f" ] || continue
-  proj_name=$(basename "$f" .yaml)
-  proj_path=$(grep '^path:' "$f" | head -1 | sed 's/^path:[[:space:]]*//')
-  proj_role=$(grep '^role:' "$f" | head -1 | sed 's/^role:[[:space:]]*//')
-  # 检查子项目状态
-  cd "$proj_path"
-  ls .sillyspec/ 2>/dev/null
-  cat .sillyspec/PROJECT.md 2>/dev/null
-  ls docs/${proj_name}/scan/ 2>/dev/null | wc -l
-  cd -
-done
-```
-
-输出格式：
-
-```
-🏢 工作区：<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: projects/*.yaml 格式
-
-每个子项目对应 `.sillyspec/projects/<name>.yaml`：
-
-```yaml
-name: frontend
-path: ./frontend
-status: active
-role: 前端 - Vue3 + TypeScript
-repo: https://github.com/xxx/frontend.git  # 可选
-```
-
-### 最后说：
-
-> 工作区已更新。
-> 下一步：对子项目运行 `/sillyspec:init` 或 `/sillyspec:scan`。
-
-## 绝对规则
-- 不修改子项目目录下的任何文件
-- projects/*.yaml 必须是合法 YAML
-- 子项目路径必须是相对于工作区根目录的相对路径
-- 路径必须验证存在性

package/.sillyspec/changes/archive/2026-04-08-derive-state/design.md

@@ -1,97 +0,0 @@
-# deriveState 状态推导
-
-author: qinyi
-created_at: 2026-04-08 07:10:00
-
-## 背景
-
-当前 sillyspec 的状态管理依赖 `progress.json` 作为唯一数据源。如果 AI 崩溃或异常中断，progress.json 可能与实际产出不一致（如 artifacts 文件已生成但步骤未标记完成）。
-
-借鉴 GSD v2 的 deriveState 架构，从文件系统反推状态，与 progress.json 交叉校验。
-
-## 需求
-
-1. `--done` 完成步骤时轻量校验当前步骤
-2. `doctor` 自检时全量扫描所有阶段
-3. `progress validate --deep` 支持手动触发全量校验
-4. 安全修复策略：明显正确的情况自动修复，有歧义的不动
-
-## 设计
-
-### 新增文件：`src/derive.js`
-
-纯函数模块，零外部依赖（仅 fs/path）。
-
-```js
-export function deriveState(cwd, options = {}) {
-  // options.mode: 'light' | 'full'（默认 light）
-  // options.fix: boolean（默认 false，只报告不修复）
-  // 返回 { issues: [{type, severity, step, artifact, suggestion}], fixed: number }
-}
-```
-
-#### 扫描逻辑
-
-1. 读取 progress.json，获取所有阶段步骤状态
-2. 扫描 `.sillyspec/.runtime/artifacts/` 目录
-3. 文件名格式：`{stage}-step{N}-{timestamp}.txt`
-4. 解析文件名提取 stage、stepIndex 信息
-5. 对比规则：
-
-| 情况 | 严重度 | 自动修复 |
-|------|--------|----------|
-| artifacts 有文件但 progress 标记未完成 | issue | ✅ 标记为 done |
-| progress 标记已完成但 artifacts 无文件 | warning | ❌ 可能被手动清理 |
-| artifacts 有 step5 但 progress 只到 step3 | issue | ✅ 补齐中间步骤 |
-
-#### 模式
-
-- **light**：只检查 currentStage 的当前步骤和前一步
-- **full**：检查所有阶段所有步骤
-
-### 集成方式
-
-#### 1. run.js — `--done` 轻量校验
-
-在 `completeStep` 末尾：
-```js
-import { deriveState } from './derive.js';
-const result = deriveState(cwd, { mode: 'light', fix: true });
-if (result.fixed > 0) {
-  console.log(`⚠️ 状态修复：${result.fixed} 个步骤已从 artifacts 恢复`);
-}
-```
-
-#### 2. doctor.js — 全量扫描
-
-第一步（SillySpec 内部检查）调用：
-```js
-const result = deriveState(cwd, { mode: 'full', fix: false });
-// 将 issues 加入自检报告
-```
-
-#### 3. progress.js — `validate --deep`
-
-validate 方法支持 deep 参数：
-```js
-validate(cwd, deep = false) {
-  // ...现有校验逻辑...
-  if (deep) {
-    const result = deriveState(cwd, { mode: 'full', fix: true });
-    // 输出校验结果
-  }
-}
-```
-
-CLI：`sillyspec progress validate --deep`
-
-## 改动范围
-
-- 新增：`src/derive.js`（~80 行）
-- 修改：`src/run.js`（2 行）、`src/stages/doctor.js`（3 行）、`src/progress.js`（5 行）、`src/index.js`（parse --deep）
-
-## 不做的事
-
-- 不引入 SQLite 或其他新依赖
-- 不改变 progress.json 的数据结构
-- 不自动删除 progress 中有但 artifacts 无的步骤（可能被手动清理）

package/.sillyspec/changes/archive/2026-04-08-derive-state/plan.md

@@ -1,51 +0,0 @@
-# deriveState 状态推导 — 实现计划
-
-author: qinyi
-created_at: 2026-04-08 07:12:00
-
-## Wave 1（核心，无依赖）
-
-- [ ] 实现 derive.js 核心函数
-  - 新增: `src/derive.js`
-  - 步骤:
-    1. 实现 `deriveState(cwd, options)` 纯函数
-    2. 实现 artifacts 文件名解析（`{stage}-step{N}-{timestamp}.txt`）
-    3. 实现 light/full 模式扫描逻辑
-    4. 实现安全修复策略（issues 分类 + fix 逻辑）
-    5. 验证: 在 sillyspec 项目上手动创建测试 artifacts，运行 `node -e "import('./src/derive.js').then(m => console.log(m.deriveState(process.cwd(), {mode:'full'})))"` 确认输出
-
-## Wave 2（集成，依赖 Wave 1）
-
-- [ ] 集成 run.js --done 轻量校验
-  - 修改: `src/run.js`
-  - 参考: `completeStep` 函数末尾
-  - 步骤:
-    1. 在 completeStep 末尾 import 并调用 deriveState(cwd, {mode:'light', fix:true})
-    2. 有修复时输出警告信息
-    3. 验证: 运行 brainstorm 完成 --done，确认无报错
-
-- [ ] 扩展 validate 支持 --deep
-  - 修改: `src/progress.js`
-  - 参考: `validate()` 方法
-  - 步骤:
-    1. validate 方法加 deep 参数
-    2. deep=true 时调用 deriveState(cwd, {mode:'full', fix:true})
-    3. 验证: `sillyspec progress validate --deep` 确认输出校验结果
-
-- [ ] CLI parse --deep 参数
-  - 修改: `src/index.js`
-  - 参考: progress 子命令的参数解析
-  - 步骤:
-    1. 在 progress validate 命令中解析 --deep flag
-    2. 传递给 validate 方法
-    3. 验证: `sillyspec progress validate --deep` 确认 flag 生效
-
-## Wave 3（集成，依赖 Wave 1）
-
-- [ ] 集成 doctor.js 全量扫描
-  - 修改: `src/stages/doctor.js`
-  - 参考: doctor 第一步（SillySpec 内部检查）的 prompt
-  - 步骤:
-    1. 在第一步 prompt 中加入 deriveState 全量扫描指令
-    2. 将 issues 列表纳入自检报告
-    3. 验证: `sillyspec run doctor` 确认第一步输出包含状态一致性检查

package/.sillyspec/changes/archive/2026-04-08-derive-state/proposal.md

@@ -1,29 +0,0 @@
-# deriveState 状态推导 — 提案
-
-author: qinyi
-created_at: 2026-04-08 07:11:00
-
-## 动机
-
-当前 progress.json 是 sillyspec 唯一的状态数据源。AI 崩溃或异常中断时，progress.json 可能与实际产出不一致（artifacts 已生成但步骤未标记完成）。需要从文件系统反推状态，交叉校验。
-
-## 变更范围
-
-- 新增 `src/derive.js`（状态推导纯函数）
-- 修改 `src/run.js`（--done 轻量校验）
-- 修改 `src/stages/doctor.js`（全量扫描）
-- 修改 `src/progress.js`（validate --deep）
-- 修改 `src/index.js`（parse --deep 参数）
-
-## 不在范围内
-
-- 不改 progress.json 数据结构
-- 不引入新依赖
-- 不自动删除 progress 中有但 artifacts 无的步骤
-
-## 成功标准
-
-1. `--done` 完成步骤时自动校验并修复当前步骤
-2. `doctor` 输出全量状态一致性报告
-3. `sillyspec progress validate --deep` 可手动触发全量校验
-4. 所有校验通过现有测试

package/.sillyspec/changes/archive/2026-04-08-derive-state/requirements.md

@@ -1,34 +0,0 @@
-# deriveState 状态推导 — 需求
-
-author: qinyi
-created_at: 2026-04-08 07:11:00
-
-## 功能需求
-
-### FR1: deriveState 核心函数
-- 从 artifacts 目录扫描文件，解析 `{stage}-step{N}-{timestamp}.txt` 格式
-- 与 progress.json 步骤状态对比
-- 返回 issues 列表和修复计数
-
-### FR2: 轻量模式（light）
-- 只检查 currentStage 的当前步骤和前一步
-- 用于 `--done` 完成时
-
-### FR3: 全量模式（full）
-- 检查所有阶段所有步骤
-- 用于 doctor 和 validate --deep
-
-### FR4: 安全修复策略
-- artifacts 有但 progress 漏记 → 自动修复为 done
-- artifacts 有 step5 但 progress 只到 step3 → 自动补齐
-- progress 有但 artifacts 无 → 只警告，不修复
-
-### FR5: CLI 集成
-- `--done` 时静默调用轻量校验，有修复才输出
-- `doctor` 第一步输出全量报告
-- `sillyspec progress validate --deep` 手动触发
-
-## 非功能需求
-- 零外部依赖（仅 fs/path）
-- 纯函数，易于测试
-- 不改变现有 API 行为

package/.sillyspec/changes/archive/2026-04-08-derive-state/tasks.md

@@ -1,13 +0,0 @@
-# deriveState 状态推导 — 任务
-
-author: qinyi
-created_at: 2026-04-08 07:11:00
-
-## 任务列表
-
-- [x] 实现 derive.js 核心函数 — `src/derive.js`
-- [x] 集成 run.js --done 轻量校验 — `src/run.js`
-- [x] 集成 doctor.js 全量扫描 — `src/stages/doctor.js`
-- [x] 扩展 validate 支持 --deep — `src/progress.js`
-- [x] CLI parse --deep 参数 — `src/index.js`
-- [ ] 测试验证

package/.sillyspec/changes/archive/2026-04-08-derive-state/verify-result.md

@@ -1,43 +0,0 @@
-# derive-state 验证报告
-
-author: qinyi
-created_at: 2026-04-08 07:21:00
-
-## 结论：✅ PASS
-
-## 检查结果
-
-### 1. 规范文件加载
-- ✅ design.md
-- ✅ proposal.md
-- ✅ requirements.md
-- ✅ tasks.md
-- ✅ plan.md
-
-### 2. 任务完成度：5/6 (83%)
-- ✅ 实现 derive.js 核心函数
-- ✅ 集成 run.js --done 轻量校验
-- ✅ 集成 doctor.js 全量扫描
-- ✅ 扩展 validate 支持 --deep
-- ✅ CLI parse --deep 参数
-- ⬜ 测试验证（本项目无自动化测试套件，通过手动验证替代）
-
-### 3. 设计一致性
-- ✅ derive.js 纯函数模块，零外部依赖（仅 fs/path）
-- ✅ light/full 模式
-- ✅ fix 参数 + 安全修复策略
-- ✅ run.js --done 轻量校验集成
-- ✅ doctor.js 全量扫描集成
-- ✅ progress.js validate --deep 支持
-- ✅ index.js CLI --deep 参数
-- ✅ 改动文件范围与 design.md 一致
-
-### 4. 测试和质量
-- ✅ derive.js 模块导入正常
-- ✅ sillyspec progress validate --deep 通过
-- ✅ 无 TODO/FIXME/HACK/XXX 技术债务
-- ✅ sillyspec run quick --status 正常
-- ✅ sillyspec run doctor --status 正常
-
-## 下一步
-sillyspec run archive

package/.sillyspec/changes/auto-mode/design.md

@@ -1,50 +0,0 @@
-# auto mode — 设计文档
-
-author: qinyi
-created_at: 2026-04-08 07:28:00
-
-## 背景
-
-当前 sillyspec 的每个阶段（brainstorm → plan → execute → verify）需要用户手动执行 `sillyspec run <stage>` 和 `sillyspec run <stage> --done`。用户希望一个自动模式，从 brainstorm 一路推进到 verify 完成。
-
-## 需求
-
-1. 用户启动一次，AI 自动循环所有阶段和步骤
-2. 步骤内部的用户确认点保留不变
-3. 不修改 CLI 代码，纯 skill 文件实现
-
-## 设计
-
-### 新增文件：`.claude/skills/sillyspec-auto/SKILL.md`
-
-**核心逻辑：**
-
-1. 读 `$ARGUMENTS` 作为用户需求
-2. 阶段循环（brainstorm → plan → execute → verify）
-3. 每个阶段内步骤循环：
-   - `sillyspec run <stage> --input "需求"` → 读 step prompt
-   - 执行 prompt 中的操作
-   - 需要用户确认的步骤 → 暂停等回复
-   - 完成后自动 `sillyspec run <stage> --done --output "摘要"`
-   - 读下一步 prompt，继续
-4. 当前阶段全部完成 → 自动进入下一阶段
-5. verify 完成 → 输出总结，停止
-6. 命令失败 → 暂停，等用户介入
-
-**确认点保留规则：**
-- prompt 中有"请用户选择""等待用户回答""展示给用户"等字样 → 暂停
-- prompt 中有"自审""检查"等纯内部操作 → 自动完成
-
-### 同步到 npm 包
-
-init.js 已有逻辑复制 `sillyspec-*` skills 到项目 `.claude/skills/`，新 skill 自动生效。
-
-## 改动范围
-
-- 新增：`.claude/skills/sillyspec-auto/SKILL.md`（~60 行）
-
-## 不做的事
-
-- 不修改任何 JS 源码
-- 不改变现有阶段流程
-- 不自动 commit 或发布

package/.sillyspec/changes/auto-mode/proposal.md

@@ -1,19 +0,0 @@
-# auto mode — 提案
-
-author: qinyi
-created_at: 2026-04-08 07:29:00
-
-## 动机
-用户希望一次启动就自动完成 brainstorm → plan → execute → verify 全流程，不需要手动输入 `sillyspec run <stage>` 和 `--done`。
-
-## 变更范围
-新增 `.claude/skills/sillyspec-auto/SKILL.md`
-
-## 不在范围内
-- 不修改 JS 源码
-- 不改变阶段流程
-
-## 成功标准
-1. `/sillyspec:auto "需求"` 能自动推进全流程
-2. 步骤内部确认点正常暂停
-3. 异常时暂停等用户介入

package/.sillyspec/changes/auto-mode/requirements.md

@@ -1,21 +0,0 @@
-# auto mode — 需求
-
-author: qinyi
-created_at: 2026-04-08 07:29:00
-
-## 功能需求
-
-### FR1: 阶段自动推进
-- 按 brainstorm → plan → execute → verify 顺序自动执行
-- 当前阶段完成后自动进入下一阶段
-
-### FR2: 步骤自动循环
-- 每个步骤：读 prompt → 执行 → 自动 --done → 读下一步
-- 不需要用户手动触发 --done
-
-### FR3: 确认点保留
-- prompt 中有用户确认要求时暂停等回复
-- 纯内部操作步骤自动完成
-
-### FR4: 异常处理
-- 命令失败时暂停，展示错误，等用户介入

package/.sillyspec/changes/auto-mode/tasks.md

@@ -1,7 +0,0 @@
-# auto mode — 任务
-
-author: qinyi
-created_at: 2026-04-08 07:29:00
-
-- [x] 编写 sillyspec-auto SKILL.md — `.claude/skills/sillyspec-auto/SKILL.md`
-- [x] 同步到 agents skills — `~/.agents/skills/sillyspec-auto/SKILL.md`