sillyspec 3.20.5 → 3.20.7

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

@@ -1,21 +1,74 @@
----
-name: sillyspec:scan
-description: 用于扫描项目代码库，生成架构文档、代码约定、目录结构等。适合用户说"扫描项目、分析代码库、生成文档、scan"。产出 7 份扫描文档 + 模块映射。
----
-
-## 多变更说明
-
-如果项目有多个活跃变更（`.sillyspec/changes/` 下有多个目录），所有 `sillyspec run` 命令需要加 `--change <变更名>`。只有一个变更时可省略（CLI 自动检测）。
-
-## 执行
-
-**你必须使用 exec 工具（shell）执行以下命令，不要自己编造流程：**
-
-1. 运行 `sillyspec run scan` — 读取输出的步骤 prompt
-2. 按照输出的 prompt **严格执行**，不要跳过或自行添加步骤
-3. 步骤完成后，运行 `sillyspec run scan --done --output "你的摘要"`
-4. 重复 2-3 直到阶段完成
-5. **禁止**在没有运行 CLI 的情况下自行决定流程
-
-## 用户指令
-$ARGUMENTS
+---
+name: sillyspec:scan
+description: 用于扫描项目代码库，生成架构文档、代码约定、目录结构等。适合用户说"扫描项目、分析代码库、生成文档、scan"。产出 7 份扫描文档 + 模块映射。
+---
+
+## 何时使用
+
+- 用户说"扫描项目、分析代码库、生成文档、scan"
+- 棕地项目首次接入 sillyspec，生成架构/约定/结构等基础文档
+- 产出 7 份 scan 文档（PROJECT/ARCHITECTURE/CONVENTIONS/STRUCTURE/INTEGRATIONS/TESTING/CONCERNS）+ 模块映射
+
+## 多变更说明
+
+scan 是辅助阶段，通常不需要 `--change`。但项目有多个活跃变更时，所有 `sillyspec run` 命令加 `--change <变更名>` 可指定操作目标。
+
+## 步骤生命周期（所有阶段通用）
+
+> `sillyspec scan` 是 `sillyspec run scan` 的顶层别名，两者等价。
+
+```bash
+sillyspec run scan                             # 输出当前步骤 prompt
+sillyspec run scan --done --output "摘要"      # 完成当前步骤
+sillyspec run scan --status                    # 查看阶段进度
+sillyspec run scan --skip                      # 跳过可选步骤
+sillyspec run scan --reset                     # 重置阶段（从头开始）
+```
+
+## 通用参数（所有阶段适用）
+
+| 参数 | 说明 |
+|---|---|
+| `--spec-dir <path>` | 指定规范目录（默认 `<项目>/.sillyspec`） |
+| `--non-interactive` | CI/脚本下禁用交互式 prompt |
+| `--skip-approval` | 跳过审批/校验门控 |
+| `--json` | 输出 JSON（程序化读取） |
+
+## scan 特有参数
+
+| 参数 | 说明 |
+|---|---|
+| `--deep` | 强制 deep 扫描 profile（完整流程，不按规模裁剪） |
+| `--force-rescan` | 覆盖已有 scan 文档的保护（默认覆盖需 source_commit/updated_at 匹配） |
+
+### scanProfile（按项目规模自动裁剪）
+
+CLI 根据源码规模自动选择 profile，无需手动指定：
+
+| profile | 触发条件 | 行为 |
+|---|---|---|
+| quick | ≤30 文件 且 ≤80KB 且 ≤3 项目 | 3 步，0 子代理，5 份核心文档 |
+| standard | ≤200 文件 且 ≤800KB | 压缩步骤，最多 1 子代理 |
+| deep | 大项目或 `--deep` | 完整流程 |
+
+### post-check
+
+scan 完成时 CLI 自动校验 7 份文档齐全。缺失会设状态为 `failed_post_check`，阻断进入主流程下游（brainstorm/plan 等），需修复后重跑 scan。
+
+## 阶段流转
+
+```
+(项目起点) → scan → brainstorm
+```
+
+scan 完成后，运行 `sillyspec run brainstorm "<需求>"` 开始具体变更的设计。
+
+## 铁律
+
+- **必须用 exec 工具（shell）执行 CLI，不要自己编造流程**
+- 只做当前步骤 prompt 描述的操作，不跳过
+- scan 文档写入 `{DOCS_ROOT}/scan/`（平台模式用占位符路径，不写裸 `.sillyspec/`）
+- 完成后立即 `--done`，不跳过
+
+## 用户指令
+$ARGUMENTS

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

@@ -46,9 +46,19 @@ sillyspec progress show
 >
 > 进度数据会在 `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 看"在做什么"

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

@@ -1,21 +1,55 @@
----
-name: sillyspec:status
-description: 用于查看 SillySpec 当前进度和状态。适合用户说"看下状态、当前进度、status"。显示当前阶段、步骤完成度、活跃变更。
----
-
-## 多变更说明
-
-如果项目有多个活跃变更（`.sillyspec/changes/` 下有多个目录），所有 `sillyspec run` 命令需要加 `--change <变更名>`。只有一个变更时可省略（CLI 自动检测）。
-
-## 执行
-
-**你必须使用 exec 工具（shell）执行以下命令，不要自己编造流程：**
-
-1. 运行 `sillyspec run status` — 读取输出的步骤 prompt
-2. 按照输出的 prompt **严格执行**，不要跳过或自行添加步骤
-3. 步骤完成后，运行 `sillyspec run status --done --output "你的摘要"`
-4. 重复 2-3 直到阶段完成
-5. **禁止**在没有运行 CLI 的情况下自行决定流程
-
-## 用户指令
-$ARGUMENTS
+---
+name: sillyspec:status
+description: 用于查看 SillySpec 当前进度和状态。适合用户说"看下状态、当前进度、status"。显示当前阶段、步骤完成度、活跃变更。
+---
+
+## 何时使用
+
+- 用户说"看下状态、当前进度、status"
+- 查看项目整体进度：活跃变更、各阶段状态、步骤完成度
+
+## status vs state 分工
+
+- **`/sillyspec:status`**（本 skill）— 查看项目整体进度（change 文件级别、各阶段状态）。走 `sillyspec run status` 阶段。
+- **`/sillyspec:state`** — 查看当前工作状态（阶段/步骤级别、下一步建议）。走 `sillyspec progress show`。
+
+两者互补：status 看"有什么"，state 看"在做什么"。
+
+## 多变更说明
+
+status 是辅助阶段。项目有多个活跃变更时，加 `--change <变更名>` 查看指定变更的详情；不指定时汇总显示所有变更。
+
+## 步骤生命周期（所有阶段通用）
+
+> `sillyspec status` 是 `sillyspec run status` 的顶层别名，两者等价。status 是辅助阶段，只读。
+
+```bash
+sillyspec run status                           # 输出当前步骤 prompt
+sillyspec run status --done --output "摘要"    # 完成阶段
+sillyspec run status --status                  # 查看阶段状态
+```
+
+## 通用参数（所有阶段适用）
+
+| 参数 | 说明 |
+|---|---|
+| `--change <名>` | 指定变更名（多变更时查看指定变更详情） |
+| `--spec-dir <path>` | 指定规范目录（默认 `<项目>/.sillyspec`） |
+| `--json` | 输出 JSON（程序化读取） |
+
+## 配套的只读查询命令（不经 run）
+
+```bash
+sillyspec progress show                        # 当前工作状态（阶段/步骤级）
+sillyspec progress show --change <名>          # 指定变更详情
+sillyspec progress check                       # 状态一致性检查
+```
+
+## 铁律
+
+- status 是只读阶段，**不修改任何文件**
+- **必须用 exec 工具（shell）执行 CLI**
+- 完成后立即 `--done`，不跳过
+
+## 用户指令
+$ARGUMENTS

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

@@ -1,21 +1,82 @@
----
-name: sillyspec:verify
-description: 用于验证代码实现是否符合 design 和模块文档。适合用户说"验证下、检查下、跑 verify"。对照 design.md + 模块文档检查任务完成度、设计一致性、运行测试。
----
-
-## 多变更说明
-
-如果项目有多个活跃变更（`.sillyspec/changes/` 下有多个目录），所有 `sillyspec run` 命令需要加 `--change <变更名>`。只有一个变更时可省略（CLI 自动检测）。
-
-## 执行
-
-**你必须使用 exec 工具（shell）执行以下命令，不要自己编造流程：**
-
-1. 运行 `sillyspec run verify` — 读取输出的步骤 prompt
-2. 按照输出的 prompt **严格执行**，不要跳过或自行添加步骤
-3. 步骤完成后，运行 `sillyspec run verify --done --output "你的摘要"`
-4. 重复 2-3 直到阶段完成
-5. **禁止**在没有运行 CLI 的情况下自行决定流程
-
-## 用户指令
-$ARGUMENTS
+---
+name: sillyspec:verify
+description: 用于验证代码实现是否符合 design 和模块文档。适合用户说"验证下、检查下、跑 verify"。对照 design.md + 模块文档检查任务完成度、设计一致性、运行测试。
+---
+
+## 何时使用
+
+- 用户说"验证下、检查下、跑 verify"
+- 对照 design.md + 模块文档检查任务完成度
+- 设计一致性检查 + 运行测试套件
+- 产出 `verify-result.md`（PASS / PASS WITH NOTES / FAIL）
+
+## 多变更说明
+
+项目有多个活跃变更（`.sillyspec/changes/` 下有多个目录）时，所有 `sillyspec run` 命令需加 `--change <变更名>` 指定操作目标；只有一个变更时可省略（CLI 自动检测）。
+
+## 步骤生命周期（所有阶段通用）
+
+> `sillyspec verify` 是 `sillyspec run verify` 的顶层别名，两者等价。
+
+```bash
+sillyspec run verify                           # 输出当前步骤 prompt
+sillyspec run verify --done --output "摘要"    # 完成当前步骤（--input "用户原话" 记录输入）
+sillyspec run verify --status                  # 查看阶段进度
+sillyspec run verify --skip                    # 跳过可选步骤
+sillyspec run verify --reset                   # 重置阶段（从头开始）
+sillyspec run verify --reopen --from-step N    # 重新打开已完成阶段修订（N=序号或名称）
+```
+
+## 通用参数（所有阶段适用）
+
+| 参数 | 说明 |
+|---|---|
+| `--change <名>` | 指定变更名（多活跃变更必填，单变更可省略自动检测） |
+| `--spec-dir <path>` | 指定规范目录（默认 `<项目>/.sillyspec`） |
+| `--non-interactive` | CI/脚本下禁用交互式 prompt |
+| `--skip-approval` | 跳过审批/校验门控（需明确意图） |
+| `--json` | 输出 JSON（程序化读取） |
+
+## verify 特有：完成门控（重要）
+
+verify 是只读阶段（**禁止改代码/改 git 状态**，只检查 + 写报告）。完成时有硬校验：
+
+- **必须产出 `verify-result.md`**——不存在则阻断完成（不能跳过报告直接 `--done`）
+- **结论为 `FAIL` 则阻断完成**——不能带着 FAIL 标记 verify 完成
+- **`integration-critical` / `deployment-critical` 变更**（design/plan 含 daemon/session/lease/lifecycle 等关键词）：结论 PASS WITH NOTES 降级为 FAIL，必须有真实集成证据（Runtime Evidence section）
+- `verify-required-evidence.json`（execute 写入）中每条 missing evidence → 阻断
+
+被阻断时 CLI 打印 ❌ 校验失败，不会提示"验证通过"。修复 `verify-result.md` 后重新 `--done`。
+
+## verify-result.md 格式
+
+```markdown
+# 验证报告
+## 结论
+PASS / PASS WITH NOTES / FAIL      ← 必须有此章节，FAIL 会阻断 verify 完成
+## 任务完成度
+## 设计一致性
+## 探针结果
+## 测试结果
+## 变更风险等级
+## Runtime Evidence（integration/deployment-critical 必填）
+```
+
+## 阶段流转
+
+```
+execute → verify → archive
+```
+
+verify 通过（PASS）后，运行 `sillyspec run archive --change <变更名>` 归档。FAIL 则修复后重跑 `sillyspec run verify`。
+
+## 铁律
+
+- **必须用 exec 工具（shell）执行 CLI，不要自己编造流程**
+- verify 阶段**绝对禁止** git checkout/restore/reset、删除/覆盖源码文件——只检查 + 报告
+- 发现问题只报告，不尝试修复（修复回 execute）
+- `verify-result.md` 结论必须基于证据，不写"看起来没问题"
+- 完成后立即 `--done`，不跳过
+
+## 用户指令
+$ARGUMENTS

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

@@ -12,6 +12,18 @@ description: 工作区管理 — 初始化、管理多项目工作区，查看
 
 ---
 
+## CLI 边界（重要）
+
+sillyspec CLI **没有 `workspace` 顶层命令**。本 skill 通过直接读写 `.sillyspec/projects/*.yaml` 管理工作区，配套用 `sillyspec scan` 扫描子项目、`sillyspec init` 安装命令模板。**不要编造 `sillyspec workspace ...` 子命令。**
+
+## 相关 CLI 命令
+
+```bash
+sillyspec scan                       # 扫描子项目生成文档
+sillyspec init [--tool <名>]         # 安装命令模板
+sillyspec progress show              # 查看进度
+```
+
 你现在是 SillySpec 的工作区管理器。
 
 ## 用户指令

package/CLAUDE.md

@@ -1,5 +1,9 @@
 # Claude Code 指引
 
+# SillySpec工具定位
+1. 是给Agent调用的CLI工具，非人类直接使用
+2. 管理Agent工作流的CLI工具，非业务工具
+
 ## 文件生命周期文档同步
 每次修改 `src/stages/` 下的阶段定义（prompt、步骤、输出文件名等）或 `src/run.js`、`src/progress.js` 等影响文件生命周期的代码后，**必须同步更新** `docs/sillyspec/file-lifecycle.md`，确保文档与代码一致。
 

package/docs/sillyspec/file-lifecycle/platform-workflows-sync.md

@@ -1,6 +1,7 @@
 ---
 author: qinyi
 created_at: 2026-06-04 16:25:42
+updated_at: 2026-07-02 11:00:00
 ---
 
 # 平台模式、Workflow 与 Sync
@@ -24,6 +25,10 @@ created_at: 2026-06-04 16:25:42
 
 后续 `--done` / `--skip` 会从该文件恢复参数。
 
+## 平台残留清理（一次性）
+
+`run.js` 在平台模式（`specRoot` 指向外部）首次启动时，会检查源码目录 `cwd/.sillyspec/` 是否为旧版本残留并清理（复用 `init.js` 的 `cleanupRuntimeResidue`）。该清理**仅在首次执行一次**：完成后在 cwd 根写入 `.sillyspec-platform-cleaned` 标记文件，后续每次 `run` 直接跳过，避免重复检查与噪声。清理白名单与边界见总览的「平台模式残留清理边界」。
+
 ## 路径替换
 
 `run.js outputStep()` 在 scan 阶段替换：

package/docs/sillyspec/file-lifecycle/stage-artifacts.md

@@ -31,7 +31,7 @@ created_at: 2026-06-04 16:25:42
 | execute | 12+ | 生成/使用 worktree，按 Wave 执行；最终 apply/cleanup |
 | verify | 7 | 写 `verify-result.md` |
 | archive | 5 | 写 `module-impact.md`，同步模块文档，归档目录 |
-| quick | 3 | 写 quicklog 或追加 change tasks；直接改主工作区 |
+| quick | 3 | 始终写 quicklog；关联变更时另在各 change tasks.md 追加并勾选 task；直接改主工作区 |
 
 ## 变更四件套
 
@@ -42,7 +42,7 @@ created_at: 2026-06-04 16:25:42
 | `proposal.md` | brainstorm 第 11 步；propose 第 5 步 | propose/plan/verify/archive prompt |
 | `design.md` | brainstorm 第 10/11 步；propose 第 5 步 | plan、execute、verify、worktree apply 的文件清单 |
 | `requirements.md` | brainstorm 第 11 步；propose 第 5 步 | plan、verify |
-| `tasks.md` | brainstorm 第 11 步；propose 第 5 步；quick `--change` 可追加 task | plan、execute、verify、archive |
+| `tasks.md` | brainstorm 第 11 步；propose 第 5 步；quick 关联变更时可追加 task | plan、execute、verify、archive |
 
 `run.js validateFileLocations()` 在阶段完成时会检查：
 
@@ -140,7 +140,7 @@ created_at: 2026-06-04 16:25:42
 
 路径：`.sillyspec/quicklog/QUICKLOG-<git-user>.md`
 
-创建方式：quick 阶段“理解任务”prompt，且没有 `--change` 时创建/追加。
+创建方式：quick 阶段“理解任务”prompt，**每次 quick 都创建/追加**（无论是否关联变更）。关联变更时，同一 ql-ID 会同步写入各关联变更的 tasks.md 作为未勾选 task，step 3 完成时勾选。
 
 格式规则来自 prompt：
 

package/docs/sillyspec/file-lifecycle.md

@@ -1,7 +1,7 @@
 ---
 author: qinyi
 created_at: 2026-05-31 11:00:00
-updated_at: 2026-07-01 15:00:00
+updated_at: 2026-07-03 11:00:00
 ---
 
 # SillySpec 文件生命周期
@@ -46,8 +46,8 @@ updated_at: 2026-07-01 15:00:00
 | propose | 7 | 包含“生成规范文件”与“自检门控”，四件套是该阶段预期产物 |
 | plan | 动态 | 默认 8 步；`plan.md` 解析到任务后插入任务蓝图协调器 |
 | execute | 动态 | 默认 12 步；Wave 来自 `plan.md`，解析失败时默认 3 个 Wave |
-| verify | 7 | 只读校验 + 写 `verify-result.md` |
-| archive | 5 | 辅助阶段；第 4 步必须带 `--confirm`，由 `run.js` 移动目录并注销 active change |
+| verify | 7 | 只读校验 + 写 `verify-result.md`；完成时 `validateVerifyOutputs` 校验 `verify-result.md` 存在且结论非 FAIL，缺失或 FAIL 则阻断完成 |
+| archive | 5 | 辅助阶段；第 4 步必须带 `--confirm`，由 `run.js` 移动目录并注销 active change；移动前硬校验 `plan.md` 存在，移动后校验 `design.md`/`module-impact.md` |
 | quick | 3 | 辅助阶段；直接在主工作区实现，不创建 worktree |
 | explore | 1 | 只读探索 |
 | status | 3 | 状态展示 |
@@ -66,15 +66,16 @@ updated_at: 2026-07-01 15:00:00
 | `.sillyspec/changes/archive/` | 是 | archive `确认归档 --confirm` 分支 | 已归档变更目录 |
 | `.sillyspec/knowledge/` | 是 | `init.js` 建目录；scan「Extract Project Knowledge」步骤产出 | `INDEX.md`、`uncategorized.md`，以及 scan 提取的 `conventions.md`/`patterns.md`/`known-issues.md` |
 | `.sillyspec/workflows/` | 是 | `init.js` 从模板复制 | workflow check 定义 |
-| `.sillyspec/quicklog/` | 是 | quick prompt | 无 `--change` quick 任务记录 |
+| `.sillyspec/quicklog/` | 是 | quick prompt | 每次 quick 任务记录（始终写入；关联变更另在各 change tasks.md 勾选） |
 | `.sillyspec/shared/` | 是 | `init.js` | 共享目录，当前无核心生命周期逻辑 |
 | `.sillyspec/workspace/` | 是 | `init.js` | 工作区目录，当前无核心生命周期逻辑 |
 | `.sillyspec/.runtime/` | 否 | `init.js`、`ProgressManager`、运行时命令 | DB、gate、artifacts、history、workflow-runs、worktrees、knowledge-hit-report.json、postcheck-result.json |
 
 `init.js` 会把 `.sillyspec/.runtime/`、`.sillyspec/local.yaml`、`.sillyspec/codebase/SCAN-RAW.md` 追加到 `.gitignore`。
 
-> **平台模式残留清理边界**（`init.js` `cleanupRuntimeResidue`，由 `run.js` 启动时复用）：
+> **平台模式残留清理边界**（`init.js` `cleanupRuntimeResidue`，由 `run.js` 启动时首次执行一次）：
 > 当 `specRoot` 指向外部、源码目录的 `.sillyspec/` 含真实资产（`changes/`/`projects/`/`sillyspec.db`）时，只清理运行时残留，**不整删 `.runtime/`**。清理白名单保留权威状态：`worktrees/`、`sillyspec.db`、`global.json`、`gate-status.json`、`contract-artifacts/`、`execute-runs/`；其余子项（`artifacts/`、`scan-runs/`、`scan-projects.json`、`user-inputs.md`、`postcheck-result.json` 等可重建缓存）逐项删除，`local.yaml`、`codebase/` 整删。未知子项默认保留（安全侧倾斜）。
+> 该清理在 `run.js` 启动时**仅执行一次**：首次处理后写 cwd 根的 `.sillyspec-platform-cleaned` 标记文件，后续每次 `run` 直接跳过。旧版每次启动都打印 `❌ 拒绝删除` 红叉属误导性噪声（清理既不阻塞流程也不动真实资产），已降为 `ℹ️` 一次性提示。
 
 ## 主要文件流
 
@@ -113,6 +114,16 @@ quick
   -> code changes are made in the main workspace
 ```
 
+sillyspec doctor --json（结构化诊断，平台模式状态分裂检测）
+  -> <authoritySpecDir>/.runtime/doctor-diagnosis.json
+  （authoritySpecDir = pointer.specRoot 平台模式 / <cwd>/.sillyspec 本地模式；只读检测，不写 db）
+
+sillyspec doctor --dump-db --path <db>
+  -> <authoritySpecDir>/.runtime/doctor-dumps/dump-<ts>.json（只读取证：schema_version + 全量 changes + stages）
+
+sillyspec doctor --cleanup-remnant [--confirm]
+  -> 删除 0 字节空占位 db（默认 dry-run；--confirm 才真删；只删 size===0，不动有内容的 db）
+
 ## 核心修正
 
 这版文档相对旧版长文档做了几项关键修正：
@@ -129,3 +140,4 @@ quick
 - plan→execute Contract 校验（`parseWavesFromPlan`）只解析 `## Wave N` 段内的 `- [ ] task-XX:` 行；遇到非 Wave 标题行（`## 自检` 等）即退出当前 Wave 段，避免自检 `- [x]` checkbox 被误当 task 定义。
 - `executePlanPostcheck` 的 `resolveChangeDir` 复用 `run.js` 模块内本地函数，不从 `./modules.js` 导入（该模块未导出此函数）。
 - Revision v1：`stages` 表新增 `revision`/`reopened_from_step`/`reopened_at`/`stale_reason` 列；阶段新增 `revising`/`stale` 状态；`sillyspec run <stage> --reopen --from-step <n>` 重开已完成阶段、级联标记下游 stale；`.runtime/postcheck-result.json` 由 `scan-postcheck.js` 的 `writeStructuredResult` 落盘（本地写 `specDir/.runtime`，平台写 `runtimeRoot/scan-runs/<id>`）。
+- 平台指针 fail-closed（2026-07-03）：`resolvePlatformSpecDir`（`progress.js`）在 pointer 存在但失效（specRoot 不可达/损坏/缺字段）时抛 `PointerUnreachableError`，`index.js` 顶层 catch 打印修复引导 + exit 1，**不再静默回退本地孤儿 db**；无 pointer 的纯本地项目不受影响。`sync.js` 用 `safePlatformSpecDir` best-effort 包裹保持容错。逃生口：显式 `--spec-dir`。

package/docs/worktree-isolation.md

@@ -114,7 +114,7 @@ allowWrite = stageGate && locationGate && fileGate
 | 场景 | 处理方式 |
 |------|---------|
 | **git < 2.15** | 不支持 worktree，报错停止 |
-| **`--no-worktree` 标志** | 跳过隔离创建，但 hook 仍然拦截源码写入 |
+| **`--no-worktree` 标志** | ⚠️ **未接通**（`runCommand` 未解析此 flag，相关错误提示已移除）。worktree 失败改用 `sillyspec worktree doctor --fix` 或手动清理残留（`git worktree prune && git branch -D sillyspec/<change>`）；紧急用 `SILLYSPEC_DISABLE_HOOKS=1`。详见 `docs/sillyspec/file-lifecycle/known-implementation-gaps.md` |
 | **`SILLYSPEC_DISABLE_HOOKS=1`** | 紧急禁用所有 hook，全部放行 |
 | **无 gate-status.json** | stageGate=false，默认禁止源码写入 |
 | **worktree 创建失败** | 自动降级为 in-place + baseline protection（mode: in-place-fallback） |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sillyspec",
-  "version": "3.20.5",
+  "version": "3.20.7",
   "description": "SillySpec CLI — 流程状态机，让 AI 严格按步骤来",
   "icon": "logo.jpg",
   "homepage": "https://sillyspec.ppdmq.top/",
@@ -10,7 +10,7 @@
   },
   "type": "module",
   "bin": {
-    "sillyspec": "./bin/sillyspec.js"
+    "sillyspec": "bin/sillyspec.js"
   },
   "engines": {
     "node": ">=18"