sillyspec 3.27.5 → 3.27.7

package/.worktrees/c1eae35e/.claude/skills/sillyspec-init/SKILL.md

@@ -0,0 +1,177 @@
+---
+name: sillyspec:init
+description: 绿地项目初始化 — 深度提问、调研、需求文档、路线图
+---
+
+## 交互规范
+
+**当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项以参数传入。**
+
+不要用编号列表让用户手动输入数字。
+如果需要自由输入，在 AskUserQuestion 的选项中加入"Other（自定义输入）"。
+
+---
+
+## 两个 init 的区别（重要）
+
+- **`sillyspec init`（CLI 命令）** — 安装命令模板/MCP 工具到项目（零交互，自动检测工具）。用法：`sillyspec init [--tool <名>] [--interactive] [--dir <path>] [--spec-dir <path>]`
+- **`/sillyspec:init`（本 skill）** — 绿地项目的需求文档生成流程（深度提问 → REQUIREMENTS.md → ROADMAP.md → PROJECT.md），不写代码、不装依赖
+
+两者用途不同、不冲突：可先用本 skill 搞清需求，再用 CLI `sillyspec init` 装工具。
+
+你现在是 SillySpec 的项目初始化器。
+
+## 用户输入
+$ARGUMENTS
+
+## 核心流程
+
+这是一个从零开始创建新项目的完整流程。你的目标是：**在开始写任何代码之前，把需求彻底搞清楚。**
+
+### Step 1: 检查工作区模式
+
+```bash
+ls .sillyspec/projects/*.yaml 2>/dev/null | grep -q .
+```
+
+如果 projects/ 目录存在且包含 .yaml 文件 → 工作区模式：
+1. 列出所有子项目（读取 projects/*.yaml）：
+   检测到工作区模式，请选择要初始化的子项目：
+   > 1. frontend — 前端 - Vue3 + TypeScript
+   > 2. backend — 后端 - Node.js + PostgreSQL
+   > 3. 新建子项目（先运行 /sillyspec:workspace add）
+2. 用户选择后，**切换到该子项目目录**执行后续所有步骤
+3. 后续步骤中的所有文件路径相对于子项目目录
+
+否则 → 单项目模式，继续。
+
+### Step 2: 检查项目状态
+
+```bash
+ls -la
+```
+
+如果目录已经有代码/配置文件 → 提示用 `/sillyspec:scan` 代替。
+如果是空目录 → 继续。
+
+### Step 3: 深度提问
+
+**一次只问一个问题**，按以下顺序探索：
+
+1. **项目本质** — 这个项目要解决什么问题？给谁用？
+2. **核心功能** — 用户能做的最重要的事情是什么？
+3. **技术偏好** — 有偏好的语言/框架吗？还是让我建议？
+4. **非功能需求** — 性能要求？安全要求？离线支持？多语言？
+5. **设计偏好** — 有参考产品吗？喜欢什么风格？
+6. **约束** — 预算？时间？团队规模？
+7. **不在范围内** — 明确什么不做
+
+### Step 4: 技术选型（如需要）
+
+如果用户没有明确偏好，基于项目需求推荐 2-3 套技术栈，列出优劣：
+- 语言 + 框架 + 数据库 + 部署方案
+- 给出推荐和理由
+
+### Step 5: 可选调研
+
+如果用户同意，对关键技术选型做快速调研：
+- 选定框架的当前版本和生态状态
+- 已知的坑和替代方案
+- 依赖的第三方服务的稳定性
+
+### Step 6: 生成需求文档
+
+保存到 `.sillyspec/REQUIREMENTS.md`：
+
+```markdown
+# 需求文档
+
+## 项目概述
+[一句话描述]
+
+## 目标用户
+[谁在用、在什么场景下用]
+
+## 功能需求
+### P0 — 必须有
+- [ ] 需求 1
+- [ ] 需求 2
+
+### P1 — 应该有
+- [ ] 需求 3
+
+### P2 — 有了更好
+- [ ] 需求 4
+
+## 非功能需求
+- 性能：xxx
+- 安全：xxx
+- 部署：xxx
+
+## 不在范围内
+- xxx
+- xxx
+
+## 技术选型
+| 层 | 选择 | 理由 |
+|---|---|---|
+| 前端 | React + TypeScript | xxx |
+| 后端 | xxx | xxx |
+| 数据库 | xxx | xxx |
+```
+
+### Step 7: 生成路线图：
+
+```markdown
+# 项目路线图
+
+## Phase 1: 基础骨架
+- 目标：可运行的最小版本
+- 交付物：项目结构 + 基础配置 + 首个可运行页面/接口
+
+## Phase 2: 核心功能
+- 目标：P0 功能全部可用
+- 交付物：xxx
+
+## Phase 3: 完善
+- 目标：P1 + 测试 + 打磨
+- 交付物：xxx
+```
+
+### Step 8: 生成 PROJECT.md
+
+保存到 `.sillyspec/PROJECT.md`：
+
+```markdown
+# PROJECT.md
+
+## 项目名：xxx
+## 一句话：xxx
+## 状态：已初始化，等待规划
+```
+
+### Step 9: Git 初始化
+
+```bash
+git init
+git add .
+```
+
+### 最后说：
+
+> ✅ 项目初始化完成！
+>
+> 生成文件：
+> - `.sillyspec/PROJECT.md` — 项目概述
+> - `.sillyspec/REQUIREMENTS.md` — 需求文档
+> - `.sillyspec/ROADMAP.md` — 路线图
+>
+> 下一步：
+> - 开始第一个功能：`/sillyspec:brainstorm "Phase 1: xxx"`
+> - 或修改需求：直接告诉我改什么
+
+## 绝对规则
+- 不写任何实现代码
+- 不安装任何依赖
+- 提问阶段一次一个问题
+- 需求必须具体，不能模糊（❌"好用" → ✅"首屏加载 < 2 秒"）

package/.worktrees/c1eae35e/.claude/skills/sillyspec-knowledge/SKILL.md

@@ -0,0 +1,270 @@
+---
+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/.worktrees/c1eae35e/.claude/skills/sillyspec-plan/SKILL.md

@@ -0,0 +1,156 @@
+---
+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