sillyspec 3.33.3 → 3.33.5

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

@@ -0,0 +1,48 @@
+---
+name: sillyspec:config
+description: 用于 SillySpec local.yaml 配置引导。适合用户说"配置下 sillyspec、连接平台、配 MCP、lint 不跑、测试太慢、加豁免"或 agent 需要写 .sillyspec/local.yaml 时。核心原则：默认零配置可用，只写真需要的键，写完必须 config validate 通过。
+---
+
+## 何时使用
+
+- 用户要求配置 SillySpec（平台凭据/MCP/测试/lint/调优键）
+- agent 判断需要写 `.sillyspec/local.yaml`（任何场景——本技能是唯一引导面）
+
+## 第一原则：默认零配置可用（先读这段再动手）
+
+**local.yaml 一个键都不写，SillySpec 就是完整可用的。** 全部 ~70 个注册键中只有平台/MCP 凭据族（4 键）真必填，且仅当用户要用平台功能。测试面按变更动态推断、lint 未配置自动跳过归 pre-push、FR 回归层缺省不跑归 CI——都是零配置最优缺省（2026-10-23 起）。
+
+**不要「预防性配置」**：不确定要不要写的键就是不写。写了多余键的唯一效果是偏离缺省、增加审计面。
+
+## 必填场景决策表（只有这些场景才动配置）
+
+| 场景 | 症状/触发 | 要写的键 | 怎么获得值 |
+|---|---|---|---|
+| 平台同步/看板 | 用户要用 SillyHub 平台 | `platform.url` + `platform.token` | **不手填**：跑 `sillyspec platform connect <url> --token <t>` 自动写 |
+| MCP 派发 | 评审平台单调用/独立审查派发 | `mcp.url` + `mcp.token` | 同上（connect 成对签发） |
+| 评审单调用 | 用户要评审收口一次完成（省 missing→PASS 往返） | `review_inline_wait: 180` | 依赖 mcp 凭据；平台不可用自动回退任务书面零损失 |
+| dirty 门残渣 | 收口反复被已知残渣文件拦（--accept-dirty-gap 成常态） | `dirty_gate_ignore: <前缀1>, <前缀2>` | 看收口输出点名的文件，取其稳定目录前缀 |
+| lint 收口实测 | 用户要 lint 在收口时跑（缺省跳过归 pre-push） | `commands.lint: <命令>` | 从 package.json scripts / Makefile 抄 |
+| 慢套件超时 | 实测被 600s 默认帽判超时失败 | `commands.test_timeout_sec: 2400` | 收口输出会提示 |
+| 全量测试道 | 用户明确要本地跑全量（罕见） | `test_strategy: full` | 仅显式全量时；缺省动态子集已是最优 |
+| 项目特有评审必查面 | 团队有自己的评审红线 | `review_probes:` 段 | 见 `sillyspec config schema` review_probes 节 |
+
+调优键全清单与语义：`sillyspec config schema`（单一真相；example 列可照抄值）。
+
+## 操作流程
+
+1. **看现状**：`sillyspec config cat`（权威路径链解析——worktree 内也能拿到主仓真实文件；不存在=零配置形态，正常）。
+2. **对决策表**：确认触发场景真实存在；不在表内的场景**不写任何键**，向用户说明缺省行为已覆盖。
+3. **获得值**：凭据族走 `sillyspec platform connect`（禁止手填 token 到 yaml）；其余键从仓库结构（package.json/pyproject/Makefile）或收口输出提示取值。
+4. **写文件**：编辑 `.sillyspec/local.yaml`（config cat 显示的路径；整文件 YAML，注意缩进用空格、保存为 UTF-8 无 BOM——PS 下用 Set-Content -Encoding utf8NoBOM 或让 CLI 命令代写）。**只写决策表需要的键，逐键照抄 schema 的 example 形态。**
+5. **硬门验证（必做，不许跳过）**：跑 `sillyspec config validate`
+   - **exit 0 才算配置完成**；exit 1 时按输出的错误行逐条修复后重跑。
+   - 有「未知顶层键」警告=键名/层级写错，回 schema 核对。
+   - 凭据段报缺键=两键要成对（或整段删除回退）。
+   - **禁止**在 validate 未通过时向用户宣称配置完成。
+
+## 边界
+
+- 禁止写 `.sillyspec/` 之外的 local.yaml（hook 拦截）；项目根没有这个文件。
+- 禁止把 token 写进 local.yaml.example 或任何可提交文件（真实 local.yaml 是 gitignored）。
+- known_failures 豁免键不用手改 yaml：`sillyspec config known-failures add|remove`（行级手术保注释）。

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

@@ -3,6 +3,10 @@ name: sillyspec:flow
 description: 轻量变更（默认快道）——需求明确的小/中改动。适合用户说"直接改、快速修、顺手调整、改个文案、修个小 bug、更新一个文件、需求很明确、开干吧、把这个改了"。协议链：flow start → 补 spec 面（FR 绑定+design 四节）→ 批准（flow approve / 用户显式 --autopilot）→ 干活（改代码写测试）→ flow done（实测门+测试绑定+patch 留档）。顺序纪律：先答 spec 面、批准后才动码（读代码探究不算动码）。
 ---
 
+## 交互规范
+
+**当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项以参数传入。** 不要用编号列表让用户手动输入数字。
+
 ## 何时使用
 
 - 需求已含决策：改什么、成功标准说得清（能列 1-3 条可验证标准）

package/AGENTS.md

@@ -33,7 +33,7 @@ sillyspec flow start --change <YYYY-MM-DD-名> --input "<一句 10-30 字中文
 1. **禁止绕过本文件规则和 SillySpec 流程**。所有变更走 sillyspec 流程，不裸改裸提交。
 2. **改代码前必须先说明依据**——依据的文档路径（design.md / 模块文档 / file-lifecycle.md（如有））或现有代码依据，无依据不改。
 3. **执行顺序**：文档 → 读代码 → 写测试 → 写实现 → 跑测试 → 验收 → 更新文档（轻量道即：FR 绑定+design 四节+用户批准先于动码，读代码探究不算动码）。测试按层适用：纯逻辑先写测试，行为契约断言用户可见行为，视觉样式与纯配置/文档不写测试（记「不适用：理由」，验收靠规范与人工）。
-4. **实证核验再收口**：触及 `src`/`test` 的改动，CLI 会在收口时亲自实测（实测失败阻断收口；纯 doc/配置自动跳过）。测试面按变更动态推断（本变更测试 ∪ FR 关联回归 ∪ import 依赖，runner 自项目结构推断——无需配置）；lint 走 `.sillyspec/local.yaml` 的 `commands.lint`。以落盘文件与测试结果为准，不信口头"已完成"。自验口径＝变更测试面（新增测试+受影响既有面）+ lint 即收口证据——全量套件归 pre-push 门，勿每变更重复手跑（共享仓全量红先做归属判别，非本变更引入如实留痕不阻断）；跑批输出落 `.sillyspec/.runtime/logs/` 日志回看尾部，勿整段吞掉。
+4. **实证核验再收口**：触及 `src`/`test` 的改动，CLI 会在收口时亲自实测（实测失败阻断收口；纯 doc/配置自动跳过）。测试面按变更动态推断（本变更测试 ∪ FR 关联回归 ∪ import 依赖，runner 自项目结构推断——无需配置）；lint 走 `.sillyspec/local.yaml` 的 `commands.lint`（未配置/标 `unavailable` → 收口跳过并留痕理由，归 pre-push/CI 门——pre-push 已跑同款 lint 的仓可标 unavailable 免重复）。以落盘文件与测试结果为准，不信口头"已完成"。自验口径＝变更测试面（新增测试+受影响既有面）即收口证据（lint 已配置时一并实测；标 `unavailable` 的仓归 git 钩子/CI 门）——全量套件归 pre-push 门，勿每变更重复手跑（共享仓全量红先做归属判别，非本变更引入如实留痕不阻断）；跑批输出落 `.sillyspec/.runtime/logs/` 日志回看尾部，勿整段吞掉。
 5. **非测试逻辑本身有误时，禁止改测试来"通过"**——修逻辑，不修测试。
 6. **git hook 拦截提交时禁止跳过**（如 `.husky/pre-push`），修复问题后再提交。
 7. **代码必须兼容 Windows / Linux / macOS**（路径 / 换行 / 并发都要顾）。

package/package.json

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

package/src/config-known-failures.js

@@ -0,0 +1,258 @@
+/**
+ * config-known-failures —— local.yaml known_failures 键的行级增删查（2026-10-21-p0-p1-hardening FR-07）
+ *
+ * 背景（dsh z2 实证）：agent 用 PS5.1 `Set-Content -Encoding UTF8` 手改 50KB local.yaml 的
+ * known_failures 行 → BOM/mojibake 不可逆损坏（510 个 `?`），恢复等用户人工贴备份 2h13m。
+ * known_failures 无 CLI 管理面 = 手改场景必然存在。本模块给 `sillyspec config known-failures
+ * list|add|remove` 提供纯逻辑核心：
+ *   - 行级定向手术（块式/流式两种既有形态都认），保留文件其余内容与注释——禁止 js-yaml 整体
+ *     重序列化（丢注释，用户文档性受损）；
+ *   - 改前 YAML 全文可解析性门（jsYaml.load 抛错 → 拒改，坏文件上叠加手术只会更坏）；
+ *   - 写入 writeAtomicSync（tmp+rename 原子替换）+ UTF-8 无 BOM 新写。
+ * 读法口径对齐 docs-check.js known_failures 键提取（块式 + 流式）——不 import（该模块拖重链）。
+ */
+import { existsSync, readFileSync } from 'node:fs'
+import jsYaml from 'js-yaml'
+import { writeAtomicSync } from './fs-atomic.js'
+import { unquoteYamlScalar, unescapeYamlDoubleQuoted } from './yaml-scalar-unquote.js'
+
+/** 块式头行：known_failures: 顶格、后接注释或空（docs-check.js:982 同口径） */
+const BLOCK_HEADER_RE = /^known_failures:\s*(?:#.*)?$/
+/** 流式行：known_failures: [a, b]（docs-check.js:971 同口径） */
+const INLINE_HEADER_RE = /^known_failures:\s*\[(.*)\]\s*(?:#.*)?$/
+/** 块式条目行：缩进 + 列表杠 + 键（支持裸/双引/单引形态，尾注释剥除） */
+const ITEM_RE = /^(\s+)-\s*(?:"([^"]*)"|'([^']*)'|([^#]*?))\s*(?:#.*)?$/
+
+/** 键的裸写安全性：字母数字/下划线/连字符/点/中文——其余（逗号方括号引号#等）写回时加双引号 */
+const BARE_KEY_SAFE_RE = /^[\w.\-\u4e00-\u9fff]+$/
+
+/**
+ * 纯函数：从 local.yaml 文本提取 known_failures 键清单（块式 + 流式两形态）。
+ * 无 known_failures 段 → 空数组；块头无条目（含 `known_failures: []` 流式空）→ 空数组。
+ * @param {string} text
+ * @returns {string[]}
+ */
+export function parseKnownFailureKeys(text) {
+  const src = String(text || '')
+  const lines = src.split(/\r?\n/)
+  // 流式优先（同键只可能一种形态在场；流式正则更具体）。条目规范化走 yaml-scalar-unquote
+  // 单点（2026-10-21-known-failures-unescape）：双引号条目反转义（renderKey 写侧按规范转义，
+  // 读侧不反转义会把 \\. 留成字面双反斜杠——锚定豁免模式静默失配）。
+  for (const l of lines) {
+    const m = l.match(INLINE_HEADER_RE)
+    if (m) {
+      return (m[1] || '')
+        .split(',')
+        .map((s) => s.trim())
+        .filter(Boolean)
+        .map((s) => unquoteYamlScalar(s))
+    }
+  }
+  const idx = lines.findIndex((l) => BLOCK_HEADER_RE.test(l))
+  if (idx === -1) return []
+  const keys = []
+  for (let i = idx + 1; i < lines.length; i++) {
+    const l = lines[i]
+    if (/^\S/.test(l)) break // 下一个顶层键——段结束
+    const m = l.match(ITEM_RE)
+    if (m) {
+      // 双引组内文反转义 / 单引组 ''→' / 兜底组（裸值或正则引号组吃不掉的形态，如内嵌
+      // '' 的单引号条目——ITEM_RE 单引号组 [^']* 在第二个引号停）统一过 unquoteYamlScalar
+      const k = m[2] !== undefined
+        ? unescapeYamlDoubleQuoted(m[2])
+        : m[3] !== undefined
+          ? m[3].replace(/''/g, "'")
+          : unquoteYamlScalar(m[4] || '')
+      if (k) keys.push(k)
+    }
+  }
+  return keys
+}
+
+function renderKey(k) {
+  return BARE_KEY_SAFE_RE.test(k) ? k : `"${String(k).replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`
+}
+
+/**
+ * 纯函数：行级手术增删 known_failures 键。
+ * - 增：去重后追加（块式→段尾插条目行；流式→行内数组追加；无段→文件尾整段追加）；
+ * - 删：移除命中条目（块式删行；流式重拼数组）；删空后流式写 `[]`、块式头改写 `known_failures: []`；
+ * - 改前全文 jsYaml 可解析门：抛错 → { ok:false }（坏文件上拒绝手术）；
+ * - 文件其余行（含注释/空行/换行风格）逐字节保留——只动 known_failures 相关行。
+ * @param {string} text 原 local.yaml 全文
+ * @param {{ add?: string[], remove?: string[] }} edit
+ * @returns {{ ok: true, next: string, keys: string[] } | { ok: false, error: string }}
+ */
+export function applyKnownFailureEdit(text, { add = [], remove = [] } = {}) {
+  const src = String(text || '')
+  // 坏 YAML 拒改门（FR-07：mojibake/残缺文件上手术只会更坏——先修文件再管理键）
+  try {
+    const doc = jsYaml.load(src)
+    if (doc !== null && typeof doc !== 'object') {
+      return { ok: false, error: 'local.yaml 顶层不是映射（YAML 合法但形态异常）——拒改，请人工核对' }
+    }
+  } catch (e) {
+    return { ok: false, error: `local.yaml YAML 解析失败（${String(e && e.message ? e.message : e).split('\n')[0]}）——拒改。先从备份/git 历史恢复或重建文件，再用本命令管理 known_failures` }
+  }
+  const nl = src.includes('\r\n') ? '\r\n' : '\n'
+  const lines = src.split(/\r?\n/)
+  // trailing newline 语义：原文以换行结尾 → 重组时补回
+  const endedWithNl = /\n$/.test(src) || /\r\n$/.test(src)
+
+  const addSet = [...add].filter(Boolean)
+  const removeSet = new Set([...remove].filter(Boolean))
+
+  // 流式形态
+  const inlineIdx = lines.findIndex((l) => INLINE_HEADER_RE.test(l))
+  if (inlineIdx !== -1) {
+    const cur = parseKnownFailureKeys(src)
+    const curSet = new Set(cur)
+    const removeHit = cur.filter((k) => removeSet.has(k))
+    let next = cur.filter((k) => !removeSet.has(k))
+    for (const k of addSet) {
+      if (!next.includes(k) && !curSet.has(k)) next.push(k)
+      else if (curSet.has(k) && !removeSet.has(k) && !next.includes(k)) next.push(k)
+    }
+    const inlineMatch = lines[inlineIdx].match(INLINE_HEADER_RE)
+    const trailingComment = (inlineMatch[0].match(/#.*$/)?.[0]) || ''
+    lines[inlineIdx] = next.length > 0
+      ? `known_failures: [${next.map(renderKey).join(', ')}]${trailingComment ? ` ${trailingComment}` : ''}`
+      : `known_failures: []${trailingComment ? ` ${trailingComment}` : ''}`
+    const out = lines.join(nl) + (endedWithNl ? nl : '')
+    return { ok: true, next: out, keys: next, removedKeys: removeHit }
+  }
+
+  // 块式形态
+  const blockIdx = lines.findIndex((l) => BLOCK_HEADER_RE.test(l))
+  if (blockIdx !== -1) {
+    const cur = parseKnownFailureKeys(src)
+    const removeHit = cur.filter((k) => removeSet.has(k))
+    const keep = cur.filter((k) => !removeSet.has(k))
+    const curSet = new Set(cur)
+    for (const k of addSet) if (!keep.includes(k) && !curSet.has(k)) keep.push(k)
+    // 段边界：块头行之后连续的缩进行（条目/空行/注释行都属于段——条目行重写，其余保留）
+    let end = blockIdx + 1
+    while (end < lines.length && !/^\S/.test(lines[end])) end++
+    // 重组段：保留段内注释/空行的相对位置有过度工程之嫌——known_failures 段语义就是键清单，
+    // 直写键条目行（段内注释罕见，注释保真交给其余 99% 的文件内容）
+    const section = keep.map((k) => `  - ${renderKey(k)}`)
+    lines.splice(blockIdx + 1, end - (blockIdx + 1), ...section)
+    if (keep.length === 0) {
+      // 删空：块头改流式空（两种 reader 都认 `[]`；裸块头= null 语义靠 reader 兜底，不赌）
+      lines[blockIdx] = 'known_failures: []'
+    }
+    const out = lines.join(nl) + (endedWithNl ? nl : '')
+    return { ok: true, next: out, keys: keep, removedCount: removeHit.length, removedKeys: removeHit }
+  }
+
+  // 无段：文件尾整段追加（add 空且 remove 命不中 → 无事可做，原样返回）
+  if (addSet.length === 0) return { ok: true, next: src, keys: [] }
+  const keys = addSet.filter((k, i) => addSet.indexOf(k) === i)
+  const header = src.length === 0 ? '' : (endedWithNl ? '' : nl)
+  const out = `${src}${header}known_failures:${nl}${keys.map((k) => `  - ${renderKey(k)}`).join(nl)}${nl}`
+  return { ok: true, next: out, keys }
+}
+
+/**
+ * 读文件列键（CLI list / doctor 联动用）。
+ * @param {string} yamlPath
+ * @returns {{ ok: boolean, keys?: string[], error?: string, missing?: boolean }}
+ */
+export function listKnownFailures(yamlPath) {
+  if (!existsSync(yamlPath)) return { ok: false, missing: true, error: `local.yaml 不存在: ${yamlPath}` }
+  let text
+  try {
+    text = readFileSync(yamlPath, 'utf8')
+  } catch (e) {
+    return { ok: false, error: `读取失败: ${e && e.message ? e.message : e}` }
+  }
+  try {
+    jsYaml.load(text)
+  } catch (e) {
+    return { ok: false, error: `local.yaml YAML 解析失败（${String(e && e.message ? e.message : e).split('\n')[0]}）——键清单不可信，先修复文件（doctor local_yaml_integrity 维度有指引）` }
+  }
+  return { ok: true, keys: parseKnownFailureKeys(text) }
+}
+
+/**
+ * 文件级增删（读 → applyKnownFailureEdit → 原子写）。
+ * @param {string} yamlPath
+ * @param {{ add?: string[], remove?: string[] }} edit
+ * @returns {{ ok: boolean, keys?: string[], error?: string }}
+ */
+export function mutateKnownFailuresFile(yamlPath, edit) {
+  if (!existsSync(yamlPath)) return { ok: false, error: `local.yaml 不存在: ${yamlPath}——先 sillyspec local detect / platform connect 生成，再管理 known_failures` }
+  let text
+  try {
+    text = readFileSync(yamlPath, 'utf8')
+  } catch (e) {
+    return { ok: false, error: `读取失败: ${e && e.message ? e.message : e}` }
+  }
+  const r = applyKnownFailureEdit(text, edit)
+  if (!r.ok) return r
+  if (r.next !== text) writeAtomicSync(yamlPath, r.next)
+  return { ok: true, keys: r.keys, removedKeys: r.removedKeys || [] }
+}
+
+/**
+ * CLI 入口薄壳（index.js config known-failures 接线消费）：打印 + 退出码。
+ * @param {{ yamlPath: string, exists: boolean, verb: string, keys: string[], json: boolean }} p
+ * @returns {number} process.exitCode
+ */
+export function runKnownFailuresCommand({ yamlPath, exists, verb, keys = [], json = false }) {
+  const want = verb || 'list'
+  if (!['list', 'add', 'remove'].includes(want)) {
+    console.error(`❌ 未知动作: config known-failures ${want}`)
+    console.error('用法: sillyspec config known-failures list | add <key…> | remove <key…>')
+    return 2
+  }
+  if (want !== 'list' && keys.filter(Boolean).length === 0) {
+    console.error(`❌ config known-failures ${want} 需要至少一个键参数（空格分隔多个）`)
+    return 2
+  }
+  if (want === 'list') {
+    if (!exists) {
+      if (json) console.log(JSON.stringify({ cmd: 'config known-failures list', exists: false }))
+      else console.error(`📭 未找到 local.yaml（${yamlPath}）——无 known_failures 可列`)
+      return 1
+    }
+    const r = listKnownFailures(yamlPath)
+    if (!r.ok) {
+      if (json) console.log(JSON.stringify({ cmd: 'config known-failures list', ok: false, error: r.error }))
+      else console.error(`❌ ${r.error}`)
+      return 1
+    }
+    if (json) {
+      console.log(JSON.stringify({ cmd: 'config known-failures list', ok: true, count: r.keys.length, keys: r.keys }))
+    } else if (r.keys.length === 0) {
+      console.log('📭 known_failures 为空（无豁免键）')
+    } else {
+      console.log(`📋 known_failures（${r.keys.length} 个）:`)
+      for (const k of r.keys) console.log(`   - ${k}`)
+    }
+    return 0
+  }
+  if (!exists) {
+    console.error(`📭 未找到 local.yaml（${yamlPath}）——先 sillyspec local detect / platform connect 生成`)
+    return 1
+  }
+  const r = mutateKnownFailuresFile(yamlPath, want === 'add' ? { add: keys } : { remove: keys })
+  if (!r.ok) {
+    console.error(`❌ 拒改：${r.error}`)
+    return 1
+  }
+  const uniq = [...new Set(keys.filter(Boolean))]
+  // remove 诚实文案（2026-10-21-known-failures-unescape FR-02）：仅未命中键注记静默忽略——
+  // 旧文案恒打「已移除…（未命中键静默忽略）」，全命中时也自称可能有未命中，误导排查。
+  const removedSet = new Set(r.removedKeys || [])
+  const missed = want === 'remove' ? uniq.filter((k) => !removedSet.has(k)) : []
+  if (json) console.log(JSON.stringify({ cmd: `config known-failures ${want}`, ok: true, changed: want === 'remove' ? [...removedSet] : uniq, missed, keys: r.keys }))
+  else {
+    const note = want === 'remove'
+      ? (missed.length > 0 ? `（未命中键静默忽略：${missed.join('、')}）` : '')
+      : ''
+    console.log(`✅ known_failures 已${want === 'add' ? '添加' : '移除'}：${(want === 'remove' ? [...removedSet] : uniq).join('、')}${note}——现共 ${r.keys.length} 个`)
+    console.log(`   校验：sillyspec config known-failures list`)
+  }
+  return 0
+}

package/src/config-schema.js

@@ -122,6 +122,15 @@ export const LOCAL_YAML_SCHEMA = {
       keys: [
         { path: 'modules.<name>.path', type: 'string', optional: true, status: 'live', readers: ['extractModules (src/verify-postcheck.js)', 'parseLocalYamlModules (src/plan-postcheck.js)', 'extractModulePaths (src/worktree-deps.js)'], desc: '子模块目录路径（相对仓库根）。', example: 'frontend/' },
         { path: 'modules.<name>.test', type: 'string', optional: true, status: 'deprecated', readers: ['extractModules (src/verify-postcheck.js，退役提示用）'], desc: '【2026-09-26-dynamic-test-inference 退役，不再消费】测试面按变更动态推断、runner 自项目结构（pyproject/uv.lock/package.json 就近祖先）推断。模块级 flaky 处置迁 known_failures。块在场时 CLI 打印退役指引。', example: 'cd frontend && pnpm test' },
+        { path: 'fr_unmapped_baseline', type: 'integer', optional: true, status: 'live', readers: ['unmapped 大池消音（src/fr-index.js）'], desc: 'unmapped 域 FR 条数消音基线（跨仓历史堆积已清算时设当前值；增量 >10 才警告，缺省 0=无基线恒警告行为）。', example: '720' },
+      ],
+    },
+    {
+      id: 'repos',
+      title: '跨仓注册表',
+      note: '仓键 → 本地工作目录。注册后参与跨仓冻结面/对账/未标注交付探测与跨仓 worktree 落位；条目两种形态：字符串路径或 {path, worktree} 对象（worktree=跨仓 worktree 落位根，优先级见 worktree.crossPlacement）。local.yaml 本就 gitignored，真实本地路径不入库。',
+      keys: [
+        { path: 'repos.<repo键>', type: 'string', optional: true, status: 'live', readers: ['跨仓冻结/对账（src/cross-repo-reconcile.js）、注册探测（src/local-register.js）、跨仓 worktree（src/worktree-cross.js）'], desc: '仓键 → 该仓本地工作目录绝对路径（或 {path, worktree} 对象形态）。', example: 'shared-lib: C:/path/to/shared-lib' },
       ],
     },
     {
@@ -131,6 +140,7 @@ export const LOCAL_YAML_SCHEMA = {
       keys: [
         { path: 'verify.test_rerun', type: 'enum', values: ['incremental', 'full'], optional: true, status: 'live', readers: ['readTestRerunConfig (src/verify-postcheck.js — dynamic-subset 分支增量档)'], desc: '实测门失败后重跑档：incremental（缺省）= 前轮失败后，下轮只跑「失败批测试文件 ∪ 自失败基线以来变更文件」的三源推断面（未触碰绿面复用，返工轮分钟级）；full = 恒全子集重跑（2026-10-07 前现状，保守项目用）。env SILLYSPEC_TEST_RERUN 优先。仅作用 dynamic-subset 档（显式 test_strategy: full 不受影响）。', example: 'verify: { test_rerun: full }' },
         { path: 'test_strategy', type: 'enum', values: ['full', 'module', 'skip', 'evidence-auto'], optional: true, status: 'live', readers: ['extractTestStrategy (src/verify-postcheck.js)', 'resolveTestStrategy (src/verify-postcheck.js)'], desc: '【2026-09-26-dynamic-test-inference 起】full=全量（commands.test 在场生效，否则结构推断）；module=已退役折算动态子集（超集覆盖：变更文件面收窄 + FR 关联回归 + import 依赖）；skip=真跳过（R-07 不变）；evidence-auto=按 module-impact.md 推荐（行为→动态子集、文档/门禁→skip）。缺省=动态子集：三源并集非空实测、空则不硬跑全量（防超时/预存失败面）。', example: 'full' },
+        { path: 'fr_regress_cap', type: 'string', optional: true, status: 'live', readers: ['readFrRegressCap (src/verify-postcheck.js)'], desc: '【2026-10-23-fr-regress-default-off 缺省翻转】FR 关联回归层本地实测开关：缺省（不写）=不跑（归 pre-push/CI 门，收口披露行留痕）；N（1-2000）=前 N 个绑定文件进实测面；all=全跑旧行为显式恢复；off=同缺省。', example: '40' },
       ],
     },
     {
@@ -188,6 +198,12 @@ export const LOCAL_YAML_SCHEMA = {
         { path: 'flow.mode', type: 'enum', values: ['thin', 'legacy'], optional: true, status: 'live', readers: ['readFlowConfig (src/flow.js)'], desc: '2-调用轻量协议开关：thin（缺省——2026-09-25-thin-default-flip 翻转，入口归一：常规变更默认轻量跑道，需求不清晰 CLI 拦下指路头脑风暴预段，实测失败自动升厚）= flow start/done 轻量跑道；legacy = 显式回旧道（run <stage> 全族行为逐字不动，flow start 拒跑并指路）。切回一行 yaml。', example: 'thin' },
         { path: 'flow.edit_ratio_threshold', type: 'number', optional: true, status: 'live', readers: ['readFlowConfig (src/flow.js)'], desc: '机器稿改写比例路由阈值（amend 通道计算的行级 editRatio 超阈 → 厚档提示 route_hint）。缺省 0.5。', example: '0.5' },
         { path: 'flow.edit_ratio_enforcement', type: 'enum', values: ['advisory', 'block'], optional: true, status: 'live', readers: ['readFlowConfig (src/flow.js)'], desc: 'editRatio 超阈的执行档：advisory（缺省——测绿可轻量档过，只提示+遥测）| block（超阈阻断 flow done）。用户裁定 advisory 定案，dogfood 后可按遥测翻 block。', example: 'advisory' },
+        // 以下四键为根级标量（无点 path——2026-10-23-config-validate-skill 补登：此前散落
+        // 各 reader 内联正则、schema 发现面缺失；校验器按注册面跟随）
+        { path: 'turbo', type: 'enum', values: ['docs-auto'], optional: true, status: 'live', readers: ['readFlowConfig (src/flow.js)'], desc: '【2026-10-23-turbo-docs-auto】纯文档面常设极速授权档：docs-auto=CLI 按提交∪脏面自动判纯文档（代码分类器同源）降档 turbo（实测/评审/UI 探针跳过，授权源留痕）；不写=关（--turbo 旗标档不受影响，agent 仍不可自启）。', example: 'docs-auto' },
+        { path: 'review_inline_wait', type: 'integer', optional: true, status: 'live', readers: ['readFlowConfig (src/flow.js)'], desc: '【2026-10-23-review-inline-dispatch】薄道评审平台单调用通道等待预算秒数（1-600，钳 300s 帽）：>0 时 flow done 评审缺席分支经 SillyHub 派发 readOnly worker 有界轮询回收、同调用登记（missing→PASS 往返消灭）；任何失败回退任务书面零损失；不写/坏值=关。', example: '180' },
+        { path: 'dirty_gate_ignore', type: 'string', optional: true, status: 'live', readers: ['readDirtyGateIgnore (src/flow-parity.js)'], desc: '【2026-10-23-dirty-gate-ignore】dirty 冻结缺口门的已知残渣前缀忽略清单（单行逗号分隔、posix 前缀匹配，module_gate_ignore 同款）：命中面从缺口剔除并每轮 ℹ️ 留痕；三态 fail-soft 未配置=现状。', example: 'quicklog, test/.sillyspec' },
+        { path: 'module_gate_ignore', type: 'string', optional: true, status: 'live', readers: ['readFlowConfig (src/flow.js)'], desc: '【2026-10-12-thin-module-gate-and-feed】模块图未登记目录软门的固定忽略清单（单行逗号、目录前缀、posix）——合法未登记面（根级脚本/配置等）免登记签收。', example: 'scripts, .github' },
       ],
     },
     {
@@ -426,6 +442,18 @@ dispatch:
 #   mode: thin               # thin=flow start/done 轻量跑道（协议必需交互=2）| legacy=既有 run <stage> 全族（回滚一行）
 #   edit_ratio_threshold: 0.5   # 机器稿改写比例路由阈值（超阈提示厚档；缺省 0.5）
 #   edit_ratio_enforcement: advisory   # advisory=测绿可轻量过只提示（缺省）| block=超阈阻断
+#
+# ── 收口调优（根级键，缺省零配置即用——注释态=缺省已最优，确要调优再解注释）──
+# turbo: docs-auto   # 纯文档面自动极速档（实测/评审/UI 探针跳过，授权源留痕）；不写=关
+# review_inline_wait: 180   # 评审平台单调用等待秒（1-600，需 SillyHub）；不写=评审任务书面模式
+# dirty_gate_ignore: quicklog, test/.sillyspec   # dirty 门已知残渣前缀（单行逗号、posix 前缀）
+# module_gate_ignore: scripts   # 模块图软门固定忽略目录（单行逗号、前缀匹配）
+# fr_regress_cap: 40   # FR 回归层本地开关：缺省不跑归 pre-push/CI 门；N=前 N 个；all=全跑旧行为
+# fr_unmapped_baseline: 720   # unmapped 域 FR 消音基线（跨仓历史堆积已清算时设）
+#
+# ── 跨仓注册表（注册后参与跨仓冻结/对账；local.yaml gitignored 故真实路径不入库）──
+# repos:
+#   shared-lib: C:/path/to/shared-lib   # 或对象形态 {path: …, worktree: <跨仓落位根>}
 
 # ── 阶段说明书下发与会话墙（R16 减负批次）──
 # stage:

package/src/config-validate.js

@@ -0,0 +1,180 @@
+/**
+ * config-validate.js — local.yaml 逐键校验器（2026-10-23-config-validate-skill）
+ *
+ * 用户配置哲学（2026-10-23 裁决原话）：「能不要配置的就别让用户配置，默认都集成好；实在
+ * 不好配置的要生成一个技能去引导 agent 怎么填写，并且 agent 写完要 CLI 验证通过才行」。
+ * 本模块是那句「CLI 验证」：sillyspec config validate 经 config-cat 权威路径链解析真实
+ * local.yaml（worktree 感知），按 LOCAL_YAML_SCHEMA 单一源逐键校验——校验只消费不生产
+ * （schema 注册面新增键照常跟随，无需改本模块）。
+ *
+ * 判级：错误（exit 1）=YAML 解析失败/顶层非映射/段非映射/枚举越界/结构性类型错（标量位
+ * 收到映射或数组）/不可强转标量（number/integer 键收 "abc" 类纯文本、boolean 键收非
+ * true|false 串）/段内必填键缺失（凭据族两键齐全才生效）。警告（exit 0）=未知键（可能
+ * 无效果）。info（exit 0）=deprecated 键在场/空文件。标量强转语义（评审 P1 修正）：数字
+ * 串与数字同义（"2400"≡2400——YAML 弱型等价），但不可强转的错拼类必拦——防「宽容」变成
+ * 放过 FR 承诺要拦的坏值。缺文件=零配置可用 info exit 0（69 键仅 4 凭据键真必填且仅平台
+ * 用户——零配置契约锚）。
+ */
+import yaml from 'js-yaml'
+import { readFileSync } from 'fs'
+import { LOCAL_YAML_SCHEMA } from './config-schema.js'
+import { resolveLocalYaml } from './config-cat.js'
+
+/** schema 注册面索引：path→def、已知顶层键（段 id ∪ 无点 path）、含占位段的段（免未知键误报）。 */
+function buildRegistry() {
+  const byPath = new Map()
+  const sectionIds = new Set()
+  const rootScalars = new Set()
+  const placeholderSections = new Set()
+  for (const sec of LOCAL_YAML_SCHEMA.sections || []) {
+    sectionIds.add(sec.id)
+    for (const k of sec.keys || []) {
+      byPath.set(k.path, k)
+      if (!k.path.includes('.')) rootScalars.add(k.path)
+      if (/<[^>]+>/.test(k.path)) placeholderSections.add(sec.id)
+    }
+  }
+  return { byPath, sectionIds, knownTop: new Set([...sectionIds, ...rootScalars]), placeholderSections }
+}
+
+const kindOf = (v) => (v === null || v === undefined ? 'null' : Array.isArray(v) ? 'array' : typeof v)
+
+/** 类型检查（评审 P1 修正口径：可强转宽容、不可强转判错）——YAML 标量弱型下 24 与 "24"
+ * 同义（number/integer 收数字串合法），但 "abc" 这类不可强转错拼必须拦（FR-01 场景）；
+ * boolean 收非 true/false 串判错；string 收任意标量；结构错配（标量位收映射/数组）恒错。 */
+function checkType(def, v, path, errors) {
+  const kind = kindOf(v)
+  if (kind === 'null') return
+  const scalarSpot = ['string', 'number', 'integer', 'enum', 'boolean', 'json'].includes(def.type)
+  if (scalarSpot && (kind === 'object' || kind === 'array')) {
+    errors.push(`「${path}」期望${def.type === 'enum' ? `枚举（${(def.values || []).join('|')}）` : def.type}标量，实得 ${kind}——嵌套层级写错（该键是叶子值不是段）`)
+    return
+  }
+  if (def.type === 'object' && kind !== 'object') {
+    errors.push(`「${path}」期望键值映射，实得 ${kind}`)
+    return
+  }
+  if (def.type === 'array' && kind !== 'array') {
+    errors.push(`「${path}」期望列表，实得 ${kind}`)
+    return
+  }
+  if (def.type === 'enum' && !(def.values || []).map(String).includes(String(v))) {
+    errors.push(`「${path}」取值越界：${JSON.stringify(v)}（合法：${(def.values || []).join('|')}）`)
+    return
+  }
+  if ((def.type === 'number' || def.type === 'integer') && kind === 'string' && !/^-?\d+(\.\d+)?$/.test(v.trim())) {
+    errors.push(`「${path}」期望${def.type === 'integer' ? '整数' : '数字'}，实得字符串 ${JSON.stringify(v)}（不可强转——数字串可，纯文本不可）`)
+    return
+  }
+  if (def.type === 'integer' && kind === 'string' && !/^-?\d+$/.test(v.trim())) {
+    errors.push(`「${path}」期望整数，实得 ${JSON.stringify(v)}`)
+    return
+  }
+  if (def.type === 'boolean' && kind === 'string' && !/^(true|false)$/i.test(v.trim())) {
+    errors.push(`「${path}」期望布尔（true/false），实得 ${JSON.stringify(v)}`)
+  }
+}
+
+/**
+ * 校验 local.yaml 文本（纯函数）。@returns {{errors:string[], warnings:string[], infos:string[], keysChecked:number}}
+ */
+export function validateLocalYamlContent(text) {
+  const { byPath, knownTop, placeholderSections } = buildRegistry()
+  const errors = [], warnings = [], infos = []
+  let doc
+  try { doc = yaml.load(text) } catch (e) {
+    return { errors: [`YAML 解析失败：${(e && e.message) || e}——agent 手改易犯缩进/Tab/编码错（doctor 的 local_yaml_integrity 维度查编码）`], warnings, infos, keysChecked: 0 }
+  }
+  if (doc == null) doc = {}
+  const topKind = kindOf(doc)
+  if (topKind !== 'object') {
+    return { errors: [`local.yaml 顶层必须是键值映射（实得 ${topKind}）`], warnings, infos, keysChecked: 0 }
+  }
+  const sectionIds = new Set((LOCAL_YAML_SCHEMA.sections || []).map((s) => s.id))
+  let checked = 0
+  const checkDef = (def, v, path) => {
+    checked++
+    checkType(def, v, path, errors)
+    if (def.status === 'deprecated') infos.push(`「${path}」已退役（${String(def.desc || '').slice(0, 80)}…）——新配置勿再写`)
+  }
+  for (const [k, v] of Object.entries(doc)) {
+    if (!knownTop.has(k)) {
+      warnings.push(`未知顶层键「${k}」——sillyspec config schema 可查全部已知键（未知键大概率无效果；确认拼写与层级）`)
+      continue
+    }
+    if (sectionIds.has(k) && byPath.has(k) === false) {
+      // 纯段（如 project/commands）：校验段内键。两种真实形态：键值映射（commands.lint）
+      // 与列表-of-对象（review_probes 列表项字段建模为 sec.field 点路径——本仓 dogfood 实证）。
+      if (v == null) continue
+      const vKind = kindOf(v)
+      if (vKind !== 'object' && vKind !== 'array') { errors.push(`段「${k}」必须是键值映射或列表（实得 ${vKind}）`); continue }
+      const entries = vKind === 'array'
+        ? (v.every((it) => kindOf(it) === 'object') ? v.flatMap((it) => Object.entries(it)) : Object.entries(v[0] || {}))
+        : Object.entries(v)
+      for (const [ik, iv] of entries) {
+        const path = `${k}.${ik}`
+        const def = byPath.get(path)
+        if (!def) {
+          // 占位段（modules.<name>.path 族）：子键名是用户自定义 id，注册面无法穷举——
+          // 未知子键不警告（占位形态本身合法），具体叶子键校验交给占位 path 前缀匹配不到即跳过
+          if (!placeholderSections.has(k)) warnings.push(`「${path}」不在注册键表（可能拼错/层级错，或新版键未同步 schema——sillyspec config schema 核对）`)
+          continue
+        }
+        checkDef(def, iv, path)
+      }
+    } else {
+      // 根级标量键（test_strategy/module_gate_ignore/…）
+      const def = byPath.get(k)
+      if (!def) { warnings.push(`键「${k}」不在注册键表`); continue }
+      checkDef(def, v, k)
+    }
+  }
+  // 段内必填闭合（required:true 键所在段在场则须齐全——mcp/platform 凭据族两键成对才生效）
+  for (const sec of LOCAL_YAML_SCHEMA.sections || []) {
+    if (!(sec.id in doc) || doc[sec.id] == null || kindOf(doc[sec.id]) !== 'object') continue
+    for (const kd of sec.keys || []) {
+      if (kd.required !== true || !kd.path.startsWith(`${sec.id}.`)) continue
+      const leaf = kd.path.slice(sec.id.length + 1)
+      if (!(leaf in doc[sec.id])) {
+        errors.push(`段「${sec.id}」缺必填键「${leaf}」——${sec.id === 'mcp' || sec.id === 'platform' ? '凭据两键齐全才生效（缺半整段回退缺省/env）；补齐或整段删除' : '必填键'}`)
+      }
+    }
+  }
+  if (checked === 0 && errors.length === 0) infos.push('local.yaml 在场但无任何已注册键（空段/仅注释）——等于零配置形态')
+  return { errors, warnings, infos, keysChecked: checked }
+}
+
+/**
+ * config validate 子命令体：路径链解析（config-cat 同源，worktree 感知）→ 校验 → 人类/--json
+ * 双态渲染。退出码：0=通过（可含警告/info），1=有错误；缺文件=零配置 info exit 0。
+ */
+export function cmdConfigValidate({ dir, specBase = null, json = false } = {}) {
+  const r = resolveLocalYaml(dir, { specBase })
+  if (!r.exists) {
+    const payload = { file: null, exists: false, passed: true, errors: [], warnings: [], infos: ['local.yaml 不存在——零配置可用（全部键走缺省；仅平台/MCP 凭据族真必填）'], keysChecked: 0 }
+    if (json) console.log(JSON.stringify(payload, null, 2))
+    else console.log('✅ local.yaml 不存在——零配置可用（全部键走缺省；仅平台/MCP 凭据族真必填，需要时 sillyspec platform connect 一键写入）。\n   需要调优时：sillyspec config schema 查键 ＋ sillyspec-config 技能引导；写完跑 sillyspec config validate 验证。')
+    return 0
+  }
+  let v
+  try { v = validateLocalYamlContent(readFileSync(r.path, 'utf8')) } catch (e) {
+    // 读盘竞态兜底（评审 P3 清偿）：resolve 与 read 之间文件消失/被锁——优雅报错不裸崩
+    if (json) console.log(JSON.stringify({ file: r.path, exists: true, passed: false, errors: [`local.yaml 读取失败：${(e && e.message) || e}（可能刚被移动/删除——重跑）`], warnings: [], infos: [], keysChecked: 0 }, null, 2))
+    else console.error(`❌ local.yaml 读取失败：${(e && e.message) || e}（可能刚被移动/删除——重跑 sillyspec config validate）`)
+    return 1
+  }
+  const passed = v.errors.length === 0
+  if (json) {
+    console.log(JSON.stringify({ file: r.path, exists: true, passed, ...v }, null, 2))
+  } else {
+    console.log(`${passed ? '✅' : '❌'} local.yaml 校验${passed ? '通过' : '未通过'}（${r.path}${r.source ? `，来源 ${r.source}` : ''}；已查 ${v.keysChecked} 个注册键）`)
+    for (const e of v.errors) console.error(`   错误：${e}`)
+    for (const w of v.warnings) console.warn(`   警告：${w}`)
+    for (const i of v.infos) console.log(`   ℹ️ ${i}`)
+    if (passed && v.warnings.length === 0 && v.errors.length === 0) console.log('   无警告无未知键。')
+    if (!passed) console.error('   修复后重跑：sillyspec config validate（exit 0 才算配置完成——sillyspec-config 技能硬门）')
+  }
+  return passed ? 0 : 1
+}
+
+export default { validateLocalYamlContent, cmdConfigValidate }