sillyspec 3.27.12 → 3.28.2

package/.claude/worktrees/sillyspec-data-model-research/.claude/skills/sillyspec-knowledge/SKILL.md

@@ -1,270 +0,0 @@
----
-name: sillyspec:knowledge
-description: Agent-safe knowledge base commands for SillySpec repositories. Search, inspect, validate, refresh, and propose knowledge entries.
-argument-hint: "search --query \"<text>\" --limit N | inspect --id \"<id>\" | validate | refresh | propose --title \"<title>\" --category <name>"
-version: "3.19.2"
----
-
-## 交互规范
-当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项以参数传入。
-
-## 何时使用此技能
-Use this skill when working on a SillySpec repository and the task may depend on prior project knowledge, known issues, implementation patterns, scan-derived learnings, execute-stage knowledge hits, or `.sillyspec/knowledge`.
-
-Before implementing changes, **first search the knowledge base** to avoid repeating known work or running into known issues.
-
-## 命令列表
-
-### 1. knowledge search — 搜索知识库
-在执行任务前搜索相关知识。
-
-```bash
-sillyspec knowledge search --query "<task summary>" --limit 5
-```
-
-**示例：**
-```bash
-sillyspec knowledge search --query "worktree baseline apply conflict" --limit 5
-sillyspec knowledge search --query "postcheck validation error"
-sillyspec knowledge search --query "GLM usage metadata"
-```
-
-**输出（JSON）：**
-```json
-{
-  "ok": true,
-  "query": "worktree baseline",
-  "matches": [
-    {
-      "id": "patterns",
-      "path": "knowledge/patterns.md",
-      "title": "Patterns",
-      "summary": "每个阶段一个独立模块定义（含步骤与提示词）...",
-      "score": 3,
-      "tags": ["worktree", "git-worktree", "WorktreeManager"],
-      "category": "Patterns"
-    }
-  ]
-}
-```
-
-**使用场景：**
-- 实现新功能前，检查是否有现有模式可复用
-- 遇到报错前，搜索是否是已知问题
-- 修改特定模块前，了解约定和坑点
-
----
-
-### 2. knowledge inspect — 读取知识条目详情
-搜索命中后，读取完整条目内容。
-
-```bash
-sillyspec knowledge inspect --id "<knowledge-id>"
-```
-
-**示例：**
-```bash
-sillyspec knowledge inspect --id "patterns"
-sillyspec knowledge inspect --id "known-issues/sqljs-wasm-only"
-sillyspec knowledge inspect --id "generated/worktree-baseline-conflict"
-```
-
-**输出（JSON）：**
-```json
-{
-  "ok": true,
-  "entry": {
-    "id": "patterns",
-    "title": "Patterns",
-    "summary": "每个阶段对应 `src/stages/` 下的独立模块...",
-    "zone": "manual",
-    "path": "knowledge/patterns.md",
-    "meta": {
-      "author": "<git-user>",
-      "created_at": "2026-06-19T12:40:00+08:00",
-      "updated_at": "2026-06-24T10:00:00+08:00"
-    },
-    "body": "完整 markdown 内容..."
-  }
-}
-```
-
-**zone 说明：**
-- `manual` — 人工维护的知识（可直接信任）
-- `generated` — 自动提取的知识（scan 生成，需人工审核）
-- `proposed` — 提议待审核的知识（未合并）
-
----
-
-### 3. knowledge validate — 校验知识库健康度
-在 commit/archive 前检查知识库是否可用。
-
-```bash
-sillyspec knowledge validate
-```
-
-**输出（JSON）：**
-```json
-{
-  "ok": false,
-  "errors": [
-    {
-      "code": "broken_reference",
-      "path": "knowledge/generated/foo.md",
-      "referenced_in": "INDEX.md",
-      "display": "Foo Pattern"
-    },
-    {
-      "code": "empty_file",
-      "path": "knowledge/bar.md"
-    }
-  ],
-  "warnings": [
-    {
-      "code": "too_many_uncategorized",
-      "count": 12,
-      "path": "knowledge/uncategorized.md"
-    },
-    {
-      "code": "unregistered_file",
-      "path": "knowledge/new-file.md"
-    }
-  ]
-}
-```
-
-**错误码说明：**
-| code | 说明 |
-|---|---|
-| `knowledge_dir_missing` | `.sillyspec/knowledge/` 目录不存在 |
-| `missing_index` | `INDEX.md` 不存在 |
-| `broken_reference` | INDEX.md 引用的文件不存在 |
-| `empty_file` | 知识文件为空 |
-| `too_many_uncategorized` | uncategorized.md 条目 ≥10，需清理 |
-| `unregistered_file` | 手动知识文件未在 INDEX.md 注册 |
-
----
-
-### 4. knowledge refresh — 从 scan 文档刷新自动知识
-**仅写 generated/ 区，不覆盖 manual/。**
-
-```bash
-sillyspec knowledge refresh
-```
-
-**使用场景：**
-- scan 阶段完成后，自动提取可复用知识
-- archive 阶段完成后，沉淀长期有效的模式
-
-**行为：**
-1. 扫描 `.sillyspec/docs/<project>/scan/*.md`
-2. 提取每个 `## 章节`（至少 3 行）作为知识条目
-3. 写入 `.sillyspec/knowledge/generated/<slug>.md`
-4. 生成 `generated/INDEX.md`
-
-**输出（JSON）：**
-```json
-{
-  "ok": true,
-  "generated_count": 8,
-  "new_count": 5,
-  "overwritten_count": 3,
-  "files": [
-    { "file": "generated/worktree-isolation.md", "title": "...", "new": true },
-    { "file": "generated/progress-management.md", "title": "...", "new": false }
-  ]
-}
-```
-
-**注意事项：**
-- generated/ 区知识是自动生成，不保证准确，需人工审核后合并到 manual/
-- 已有文件会被覆盖（ overwrite_count）
-
----
-
-### 5. knowledge propose — 提议新知识
-不直接编辑 manual/，而是写入 proposed/ 供审核。
-
-```bash
-sillyspec knowledge propose --title "<title>" --category <category> --body "<content>" --from "<source>"
-```
-
-**参数说明：**
-| 参数 | 必填 | 说明 |
-|---|---|---|
-| `--title` | ✅ | 知识标题 |
-| `--category` | ❌ | 分类（默认 uncategorized），如 known-issues, patterns, conventions |
-| `--body` | ❌ | 知识正文 |
-| `--from` | ❌ | 来源标注（如 execute/quick/scan） |
-
-**示例：**
-```bash
-sillyspec knowledge propose --title "GLM API 超时处理" --category known-issues --body "GLM 模型默认超时 30 秒..." --from "execute"
-```
-
-**输出（JSON）：**
-```json
-{
-  "ok": true,
-  "id": "proposed/glm-api-timeout",
-  "path": "knowledge/proposed/glm-api-timeout.md",
-  "title": "GLM API 超时处理",
-  "category": "known-issues",
-  "new": true,
-  "action": "created"
-}
-```
-
-**后续流程：**
-- archive/commit 阶段审核 proposed/ 条目
-- 合格的合并到 manual/，不合格的删除
-
----
-
-## Agent 使用指南
-
-### 任务前必查
-在开始实现新功能、修改现有代码、或遇到报错前：
-1. `knowledge search --query "<任务关键词>"`
-2. 命中则 `knowledge inspect --id "<id>"`
-3. 遵循知识中的约定和避坑建议
-
-### 发现新知识
-执行任务中发现可复用模式或新坑：
-1. `knowledge propose --title "<标题>" --category <分类> --body "<内容>"`
-2. 不要直接编辑 `.sillyspec/knowledge/manual/*.md`
-
-### 提交前校验
-commit/archive 前检查知识库状态：
-1. `knowledge validate`
-2. 如有 errors，先修复再提交
-
-### 扫描后刷新
-scan 阶段完成后：
-1. `knowledge refresh`
-2. 审核生成的 `generated/*.md`，有用的合并到 manual/
-
----
-
-## 禁止事项
-
-❌ **不要直接编辑** `manual/` 或 `generated/` 中的知识文件
-- 使用 `knowledge propose` 提议新知识
-- 使用 `knowledge refresh` 刷新自动知识
-
-❌ **不要使用 `grep` 或 `cat` 直接读取知识文件**
-- 使用 `knowledge search` 和 `knowledge inspect`
-- 它们使用与 execute 阶段相同的匹配引擎
-
-❌ **不要让 agent 去审核 proposed/ 条目**
-- 提议供人工审核，不要自动合并
-- 只有用户明确要求才合并
-
----
-
-## 设计原则
-
-- **Agent-safe：** 所有输出为 JSON，失败有明确错误码
-- **写保护：** refresh 仅写 generated/，propose 仅写 proposed/，不碰 manual/
-- **匹配引擎：** 使用 `knowledge-match.js`（与 execute 阶段一致）
-- **审计友好：** 每个条目记录来源、创建/更新时间

package/.claude/worktrees/sillyspec-data-model-research/.claude/skills/sillyspec-plan/SKILL.md

@@ -1,156 +0,0 @@
----
-name: sillyspec:plan
-description: 用于把 design 拆解为可执行的实现计划。适合用户说"拆任务、做计划、排 wave、规划实现步骤"。产出 plan.md（Wave 分组 + 任务 ID 引用 + 依赖关系）+ tasks.md 任务清单（唯一真相，plan 阶段展开写回）。
----
-
-## 何时使用
-
-- 用户说"拆任务、做计划、排 wave、规划实现步骤"
-- 把 brainstorm 的 design.md 拆成可执行的 Wave + Task
-- 产出：`plan.md`（Wave 分组 + 任务 ID 引用行 + 依赖关系）+ `tasks.md` 任务清单展开写回（唯一真相）+ `tasks/task-NN.md` 任务蓝图
-
-## 多变更说明
-
-项目有多个活跃变更（`.sillyspec/changes/` 下有多个目录）时，所有 `sillyspec run` 命令需加 `--change <变更名>` 指定操作目标；只有一个变更时可省略（CLI 自动检测）。
-
-## 步骤生命周期（所有阶段通用）
-
-> `sillyspec plan` 是 `sillyspec run plan` 的顶层别名，两者等价。
-
-```bash
-sillyspec run plan                             # 输出当前步骤 prompt
-sillyspec run plan --done --output "摘要"      # 完成当前步骤（--input "用户原话" 记录输入）
-sillyspec run plan --status                    # 查看阶段进度
-sillyspec run plan --skip                      # 跳过可选步骤
-sillyspec run plan --reset                     # 重置阶段（从头开始）
-sillyspec run plan --reopen --from-step N      # 重新打开已完成阶段修订（N=序号或名称）
-sillyspec run plan --wait --reason "..." --options "A,B"   # 暂停等用户决策
-sillyspec run plan --continue --answer "..."               # 恢复等待中的步骤
-sillyspec run plan --done --answer "..." --output "..."    # 一步完成 wait+done
-```
-
-## 通用参数（所有阶段适用）
-
-| 参数 | 说明 |
-|---|---|
-| `--change <名>` | 指定变更名（多活跃变更必填，单变更可省略自动检测） |
-| `--spec-dir <path>` | 指定规范目录（默认 `<项目>/.sillyspec`） |
-| `--non-interactive` | CI/脚本下禁用交互式 prompt |
-| `--interactive` | 强制交互（即便 stdin 非 TTY） |
-| `--skip-approval` | 跳过阶段转换/审批检查（不能跳产物校验 gate——review.json/文档产物硬校验仍在） |
-
-## plan 特有
-
-### 动态步骤
-
-plan 的步骤是动态的：`generate_plan`（生成分级计划）→ `review_plan`（审查计划，按规模分级：tier=self 当前 agent 自审 / tier=independent 启动独立审查子代理产出 stage review.json，避免生成+自审同一次输出的偏差）→ CLI 从 `tasks.md` 注册表解析出 task 自动插入"任务蓝图协调器"步骤（per-task；plan.md 只提供 Wave 引用分组）。这是正常行为，不要手动添加。
-
-### Stage Review Gate（plan 的 design review.json）
-
-`review_plan` 步骤在 `tier=independent` 时产出一个 stage 级 `review.json`，CLI `Stage Review Gate` 硬校验其 schema 与 `docHash` 真实性。
-
-- 路径：`.sillyspec/.runtime/stage-reviews/plan-review-<stage-review-run-id>/review.json`（目录可能不存在需手建；run-id 由该步 `--done` prompt 输出指定）。marker 文件 `.runtime/current-stage-review-run-id-plan-<变更名>`。
-- **run-id / marker 由 CLI 自动生成注入**（review step prompt 渲染时 echo 完整目录路径 + 写 marker；撞 gate 报缺 review.json 时 gate 也 echo 完整路径 + 写 marker）。直接用 CLI 给的路径写 review.json，**勿手算 run-id（必须 `review-` 前缀）、勿手写 marker**。卡住时用 `sillyspec register-stage-review --change <名> --stage plan` 一步生成。
-- 字段（`schemaVersion:1`，`reviewType=plan` —— plan 阶段主审查文档是 `plan.md`；execute 阶段才是 `acceptance`）：
-
-  ```json
-  {
-    "schemaVersion": 1,
-    "reviewType": "plan",
-    "reviewedFiles": ["changes/<变更名>/plan.md"],   // [0] 为主文档
-    "docHash": "<sha256(reviewedFiles[0] 文件内容，hex)>",
-    "specVerdict": "pass",       // pass | fail | cannot_verify
-    "qualityVerdict": "pass",    // pass | fail | cannot_verify
-    "checklist": [               // 扁平数组，逐条对照 plan 章节/Wave 结构/task 完整性核验
-      { "item": "Wave 分级合理", "result": "pass", "note": "..." }   // result: pass | gap | fail
-    ],
-    "requiredEvidence": [],      // cannot_verify 时必填非空
-    "reviewerNotes": "..."
-  }
-  ```
-
-- `docHash` = `sha256(主审查文档内容)`（hex）—— plan 主文档是 `plan.md`（`reviewedFiles[0]`）。CLI 重算 sha256 比对，不符判伪造（fail-closed）。docHash 可先占位（如 "TODO"）；改 plan.md 后勿手算 sha256——跑 `sillyspec register-stage-review --change <变更名> --stage plan --refresh-hash` 一键重算代填（verdict 保留；多阶段联动加 --all）。`tier=self`（≤3 文件）降级为当前 agent 自审。
-- 运行时 CLI 会把精确 schema 表 + 完整 JSON 示例 + docHash 算法注入到该步 prompt，以你实际收到的注入版契约为权威逐字模板。
-
-### 契约门控（阻断完成）
-
-- **plan 启动前**：CLI 校验 `design.md` 是否满足 plan 契约（缺文件变更清单/风险登记/自审章节会阻断）。若失败需先 `sillyspec run brainstorm --reopen --from-step N` 修订设计。
-- **plan 完成时**：CLI 校验 `tasks.md`（任务注册表）× `plan.md`（Wave ID 引用）是否满足 execute 契约（引用存在性/覆盖恰一次/编号连续/旧格式拦）。失败会阻断完成，提示修复后重新 `--done`。
-
-### 生产接线路径检查
-
-plan 完成校验会检查：design 提到入口文件（cli.ts/main.ts/server.ts 等）但 task 的 allowed_paths 不含该文件 → 报 error。若确实不需要改入口，在 design.md 明示理由。
-
-## 跨仓 task 卡片协议（一个 change 改多个仓库）
-
-单个 change 的 task 可以分散到主仓 + 多个跨仓仓实现（典型场景：dogfood 自指、monorepo 多包仓、共享库 + 调用方联合改造）。**单仓 change 不需要任何跨仓配置**（所有 task 不写 `repo:` 即走原流程，零回归）。
-
-### 跨仓 task 卡片字段
-
-在 `tasks/task-NN.md` frontmatter 加：
-
-- `repo: <key>`（可选，缺省='main'=主仓 task）：task 所属仓的 key。key 必须在 `.sillyspec/local.yaml` `repos:` 段注册（`main` 隐式=主仓不用注册）。跨仓 change 缺注册 → execute 启动 fail-closed 阻断。
-- `allowed_paths`：跨仓 task 时指**相对跨仓仓根**的路径（非主仓根）。例如跨仓 task 改 `sillyspec` 仓的 `src/foo.js`，allowed_paths 写 `src/foo.js`（相对 sillyspec 仓根），不是 `../sillyspec/src/foo.js`。
-- `base_commit` / `head_commit`：**不要手写**——CLI 在 execute 派发/回收时自动落盘双锡点（锁 base/head 防 diff 漂移），plan 阶段不写。
-
-### local.yaml `repos:` 段（跨仓注册表）
-
-> 📍 `local.yaml` 恒在 `.sillyspec/local.yaml`——项目根目录**没有**这个文件，别去那里找或新建（hook 会拦）。worktree 内该文件不随 checkout 出现，读配置直接跑 `sillyspec config cat`（自动定位到主仓真实配置）；可用键清单见 `sillyspec config schema`。
-
-跨仓 change 的每个 repo key 都要注册（execute 启动 fail-closed 校验）。**用命令注册，勿手编 YAML**：
-
-```
-sillyspec local register-repo <key> <跨仓仓根路径>
-```
-
-（外科手术式写入，只动 `repos:` 段，其余内容保留；execute 启动报缺注册时，报错文案里就带这条命令。）手写格式参考：
-
-```yaml
-repos:
-  shared-lib: ../shared-lib
-  tool-repo: C:/path/to/your/tool-repo
-```
-
-key = task 卡 `repo:` 引用名，value = 跨仓仓绝对路径（或相对主仓根的路径）。`main` 不用注册。
-
-### design.md 文件变更清单按仓分段
-
-跨仓 change 的 `## 文件变更清单` 段须按仓分段，段头格式 `## <repo> 仓变更`（主仓段头可省略或写 `## main 仓变更`）：
-
-```markdown
-## 文件变更清单
-
-### sillyspec 仓变更
-| 操作 | 文件路径 | 说明 |
-|---|---|---|
-| 修改 | src/task-review.js | 跨仓 task 改的文件 |
-
-### main 仓变更
-| 操作 | 文件路径 | 说明 |
-|---|---|---|
-| 修改 | src/index.js | 主仓 task 改的文件 |
-```
-
-plan 完成校验会按仓分段对账：跨仓仓路径相对跨仓仓根校验 task allowed_paths 覆盖，主仓路径相对主仓根校验。跨仓 task 与主仓 task 同名物理路径分属不同 repo 不判冲突。
-
-### Wave 划分
-
-同 Wave 内允许混合主仓 + 跨仓 task（execute 按 per-task workdir 派发，不强制同 Wave 同 repo）。共享文件的 task 仍须分到不同 Wave（同 Wave 共享文件会被强制并行，子代理互相覆盖）。
-
-## 阶段流转
-
-```
-brainstorm → plan → execute
-```
-
-plan 完成后（plan.md 通过 execute 契约校验），运行 `sillyspec run execute --change <变更名>` 开始实现。
-
-## 铁律
-
-- **必须用 exec 工具（shell）执行 CLI，不要自己编造流程**
-- 只做当前步骤 prompt 描述的操作，不跳过、不自行扩展
-- tasks.md 是任务清单唯一真相（checkbox 注册表，plan 阶段展开写回——保留 ql-xxx 等非 task-XX 行）；plan.md Wave 段只写纯 ID 引用行（`- task-XX`），不重抄任务名
-- 完成后立即 `--done`，不跳过
-
-## 用户指令
-$ARGUMENTS

package/.claude/worktrees/sillyspec-data-model-research/.claude/skills/sillyspec-quick/SKILL.md

@@ -1,116 +0,0 @@
----
-name: sillyspec:quick
-description: 用于明确、低风险、范围很小的直接任务。适合用户说"直接改、快速修、顺手调整、改个文案、修个小 bug、更新一个文件、不要完整流程"。跳过 brainstorm/plan，但仍按 sillyspec quick 流程执行。
----
-
-## 何时使用
-
-- 明确、低风险、范围小的直接修改：改文案、修小 bug、更新单个文件
-- 用户说"直接改、快速修、顺手调整、不要完整流程"
-- brainstorm 判定 `scale=small` 的变更：带 design.md 进 quick（`sillyspec run quick --linked-changes <变更名>`），design 当背景
-- 跳过 brainstorm/plan，但仍走 quick 的 3 步流程（理解任务 → 实现 → 自检提交）
-
-## 多变更说明（quick 特殊，务必注意）
-
-quick 阶段的 `--change` 语义是「关联变更」**且会触发步骤重置**，**不要用 `--change` 来指定关联变更**。多活跃变更时改用：
-
-- `--linked-changes none`：不关联，仅记 QUICKLOG（CLI 启动时写入）
-- `--linked-changes a,b`：显式关联到变更 a、b
-- `--non-interactive`：CI/脚本环境，默认不关联（避免交互 prompt 崩溃）
-
-首次 `sillyspec run quick` 选定的关联会持久化到 `.runtime/quick-sessions/<quick-session-id>/guard.json`（每个 quick 会话独立，多会话并发不互覆盖），后续 `--done` 自动复用，**不会重复弹交互 prompt**。
-
-## 步骤生命周期（所有阶段通用）
-
-> `sillyspec quick` 是 `sillyspec run quick` 的顶层别名，两者等价。
-
-```bash
-sillyspec run quick                            # 输出当前步骤 prompt（首次会记录 baseline）
-sillyspec run quick --done --output "摘要"     # 完成当前步骤
-sillyspec run quick --status                   # 查看阶段进度
-sillyspec run quick --skip                     # 跳过可选步骤
-sillyspec run quick --reset                    # 重置阶段（从头开始）
-sillyspec run quick --reopen --from-step N     # 重新打开已完成阶段修订（N=序号或名称）
-```
-
-### 已有进行中会话的恢复（sessionId）
-
-`sillyspec run quick` / `run quick --done` / `--status` **不带 `--change` 时，是启动一个新 quick 会话**（CLI 分配新 `quick-<hash>` + 新 ql-ID，QUICKLOG 追加「进行中」条目），不是恢复正在进行的旧会话。多会话并发或中断恢复时，必须带上启动时 CLI 打印的 sessionId：
-
-```bash
-sillyspec run quick --change quick-<hash>        # 恢复查看该会话当前 step prompt
-sillyspec run quick --done --change quick-<hash> --output "…"  # 完成该会话步骤
-```
-
-- 这里的 `--change quick-<hash>` 是「恢复到该 CLI 生成的 session」，与下方 `--linked-changes` 的关联业务变更语义不同：想关联真实业务变更才用 `--linked-changes`。
-- 误启动的空壳会话：`sillyspec run quick --cancel --change quick-<hash>` 一键取消（QUICKLOG 条目翻「已取消」+ tasks.md 挂载行移除 + 会话目录清理 + db 行注销；已完成/已勾选的拒绝取消）。
-
-## 通用参数（所有阶段适用）
-
-| 参数 | 说明 |
-|---|---|
-| `--spec-dir <path>` | 指定规范目录（默认 `<项目>/.sillyspec`） |
-| `--input "<一句话任务描述>"` | 通用参数，**quick 启动时强烈建议带**：作为 QUICKLOG 条目标题，条目从第一分钟即语义可读。不带则落「(quick 任务)」占位标题——平台「快速修复」列表默认隐藏进行中的占位条目，语义标题要到最终 `--done` 才回填（关联变更有 proposal/design 标题时可自动提取，免传） |
-| `--non-interactive` | CI/脚本下禁用交互式 prompt |
-| `--interactive` | 强制交互（即便 stdin 非 TTY） |
-| `--skip-approval` | 跳过阶段转换/审批检查（不能跳产物校验 gate——review.json/文档产物硬校验仍在） |
-
-## quick 特有参数
-
-| 参数 | 说明 |
-|---|---|
-| `--linked-changes none\|a,b` | **显式关联变更（取代 `--change`，推荐）**。none=不关联，a,b=关联列表 |
-| `--files a.js,b.js` | 显式声明本次允许修改的文件（边界保护 + 声明即归属：多 agent 并发仓防他者窗口文件混入 QUICKLOG 文件行，未声明窗口文件进「审计：」行追溯；**他向亦然**——其他 active 会话已声明的文件在你的 `--done` 审计中自动剔除归该会话，不再误拦、无需 `--force-baseline`）。**中途可追加**：发现要改声明外文件（如新写的测试）时，带新增文件恢复会话即并入边界（追加不替换）——`sillyspec run quick --files <新增> --change <sessionId>`；不带 `--files` 恢复则边界原样保留 |
-| `--file-notes "p::注 \|\| p::注"` | quick `--done` 用：QUICKLOG「文件：」行落盘为多行带括注 bullet（省事后手改文件行）。格式 `path::括注`，`\|\|` 分隔多条；**只随 step3 --done 同命令传**（CLI 短进程，step1/step2 传无效，不带到 step3） |
-| `--allow-new` | 允许新增文件（默认禁止，防意外创建） |
-| `--allow-delete` | 允许删除文件（默认 fail-closed，删除是破坏性操作；确认删除带此 flag 显式解锁） |
-| `--force-baseline` | 允许覆盖 baseline 受保护文件 / 压制 `.sillyspec/` 危险判定（危险，慎用） |
-| `--confirm` | ⚠️ 仅打印变更概览，**不解锁 blocked**（blocked 仍 exit 1）。真正解锁用 `--force-baseline`/`--allow-new`/`--allow-delete` |
-
-## 审计与并发变更（`--done` 边界审计）
-
-`--done` 收尾时对比 step1 baseline 与当前 `git status`，拦「危险文件 / 新增文件 / 覆盖 baseline」。要点：
-
-- **并发其他会话的 `.sillyspec/changes/<非关联变更>/` 不再被本 quick 拦截**。quick 自己没有 `changes/` 目录，该路径下非关联内容视为并发会话的工作，整体放行（确定性审计无法区分「并发工作」与「本 quick 偷建变更」，后者这类意图软判定留给 sillyhub）。
-- **其他 active 会话已声明的文件自动豁免（`--files` 的他向语义）**。多 agent 并发时，并行 quick 会话 `--files` 显式声明的文件（如它的 `daemon/router.py`）出现在你的窗口内（它在你启动后改的、不在你的 baseline）——`--done` 审计自动剔除归该会话边界管，不再判危险 BLOCK、无需 `--force-baseline`。放行可见：输出 🔗 软警告逐文件列归属会话；若确系你的改动，恢复会话时 `--files` 追加声明；超 7 天未收尾的僵尸会话声明自动失效（`sillyspec run quick --cancel --change <他者会话ID>` 清理）。豁免只认他者**显式声明**——未声明的他者文件照旧走各门判定（漏声明的补 `--files`，危险文件仍需 `--force-baseline`）。
-- **关联变更的文件仍走审计**：reverse-sync 改自己关联变更的 `design.md` 会被拦，需 `--force-baseline` 显式确认。
-- **baseline 折叠目录前缀匹配**：step1 启动时整片 `changes/` 未跟踪会被 git 折叠成 `?? .sillyspec/changes/`（带尾斜杠 token）；审计时若该目录下文件被并发会话跟踪而展开成文件级路径，按尾斜杠 token 前缀放行其下所有文件，不误判。
-- **同文件并发 warn（advisory，不阻断）**：step1 启动时若你的某个 `allowedFile` 已在他者脏文件列表里（他者也改了这文件），--done 时 CLI 会比对当前内容 hash 与启动时录入的 hash——不一致（你也改了它）即判「同文件并发」并 warn：整文件 pathspec 提交会夹带他者 hunk。warn 给出分离指引（`git add -p <file>` 交互选你自己的 hunk，或 `git diff <file> > mine.patch` 编辑后 `git apply --cached mine.patch` 再 commit）。这**不阻断** --done（你可能有意整文件提交），看 warn 后自行决定是否分离。
-- **`--confirm` ≠ 解锁**：它只打印概览。blocked 时真正解锁的是 `--force-baseline`（压制 `.sillyspec/` 危险判定 + baseline 覆盖）/`--allow-new`（放行新增）/`--allow-delete`（放行删除，删除是破坏性操作默认 fail-closed，须显式 opt-in），三者可在 step1 或 `--done` 传，都生效。
-
-## 典型用法
-
-```bash
-# 推荐启动：带一句话语义标题（QUICKLOG/平台快速修复列表进行中即可见可读）
-sillyspec run quick --input "修复登录限流 INCR 计数误清" --linked-changes none --files src/auth.ts
-
-# 单变更项目，直接开始
-sillyspec run quick
-
-# 多变更项目，显式不关联
-sillyspec run quick --linked-changes none
-
-# 多变更项目，关联到指定变更
-sillyspec run quick --linked-changes 2026-07-03-add-login
-
-# CI/脚本（非交互，避免 prompt 崩溃）
-sillyspec run quick --non-interactive
-sillyspec run quick --done --linked-changes none --output "修复手机号校验"
-
-# 限定修改文件范围
-sillyspec run quick --files src/phone.ts,src/phone.test.ts
-```
-
-## 铁律
-
-- **必须用 exec 工具（shell）执行 CLI，不要自己编造流程**
-- quick 直接在主工作区改代码（不创建 worktree），范围必须小且明确
-- 完成后立即 `--done`，不跳过
-- QUICKLOG 记录的**骨架由 CLI 接管**：启动时 CLI 自动分配 ql-ID 并在 `.sillyspec/quicklog/QUICKLOG-<user>.md` 写「进行中」条目（含关联变更 tasks.md），`--done` 时 CLI 自动翻「已完成」+ 勾选 task + 回填文件路径。ql-ID 分配/状态/task 你无需手写，只需用注入的 `<quicklog-id>` 在模块文档变更索引引用
-- **QUICKLOG 落盘已结构化（`--done` 后按需核对，多数无需手改）**：CLI 已落盘结构化条目——标题从 `--output` 的「需求：」自动提取、正文四字段自动分行、文件行用 `--file-notes` 时为多行带括注。`--done` 后只需核对：标题弱才改（禁留 `(quick 任务)` 占位）；没用 `--file-notes` 时文件行是单行、可事后补括注（参照同文件早期丰富条目）；正文 `需求：`/`根因：`/`方案：`/`结果：` 四段按需充实（禁只留一段「结果：」）。一条 quick = 一条独立 ql，不追加到旧条目
-- **收尾顺序（模块文档在 `--done` 前，QUICKLOG 在 `--done` 后，别记混）**：① 命中模块→改模块文档→`git add`；② `sillyspec run quick --done --change <id> --output "四字段" [--file-notes "..."]`（CLI 自动翻完成 + 勾 task + 落盘 QUICKLOG 标题/文件/正文；若 `--linked-changes` 关联的真实变更其 tasks.md 已全部勾选**且该变更未进入完整流程**（进度库阶段停在 brainstorm 及之前），CLI 会自动将其归档到 `changes/archive/`；已走到 plan/execute/verify/archive 的变更不自动归档（tasks.md 全勾不等于流程收尾），须走原流程收尾）；③ 核对 QUICKLOG 标题（CLI 已从「需求：」提取并截断，写成短标题则无需改）→若改了再 `git add`
-- **最后一步 `--done` 必须给全四字段**（逐项一句话）：🔧 **推荐四参数形式**（CLI 自动合成结构化模板，无格式事故面）：`--done --change <id> --req "一句语义化短标题" --cause "为什么改" --solution "怎么改的" --result "验证结果"`。兼容旧形式 `--output "需求：… 根因：… 方案：… 结果：…"`（手拼须懂截断规则、禁嵌套全角冒号，缺字段被拒 exit 1）。这是 QUICKLOG「结果：」归档的唯一来源。**`--req` 写一句语义化短标题**（写「改了什么」，如「登录限流修复——INCR 计数误清」）——CLI 把它提取为 QUICKLOG 条目标题，截到首个标点、超 80 字截断；写完整需求长句会被截成语义不完整的状语前半段，需求背景放 `--cause`/`--solution`。前两个 step 的 `--output` 是中间摘要，不用此模板
-- **禁止**在没有运行 CLI 的情况下自行决定流程
-
-## 用户指令
-$ARGUMENTS

package/.claude/worktrees/sillyspec-data-model-research/.claude/skills/sillyspec-resume/SKILL.md

@@ -1,70 +0,0 @@
----
-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` 自动更新，不需要手动保存