首次进入 / bookRoot 变更 / 仅激活 | node scripts/intake-router.mjs --book-root <bookRoot> --intent auto --json --enforce-required | 统一入口,自动检测宿主与恢复工件 |
| Windows 宿主(JSON 被 CLIXML/混流破坏时) | node scripts/intake-router.mjs --book-root <bookRoot> --intent auto --json --json-out .fbs/intake-router.last.json --enforce-required | 与上等价,JSON 落盘;读完 .fbs/intake-router.last.json 再解析(见 references/05-ops/windows-host-cli.md) |
| 拆书式改写(旧书升级 / 海外落地 / 爆款重构) | node scripts/intake-router.mjs --book-root <bookRoot> --intent rewrite --json --enforce-required | 先锁定来源边界与改写模式,再按 S3 串行约束推进(每轮最多 2 文件) |
| 拆书改写计划模板 | node scripts/rewrite-plan-bootstrap.mjs --book-root <bookRoot> --json | 生成 .fbs/rewrite-plan.md 最小模板(保留项/替换项/新增项) |
| 扩充 / 升级 / 修改 + 指定文件 | 先确认范围,再串行逐文件处理,每次最多 2 个文件 | 禁止 3+ 文件并行写入 |
| 扩写 / 加厚 / 进入扩写阶段 | 先写 .fbs/expansion-plan.md 并经用户确认 → 再执行;扩写前可跑 node scripts/verify-expansion-plan-structure.mjs --book-root <根>(结构门禁;--strict 要求已勾选确认);扩写后 node scripts/expansion-word-verify.mjs 或 node scripts/expansion-gate.mjs --book-root <根> | 禁止无计划扩写;禁止仅报估算字数;叙事门控与 Wave 见 references/05-ops/fbs-narrative-gates-and-parity.md |
| 素材 vs 计划(启发式) | node scripts/expansion-plan-vs-material.mjs --book-root <根> | 可选 |
| 相邻章重叠预警 | node scripts/adjacent-chapter-similarity.mjs --file-a <a.md> --file-b <b.md> | 可选 |
| 按台账顺序扫相邻章 | node scripts/scan-adjacent-chapters.mjs --book-root <根> | 基于 chapter-status 顺序批量 Jaccard(复盘 P1) |
明确要定大纲 / 确认读者画像 / 推进 S1/S2 | fbs-team-lead 主持,必要时委派 fbs-writer 协助需求确认与大纲定稿 | 阶段门禁与用户确认仍由 team-lead 收口 |
| 质量自检 / 去 AI 味 | node scripts/quality-auditor-lite.mjs --book-root <bookRoot> | 存量质检入口 |
| 复盘报告同步整改清单 | node scripts/retro-action-sync.mjs --book-root <根> [--report <报告.md>] [--enforce-p0] | 从 .fbs/福帮手运行复盘报告*.md 提取待整改项,产出 .fbs/retro-action-items.json 与 .fbs/retro-unresolved.md |
| 复盘候选沉淀(Action→Skill) | node scripts/retro-to-skill-candidates.mjs --book-root <根> [--json] | 将未修复整改项转为可复用流程候选,输出 .fbs/retro-skill-candidates.json |
| 运行时阶段提醒(Nudge) | node scripts/runtime-nudge.mjs --book-root <根> [--json] | 基于 esm-state + 复盘项生成本轮必做/可选提醒,输出 .fbs/runtime-nudges.json |
| 终稿状态机 | `node scripts/final-draft-state-machine.mjs --book-root <根> --action transition --to <draft | candidate |
| 终稿治理器(唯一终稿) | node scripts/release-governor.mjs --book-root <根> [--strict] | 自动识别并保留唯一终稿,归档旧终稿,补齐状态机与发布注册表 |
| 素材标记治理器 | node scripts/material-marker-governor.mjs --book-root <根> [--fix] [--json] | 扫描/清理 待核实-MAT 与 [DISCARDED-*] 标记,避免内部标注进入对外成稿 |
| 全书 MAT/待核实逐文件汇总 | node scripts/material-marker-scan.mjs --book-root <根> --output .fbs/material-marker-scan.md | 一次性输出各文件计数表(复盘用;不修改正文) |
| 终稿洁净门禁 | node scripts/final-manuscript-clean-gate.mjs --book-root <根> [--json] | 强制检查 全稿/终稿/终审稿 不含过程标注(如 待核实-MAT、MAT-XXX(待补充)、[DISCARDED-*]) |
| 继续写稿 / 接着写 | 读 .fbs/workbuddy-resume.json 或 .fbs/chapter-status.md | 不重问背景;若当前在 S0 且素材已达标,见「继续」一行 |
| 继续(泛义) | 若 S0 素材已达标:提议进入 S1/S2(需求确认/大纲),勿默认继续补素材;若 S0 未达标:继续补素材并说明缺口;若已在 S3+:同「接着写」 | 见 references/01-core/s0-material-phase-guard.md §3 |
| 退出 / 退出福帮手 / 停止 | node scripts/session-exit.mjs --book-root <bookRoot> --json | 默认先保存恢复卡与会话摘要,再确认退出 |
| 看看能做什么 | list_dir 最多 2 层 | 不先全量读文件 |
| 初始化书房 / 新建项目 | node scripts/init-fbs-multiagent-artifacts.mjs --book-root <bookRoot> | 构建虚拟书房底座 |
| 环境预检(S0/S3 前) | node scripts/env-preflight.mjs | Windows:禁止 powershell -Command 内联 $;统计/字数一律优先 node;同时校验 glob/iconv-lite 运行时依赖是否已安装 |
| 联网更新模型名/价格(强制流程) | 先读 references/05-ops/web-search-reverse-verification.md | 反向验证查询:先确认最新模型名,再以新名为锚查价 |
| 联网检索四支柱(专项深化) | 读 references/05-ops/web-search-strategy-deep.md | 知识截止补强、时效锚定、时态验证、方法论与技能知识库增强 |
| S0退出门禁(强制) | node scripts/s0-exit-gate.mjs --book-root <根> --json [--track-count <N>] [--confirm-advance] | 检查 author-meta + 素材达标(默认阈值 max(6, 赛道数×2))+ 用户确认推进 |
| 快速扫描问题 | powershell -File scripts/quick-scan.ps1 -BookRoot <bookRoot> -Output <path.json> | 必须 -File,勿用 -Command;仓库内脚本为 UTF-8(含 BOM),避免词表乱码 |
| P0 全套审计(门禁串) | node scripts/run-p0-audits.mjs <书稿根> 或 --book-root <书稿根> | --skill-root 可省略(默认脚本所在技能根);产出 .fbs/p0-audit-report.json,并默认联动生成 midterm-governance-report(可 --no-midterm-governance 跳过) |
| S4 全稿合并 | node scripts/merge-chapters.mjs --book-root <根> --output deliverables/[S4]书名.md [--record-artifacts] | 跨平台;--record-artifacts 写入 .fbs/merge-chapters.last.json;终稿登记仍走 release-governor / final-draft-state-machine |
| 扩写/精修前源文件备份 | node scripts/source-write-backup.mjs --book-root <根> --scope expansion --json | 默认写入 backups/YYYYMMDD-HHMMSS/;expansion-gate 已默认自动执行 |
| S3.7 精修门禁(含备份) | node scripts/polish-gate.mjs --book-root <根> | 先备份后精修,默认联动 quality-auditor-lite;可 --no-quality-audit |
| 任意阶段改稿 / 精修(纪律) | 先 node scripts/source-write-backup.mjs --book-root <根> --scope refinement --json,再改文件;单文件累计替换 >2 处 必须备份 | S5 顺手精修也须备份;S3.7 优先整包走 polish-gate |
| 台账字数对齐 | node scripts/sync-chapter-status-chars.mjs --book-root <根> | 扩写后刷新 .fbs/chapter-status.md 字数列 |
| 一书稿健康快照 | node scripts/book-health-snapshot.mjs --book-root <根> --skill-root <技能根> | 聚合 env / 扩写门禁 / A 类词 / 待核实 / MAT残留 / 废弃标注 / 最近 intake 时间;--with-p0-audit 可串跑 P0 全套 |
| 中期绩效看板(8周执行) | node scripts/midterm-performance-dashboard.mjs --book-root <根> --days 7 --json | 自动生成 .fbs/governance/midterm-performance-dashboard-<week>.json/.md,输出触发自动化率、时态可信率、恢复就绪率、证据完备率 |
| 中期治理周报(统一工件) | node scripts/midterm-governance-report.mjs --book-root <根> [--week-label 2026-W16] --json | 汇总 门禁状态 + KPI + 整改建议 到 .fbs/governance/midterm-governance-report-<week>.json/.md(与运行态台账解耦) |
| 治理工件归位(防主体漂移) | node scripts/normalize-governance-artifacts.mjs --book-root <根> [--dry-run] [--prune-duplicates] [--prune-on-exists] --json | 将误落在 .fbs/reports 的 midterm-* 工件迁移回 .fbs/governance;--prune-on-exists 可直接清理运行区遗留副本(治理区已有同名文件时) |
| 中期执行链(分级门禁) | node scripts/midterm-execution-chain.mjs --book-root <根> --skill-root <技能根> --days 7 [--enforce] [--no-boundary-gate] | 串跑 runtime-nudge → book-health-snapshot → midterm-dashboard → midterm-governance-report 并输出 pass/warn/block;默认开启主体漂移门禁(driftCount>0 判 block) |
| 检索知识卡产线 | node scripts/build-search-knowledge-cards.mjs --book-root <根> --json | 将 .fbs/search-ledger.jsonl 结构化为 .fbs/governance/search-knowledge-cards.json/.md |
| 知识复用率 KPI | node scripts/knowledge-reuse-kpi.mjs --book-root <根> --json | 统计知识卡被正文回引比例(URL 或 [KC:<id>]),输出 .fbs/governance/knowledge-reuse-kpi.json |
| 高风险双源门禁 | node scripts/high-risk-dual-source-gate.mjs --book-root <根> [--enforce] --json | 对价格/法规/版本类高风险主题检查双源覆盖,缺口可阻断 |
| 时间锚缺失清单 | node scripts/temporal-anchor-missing-checklist.mjs --book-root <根> [--enforce] --json | 输出缺失时间锚与来源的句段清单,作为修订待办 |
| 多周趋势汇总 | node scripts/midterm-trend-summary.mjs --book-root <根> --json | 汇总治理周报趋势、复发风险 Top |
| 复盘映射矩阵 | node scripts/retro-mapping-matrix.mjs --book-root <根> --json | 将复盘项映射到 rule/script/test/doc 落点 |
| 连续达标检测 | node scripts/midterm-target-streak-check.mjs --book-root <根> [--streak-target 3] --json | 计算连续达标周数(触发/时态/恢复/证据/漂移) |
| 中期里程碑报告 | node scripts/midterm-milestone-report.mjs --book-root <根> [--week-label <YYYY-Www>] --json | 一键生成中期收口报告(趋势 + 映射 + 连续达标 + 复用率) |