sillyspec 3.19.1 → 3.20.0

package/.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": "每个阶段对应 `src/stages/` 下的独立模块...",
+      "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": "qinyi",
+      "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/.npmrc-tmp

@@ -0,0 +1 @@
+//registry.npmjs.org/:_authToken=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

package/package.json

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

package/src/index.js

@@ -63,6 +63,13 @@ SillySpec CLI — 规范驱动开发工具包
 
   sillyspec docs migrate       迁移旧文档到统一结构
 
+  sillyspec knowledge <cmd>    知识库管理（agent-safe，输出 JSON）
+    search --query "<text>" --limit N  搜索知识库
+    inspect --id "<id>"            读取知识条目详情
+    validate                        校验知识库健康度
+    refresh                         从 scan 文档刷新自动知识（仅写 generated/）
+    propose --title "<title>" --category <name>  提议新知识（写入 proposed/）
+
   sillyspec platform <cmd>      SillyHub 平台同步
     connect <url> [--token <t>]  连接平台
     disconnect                    断开连接
@@ -304,6 +311,11 @@ async function main() {
       await runCommand(stageArgs, resolveEffectiveDir(dir), specDir)
       break
     }
+    case 'knowledge': {
+      const { cmdKnowledge } = await import('./stages/knowledge.js')
+      await cmdKnowledge(filteredArgs.slice(1), resolveEffectiveDir(dir), { specDir })
+      break
+    }
     case 'dashboard': {
       // Parse dashboard options
       let port = 3456;
@@ -359,6 +371,7 @@ SillySpec worktree — git worktree 隔离管理
 用法:
   sillyspec worktree create <change-name> [--base <branch>]   创建隔离 worktree
   sillyspec worktree apply <change-name> [--check-only]        校验并应用变更到主工作区
+  sillyspec worktree assess <change-name>                     风险审计 + 自动 apply
   sillyspec worktree list                                      列出所有活跃 worktree
   sillyspec worktree cleanup <change-name> [--force]           强制清理 worktree
   sillyspec worktree doctor [--fix] [--stale-hours N]          健康检查 + 修复
@@ -434,6 +447,52 @@ SillySpec worktree — git worktree 隔离管理
           }
           break;
         }
+        case 'assess': {
+          if (!wtName) {
+            console.error('❌ 用法: sillyspec worktree assess <change-name>');
+            process.exit(1);
+          }
+          const { assessApplyRisk } = await import('./worktree-apply.js');
+          const assessment = assessApplyRisk(wtName, { cwd: dir });
+
+          const SEPARATOR = '─'.repeat(32);
+          console.log('Worktree Apply Decision');
+          console.log(SEPARATOR);
+          const decisionIcon = assessment.decision === 'SAFE' ? '✅' : assessment.decision === 'WARNING' ? '⚠️ ' : '🚫';
+          console.log(`Decision:    ${decisionIcon} ${assessment.decision}`);
+          console.log(`Changed files: ${assessment.changedFiles.length}`);
+          if (assessment.stats.additions > 0 || assessment.stats.deletions > 0) {
+            console.log(`Additions:   +${assessment.stats.additions}  Deletions: -${assessment.stats.deletions}`);
+          }
+
+          if (assessment.reasons.length > 0) {
+            console.log('');
+            console.log('Blocked reasons:');
+            for (const r of assessment.reasons) r.split('\n').forEach(l => console.log(`   ${l}`));
+          }
+          if (assessment.warnings.length > 0) {
+            console.log('');
+            console.log('Warnings:');
+            for (const w of assessment.warnings) console.log(`   ⚠️  ${w}`);
+          }
+
+          console.log('');
+          if (assessment.decision === 'SAFE' || assessment.decision === 'WARNING') {
+            console.log('Action: auto-applying...');
+            const { applyWorktree } = await import('./worktree-apply.js');
+            const applyResult = applyWorktree(wtName, { cwd: dir });
+            if (applyResult.errors.length > 0) {
+              console.error('❌ apply 失败:', applyResult.errors.join('; '));
+            } else {
+              console.log(`✅ 已自动应用 ${applyResult.changedFiles.length} 个文件变更`);
+            }
+          } else {
+            console.log('Action: blocked');
+            console.log('   → 检查变更: sillyspec worktree diff ' + wtName);
+            console.log('   → 丢弃变更: sillyspec worktree cleanup ' + wtName);
+          }
+          break;
+        }
         case 'list': {
           const items = wm.list();
           if (items.length === 0) {

package/src/run.js

@@ -1067,6 +1067,19 @@ async function executeScanPostcheck(cwd, platformOpts, scanProfile) {
   }
 }
 
+/**
+ * Plan postcheck 的执行代理：委托给 plan-postcheck.js 模块
+ */
+async function executePlanPostcheck(cwd, platformOpts) {
+  const { executePlanPostcheck: runPostcheck } = await import('./stages/plan-postcheck.js')
+  const { resolveChangeDir } = await import('./modules.js')
+  await runPostcheck({
+    cwd,
+    specRoot: platformOpts?.specRoot,
+    resolveChangeDir
+  })
+}
+
 /**
  * sillyspec run <stage> 主命令
  */
@@ -1087,6 +1100,19 @@ export async function runCommand(args, cwd, specDir = null) {
     process.exit(1)
   }
 
+  // ── cwd 纠正：向上查找真实项目根 ──
+  // 防止多 project 工作区中 cwd 停在子目录（如 backend/）时
+  // 状态写入子目录下误建的 .sillyspec，导致状态分裂
+  if (!specDir) {
+    const resolvedRoot = resolveSpecDir(cwd)
+    if (resolvedRoot && resolvedRoot !== join(cwd, '.sillyspec')) {
+      const realRoot = dirname(resolvedRoot)
+      if (realRoot !== cwd) {
+        cwd = realRoot
+      }
+    }
+  }
+
   // 平台模式参数（供 SillyHub 等平台调用）
   // --spec-dir 是统一参数名，--spec-root 保留为向后兼容别名
   const getFlagValue = (name) => {
@@ -1686,6 +1712,8 @@ async function runStage(pm, progress, stageName, cwd, changeName, skipApproval =
         await executeScanPreflight(cwd, platformOpts, scanProfile)
       } else if (cliAction === 'scanPostcheck') {
         await executeScanPostcheck(cwd, platformOpts, scanProfile)
+      } else if (cliAction === 'planPostcheck') {
+        await executePlanPostcheck(cwd, platformOpts)
       }
       stageData.steps[currentIdx].status = 'completed'
       stageData.steps[currentIdx].completedAt = new Date().toLocaleString('zh-CN', { hour12: false })
@@ -2171,29 +2199,43 @@ async function completeStep(pm, progress, stageName, cwd, outputText, inputText
     }
   }
 
-  // plan 阶段 "展开任务" 完成后，动态插入任务蓝图协调器步骤
-  if (stageName === 'plan' && steps[currentIdx]?.name === '展开任务并分组') {
-    const changeDir = resolveChangeDir(cwd, progress)
-    if (changeDir) {
-      const planFile = join(changeDir, 'plan.md')
-      if (existsSync(planFile)) {
-        const planContent = readFileSync(planFile, 'utf8')
-        const { buildPlanSteps, fixedPrefix, fixedSuffix } = await import('./stages/plan.js')
-        const fullSteps = buildPlanSteps(changeDir, planContent)
-        const prefixLen = fixedPrefix.length
-        const suffixLen = fixedSuffix.length
-        const coordinatorSteps = fullSteps.slice(prefixLen, suffixLen > 0 ? -suffixLen : undefined)
-        if (coordinatorSteps.length > 0) {
-          for (let i = 0; i < coordinatorSteps.length; i++) {
-            steps.splice(currentIdx + 1 + i, 0, {
-              name: coordinatorSteps[i].name,
-              status: 'pending',
-              prompt: coordinatorSteps[i].prompt,
-              outputHint: coordinatorSteps[i].outputHint,
-              optional: coordinatorSteps[i].optional
-            })
+  // plan 阶段 "generate_plan" 完成后，动态插入任务蓝图 + postcheck 步骤
+  // 使用稳定 id 匹配，不依赖中文标题
+  if (stageName === 'plan') {
+    const currentStepDef = defSteps?.[currentIdx]
+    const currentStepEntry = steps[currentIdx]
+    const stepId = currentStepDef?.id || currentStepEntry?.id || currentStepEntry?._stepId
+    if (stepId === 'generate_plan') {
+      const changeDir = resolveChangeDir(cwd, progress)
+      if (changeDir) {
+        const planFile = join(changeDir, 'plan.md')
+        if (existsSync(planFile)) {
+          const planContent = readFileSync(planFile, 'utf8')
+          const { buildPlanSteps, fixedPrefix, fixedSuffix } = await import('./stages/plan.js')
+          const fullSteps = buildPlanSteps(changeDir, planContent)
+          const prefixLen = fixedPrefix.length
+          const suffixLen = fixedSuffix.length
+          // 新结构：[...fixedPrefix, coordinatorStep?, postcheckStep?]
+          // fixedSuffix 为空，所以 coordinator + postcheck 都在 prefix 之后
+          const coordinatorSteps = fullSteps.slice(prefixLen, suffixLen > 0 ? -suffixLen : undefined)
+          if (coordinatorSteps.length > 0) {
+            for (let i = 0; i < coordinatorSteps.length; i++) {
+              const stepDef = coordinatorSteps[i]
+              const stepEntry = {
+                id: stepDef.id,
+                name: stepDef.name,
+                status: 'pending',
+                prompt: stepDef.prompt || '',
+                outputHint: stepDef.outputHint,
+                optional: stepDef.optional
+              }
+              // 传递 noAI / _cliAction 属性
+              if (stepDef.noAI) stepEntry.noAI = true
+              if (stepDef._cliAction) stepEntry._cliAction = stepDef._cliAction
+              steps.splice(currentIdx + 1 + i, 0, stepEntry)
+            }
+            console.log(`  📝 已动态插入 ${coordinatorSteps.length} 个步骤（${coordinatorSteps.map(s => s.name).join(', ')}）`)
           }
-          console.log(`  📝 已动态插入 ${coordinatorSteps.length} 个任务蓝图步骤（${coordinatorSteps.map(s => s.name).join(', ')}）`)
         }
       }
     }

package/src/stage-contract.js

@@ -67,7 +67,12 @@ function buildDecisionRecord(id, body) {
   const priorityMissing = priorityValue.length === 0
   const fallbackPriority = (['unresolved', 'blocking'].includes(status) || blocker) ? 'P1' : 'P2'
   const priority = (priorityValue.match(/P[0-2]/i)?.[0] || fallbackPriority).toUpperCase()
-  return { id: id.toUpperCase(), body, status, priority, blocker, priorityMissing }
+  // 解析 supersedes 字段：记录本条决策取代了哪个旧版本
+  const supersedesRaw = readDecisionField(body, 'supersedes', '')
+  const supersedes = supersedesRaw
+    ? supersedesRaw.split(',').map(s => s.trim().toUpperCase().replace(/['"]/g, '')).filter(Boolean)
+    : []
+  return { id: id.toUpperCase(), body, status, priority, blocker, priorityMissing, supersedes }
 }
 
 function findNextDecisionBoundary(content, startIndex) {
@@ -114,8 +119,16 @@ function parseDecisionRecords(content) {
 function extractCurrentDecisionIds(content) {
   const records = parseDecisionRecords(content)
   if (records.length === 0) return extractIds(content, 'D')
+  // 收集所有被 supersedes 声明取代的旧版本 ID
+  const supersededIds = new Set()
+  for (const r of records) {
+    for (const oldId of r.supersedes) {
+      supersededIds.add(oldId)
+    }
+  }
   return records
     .filter(r => !['superseded', 'rejected'].includes(r.status))
+    .filter(r => !supersededIds.has(r.id)) // 被新版本显式取代的旧版本不再校验
     .map(r => r.id)
     .sort()
 }
@@ -143,14 +156,13 @@ function warnMissingIds(warnings, ids, targetContent, targetName, sourceName) {
  */
 function validateScanOutputs(cwd, changeName, context = {}) {
   const { projectName, specRoot } = context
-  // 平台模式使用 specRoot，本地模式使用 cwd
-  const base = specRoot || cwd
-  // 如果 base 已经是 specDir（有 docs/ 子目录），直接用 base/docs/
-  // 否则按传统模式拼接 .sillyspec/docs/
-  const isSpecDir = existsSync(join(base, 'docs'))
+  // 平台模式：specRoot 直接是规范目录（含 docs/）
+  // 本地模式：规范目录是 cwd/.sillyspec
+  // 不用 isSpecDir 启发式猜测——很多项目根目录有自己的 docs/，会误判
+  const specBase = specRoot || join(cwd, '.sillyspec')
   const docsRoot = projectName
-    ? join(base, isSpecDir ? 'docs' : '.sillyspec/docs', projectName, 'scan')
-    : join(base, isSpecDir ? 'docs' : '.sillyspec/docs', 'scan')
+    ? join(specBase, 'docs', projectName, 'scan')
+    : join(specBase, 'docs', 'scan')
 
   const requiredDocs = [
     'ARCHITECTURE.md',
@@ -173,8 +185,8 @@ function validateScanOutputs(cwd, changeName, context = {}) {
 
   // 检查 modules 目录
   const modulesRoot = projectName
-    ? join(base, isSpecDir ? 'docs' : '.sillyspec/docs', projectName, 'modules')
-    : join(base, isSpecDir ? 'docs' : '.sillyspec/docs', 'modules')
+    ? join(specBase, 'docs', projectName, 'modules')
+    : join(specBase, 'docs', 'modules')
   if (!existsSync(modulesRoot)) {
     warnings.push('modules 目录不存在')
   } else {

package/src/stages/execute.js

@@ -297,45 +297,55 @@ const fixedSuffix = [
 先检查当前 worktree 的隔离模式：
 \`\`\`bash
 node -e "import('./src/worktree.js').then(w => { const wm = new w.WorktreeManager(); const m = wm.getMeta('<change-name>'); console.log(m ? JSON.stringify({mode: m.mode, path: m.worktreePath}) : 'no meta'); })"
-# 或从 DB 读取：
-sqlite3 -json .sillyspec/.runtime/sillyspec.db "SELECT isolation_status, isolation_mode, isolation_reason FROM changes WHERE name='<change-name>'" 2>/dev/null
 \`\`\`
 
 ### 操作（mode = worktree，SillySpec 创建的隔离 worktree）
-1. 运行 \`sillyspec worktree apply --check-only <change-name>\`
-2. 展示 diff 摘要（文件列表 + 变更统计）
-3. 检查结果说明（是否通过文件清单校验）
-4. 用户确认后运行 \`sillyspec worktree apply <change-name>\`
-5. apply 成功 → 运行 \`sillyspec worktree cleanup <change-name>\` → 输出 Worktree: cleaned
-6. apply 失败 → 展示错误详情，用户选择重试或手动处理
-7. 如果用户不想 apply → 运行 \`sillyspec worktree cleanup <change-name>\` 丢弃
-8. 建议下一步：\`sillyspec run verify\`
+
+**自动审计流程（不需要用户确认代码）：**
+
+1. 运行 \`sillyspec worktree assess <change-name>\` 自动风险审计
+2. 系统自动检查：
+   - patch --check 是否通过
+   - 变更是否在 allowed_paths 内
+   - 主工作区 baseline 是否变化
+   - 是否有高风险文件（lockfile/migration/配置/入口）
+   - diff 规模是否异常
+3. 输出 Apply Decision：
+
+\`\`\`
+Worktree Apply Decision
+────────────────────────
+Decision: SAFE | WARNING | BLOCKED
+Changed files: N
+Additions: +N  Deletions: -N
+Risky files: none | <list>
+Action: auto-applied | blocked
+\`\`\`
+
+4. **SAFE** → 自动 \`sillyspec worktree apply <change-name>\` + cleanup
+5. **WARNING** → 自动 apply（有警告但不阻断）+ cleanup
+6. **BLOCKED** → 不 apply，输出原因，提示用户检查：
+   - \`sillyspec worktree diff <change-name>\` 查看具体变更
+   - \`sillyspec worktree cleanup <change-name>\` 丢弃
+7. 建议下一步：\`sillyspec run verify\`
 
 ### 操作（mode = native-worktree，用户已有的 linked worktree）
-1. 运行 \`sillyspec worktree apply --check-only <change-name>\`
-2. 展示 diff 摘要
-3. 用户确认后运行 \`sillyspec worktree apply <change-name>\`
-4. **不要运行 cleanup** — 这是用户自己的 worktree，SillySpec 不能删除
-5. 输出 Worktree: kept（SillySpec 未创建此 worktree，保留不动）
-6. 建议下一步：\`sillyspec run verify\`
+1. 同上自动审计流程
+2. SAFE/WARNING → \`sillyspec worktree apply <change-name>\`
+3. **不要运行 cleanup**
+4. 输出 Worktree: kept
+5. 建议下一步：\`sillyspec run verify\`
 
 ### 操作（mode = in-place-fallback，降级模式无隔离目录）
 1. 展示本次执行摘要（\`git diff\` 查看变更）
-2. 跳过 apply 和 cleanup（没有隔离 worktree）
-3. 输出 Worktree: none（降级为 in-place，无隔离目录需要清理）
-4. 建议下一步：\`sillyspec run verify\`
-
-### 操作（无 worktree / --no-worktree 模式）
-1. 展示本次执行摘要
-2. 输出 Worktree: none
-3. 提示用户直接使用 \`git diff\` 查看变更
+2. 跳过 apply 和 cleanup
+3. 输出 Worktree: none
 4. 建议下一步：\`sillyspec run verify\`
 
 ### 输出
-apply 结果 + 下一步建议（或执行摘要）
+Apply Decision + 下一步建议
 
 ### 注意
-- 如果用户不想 apply → 运行 cleanup 丢弃
 - 完成后运行 \`sillyspec run execute --done\` 即可自动推进阶段`,
     outputHint: 'apply 结果',
     optional: false