sillyspec 3.34.0 → 3.34.2

package/src/stages/knowledge.js

@@ -17,10 +17,10 @@
  */
 
 import { existsSync, readFileSync, readdirSync, mkdirSync, statSync } from 'fs'
-import { join, basename } from 'path'
+import { join, basename, dirname } from 'path'
 import { writeAtomicSync } from '../fs-atomic.js'
 import { parseKnowledgeIndex, keywordMatchesContext, normalizeAnchorForCompare } from '../knowledge-match.js'
-import { matchKnowledgeHybrid } from '../knowledge-vector.js'
+import { matchKnowledgeHybrid, resultChannel } from '../knowledge-vector.js'
 
 // ── 工具函数 ──
 
@@ -75,13 +75,28 @@ function extractTitle(content) {
 
 // ── search ──
 
+// 位置参数取词（2026-11-04-knowledge-search-positional）：--query 缺失时取首个非 flag
+// 且非 flag 值的 token 作查询词（AGENTS.md 模板形态 search "<关键词>"）。跳过 '--' 开头
+// token 与 --limit 的值 token——防 ['--limit','2'] 的 '2' 被误拾；flag 字面量永不入查询词
+// （flag-as-value 坑语义保持：--query 后跟 flag 仍按缺参，不从残参里捡词）。
+function positionalQuery(args) {
+  for (let i = 0; i < args.length; i++) {
+    const a = args[i]
+    if (a === '--limit') { i += 1; continue }
+    if (a.startsWith('--')) continue
+    return a
+  }
+  return ''
+}
+
 export async function cmdSearch(dir, args, opts = {}) {
   const knowledgeDir = resolveKnowledgeDir(dir, opts.specDir)
   // flag-as-value 防护（坑 knowledge-flag-as-value）：值以 '--' 开头视为漏传（只读命令，
   // 按缺参处理落入既有 required 校验/默认值，不静默拿 flag 字面量当查询词）
   const queryIdx = args.indexOf('--query')
   const queryRaw = queryIdx >= 0 ? args[queryIdx + 1] : ''
-  const query = queryRaw && !queryRaw.startsWith('--') ? queryRaw : ''
+  // --query 优先（显式压过位置推断）；缺失时回退位置参数形态
+  const query = (queryRaw && !queryRaw.startsWith('--') ? queryRaw : '') || positionalQuery(args)
   const limitIdx = args.indexOf('--limit')
   const limitRaw = limitIdx >= 0 ? args[limitIdx + 1] : ''
   const parsedLimit = limitRaw && !limitRaw.startsWith('--') ? parseInt(limitRaw, 10) : NaN
@@ -117,6 +132,21 @@ export async function cmdSearch(dir, args, opts = {}) {
     ? result.json.parkingFiltered : []
   const payload = buildSearchPayload(result, knowledgeDir, limit, query)
 
+  // search 面遥测（FR-05，2026-11-05-knowledge-search-observability）：显式检索此前零落盘
+  // ——查询形态/命中率/通道分布是向量层调优（地板值/词表收录）的唯一数据源。fail-soft：
+  // 落盘失败不影响检索输出（R-04 纪律）；stats 按 type 严格过滤，type=search 不进既有视图。
+  try {
+    const { appendKnowledgeHit } = await import('../knowledge-hits.js')
+    appendKnowledgeHit(join(dirname(knowledgeDir), '.runtime'), {
+      type: 'search',
+      query,
+      matched: Boolean(result && result.matched),
+      channel: resultChannel(result),
+      entry_count: (payload.matches || []).length,
+      matchedFiles: (payload.matches || []).map((m) => m.id).slice(0, 12),
+    })
+  } catch { /* 遥测 fail-soft（R-04） */ }
+
   output(true, {
     query,
     ...payload,
@@ -161,11 +191,8 @@ export function buildSearchPayload(result, knowledgeDir, limit, query) {
  */
 export function buildSearchMatches(result, knowledgeDir, limit, query) {
   const ctx = String(query || '').toLowerCase()
-  const channel = result && result.json && result.json.fallback ? 'fallback'
-    : result && result.json && result.json.vector ? 'vector'
-      : result && result.json && result.json.scope ? 'scope'
-        : 'routing'
-  return result.entries.slice(0, limit).map(entry => {
+  const channel = resultChannel(result)
+  return result.entries.slice(0, limit).map((entry) => {
     const filePath = join(knowledgeDir, entry.file)
     let title = entry.display
     let summary = ''
@@ -177,12 +204,16 @@ export function buildSearchMatches(result, knowledgeDir, limit, query) {
     }
 
     const tags = entry.keywords
+    // 向量通道透出真实余弦分（FR-03，2026-11-05-knowledge-search-observability）：
+    // keywords∩query 对 vector 通道恒 0（keywords=['vector'] 非查询词）——错值不只是缺值；
+    // vectorScore 由 buildResultFromPlatform 挂文件级最高分。其余通道 score 口径不变。
+    const vectorScore = channel === 'vector' && typeof entry.vectorScore === 'number' ? entry.vectorScore : null
     return {
       id: pathToId(entry.file, knowledgeDir),
       path: join('knowledge', entry.file),
       title,
       summary,
-      score: tags.filter(k => keywordMatchesContext(k, ctx)).length,
+      score: vectorScore !== null ? Math.round(vectorScore * 1000) / 1000 : tags.filter((k) => keywordMatchesContext(k, ctx)).length,
       tags,
       channel,
       category: entry.category,
@@ -384,120 +415,17 @@ export async function cmdValidate(dir, args, opts = {}) {
 // ── refresh ──
 
 export async function cmdRefresh(dir, args, opts = {}) {
+  // generated 切块退役（2026-11-07-knowledge-generated-retire）：双仓审计实证切块镜像为
+  // 零消费死区（INDEX 零引用、检索四层零进语料、自带 INDEX 零读取方）且是双源漂移源
+  // （平台仓同事实矛盾实证）——scan 文档本体在 docs 下项目 scan 目录，保留为唯一真相源，
+  // 切块产物退出知识库。子命令入口保留防脚本断链，行为=废弃提示零写盘。
   const knowledgeDir = resolveKnowledgeDir(dir, opts.specDir)
-  const generatedDir = join(knowledgeDir, 'generated')
-
-  if (!existsSync(knowledgeDir)) {
-    output(false, {}, { code: 'knowledge_dir_missing', path: knowledgeDir })
-    return
-  }
-
-  // refresh 只写 generated/ 区
-  mkdirSync(generatedDir, { recursive: true })
-
-  // 扫描 scan 文档。项目名用 DB 注册名优先（坑 knowledge-basename-project-mismatch）：
-  // scan 写侧 docs/<project> 的 project 来自 dbProjectName || basename(cwd)，注册名 ≠ 目录名
-  // （projects yaml name/path 分离、平台模式 specRoot≠sourceRoot）时，用 basename(dir) 拼
-  // scanDir 永远找不到 → refresh 恒报 scan_docs_missing。DB 读失败回退 basename（与写侧
-  // default 同口径）。查不到注册名对应目录时再回退 basename 试一次（双形态兼容）。
-  const base = opts.specDir || join(dir, '.sillyspec')
-  let projectName = null
-  try {
-    const { DatabaseSync } = await import('node:sqlite')
-    const db = new DatabaseSync(join(base, '.runtime', 'sillyspec.db'), { readOnly: true })
-    const row = db.prepare('SELECT name FROM project LIMIT 1').get()
-    db.close()
-    if (row && row.name) projectName = row.name
-  } catch { /* db 不可读 → 走 basename 兜底 */ }
-  if (!projectName) projectName = basename(dir)
-  let scanDir = join(base, 'docs', projectName, 'scan')
-  if (!existsSync(scanDir) && projectName !== basename(dir)) {
-    scanDir = join(base, 'docs', basename(dir), 'scan')
-  }
-
-  if (!existsSync(scanDir)) {
-    output(false, {}, { code: 'scan_docs_missing', path: scanDir })
-    return
-  }
-
-  const scanFiles = readdirSync(scanDir).filter(f => f.endsWith('.md'))
-  const generated = []
-  const overwritten = []
-  // 同 run 文件名去重（坑 knowledge-slug-collision）：slug 只由章节标题生成，不同 scan 文件
-  // 的同名章节（如各自都有「## 概述」）后者 writeFileSync 静默覆盖前者，INDEX 却登记两条
-  // 指向同一路径的条目——知识条目无声丢失。碰撞时追加 -2/-3 后缀保双份（唯一命名零扰动，
-  // 每次 refresh 按相同文件顺序重跑，后缀分配稳定）
-  const usedNames = new Set()
-
-  for (const scanFile of scanFiles) {
-    const scanPath = join(scanDir, scanFile)
-    const content = readFileSync(scanPath, 'utf8')
-    const title = extractTitle(content) || scanFile.replace('.md', '')
-
-    // 简单提取：取每个 ## 章节作为一个知识条目候选
-    const sections = extractSections(content)
-    for (const section of sections) {
-      if (section.lines < 3) continue // 太短的章节跳过
-
-      const slug = section.heading.toLowerCase()
-        .replace(/[^\w\u4e00-\u9fff]+/g, '-')
-        .replace(/^-|-$/g, '')
-        .slice(0, 60)
-
-      let fileName = `${slug}.md`
-      if (usedNames.has(fileName)) {
-        let n = 2
-        while (usedNames.has(`${slug}-${n}.md`)) n++
-        fileName = `${slug}-${n}.md`
-      }
-      usedNames.add(fileName)
-      const genPath = join(generatedDir, fileName)
-      const isNew = !existsSync(genPath)
-
-      const entryContent = [
-        `---`,
-        `source: scan/${scanFile}`,
-        `section: ${section.heading}`,
-        `generated_at: ${new Date().toISOString()}`,
-        `---`,
-        ``,
-        `# ${title} — ${section.heading}`,
-        ``,
-        section.body,
-      ].join('\n')
-
-      // INDEX/generated 是 search/validate 的解析源（跨进程读），走原子写防半截
-      writeAtomicSync(genPath, entryContent)
-      generated.push({ file: `generated/${fileName}`, title: `${title} — ${section.heading}`, new: isNew })
-      if (!isNew) overwritten.push(`generated/${fileName}`)
-    }
-  }
-
-  // 更新 generated/INDEX.md
-  const genIndexPath = join(generatedDir, 'INDEX.md')
-  const indexLines = [
-    '---',
-    `generated_at: ${new Date().toISOString()}`,
-    '---',
-    '',
-    '# Generated Knowledge Index',
-    '',
-    '> Auto-generated from scan documents. Do not edit manually.',
-    '',
-  ]
-  for (const g of generated) {
-    indexLines.push(`- ${g.title} → [${g.file}](${g.file})`)
-  }
-  writeAtomicSync(genIndexPath, indexLines.join('\n'))
-
   output(true, {
-    generated_count: generated.length,
-    new_count: generated.filter(g => g.new).length,
-    overwritten_count: overwritten.length,
-    files: generated,
+    deprecated: true,
+    message: 'knowledge refresh 已退役（2026-11-07-knowledge-generated-retire）：generated 切块为死区已退库。scan 文档本体在 docs 下的项目 scan 目录，由 scan 流程维护；知识沉淀走 propose → 用户确认后 accept 合并。',
+    knowledge_dir: knowledgeDir,
   })
 }
-
 // ── propose ──
 
 export async function cmdPropose(dir, args, opts = {}) {
@@ -510,6 +438,13 @@ export async function cmdPropose(dir, args, opts = {}) {
   const category = categoryIdx >= 0 && args[categoryIdx + 1] ? args[categoryIdx + 1] : 'uncategorized'
   const bodyIdx = args.indexOf('--body')
   const body = bodyIdx >= 0 && args[bodyIdx + 1] ? args[bodyIdx + 1] : ''
+  // --body-file 文件正文通道（2026-11-06-knowledge-propose-body-file）：中文长正文
+  // 经命令行 argv 传递会被策略层分词误杀（「斜杠+中文标点」序列误判路径，2026-11-06
+  // 平台会话双 shell 实证），文件通道彻底绕开 argv。相对路径按进程 cwd 解析
+  // （readFileSync 直读，不做 specDir 拼接）。
+  const bodyFileIdx = args.indexOf('--body-file')
+  const bodyFile = bodyFileIdx >= 0 && args[bodyFileIdx + 1] ? args[bodyFileIdx + 1] : ''
+  let bodyFromFile = ''
   const fromIdx = args.indexOf('--from')
   const from = fromIdx >= 0 && args[fromIdx + 1] ? args[fromIdx + 1] : ''
 
@@ -518,6 +453,40 @@ export async function cmdPropose(dir, args, opts = {}) {
     return
   }
 
+  // 三类参数错误先于 mkdirSync/writeAtomicSync——错误路径零目录创建零落盘。
+  // 互斥按 flag 在场判定（值缺省同算同给，报冲突优于静默择一）。
+  if (bodyFileIdx >= 0 && bodyIdx >= 0) {
+    output(false, {}, {
+      code: 'body_source_conflict',
+      message: '--body 与 --body-file 互斥，只能提供一个正文来源',
+    })
+    return
+  }
+  if (bodyFileIdx >= 0) {
+    if (!bodyFile || bodyFile.startsWith('--')) {
+      output(false, {}, '--body-file requires a path')
+      return
+    }
+    if (!existsSync(bodyFile)) {
+      output(false, {}, { code: 'body_file_missing', path: bodyFile })
+      return
+    }
+    try {
+      // 文件通道逐字快照读：空文件落空正文（不走 argv 通道的 '(no body provided)'
+      // 兜底——FR-01 落盘与源文件一致）
+      bodyFromFile = readFileSync(bodyFile, 'utf8')
+    } catch (err) {
+      output(false, {}, {
+        code: 'body_file_read_failed',
+        path: bodyFile,
+        reason: String((err && err.message) || err),
+      })
+      return
+    }
+  }
+  const hasBodyFile = bodyFileIdx >= 0
+  const bodyText = hasBodyFile ? bodyFromFile : body
+
   mkdirSync(proposedDir, { recursive: true })
 
   // 生成 slug
@@ -540,7 +509,8 @@ export async function cmdPropose(dir, args, opts = {}) {
     '',
     `# ${title}`,
     '',
-    body || '(no body provided)',
+    // argv 通道保持既有空兜底；文件通道逐字（空即空，见上方读取处注释）
+    hasBodyFile ? bodyText : (bodyText || '(no body provided)'),
     '',
     '---',
     '> This is a proposed knowledge entry. Review and merge into manual/ or generated/.',
@@ -652,21 +622,22 @@ export async function cmdKnowledge(args, dir, opts = {}) {
       '用法: sillyspec knowledge <子命令> [参数]',
       '',
       '子命令:',
-      '  search "<关键词>"     检索知识库（命中自动注入 prompt 的同源面）',
+      '  search "<关键词>"     检索知识库（--query 等效；命中自动注入 prompt 的同源面）',
       '  inspect <文件>        查看单个知识文件条目结构',
       '  validate              校验知识库完整性（INDEX 锚点/注册/幽灵条目——纯读）',
       '  digest                治理信号卡（rot/伪域/坏绑定——纯读）',
       '  scope                 知识注入作用域现状与标记语法（always/repo/module/关键词；纯读）',
       '  stats                 覆盖率/死条目统计（纯读）',
-      '  refresh               重扫 scan 文档重写 generated/ 区（**写盘**——先 validate 再用）',
-      '  propose / classify / inbox / graph / stats / renumber',
+      '  refresh               （已退役 2026-11-07）generated 切块死区退库——零写盘废弃提示；scan 本体由 scan 流程维护',
+      '  propose --title "..." [--body "<文本>" | --body-file <路径>] [--category <名>] [--from <来源>]   提议新知识（长中文正文用 --body-file 从文件读正文，绕开命令行传参）',
+      '  accept --id proposed/<slug> [--file <目标>] [--dry-run]   合并待审提议为正式知识（用户确认后执行；category 有效时可省 --file 自动路由）',
       '  renumber [--dry-run|--apply]  存量决策号迁移为全局号（dry-run 先行；apply 写盘幂等）',
       '  redomain-unmapped [--face decisions|fr] [--apply]  unmapped 停车场存量批量清偿（文件锚/覆盖面投票目标域；dry-run 先行）',
       '',
       '写盘面子命令（refresh/propose/classify）先跑同名只读命令确认现状；探索用法先看本帮助。',
     ]
     for (const l of lines) console.log(l)
-    output(true, { help: true, subcommands: ['search', 'inspect', 'validate', 'digest', 'refresh', 'propose', 'classify', 'inbox', 'graph', 'stats', 'scope', 'redomain-unmapped'] })
+    output(true, { help: true, subcommands: ['search', 'inspect', 'validate', 'digest', 'refresh', 'propose', 'accept', 'classify', 'inbox', 'graph', 'stats', 'scope', 'redomain-unmapped'] })
     return
   }
   const subCommand = args[0] || ''
@@ -682,6 +653,20 @@ export async function cmdKnowledge(args, dir, opts = {}) {
       return cmdRefresh(dir, args.slice(1), opts)
     case 'propose':
       return cmdPropose(dir, args.slice(1), opts)
+    case 'accept': {
+      // 待审知识收口（2026-11-07-knowledge-accept-channel）：合并 proposed 条目到正式知识
+      // 文件——动态 import 同 classify 先例（实现缺席返回友好错误）。
+      const mod = await tryImportSubcommandImpl('../knowledge-classify.js', 'knowledge-classify.js')
+      if (!mod || typeof mod.cmdKnowledgeAccept !== 'function') {
+        output(false, {}, {
+          code: 'not_implemented',
+          subcommand: 'accept',
+          message: '实现未落地（src/knowledge-classify.js cmdKnowledgeAccept）',
+        })
+        return
+      }
+      return mod.cmdKnowledgeAccept(dir, args.slice(1), opts)
+    }
     case 'redomain-unmapped': {
       // unmapped 停车场存量批量清偿（FR-04，2026-10-21-knowledge-tier-denoise）：decisions 按文件锚
       // / fr 按来源变更覆盖面投票目标域；缺省 dry-run 报告先行，--apply 幂等迁移（不裸删、冲突跳过）。
@@ -842,7 +827,7 @@ export async function cmdKnowledge(args, dir, opts = {}) {
       output(false, {}, {
         code: 'unknown_subcommand',
         subCommand: subCommand,
-        available: ['search', 'inspect', 'validate', 'refresh', 'propose', 'classify', 'inbox', 'stats', 'digest', 'graph', 'renumber', 'redomain-unmapped'],  // dump 随 graph 路由面（2026-10-09-graph-dump-layout）
+        available: ['search', 'inspect', 'validate', 'refresh', 'propose', 'accept', 'classify', 'inbox', 'stats', 'digest', 'graph', 'renumber', 'redomain-unmapped'],  // dump 随 graph 路由面（2026-10-09-graph-dump-layout）
       })
   }
 }

package/src/task-tick.js

@@ -20,6 +20,7 @@
  */
 import { existsSync, readFileSync, appendFileSync } from 'node:fs'
 import { runtimeStatePath } from './runtime-paths.js'
+import { fenceScan } from './md-fence.js'
 import { join } from 'node:path'
 
 /** 任务行（宽容缩进/星号有序标记，与哨兵判集行锚同口径 + 缩进容差）。 */
@@ -31,11 +32,23 @@ export function normalizeTaskId(id) {
   return m ? `task-${String(Number(m[1])).padStart(2, '0')}` : null
 }
 
-/** 任务行清单（行序即文档序）：[{id, checked, desc}]。 */
+/**
+ * 任务行清单（行序即文档序）：[{id, checked, desc}]。
+ * 围栏感知（2026-11-04-fence-aware-task-rows）：代码围栏内的示例任务行不计——
+ * 文档围栏常含 `- [ ] task-N:` 形态示例，逐行正则会把它们当真实任务（幻影行污染
+ * 进度 N/M 与下一任务指针）。按 fenceScan 行标记过滤，围栏语法口径见 md-fence.js。
+ */
 function collectRows(md) {
+  const text = String(md || '')
+  const { inFence } = fenceScan(text)
   const rows = []
-  for (const line of String(md || '').split(/\r?\n/)) {
-    const m = line.match(TASK_ROW_RE)
+  // 行切分口径：split(/\r?\n/) 与 fenceScan 的 split('\n') 行数恒等（\r 只附着前行段），
+  // inFence 行索引直接对齐；行内容去 \r 是硬需求——JS 正则的 . 不匹配 \r，TASK_ROW_RE
+  // 的 (.*)$ 咬不到带 \r 的行尾（CRLF 全漏检）。
+  const lines = text.split(/\r?\n/)
+  for (let i = 0; i < lines.length; i++) {
+    if (inFence[i]) continue
+    const m = lines[i].match(TASK_ROW_RE)
     if (m) rows.push({ id: `task-${String(Number(m[4])).padStart(2, '0')}`, checked: m[2].toLowerCase() === 'x', desc: (m[5] || '').trim() })
   }
   return rows
@@ -44,19 +57,34 @@ function collectRows(md) {
 /**
  * 纯函数：翻格 + 进度回显材料。
  * @param {{tasksMd:string, taskId:string}} opts
- * @returns {{kind:'ticked'|'already', tasksMd:string, checked:number, total:number, next:{id:string,desc:string}|null}
- *   |{kind:'unknown', available:string[]}}
+ * @returns {{kind:'ticked'|'already', tasksMd:string, checked:number, total:number, next:{id:string,desc:string}|null, unclosedFence:boolean, unclosedFenceLine:number|null}
+ *   |{kind:'unknown', available:string[], unclosedFence:boolean, unclosedFenceLine:number|null}}
+ *   unclosedFence/unclosedFenceLine（2026-11-04-fence-aware-task-rows）：tasks.md 存在未闭合
+ *   代码围栏及其 1 基起始行号——围栏内任务行按开栏即入栏不计，advisory 面（不阻断翻格）。
  */
 export function tickTasksMd({ tasksMd, taskId }) {
   const id = normalizeTaskId(taskId)
-  if (!id) return { kind: 'unknown', available: [] }
+  if (!id) return { kind: 'unknown', available: [], unclosedFence: false, unclosedFenceLine: null }
+  const scanInfo = fenceScan(String(tasksMd || ''))
   const rows = collectRows(tasksMd)
   const target = rows.find((r) => r.id === id)
-  if (!target) return { kind: 'unknown', available: rows.map((r) => r.id) }
+  if (!target) {
+    return { kind: 'unknown', available: rows.map((r) => r.id), unclosedFence: scanInfo.unclosed, unclosedFenceLine: scanInfo.fenceStartLine }
+  }
   let out = String(tasksMd || '')
   if (!target.checked) {
-    const re = new RegExp(`^(\\s*[-*] \\[) (\\] ${id}:)`, 'm')
-    out = out.replace(re, '$1x$2')
+    // 行内替换（围栏感知）：只动目标行 checkbox 态字符，其余字节逐字保留（\r 留在行内，
+    // 按 \n split 重 join 对 LF/CRLF 透明）；围栏内同 id 示例行不命中（inFence 行跳过）。
+    const re = new RegExp(`^(\\s*[-*] \\[) (\\] ${id}:)`)
+    const lines = out.split('\n')
+    for (let i = 0; i < lines.length; i++) {
+      if (scanInfo.inFence[i]) continue
+      if (re.test(lines[i])) {
+        lines[i] = lines[i].replace(re, '$1x$2')
+        break
+      }
+    }
+    out = lines.join('\n')
   }
   const after = collectRows(out)
   const checked = after.filter((r) => r.checked).length
@@ -67,6 +95,8 @@ export function tickTasksMd({ tasksMd, taskId }) {
     checked,
     total: after.length,
     next: pending ? { id: pending.id, desc: pending.desc } : null,
+    unclosedFence: scanInfo.unclosed,
+    unclosedFenceLine: scanInfo.fenceStartLine,
   }
 }
 
@@ -111,6 +141,9 @@ export async function runTaskTick({ changeName, cwd, taskId, specBase, evidence
     process.exit(2)
   }
   const r = tickTasksMd({ tasksMd: readFileSync(tasksPath, 'utf8'), taskId })
+  if (r.unclosedFence) {
+    console.warn(`⚠️ tasks.md 存在未闭合代码围栏（第 ${r.unclosedFenceLine} 行起）——围栏内任务行不计入任务集（检查围栏开合）`)
+  }
   if (r.kind === 'unknown') {
     const ids = (r.available || []).join('、') || '（tasks.md 无任务行）'
     console.error(`❌ tasks.md 中无 ${taskId}——可选任务：${ids}`)

package/templates/agents-instruction.md

@@ -3,6 +3,9 @@
 ## 项目说明
 本项目使用 **SillySpec** 管理变更，采用文档驱动开发。SillySpec 是给 Agent 调用的 CLI 流程控制器：你通过 CLI 告诉它"我在哪"，它告诉你"下一步做什么"；你执行步骤，它校验产出、推进状态，人类只在关键决策点介入审批。要考虑多 agent 同时操作代码，代码随时可能变化。所有变更以稳定、可用、可维护为目标，按生产级标准处理。
 
+## 子代理豁免
+被派发/派生的子代理（subagent）不执行本流程：不运行 sillyspec 流程命令（立项/批准/收口/归档/推送等），只完成派单任务并回传结果——变更状态所有权归派单的主会话。子代理发现流程前提不满足时在回传中报告，由主会话处理。
+
 ## 选道（动手前先对号入座）
 | 需求形态 | 走法 |
 |---|---|