sillyspec 3.25.2 → 3.25.4

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

@@ -87,7 +87,8 @@ 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），完成时 CLI 自动翻「已完成」并勾选 task。**你无需手写 QUICKLOG / tasks.md**，只需用注入的 `<quicklog-id>` 在模块文档变更索引引用
+- QUICKLOG 记录的**骨架由 CLI 接管**：启动时 CLI 自动分配 ql-ID 并在 `.sillyspec/quicklog/QUICKLOG-<user>.md` 写「进行中」条目（含关联变更 tasks.md），`--done` 时 CLI 自动翻「已完成」+ 勾选 task + 回填文件路径。ql-ID 分配/状态/task 你无需手写，只需用注入的 `<quicklog-id>` 在模块文档变更索引引用
+- **QUICKLOG 正文精修（`--done` 后必做，不可跳过）**：CLI 落盘的是简版骨架（标题可能是 `(quick 任务)`、文件是单行逗号无括注），**不合格**。`--done` 成功后必须立即编辑本次 `<quicklog-id>` 条目，手动精修成丰富格式：① 标题改真实需求摘要（禁 `(quick 任务)`）；② 文件改多行 bullet、每行带关键改动括注（禁 `（见实际改动）` 或无括注纯路径）；③ 正文 `需求：`/`根因：`/`方案：`/`结果：` 四段逐项充实（禁只留一段「结果：」）。参照同文件早期丰富条目。一条 quick = 一条独立 ql，不追加到旧条目
 - **最后一步 `--done --output` 必须按结构化结果模板给全四字段**（逐项一句话）：`需求：… 根因：… 方案：… 结果：…`。这是 QUICKLOG「结果：」归档的唯一来源；CLI 校验缺字段会拒绝 `--done`（exit 1），补全后重跑即可。前两个 step 的 `--output` 是中间摘要，不用此模板
 - **禁止**在没有运行 CLI 的情况下自行决定流程
 

package/package.json

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

package/src/quicklog.js

@@ -215,7 +215,7 @@ async function checkTaskCheckbox(specBase, change, qlId) {
 // 可能是 CRLF，split('\n') 后每行带 \r。原代码 `lines[i] === '状态：进行中'` 精确匹配
 // 恒失败 → 走 splice「兜底插入」→ 条目内同时出现「状态：已完成」+「状态：进行中」。
 // 状态行匹配与「已完成」判断统一用行首前缀匹配，容忍行尾 \r；写入保持 CRLF 不扩大改动。
-function flipEntryInContent(content, qlId, result) {
+function flipEntryInContent(content, qlId, result, changedFiles = []) {
   const lines = content.split('\n')
   const startIdx = lines.findIndex(l => l.startsWith(`## ${qlId} |`))
   if (startIdx === -1) return null
@@ -228,6 +228,12 @@ function flipEntryInContent(content, qlId, result) {
   for (let i = startIdx + 1; i < endIdx; i++) {
     if (/^状态：进行中\r?$/.test(lines[i])) { lines[i] = '状态：已完成'; flipped = true }
     if (lines[i].startsWith('结果：')) hasResult = true
+    // 回填实际改动文件（调用方已用 isQuickMetadata 过滤 quick 自身元数据，只留业务文件）。
+    // 原地替换 lines[i]，不改数组长度 → 与下方状态/结果 splice 的索引完全解耦。
+    // changedFiles 空（brownfield 无 guard / 调用方未传）→ 不动文件行，保持「（见实际改动）」。
+    if (changedFiles.length > 0 && lines[i].startsWith('文件：')) {
+      lines[i] = `文件：${changedFiles.join(', ')}`
+    }
   }
   if (!flipped && !lines.slice(startIdx, endIdx).some(l => /^状态：已完成\r?$/.test(l))) {
     // 无状态行（异常），插一条已完成
@@ -297,11 +303,13 @@ export async function allocateQuicklogEntry(specBase, gitUser, { description, li
 /**
  * 翻某 qlId 条目为「已完成」+ 追加结果 + 勾选关联 tasks.md。持锁。
  */
-export async function completeQuicklogEntry(specBase, gitUser, qlId, { resultText = '', linkedChanges = [] } = {}) {
+export async function completeQuicklogEntry(specBase, gitUser, qlId, { resultText = '', linkedChanges = [], changedFiles = [] } = {}) {
   const quicklogDir = join(specBase, 'quicklog')
   const lockPath = join(quicklogDir, `.QUICKLOG-${(gitUser || 'unknown')}.md.lock`)
   const result = sanitizeResult(resultText)
   const linked = Array.isArray(linkedChanges) ? linkedChanges : []
+  // 实际改动文件（调用方 complete-handlers 已用 isQuickMetadata 过滤 quick 自身元数据）。空 → 不动文件行。
+  const realFiles = Array.isArray(changedFiles) ? changedFiles.filter(Boolean) : []
 
   await withFileLock(lockPath, async () => {
     // 条目可能在主文件或轮转归档中
@@ -309,7 +317,7 @@ export async function completeQuicklogEntry(specBase, gitUser, qlId, { resultTex
       const filePath = join(quicklogDir, f)
       let content = ''
       try { content = readFileSync(filePath, 'utf8') } catch { continue }
-      const updated = flipEntryInContent(content, qlId, result)
+      const updated = flipEntryInContent(content, qlId, result, realFiles)
       if (updated !== null) {
         await writeAtomic(filePath, updated) // 命中处原子落盘（只改含目标条目的那一个文件）
         break

package/src/run/complete-handlers.js

@@ -23,7 +23,7 @@
 import { basename, join, resolve, relative, isAbsolute } from 'node:path'
 import { existsSync, readdirSync, readFileSync, writeFileSync, mkdirSync, unlinkSync, rmSync } from 'node:fs'
 import { renameSyncRetry, writeAtomicSync } from '../fs-atomic.js'
-import { resolveChangeDir, safeGit, auditQuickCompletion, triggerSync } from './shared.js'
+import { resolveChangeDir, safeGit, auditQuickCompletion, triggerSync, isQuickMetadata } from './shared.js'
 import { stageRegistry } from '../stages/index.js'
 import { SCAN_STATUS, POINTER_STATUS } from '../constants.js'
 import { printQuickAuditReview } from './quick-audit.js'
@@ -559,6 +559,9 @@ export async function handleQuickStageCompletion({ stageName, steps, currentIdx,
     const gitUser = safeGit(cwd, ['config', 'user.name']).value || 'unknown'
     let qlId = guard?.quicklogId || null
     const linkedChanges = Array.isArray(guard?.linkedChanges) ? guard.linkedChanges : []
+    // 审计结果（仅 guard 存在时填充）。提到 if(guard) 外声明，供下方回填 QUICKLOG 文件行复用
+    // review.changedFiles；brownfield 无 guard 时保持 null → 文件行不回填（降级，不报错）。
+    let review = null
 
     // 审计：仅在有 guard 时跑（brownfield 无 guard 跳过，兼容 D-003 brownfield 行为）。
     if (guard) {
@@ -570,7 +573,7 @@ export async function handleQuickStageCompletion({ stageName, steps, currentIdx,
         forceBaseline: guard.forceBaseline || isForceBaseline,
         allowNew: guard.allowNew || isAllowNew,
       }
-      const review = await auditQuickCompletion(cwd, mergedGuard, { isConfirm: confirm })
+      review = await auditQuickCompletion(cwd, mergedGuard, { isConfirm: confirm })
       printQuickAuditReview(review)
       if (review.status === 'blocked') {
         steps[currentIdx].status = 'pending'
@@ -632,9 +635,15 @@ export async function handleQuickStageCompletion({ stageName, steps, currentIdx,
     // 翻状态进行中→已完成 + 追加结果 + 勾选关联 tasks.md
     // resultText 不再截断：结构化结果块（需求/根因/方案/结果）完整落盘，多行写成字段化块。
     try {
+      // 回填实际改动文件：review.changedFiles 含 quick 自身元数据（quicklog/.runtime/modules 等），
+      // 用 isQuickMetadata 过滤掉，只留真实业务文件。brownfield 无 review → 空数组，文件行不动。
+      const realFiles = Array.isArray(review?.changedFiles)
+        ? review.changedFiles.filter(f => !isQuickMetadata(f, linkedChanges))
+        : []
       await completeQuicklogEntry(specBase, gitUser, qlId, {
         resultText: outputText || '',
         linkedChanges,
+        changedFiles: realFiles,
       })
       console.log(`📝 QUICKLOG 条目 ${qlId} 已标记完成`)
     } catch (e) {

package/src/run/gates.js

@@ -234,7 +234,7 @@ export async function runStageCompletionGates({ stageName, cwd, changeName, plat
       if (tier.tier === 'self') {
         console.log('\nℹ️  Stage Review: ' + stageName + ' tier=self（' + tier.reason + '），已降级为当前 agent 自审，不强制独立子代理。')
       } else {
-        const reviewRunId = getLatestStageReviewRunId(runtimeRoot, stageName)
+        const reviewRunId = getLatestStageReviewRunId(runtimeRoot, stageName, changeName)
         const reviewType = stageName === 'brainstorm' ? 'design'
           : stageName === 'plan' ? 'plan'
           : stageName === 'propose' ? 'proposal'

package/src/run/prompt.js

@@ -472,7 +472,7 @@ export async function outputStep(stageName, stepIndex, steps, cwd, changeName, d
   if (['brainstorm', 'plan', 'propose', 'execute'].includes(stageName) && promptText.includes('{REVIEW_TIER}')) {
     try {
       const { classifyReviewTier } = await import('../review-tier.js')
-      const { generateStageReviewRunId, renderReviewJsonContract } = await import('../stage-review.js')
+      const { generateStageReviewRunId, renderReviewJsonContract, stageReviewMarkerPath } = await import('../stage-review.js')
       const tierSpecBase = platformOpts?.specRoot || join(cwd, '.sillyspec')
       const tierChangeDir = changeName ? join(tierSpecBase, 'changes', changeName) : null
       const designPath = tierChangeDir ? join(tierChangeDir, 'design.md') : null
@@ -485,7 +485,21 @@ export async function outputStep(stageName, stepIndex, steps, cwd, changeName, d
         }
       }
       const tier = classifyReviewTier({ planLevel, designPath })
-      const reviewRunId = generateStageReviewRunId()
+      // reviewRunId：优先读 marker 复用（保证多次渲染 prompt 注入同一 ID == gate 读取的 ID，
+      // 修复「prompt 多次渲染 / 多次 review 时 gate 取错 ID 读错 review.json」），marker 缺失才
+      // generate + 落盘。对齐 execute {EXECUTE_RUN_ID} 段（prompt.js:449-467）。
+      const tierRuntimeRoot = platformOpts?.runtimeRoot || join(tierSpecBase, '.runtime')
+      const reviewRunIdMarker = stageReviewMarkerPath(tierRuntimeRoot, stageName, changeName)
+      let reviewRunId = ''
+      try {
+        if (existsSync(reviewRunIdMarker)) {
+          reviewRunId = readFileSync(reviewRunIdMarker, 'utf8').trim()
+        }
+      } catch {}
+      if (!reviewRunId) {
+        reviewRunId = generateStageReviewRunId()
+        try { mkdirSync(tierRuntimeRoot, { recursive: true }); writeFileSync(reviewRunIdMarker, reviewRunId + '\n') } catch {}
+      }
       // review.json 产物契约(schema + 示例 + docHash 算法 + 重算提示)事前注入,与 validateStageReviewSchema 同源
       const reviewContractMd = renderReviewJsonContract({ stage: stageName, changeDir: tierChangeDir, reviewRunId, tier: tier.tier })
       promptText = promptText

package/src/run/shared.js

@@ -188,6 +188,38 @@ export function parsePorcelainPath(line) {
   return path.replace(/\\/g, '/')
 }
 
+/**
+ * quick 自身写入的 .sillyspec/ 元数据判定（auditQuickCompletion 审计 与 QUICKLOG「文件：」行回填
+ * 单源）。回填文件行时复用：review.changedFiles 含这些元数据时过滤掉，只留真实业务文件。
+ *
+ * 归类口径：
+ * - quicklog/.runtime/modules/_module-map/knowledge-uncategorized 等 quick 自身产物 → 元数据
+ * - .sillyspec/changes/：quick 自己没有该目录，其下文件要么是关联变更（reverse-sync），
+ *   要么是并发他者会话的工作。非关联变更目录整体视为元数据放行；关联变更文件不算（属本 quick 真实改动）
+ *
+ * 「并发工作 vs 偷建变更」的意图软判定留给 sillyhub，确定性校验只做路径归类。
+ *
+ * @param {string} p 文件路径（容错 \\ / 混用）
+ * @param {string[]} [linkedChanges] 关联变更名列表（影响 changes/ 归类）
+ * @returns {boolean} true=quick 元数据，应从业务文件列表过滤掉
+ */
+export function isQuickMetadata(p, linkedChanges = []) {
+  const normalizeGitPath = (x) => String(x).replace(/\\/g, '/')
+  const file = normalizeGitPath(p)
+  if (file.startsWith('.sillyspec/quicklog/')
+    || file.startsWith('.sillyspec/.runtime/')
+    || file === '.sillyspec/knowledge/uncategorized.md'
+    || (/^\.sillyspec\/docs\/[^/]+\/modules\/[^/]+\.md$/.test(file))
+    || (/^\.sillyspec\/docs\/[^/]+\/modules\/_module-map\.yaml$/.test(file))) return true
+  if (file.startsWith('.sillyspec/changes/')) {
+    const linkedChangeNames = new Set((Array.isArray(linkedChanges) ? linkedChanges : []).map(c => normalizeGitPath(c)))
+    const m = file.match(/^\.sillyspec\/changes\/([^/]+)(\/|$)/)
+    // bare 折叠 token（git 把全新未跟踪 changes/ 折叠成 `changes/`）或具体但非关联的变更 → 放行
+    if (!m || !linkedChangeNames.has(m[1])) return true
+  }
+  return false
+}
+
 /**
  * quick 完成审计：对比 baseline 与实际变更。
  * @returns {{ status: 'safe'|'warning'|'blocked', reasons: string[], changedFiles: string[], newFiles: string[], deletedFiles: string[], baselineHit: string[] }}
@@ -215,26 +247,6 @@ export async function auditQuickCompletion(cwd, guard, options = {}) {
       const f = normalizeGitPath(p)
       return baselineExact.has(f) || baselineDirs.some(d => f.startsWith(d))
     }
-    // quick 自己没有 .sillyspec/changes/ 目录——该路径下任何文件要么是关联变更（reverse-sync），
-    // 要么是并发其他会话的变更工作。多会话并行时别人的 changes/ 不应被本 quick 审计拦截
-    // （确定性校验无法区分「并发工作」与「本 quick 偷建变更」，后者这类意图软判定留给 sillyhub）。
-    // 故：非关联变更目录整体放行；关联变更的文件仍走正常审计（reverse-sync 可见，需 --force-baseline）。
-    const linkedChangeNames = new Set((Array.isArray(guard.linkedChanges) ? guard.linkedChanges : []).map(c => normalizeGitPath(c)))
-    const isQuickMetadata = (p) => {
-      const file = normalizeGitPath(p)
-      if (file.startsWith('.sillyspec/quicklog/')
-        || file.startsWith('.sillyspec/.runtime/')
-        || file === '.sillyspec/knowledge/uncategorized.md'
-        || (/^\.sillyspec\/docs\/[^/]+\/modules\/[^/]+\.md$/.test(file))
-        || (/^\.sillyspec\/docs\/[^/]+\/modules\/_module-map\.yaml$/.test(file))) return true
-      // .sillyspec/changes/ 下：bare 折叠 token（git 把全新未跟踪 changes/ 折叠成 `changes/`）
-      // 或具体但【非关联】的变更 → 都属并发其他会话工作，放行；关联变更文件仍走审计。
-      if (file.startsWith('.sillyspec/changes/')) {
-        const m = file.match(/^\.sillyspec\/changes\/([^/]+)(\/|$)/)
-        if (!m || !linkedChangeNames.has(m[1])) return true
-      }
-      return false
-    }
     const DANGEROUS_PATTERNS = [
       'package.json',
       'package-lock.json',
@@ -269,7 +281,7 @@ export async function auditQuickCompletion(cwd, guard, options = {}) {
       }
 
       // 检查危险文件（除非 force-baseline）
-      if (file.startsWith('.sillyspec/') && !isQuickMetadata(file) && !forceBaseline) {
+      if (file.startsWith('.sillyspec/') && !isQuickMetadata(file, guard.linkedChanges) && !forceBaseline) {
         result.reasons.push(`危险文件变更: ${file}`)
       }
 
@@ -293,7 +305,7 @@ export async function auditQuickCompletion(cwd, guard, options = {}) {
     // 检查 new files（除非 allow-new）
     if (!allowNew) {
       for (const f of result.newFiles) {
-        if (!isQuickMetadata(f)) {
+        if (!isQuickMetadata(f, guard.linkedChanges)) {
           result.reasons.push(`新增文件（需 --allow-new）: ${f}`)
         }
       }
@@ -302,7 +314,7 @@ export async function auditQuickCompletion(cwd, guard, options = {}) {
     // 检查 allowedFiles 范围
     if (allowedFiles.length > 0) {
       for (const f of result.changedFiles) {
-        if (!allowedFiles.includes(f) && !isQuickMetadata(f)) {
+        if (!allowedFiles.includes(f) && !isQuickMetadata(f, guard.linkedChanges)) {
           result.reasons.push(`超出 allowedFiles: ${f}`)
         }
       }

package/src/run.js

@@ -12,8 +12,8 @@
  */
 // W6 Step8c: 主命令分发（runCommand）+ auto 模式 + ensureStageSteps 搬至 ./run/command.js
 export { runCommand, ensureStageSteps } from './run/command.js'
-// barrel re-export: parsePorcelainPath + auditQuickCompletion 被 test 直接 import（契约保留）
-export { parsePorcelainPath, auditQuickCompletion } from './run/shared.js'
+// barrel re-export: parsePorcelainPath + auditQuickCompletion + isQuickMetadata 被 test 直接 import（契约保留）
+export { parsePorcelainPath, auditQuickCompletion, isQuickMetadata } from './run/shared.js'
 // barrel re-export: applyRootPlaceholders 被 test/prompt-placeholders.test.mjs 直接 import（契约保留）
 export { applyRootPlaceholders } from './run/prompt.js'
 // barrel re-export: sanitizeProjectName + validateParsedProjects 被 test 直接 import（随 handleScan 搬走，契约保留）

package/src/stage-review.js

@@ -175,8 +175,9 @@ export function validateStageReviewSchema(review) {
  * 对应 task-review.verifyReviewGitEvidence 的"防伪造"职责——agent 不能凭空编一份
  * review.json 贴个假 hash。约定 docHash 对应 reviewedFiles[0]（主审查对象）。
  *
- * searchDirs 依次尝试解析 reviewedFiles 的相对路径（specBase / changeDir / cwd 都可能）。
- * 主文档在所有基准下都找不到时降级 warning，不阻断（不因路径基准差异误杀）。
+ * searchDirs 依次尝试解析 reviewedFiles[0] 的相对路径（effectiveSpecBase / changeDir / cwd）。
+ * 主文档在所有基准下都找不到时 fail-closed 阻断——连主审查文档都定位不到，要么 reviewedFiles[0]
+ * 是伪造路径（防 agent 填假路径跳过校验），要么路径基准严重错位，两者都不该静默放行。
  *
  * @param {object} review - 已通过 schema 校验
  * @param {string[]} searchDirs - 解析相对路径的候选基准目录（绝对路径）
@@ -204,9 +205,13 @@ export function verifyStageReviewDocHash(review, searchDirs) {
     return { ok: true, errors, warnings }
   }
 
-  // 所有基准都找不到主文档：路径基准差异，降级 warning
-  warnings.push(`主审查文档 ${primaryRel} 在候选目录下均不存在，跳过 docHash 校验（可能路径基准不同）`)
-  return { ok: true, errors, warnings }
+  // 所有基准都找不到主文档 → fail-closed。连主审查文档都定位不到，说明 reviewedFiles[0] 要么
+  // 是伪造路径（恶意 agent 填假路径跳过 docHash 校验），要么路径基准严重错位——两者都该阻断
+  // 而非静默放行（历史降级 warning 是可被利用的伪造通道）。searchDirs =
+  // [effectiveSpecBase(.sillyspec), reviewChangeDir(changes/<change>), cwd]，契约规定的
+  // reviewedFiles[0]（changes/<change>/<mainDoc> 或 <mainDoc>）在这三个基准下必命中其一。
+  errors.push('主审查文档 ' + primaryRel + ' 在 ' + (searchDirs || []).length + ' 个候选基准目录下均不存在 — 无法做 docHash 校验（reviewedFiles[0] 路径伪造或基准错位）')
+  return { ok: false, errors, warnings }
 }
 
 /**
@@ -220,13 +225,45 @@ export function generateStageReviewRunId() {
 }
 
 /**
- * 获取最新的 stage review run id（扫描 stage-reviews/<stage>-review-* 目录取最新）
+ * stage review marker 文件路径（prompt 渲染时写 / getLatestStageReviewRunId 读，同源）。
+ *
+ * 对齐 execute 的 current-execute-run-id-<change> 语义：含 change 防多 change 串台
+ * （同一 stage 不同变更的 review 各自独立 marker）；changeName 缺失时退化为按 stage 分。
+ *
+ * @param {string} runtimeRoot - .runtime 绝对路径
+ * @param {string} stage - brainstorm|plan|propose|execute
+ * @param {string} [changeName] - 变更名（防多 change 串台）
+ * @returns {string} marker 文件绝对路径
+ */
+export function stageReviewMarkerPath(runtimeRoot, stage, changeName) {
+  const suffix = changeName ? `${stage}-${changeName}` : stage
+  return join(runtimeRoot, `current-stage-review-run-id-${suffix}`)
+}
+
+/**
+ * 获取最新的 stage review run id
+ *
+ * 优先读 marker 文件（prompt 渲染 {REVIEW_TIER} 时写入，保证 gate 取的 ID == 注入给 agent
+ * 的 ID —— 修复「prompt 多次渲染 / 多次 review 时 gate 取错 ID 读错 review.json」），
+ * 对齐 getLatestExecuteRunId（task-review.js:420-428）。marker 缺失时 fallback 扫描
+ * stage-reviews/<stage>-review-* 目录取字典序最新（向后兼容无 marker 旧数据）。
  *
  * @param {string} runtimeRoot - .runtime 绝对路径
  * @param {string} stage - brainstorm|plan|propose|execute
+ * @param {string} [changeName] - 变更名（读对应 marker，防多 change 串台）
  * @returns {string|null} run id（如 'review-2026-07-16-143000'），无则 null
  */
-export function getLatestStageReviewRunId(runtimeRoot, stage) {
+export function getLatestStageReviewRunId(runtimeRoot, stage, changeName) {
+  // 优先读 marker（prompt 写 / gate 读同源，对齐 execute current-execute-run-id 机制）
+  try {
+    const markerPath = stageReviewMarkerPath(runtimeRoot, stage, changeName)
+    if (existsSync(markerPath)) {
+      const content = readFileSync(markerPath, 'utf8').trim()
+      if (content) return content
+    }
+  } catch {}
+
+  // fallback：扫描 stage-reviews/<stage>-review-* 目录取字典序最新（向后兼容无 marker 旧数据）
   const dir = join(runtimeRoot, 'stage-reviews')
   if (!existsSync(dir)) return null
   try {

package/src/stages/plan-postcheck.js

@@ -202,6 +202,34 @@ export function topoSortWaves(depMap) {
   return { waves, error: null }
 }
 
+/**
+ * 解析 plan.md 显式 Wave 分组 → Map<taskId, waveIndex>。
+ *
+ * Wave 口径与 execute.js parseWavesFromPlan 一致（execute 的真实并行单元，非 topoSort 建议值）：
+ *   - `## Wave N` 标题下的 task-XX checkbox 归入 Wave N；
+ *   - 非 Wave 标题行（## 自检 等）退出当前 Wave 段，避免其 checkbox 混入。
+ * 返回 null = plan.md 不存在或无显式 Wave 标题 → execute 会把所有 task 放进单个隐式 Wave
+ * 全并行（execute.js:402-408），调用方据此判「同文件即冲突」。
+ *
+ * @param {string} planPath - plan.md 绝对路径
+ * @returns {Map<string, number>|null} taskId → waveIndex；null = 无显式 Wave
+ */
+function parseTaskWavesFromPlan(planPath) {
+  if (!existsSync(planPath)) return null
+  const content = readFileSync(planPath, 'utf8')
+  if (!/^#+\s*Wave\s+\d+/im.test(content)) return null
+  const map = new Map()
+  let currentWave = null
+  for (const line of content.split('\n')) {
+    const wm = line.match(/^#+\s*Wave\s+(\d+)/i)
+    if (wm) { currentWave = parseInt(wm[1], 10); continue }
+    if (/^#+\s/.test(line)) { currentWave = null; continue } // 非 Wave 标题退出当前 Wave 段
+    const tm = line.match(/^[-*]\s*\[[ x]\]\s*(task-\d+)/i)
+    if (tm && currentWave !== null) map.set(tm[1], currentWave)
+  }
+  return map
+}
+
 /**
  * 本地一致性校验器
  * @param {string} changeDir - 变更目录
@@ -258,10 +286,40 @@ export function validateBlueprintConsistency(changeDir) {
     }
   }
 
-  // 路径冲突
+  // 路径冲突（Wave 感知）：同 Wave 内 >1 task 共享 allowed_path → execute 强制并行（execute.js:603）
+  // 子代理会互相覆盖该文件 → error。跨 Wave 同文件 → 串行执行安全 → warning。
+  // Wave 口径 = plan.md 显式 `## Wave N`（parseTaskWavesFromPlan，与 execute 同源，非 topoSort 建议值）；
+  // plan.md 无显式 Wave → execute 全并行（隐式单 Wave，execute.js:402-408）→ 同文件即冲突。
+  const waveOfTask = parseTaskWavesFromPlan(pJoin(changeDir, 'plan.md'))
   for (const [p, owners] of pathOwners) {
-    if (owners.length > 1) {
-      warnings.push(`路径 ${p} 被 ${owners.length} 个 task 修改: ${owners.join(', ')}（确认是否为有意共享）`)
+    if (owners.length < 2) continue
+    if (waveOfTask === null) {
+      errors.push(
+        `路径 ${p} 被 ${owners.length} 个 task 修改: ${owners.join(', ')} — plan.md 无显式 Wave 划分，` +
+        `execute 会把它们放进同一隐式 Wave 全并行（execute.js:402-408），子代理互相覆盖。` +
+        `解法：拆到不同 Wave（串行），或合并为单个 task。`
+      )
+      continue
+    }
+    // 显式 Wave：按 wave 分组 owners，找同 Wave 冲突
+    const byWave = new Map()
+    for (const t of owners) {
+      const w = waveOfTask.get(t)
+      if (w === undefined) continue // 未列入任何 Wave → execute 不执行，不参与冲突判定
+      if (!byWave.has(w)) byWave.set(w, [])
+      byWave.get(w).push(t)
+    }
+    for (const [w, ts] of byWave) {
+      if (ts.length > 1) {
+        errors.push(
+          `路径 ${p} 被 Wave ${w} 内 ${ts.length} 个 task 修改: ${ts.join(', ')} — 同 Wave 任务 execute 强制并行（execute.js:603），` +
+          `子代理会互相覆盖该文件。解法：把它们拆到不同 Wave（串行）。`
+        )
+      }
+    }
+    // 跨 Wave 共享：串行安全，仅提示
+    if (byWave.size > 1) {
+      warnings.push(`路径 ${p} 跨 Wave 被修改: ${owners.join(', ')}（不同 Wave 串行执行，安全；确认是否有意共享）`)
     }
   }
 
@@ -468,8 +526,9 @@ export function validatePlanFeasibility(changeDir, projectRoot = null) {
     // 1. 必要字段检查
     const taskId = (fm.match(/^id:\s*(.+)/m)?.[1] || '').trim()
     const title = (fm.match(/^title:\s*(.+)/m)?.[1] || '').trim()
-    const allowedPathsRaw = fm.match(/allowed_paths:\s*\n((?:\s+-\s+.+\n?)+)/)?.[1] || ''
-    const allowedPaths = allowedPathsRaw.match(/-\s+(.+)/g)?.map(s => s.replace(/^-\s+/, '').trim()) || []
+    // 复用 parseAllowedPaths（认 inline [x] + 块式两种写法），与 blueprint consistency / design coverage
+    // 三处统一，消除「feasibility 只认块式 → inline 写法被误报 allowed_paths 为空」的漂移（transcript 卡 3 轮根因）。
+    const allowedPaths = parseAllowedPaths(content)
 
     if (!taskId) errors.push(fsRule.data.messageId.replaceAll('${id}', file))
     if (!title) errors.push(fsRule.data.messageTitle.replaceAll('${id}', file))

package/src/stages/quick.js

@@ -31,7 +31,9 @@ export const definition = {
 - 在 \`{SPEC_ROOT}/quicklog/QUICKLOG-<git-user>.md\` 写入「进行中」条目（含关联变更与预估文件）
 - 对每个关联变更 \`<c>\`：在 \`{SPEC_ROOT}/changes/<c>/tasks.md\` 追加未勾选 task \`- [ ] <quicklog-id> <任务描述>\`
 
-**你不要创建或修改任何 QUICKLOG / tasks.md 记录**——完成本任务时 CLI 会自动将条目翻为「已完成」并勾选 task（含轮转）。\`<quicklog-id>\` 可用于 design.md / plan.md / archive / 模块变更索引引用。
+**你不要创建或修改任何 QUICKLOG 的条目骨架 / tasks.md 记录**——ql-ID 分配、「进行中」条目、状态翻转、task 勾选、轮转全由 CLI 接管，你无需手写。<quicklog-id> 可用于 design.md / plan.md / archive / 模块变更索引引用。
+
+> ⚠️ 例外：step 3 --done 之后，CLI 落盘的 QUICKLOG 只是简版骨架，**你必须手动精修正文成丰富格式**（标题语义化 + 文件多行带括注 + 四段充实），详见 step 3「QUICKLOG 正文精修」。这是 quick 交付质量的一部分，不可跳过。
 
 ### 输出
 任务理解 + 上下文摘要`,
@@ -85,7 +87,7 @@ export const definition = {
 2. 使用 \`git add -- <file...>\` 暂存本次 quick 实际修改的文件（不要 commit，由用户通过统一提交工具处理）
    - 禁止使用 \`git add -A\`
    - 不要暂存 quick 开始前就已存在的无关改动
-3. QUICKLOG / tasks.md 记录由 CLI 在本 step 完成时自动收尾（翻「已完成」+ 勾选 task + 轮转），你无需手动更新
+3. QUICKLOG / tasks.md 记录由 CLI 在本 step 完成时自动收尾（翻「已完成」+ 勾选 task + 轮转），你无需手动建/翻骨架——但**正文精修必做**（见下方「QUICKLOG 正文精修」）
 4. 如果发现项目特有的坑，追加到 \`{SPEC_ROOT}/knowledge/uncategorized.md\`
 5. 任务比预期复杂 → 建议用完整流程
 
@@ -100,8 +102,20 @@ export const definition = {
    - 使用 \`git add -- <module-doc>\` 暂存更新的模块文件
 9. 未命中任何模块 → 跳过，不做额外操作
 
-### 输出
-暂存确认 + 记录路径 + 模块文档同步结果（如有）`,
+### 输出
+暂存确认 + 记录路径 + 模块文档同步结果（如有）
+
+### 📝 QUICKLOG 正文精修（--done 之后必做，不可跳过）
+sillyspec run quick --done 成功后，CLI 已在 {SPEC_ROOT}/quicklog/QUICKLOG-<git-user>.md 落盘本次 <quicklog-id> 条目的简版骨架：状态翻「已完成」、「文件：」是单行逗号路径、正文是 --output 的四字段。骨架是机械产物不达标，你必须立即编辑该条目手动精修成丰富格式，三项必改：
+
+1. 标题：把 ## <quicklog-id> | <时间> | <标题> 中的 <标题> 改为真实需求摘要（如「登录加 IP 限流（5 次/分）+ 失败 3 次滑块验证」）。禁止保留 CLI 兜底的 (quick 任务) 或一句话笼统描述。
+2. 文件：把 CLI 写的单行「文件：a.js, b.js」改写为多行 bullet，每个文件带关键改动括注；禁止「（见实际改动）」或无括注纯路径单行。示例：
+   文件：
+   - backend/app/modules/auth/router.py（登录端点串 check_rate_limit→assert_captcha_if_needed）
+   - backend/app/modules/auth/captcha_service.py（新建：限流 INCR + 失败计数 + Pillow 滑块生成/校验）
+3. 正文：核对 需求： 根因： 方案： 结果： 四段逐项充实（--output 已写、CLI 原样插入，按需扩写），不允许只留一段「结果：」。
+
+一条 quick = 一条独立 ql 条目；精修只动本次 <quicklog-id> 条目，不追加到旧条目。QUICKLOG 在 .sillyspec/（gitignore），精修不影响 --done 已通过的边界审计。`,
       outputHint: '暂存和记录确认',
       optional: false
     }

package/src/sync.js

@@ -26,6 +26,13 @@ const LOCAL_YAML = '.sillyspec/local.yaml';
 const CHANGES_DIR = '.sillyspec/changes';
 const REQUEST_TIMEOUT_MS = 10_000;
 
+// 未连接平台是本地独立用户的合法默认状态。sync / syncDocuments / checkApproval 由 run 流程
+// 在后台 best-effort 触发（每步完成、execute 阶段启动），未连接时默认静默跳过——不每步催连
+// 平台制造噪音（本地用户根本不需要平台）。需要排查同步行为时设 SILLYSPEC_DEBUG_SYNC=1。
+function debugLog(msg) {
+  if (process.env.SILLYSPEC_DEBUG_SYNC) console.warn(msg)
+}
+
 /** 四件套文档文件名 */
 const DOCUMENT_FILES = ['proposal.md', 'design.md', 'requirements.md', 'tasks.md'];
 
@@ -193,7 +200,7 @@ export class SyncManager {
   async sync(changeName) {
     const platform = this._getPlatform();
     if (!platform) {
-      console.warn('[sync] 未连接平台，请先 sillyspec platform connect');
+      debugLog('[sync] 未连接平台（本地合法状态）；如需平台同步：sillyspec platform connect');
       return { synced: 0, errors: ['未连接平台'] };
     }
 
@@ -255,7 +262,7 @@ export class SyncManager {
   async syncDocuments(changeName) {
     const platform = this._getPlatform();
     if (!platform) {
-      console.warn('[sync] 未连接平台，请先 sillyspec platform connect');
+      debugLog('[sync] 未连接平台（本地合法状态）；如需平台同步：sillyspec platform connect');
       return { synced: 0, errors: ['未连接平台'] };
     }
 
@@ -317,7 +324,7 @@ export class SyncManager {
   async checkApproval(changeName) {
     const platform = this._getPlatform();
     if (!platform) {
-      console.warn('[sync] 未连接平台，请先 sillyspec platform connect');
+      debugLog('[sync] 未连接平台（本地合法状态）；如需平台同步：sillyspec platform connect');
       return { status: 'pending', reason: '未连接平台' };
     }
 

package/src/worktree-apply.js

@@ -185,11 +185,16 @@ export function applyWorktree(changeName, { cwd, checkOnly = false, merge = fals
 
   // --- 4.5 校验：主工作区 baseline 是否变化（防 execute 期间主工作区被修改）---
   // 注意：必须和 computeBaselineHash (worktree.js) 使用相同的排除规则。
-  // 排除 execute 流程自身会改的元数据（否则每个 execute 收尾都因自身改动 baseline 漂移 BLOCKED）：
+  // 排除非交付物的元数据/文档 churn（execute 自身改的 + 多操作者常改的 agent 指引/文档），
+  // 否则别人改 CLAUDE.md/docs/.claude → 整树 hash 变 → apply 误阻断（多操作者仓库高频踩坑）。
+  // 安全：放过它们不丢真冲突——下方 step5a(未提交∩changedFiles)+step5b(HEAD blob) 对交付文件
+  // 做精确 per-file 校验，不读这里的 exclude。
   //   - .sillyspec/：plan/design 蓝图 + runtime 产物
-  //   - docs/sillyspec/：工具坑文件（CLAUDE.md 规则要求 execute 期间记录）
+  //   - .claude/：agent 配置/skills/CLAUDE.md
+  //   - docs/：文档（deliverable 文档冲突由 step5a/5b 兜底）
+  //   - CLAUDE.md：根 agent 指引
   if (meta.baselineHash) {
-    const exclude = '-- . ":(exclude).sillyspec/" ":(exclude)docs/sillyspec/"';
+    const exclude = '-- . ":(exclude).sillyspec/" ":(exclude).claude/" ":(exclude)docs/" ":(exclude)CLAUDE.md"';
     const staged = gitQuiet(projectRoot, `diff --cached ${exclude}`) || '';
     const unstaged = gitQuiet(projectRoot, `diff ${exclude}`) || '';
     const untracked = gitQuiet(projectRoot, `ls-files --others --exclude-standard ${exclude}`) || '';

package/src/worktree.js

@@ -168,11 +168,16 @@ function sleepMs(ms) {
 }
 
 export function computeBaselineHash(cwd) {
-  // 排除 execute 流程自身会改的元数据，避免漂移误报（否则每个 execute 收尾都因自身改动 BLOCKED）：
+  // 排除非交付物的元数据/文档 churn，避免多操作者仓库里别人改这些 → 整树 hash 变 → apply 误阻断
+  // （execute 自身也会改 .sillyspec/docs.sillyspec，否则每个 execute 收尾都因自身改动 BLOCKED）。
+  // 安全：coarse hash 放过这些不丢真冲突——applyWorktree step5a(未提交∩changedFiles)+step5b(HEAD blob)
+  // 对交付文件做精确 per-file 校验，不读这里的 exclude。
   //   - .sillyspec/：brainstorm/plan 蓝图 + runtime 产物
-  //   - docs/sillyspec/：工具坑文件（CLAUDE.md 规则要求 execute 期间记录）
+  //   - .claude/：agent 配置/skills/CLAUDE.md（多操作者 agent 指引 churn）
+  //   - docs/：文档（非代码交付物；deliverable 文档冲突由 step5a/5b 兜底）
+  //   - CLAUDE.md：根 agent 指引（多操作者常改）
   // 必须和 applyWorktree step 4.5 (worktree-apply.js) 使用相同的排除规则。
-  const exclude = '-- . ":(exclude).sillyspec/" ":(exclude)docs/sillyspec/"';
+  const exclude = '-- . ":(exclude).sillyspec/" ":(exclude).claude/" ":(exclude)docs/" ":(exclude)CLAUDE.md"';
   const staged = gitQuiet(cwd, `diff --cached ${exclude}`) || '';
   const unstaged = gitQuiet(cwd, `diff ${exclude}`) || '';
   const untracked = gitQuiet(cwd, `ls-files --others --exclude-standard ${exclude}`) || '';

package/.playwright-mcp/console-2026-07-27T15-45-50-621Z.log

@@ -1 +0,0 @@
-[     809ms] [ERROR] Failed to load resource: the server responded with a status of 404 (File not found) @ http://localhost:8848/favicon.ico:0

package/.playwright-mcp/page-2026-07-27T15-45-51-459Z.yml

@@ -1,144 +0,0 @@
-- generic [active] [ref=e1]:
-  - banner [ref=e2]:
-    - generic [ref=e3]:
-      - generic [ref=e4]:
-        - text: Silly
-        - emphasis [ref=e5]: Spec
-      - generic [ref=e6]: Prompt Dossier
-    - generic [ref=e7]:
-      - text: ⌕
-      - textbox "搜索步骤名 / prompt 内容 / 占位符…" [ref=e8]
-    - generic [ref=e9]:
-      - generic [ref=e10]: 12 stages · 71 steps · 87k
-      - button "◐" [ref=e11] [cursor=pointer]
-  - generic [ref=e87]:
-    - navigation [ref=e88]:
-      - generic [ref=e89]:
-        - generic [ref=e90]:
-          - text: 主流程
-          - generic [ref=e91]: "4"
-        - generic [ref=e92] [cursor=pointer]:
-          - generic [ref=e93]: "01"
-          - generic [ref=e94]: 头脑风暴
-          - generic [ref=e95]: "8"
-        - generic [ref=e96] [cursor=pointer]:
-          - generic [ref=e97]: "02"
-          - generic [ref=e98]: 实现计划
-          - generic [ref=e99]: "5"
-        - generic [ref=e100] [cursor=pointer]:
-          - generic [ref=e101]: "03"
-          - generic [ref=e102]: 波次执行
-          - generic [ref=e103]: "12"
-        - generic [ref=e104] [cursor=pointer]:
-          - generic [ref=e105]: "04"
-          - generic [ref=e106]: 验证
-          - generic [ref=e107]: "7"
-      - generic [ref=e108]:
-        - generic [ref=e109]:
-          - text: 辅助
-          - generic [ref=e110]: "6"
-        - generic [ref=e111] [cursor=pointer]:
-          - generic [ref=e112]: "05"
-          - generic [ref=e113]: 项目扫描
-          - generic [ref=e114]: "11"
-        - generic [ref=e115] [cursor=pointer]:
-          - generic [ref=e116]: "06"
-          - generic [ref=e117]: 快速任务
-          - generic [ref=e118]: "3"
-        - generic [ref=e119] [cursor=pointer]:
-          - generic [ref=e120]: "07"
-          - generic [ref=e121]: 自由探索
-          - generic [ref=e122]: "1"
-        - generic [ref=e123] [cursor=pointer]:
-          - generic [ref=e124]: "08"
-          - generic [ref=e125]: 归档
-          - generic [ref=e126]: "5"
-        - generic [ref=e127] [cursor=pointer]:
-          - generic [ref=e128]: "09"
-          - generic [ref=e129]: 状态
-          - generic [ref=e130]: "3"
-        - generic [ref=e131] [cursor=pointer]:
-          - generic [ref=e132]: "10"
-          - generic [ref=e133]: 自检
-          - generic [ref=e134]: "5"
-      - generic [ref=e135]:
-        - generic [ref=e136]:
-          - text: 变体
-          - generic [ref=e137]: "1"
-        - generic [ref=e138] [cursor=pointer]:
-          - generic [ref=e139]: "11"
-          - generic [ref=e140]: 自动模式头脑风暴
-          - generic [ref=e141]: "4"
-      - generic [ref=e142]:
-        - generic [ref=e143]:
-          - text: 已废弃
-          - generic [ref=e144]: "1"
-        - generic [ref=e145] [cursor=pointer]:
-          - generic [ref=e146]: "12"
-          - generic [ref=e147]: propose · 已废弃
-          - generic [ref=e148]: "7"
-    - main [ref=e149]:
-      - generic [ref=e150]: 主流程 · STAGE 01
-      - heading "头脑风暴" [level=1] [ref=e151]
-      - paragraph [ref=e152]: 探索需求、分析技术方案、识别风险
-      - generic [ref=e153]:
-        - generic [ref=e154]: sourcesrc/stages/brainstorm.js
-        - generic [ref=e155]: persona资深架构师
-        - generic [ref=e156]: steps8
-      - generic [ref=e157]:
-        - button "全部展开" [ref=e158] [cursor=pointer]
-        - button "全部折叠" [ref=e159] [cursor=pointer]
-        - generic [ref=e160]: 8 STEPS
-      - generic [ref=e161]:
-        - article [ref=e162]:
-          - generic [ref=e163] [cursor=pointer]:
-            - generic [ref=e164]: 01 / 08
-            - generic [ref=e165]: 状态检查
-            - generic [ref=e166]: ▸
-        - article [ref=e167]:
-          - generic [ref=e168] [cursor=pointer]:
-            - generic [ref=e169]: 02 / 08
-            - generic [ref=e170]: 加载项目上下文
-            - generic [ref=e171]: ▸
-        - article [ref=e172]:
-          - generic [ref=e173] [cursor=pointer]:
-            - generic [ref=e174]: 03 / 08
-            - generic [ref=e175]: 对话式探索与需求澄清
-            - generic [ref=e176]:
-              - generic [ref=e177]: conditionalWait
-              - generic [ref=e178]: repeatable×8
-            - generic [ref=e179]: ▸
-        - article [ref=e180]:
-          - generic [ref=e181] [cursor=pointer]:
-            - generic [ref=e182]: 04 / 08
-            - generic [ref=e183]: 提出 2-3 种方案
-            - generic [ref=e184]: requiresWait
-            - generic [ref=e186]: ▸
-        - article [ref=e187]:
-          - generic [ref=e188] [cursor=pointer]:
-            - generic [ref=e189]: 05 / 08
-            - generic [ref=e190]: 分段展示设计
-            - generic [ref=e191]: requiresWait
-            - generic [ref=e193]: ▸
-        - article [ref=e194]:
-          - generic [ref=e195] [cursor=pointer]:
-            - generic [ref=e196]: 06 / 08
-            - generic [ref=e197]: 写设计文档并自审
-            - generic [ref=e198]: ▸
-        - article [ref=e199]:
-          - generic [ref=e200] [cursor=pointer]:
-            - generic [ref=e201]: 07 / 08
-            - generic [ref=e202]: Design Grill 交叉审查
-            - generic [ref=e203]: conditionalWait
-            - generic [ref=e205]: ▸
-        - article [ref=e206]:
-          - generic [ref=e207] [cursor=pointer]:
-            - generic [ref=e208]: 08 / 08
-            - generic [ref=e209]: 用户确认并生成规范文件
-            - generic [ref=e210]: requiresWait
-            - generic [ref=e212]: ▸
-  - contentinfo [ref=e213]:
-    - text: 数据机械提取自
-    - code [ref=e214]: src/stages/*.js
-    - text: · 单文件自包含 · file:// 可直接打开 · 生成命令：
-    - code [ref=e215]: node docs/prompt/_build-site.mjs