sillyspec 3.28.0 → 3.28.3

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

@@ -1,87 +1,16 @@
----
-name: sillyspec:propose
-description: 生成结构化规范 — proposal + design + tasks。适合用户说"生成规范、补全四件套、propose"。产出 proposal.md + design.md + tasks.md（+ 可能的 requirements.md）。
----
-
-## 何时使用
-
-- 用户说"生成规范、补全四件套、propose"
-- 已有零散设计/需求，需补全结构化规范四件套
-- 产出：`proposal.md` + `design.md` + `tasks.md`（+ 可选 `requirements.md`）
-
-> 注：propose 与 brainstorm 都产出四件套。brainstorm 是从需求开始的完整设计流程；propose 更偏"补全/生成规范"。新需求一般走 brainstorm。
-
-## 多变更说明
-
-项目有多个活跃变更（`.sillyspec/changes/` 下有多个目录）时，所有 `sillyspec run` 命令需加 `--change <变更名>` 指定操作目标；只有一个变更时可省略（CLI 自动检测）。
-
-## 步骤生命周期（所有阶段通用）
-
-> `sillyspec run propose` 需用 `run` 形式（propose 无顶层别名，与 brainstorm/plan 等不同）。
-
-```bash
-sillyspec run propose                          # 输出当前步骤 prompt
-sillyspec run propose --done --output "摘要"   # 完成当前步骤
-sillyspec run propose --status                 # 查看阶段进度
-sillyspec run propose --skip                   # 跳过可选步骤
-sillyspec run propose --reset                  # 重置阶段（从头开始）
-sillyspec run propose --reopen --from-step N   # 重新打开已完成阶段修订
-```
-
-## 通用参数（所有阶段适用）
-
-| 参数 | 说明 |
-|---|---|
-| `--change <名>` | 指定变更名（多活跃变更必填，单变更可省略自动检测） |
-| `--spec-dir <path>` | 指定规范目录（默认 `<项目>/.sillyspec`） |
-| `--non-interactive` | CI/脚本下禁用交互式 prompt |
-| `--skip-approval` | 跳过审批/校验门控 |
-| `--json` | 输出 JSON（程序化读取） |
-
-## propose 特有：自检门控
-
-propose 含自检步骤（按规模分级：tier=self 当前 agent 自审 / tier=independent 启动独立审查子代理产出 stage review.json），完成时校验四件套文档齐全 + 内容章节（如 proposal 的 Non-Goals、design 的文件变更清单/风险登记/自审）。缺失会阻断完成。
-
-### Stage Review Gate（propose 的 proposal review.json）
-
-propose 在 `tier=independent` 时产出一个 stage 级 `review.json`，CLI `Stage Review Gate` 硬校验其 schema 与 `docHash` 真实性。
-
-- 路径：`.sillyspec/.runtime/stage-reviews/propose-review-<stage-review-run-id>/review.json`（目录可能不存在需手建；run-id 由该步 `--done` prompt 输出指定）。marker 文件 `.runtime/current-stage-review-run-id-propose-<变更名>`。
-- 字段（`schemaVersion:1`，`reviewType=proposal` —— propose 阶段主审查文档是 `proposal.md`）：
-
-  ```json
-  {
-    "schemaVersion": 1,
-    "reviewType": "proposal",
-    "reviewedFiles": ["changes/<变更名>/proposal.md"],   // [0] 为主文档
-    "docHash": "<sha256(reviewedFiles[0] 文件内容，hex)>",
-    "specVerdict": "pass",       // pass | fail | cannot_verify
-    "qualityVerdict": "pass",    // pass | fail | cannot_verify
-    "checklist": [               // 扁平数组，逐条对照 proposal 章节/Non-Goals 核验
-      { "item": "Non-Goals 明确", "result": "pass", "note": "..." }   // result: pass | gap | fail
-    ],
-    "requiredEvidence": [],      // cannot_verify 时必填非空
-    "reviewerNotes": "..."
-  }
-  ```
-
-- `docHash` = `sha256(主审查文档内容)`（hex）—— propose 主文档是 `proposal.md`（`reviewedFiles[0]`）。CLI 重算 sha256 比对，不符判伪造（fail-closed）。改 proposal.md 后须重算 docHash。`tier=self`（≤3 文件）降级为当前 agent 自审。
-- 运行时 CLI 通过 `{REVIEW_JSON_CONTRACT}` 注入精确 schema+示例，以注入版为权威逐字模板。
-
-## 阶段流转
-
-```
-(零散设计/需求) → propose → plan
-```
-
-propose 完成后（四件套齐 + 自检通过），运行 `sillyspec run plan --change <变更名>` 进入实现计划。
-
-## 铁律
-
-- **必须用 exec 工具（shell）执行 CLI，不要自己编造流程**
-- 只做当前步骤 prompt 描述的操作，不跳过
-- 产物写入 CLI 输出的 `changeDir` 目录
-- 完成后立即 `--done`，不跳过
-
-## 用户指令
-$ARGUMENTS
+---
+name: sillyspec:propose
+description: 已废弃重定向 — 生成结构化规范四件套请直接走 brainstorm。适合用户说"生成规范、补全四件套、propose"——一律转用 /sillyspec:brainstorm。
+---
+
+## propose 阶段已废弃（重定向到 brainstorm）
+
+`propose` 阶段已从 CLI 移除（`src/stages/propose.js` 标注 @deprecated 且未注册进 stageRegistry）——**`sillyspec run propose` 不存在**（报「未知阶段: propose」）。本 skill 只保留触发词重定向，没有任何 propose 专属流程，勿尝试执行任何 `run propose` 命令。
+
+用户说"生成规范 / 补全四件套 / propose"时，**直接执行 `/sillyspec:brainstorm`**：
+
+- brainstorm 产出同一套四件套（`proposal.md` + `design.md` + `requirements.md` + `tasks.md`），且含需求澄清与 Design Grill 审查
+- 「已有零散设计只需补全」与「新需求从零设计」在 brainstorm 内同流程处理——若用户明确要求跳过澄清，在对话探索步骤直接说明「需求已明确」尽早推进即可
+
+## 用户指令
+$ARGUMENTS

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

@@ -1,70 +1,21 @@
----
-name: sillyspec:resume
-description: 恢复工作 — 从中断处继续
----
-
-## 交互规范
-
-**当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项传入。**
-
-不要用编号列表让用户手动输入数字。
-如果需要自由输入，在 AskUserQuestion 的选项中加入"Other（自定义输入）"。
-
----
-
-你现在是 SillySpec 的恢复管理器。
-
-## 流程
-
-### 1. 读取进度
-
-```bash
-sillyspec progress show
-```
-
-### 2. 如果有活跃变更
-
-从 `sillyspec progress show` 输出中提取并展示当前状态。
-
-然后问用户：
-   1. 直接继续执行下一步
-   2. 查看更多细节
-
-### 3. 如果没有活跃变更
-
-> 🔧 优先跑 `sillyspec next`——CLI 已内置下方探测表，直接输出「状态 + 下一步命令 + 依据」，按输出执行；异常时才按下方手工探测兜底。
-
-自动探测项目状态：
-
-```bash
-# 检查活跃变更
-ls -d .sillyspec/changes/*/ | grep -v archive 2>/dev/null
-
-# 检查大需求拆分
-ls .sillyspec/changes/*/MASTER.md 2>/dev/null
-
-# 检查扫描文档
-ls .sillyspec/docs/*/scan/ 2>/dev/null | wc -l
-
-# 检查需求/路线图
-cat .sillyspec/REQUIREMENTS.md 2>/dev/null
-cat .sillyspec/ROADMAP.md 2>/dev/null
-```
-
-根据探测结果推断：
-
-| 探测到的文件 | 推断阶段 | 建议操作 |
-|---|---|---|
-| 无任何 .sillyspec/ 内容 | 未开始 | `/sillyspec:init` 或 `/sillyspec:scan` |
-| 有 docs/ 但缺失文档 | 扫描中断 | `/sillyspec:scan`（断点续扫） |
-| 有 docs/ 7 份齐全但无 changes/ | 已扫描，未开始需求 | `/sillyspec:brainstorm "想法"` |
-| 有 REQUIREMENTS.md 但无 changes/ | 绿地项目，已有需求 | `/sillyspec:brainstorm "想法"` |
-| changes/ 下有 proposal + design，无 plan.md | 已有规范，待计划 | `/sillyspec:plan` |
-| changes/ 下有 plan.md，tasks 有未完成项 | 执行中 | `/sillyspec:execute` |
-| tasks.md / plan.md 全部 checkbox 已勾选 | 待验证 | `/sillyspec:verify` |
-| 已验证通过 | 待归档 | `/sillyspec:archive` |
-
-### 4. 关键原则
-
-- 进度数据存储在 SQLite 数据库中（`.sillyspec/.runtime/sillyspec.db`），通过 `sillyspec progress show` 命令查看
-- 进度随 `sillyspec run <stage> --done` 自动更新，不需要手动保存
+---
+name: sillyspec:resume
+description: 恢复工作 — 从中断处继续
+---
+
+## 交互规范
+
+**当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项传入。** 不要用编号列表让用户手动输入数字。需要自由输入时在选项中加入"Other（自定义输入）"。
+
+## 流程
+
+1. **读进度**：跑 `sillyspec progress show`。
+2. **有活跃变更**：把当前状态（变更/阶段/步骤）转述给用户，用 AskUserQuestion 问「直接继续执行下一步 / 查看更多细节」。
+3. **无活跃变更**：跑 `sillyspec next`——CLI 已内置全套探测（文件存在性 → 推断阶段 → 建议命令 + 依据），按输出转述并执行建议命令。勿自行 ls/cat 重算（输出与实际不符时才手工核对）。
+
+## 关键原则
+
+- 进度存 SQLite（`.sillyspec/.runtime/sillyspec.db`），随 `sillyspec run <stage> --done` 自动更新，不需要手动保存、不需要从中途状态"恢复文件"——直接续跑即可。
+
+## 用户指令
+$ARGUMENTS

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

@@ -1,64 +1,25 @@
----
-name: sillyspec:state
-description: 查看当前工作状态 — 显示 SillySpec 进度
----
-
-你现在是 SillySpec 的状态查看器。
-
-## 流程
-
-### 1. 读取进度
-
-```bash
-sillyspec progress show
-```
-
-### 2. 如果有活跃变更
-
-格式化展示当前状态：
-
-> 📊 当前状态
->
-> **变更**：<名称>
-> **阶段**：<当前阶段>
-> **进度**：<具体进度>
-> **下一步**：<命令>
->
-> **阶段进度**（大模块）：
-> （显示各阶段状态表）
->
-> **关键决策**：
-> - xxx
->
-> **阻塞项**：
-> - xxx（如无则省略）
-
-### 3. 如果没有活跃变更
-
-提示用户项目还没有开始：
-
-> 📊 还没有工作记录。
->
-> 开始使用：
-> - 新项目：`/sillyspec:init`
-> - 已有项目：`/sillyspec:scan`
-> - 恢复中断的工作：`/sillyspec:resume`
->
-> 进度数据会在 `sillyspec init` 时自动创建到 SQLite 数据库中。
-
-## progress 完整子命令（只读查询 / 诊断）
-
-```bash
-sillyspec progress show [--change <名>]    # 当前工作状态（本 skill 主命令）
-sillyspec progress check                   # 状态一致性检查（只报告，不修复）
-sillyspec progress repair                  # 修复状态元数据（dry-run，加 --apply 才真改）
-sillyspec progress validate                # 校验并修复
-sillyspec progress reset [--stage <阶段>]  # 重置进度（破坏性，慎用）
-```
-
-### 注意
-
-- 这是只读命令，**不修改任何文件**（repair/validate/reset 除外）
-- `/sillyspec:status` 查看项目整体进度（change 文件级别）
-- `/sillyspec:state` 查看当前工作状态（阶段/步骤级别）
-- 两者互补：status 看"有什么"，state 看"在做什么"
+---
+name: sillyspec:state
+description: 查看当前工作状态 — 显示 SillySpec 进度
+---
+
+## 流程
+
+跑 `sillyspec progress show [--change <名>]`，把 CLI 输出**原样转述**给用户即可——输出本身已是成品格式（变更/阶段/最近活跃/未决冲突/滞留信号/下一步建议），勿再按自备模板重排。
+
+- 多活跃变更时输出为汇总表；需要单变更细节加 `--change <名>`。
+- 输出「没有活跃的变更」时，提示用户：新项目 `/sillyspec:init`、已有项目 `/sillyspec:scan`、恢复中断 `/sillyspec:resume`。
+
+## progress 只读子命令（诊断用）
+
+```bash
+sillyspec progress check                   # 状态一致性检查（只报告，不修复）
+sillyspec progress repair                  # 修复状态元数据（dry-run，加 --apply 才真改）
+sillyspec progress validate                # 校验并修复
+sillyspec progress reset [--stage <阶段>]  # 重置进度（破坏性，慎用）
+```
+
+- `/sillyspec:status` 看项目整体进度（change 文件级别）；`/sillyspec:state` 看当前工作状态（阶段/步骤级别）——status 看"有什么"，state 看"在做什么"。
+
+## 用户指令
+$ARGUMENTS

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

@@ -1,175 +1,33 @@
----
-name: sillyspec:workspace
-description: 工作区管理 — 初始化、管理多项目工作区，查看子项目状态
----
-
-## 交互规范
-
-**当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项以参数传入。**
-
-不要用编号列表让用户手动输入数字。
-如果需要自由输入，在 AskUserQuestion 的选项中加入"Other（自定义输入）"。
-
----
-
-## CLI 边界（重要）
-
-`sillyspec workspace` 命令已存在（2026-08-21 落地）：
-```bash
-sillyspec workspace add <名> <相对路径> [--role <角色>] [--repo <仓库地址>]   # 登记子项目（外科写入 yaml，已有字段保留）
-sillyspec workspace remove <名>                                             # 删除登记（项目本体不动）
-sillyspec workspace status                                                  # 三态探测表（已扫描/已初始化/未初始化）
-```
-优先用命令；命令异常时才按下文手工兜底（yaml 字段口径：init 写 name/path/status 三字段，role/repo 由 add 追加）。
-
-## 相关 CLI 命令
-
-```bash
-sillyspec scan                       # 扫描子项目生成文档
-sillyspec init [--tool <名>]         # 安装命令模板
-sillyspec progress show              # 查看进度
-```
-
-你现在是 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
-   ```
-   > ⚠️ `sillyspec init` 只会写入 `name`、`path`、`status` 三个字段。
-   > `role` 和 `repo` 由 `/sillyspec:workspace add` 追加。
-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 .sillyspec/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`：
-
-**sillyspec init 创建的格式（3 字段）：**
-```yaml
-name: frontend
-path: ./frontend
-status: active
-```
-
-**workspace add 扩展的格式（最多 5 字段）：**
-```yaml
-name: frontend
-path: ./frontend
-status: active
-role: 前端 - Vue3 + TypeScript
-repo: https://github.com/xxx/frontend.git  # 可选
-```
-
-### 最后说：
-
-> 工作区已更新。
-> 下一步：对子项目运行 `/sillyspec:init` 或 `/sillyspec:scan`。
-
-## 绝对规则
-- 不修改子项目目录下的任何文件
-- projects/*.yaml 必须是合法 YAML
-- 子项目路径必须是相对于工作区根目录的相对路径
-- 路径必须验证存在性
+---
+name: sillyspec:workspace
+description: 工作区管理 — 初始化、管理多项目工作区，查看子项目状态
+---
+
+## 交互规范
+
+**当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项以参数传入。** 不要用编号列表让用户手动输入数字。需要自由输入时在选项中加入"Other（自定义输入）"。
+
+## CLI 命令（一切读写都走命令，勿手写 yaml / 勿 bash 解析）
+
+```bash
+sillyspec workspace add <名> <相对路径> [--role <角色>] [--repo <仓库地址>]   # 登记子项目（外科写入 yaml，已有字段保留；路径须存在）
+sillyspec workspace remove <名>                                             # 删除登记（项目本体不动）
+sillyspec workspace status                                                  # 三态探测表（未初始化/已初始化/已扫描+文档数）
+```
+
+无参运行任一子命令可见用法。`status` 的输出即成品状态表，直接转述给用户即可，勿再自行 for-loop 探测。
+
+## 核心流程
+
+1. **解析指令**：无参数 / `status` → 跑 `workspace status` 转述；`add` / `remove` → 交互收集参数后跑命令；`info <名>` → 读该子项目 `PROJECT.md` / `REQUIREMENTS.md` 摘要转述。
+2. **初始化工作区**（`projects/` 尚无任何 yaml 且用户同意时）：用 AskUserQuestion 逐个收集子项目名称/相对路径/角色（可选 repo），每收集一个跑一次 `workspace add`；添加完询问是否继续或完成。共享规范目录 `.sillyspec/shared/` 需要时手动创建。
+3. **收尾**：add/remove 后建议 git 提交（CLI 只写 yaml 不提交）；提示下一步对子项目跑 `/sillyspec:init` 或 `/sillyspec:scan`。
+
+## 绝对规则
+
+- 不修改子项目目录下的任何文件
+- 子项目路径必须是相对于工作区根目录的相对路径，且真实存在（`workspace add` 会校验）
+- yaml 读写一律交给 CLI——字段口径（name/path/status/role/repo）由命令维护，不手工拼
+
+## 用户指令
+$ARGUMENTS

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sillyspec",
-  "version": "3.28.0",
+  "version": "3.28.3",
   "description": "SillySpec CLI — 流程状态机，让 AI 严格按步骤来",
   "icon": "logo.jpg",
   "homepage": "https://sillyspec.ppdmq.top/",