# Fbs Bookwriter > FBS 福帮手长文档写作：书/手册/白皮书/长篇报道全流程；Node 脚本驱动 intake、会话恢复、S/P/C/B 质检与 MD/HTML 交付。用户提及写书、出书、章节、大纲、素材、质检、导出、扩写、退出保存时启用。 - Skill: `xplore-lab/fbs-bookwriter` (Agent Skill, multi-file: 441 files) - Install (CLI): `npx skillmds@latest add xplore-lab/fbs-bookwriter` - Raw SKILL.md: https://api.skillmd.com/api/skills/xplore-lab/fbs-bookwriter/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Web & Frontend - Author: Xplore-LAB (https://skillmd.com/u/xplore-lab) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/xplore-lab/fbs-bookwriter --- # FBS-BookWriter（OpenClaw 封装版） > **上游版本**：2.1.2（与仓库 `FBS-BookWriter` 同源） > **适配目标**：[OpenClaw](https://docs.openclaw.ai/tools/creating-skills) 技能模型：`SKILL.md` + `metadata.openclaw`（`name` 蛇形命名、`skillKey` 用于 `openclaw.json` 中 `skills.entries` / 代理 allowlist）。 本目录为 **OpenClaw 专用入口**：与 WorkBuddy / CodeBuddy **市场通道**解耦（发布包内 **不含** `workbuddy/`、`codebuddy/`、`.codebuddy-plugin/`），仍保留完整 `references/`、`scripts/`、`scene-packs/`、`assets/` 与 `package.json`，便于在 Gateway 内用 **shell/exec** 调用同一套 Node 工具链。 **认知资产与商业口径（与主仓一致）**：价值表述统一为「可进化、可分发、可增值」；能力分层统一为「场景包 + 乐包 + 离线/在线会员」。机读见根目录 `fbs-runtime-hints.json` → `cognitiveAsset`；首响 JSON 见 `firstResponseContext.cognitiveAssetSnapshot`。详细说明见 [`references/05-ops/cognitive-asset-threeization.md`](./references/05-ops/cognitive-asset-threeization.md)。 --- ## 安装（OpenClaw） **从 ClawHub 安装（推荐，需已发布）：** 在已登录环境下执行 `openclaw skills install fbs-bookwriter` 或 `npx clawhub@latest install fbs-bookwriter`，再于技能根执行 `npm install`。列表与版本见 [ClawHub 上的 fbs-bookwriter](https://clawhub.ai/skills/fbs-bookwriter)。 1. 将技能根目录（文件夹名建议 **`fbs_bookwriter`**，与 `name` 一致）放到任一扫描路径，例如： - 工作区：`./skills/fbs_bookwriter/`（优先级最高） - 或 `~/.openclaw/workspace/skills/fbs_bookwriter/` - 或 `~/.openclaw/skills/fbs_bookwriter/` - 或在 `~/.openclaw/openclaw.json` → `skills.load.extraDirs` 中加入父目录 详见 [Skills](https://docs.openclaw.ai/tools/skills) 与 [skills-config](https://docs.openclaw.ai/tools/skills-config)（`load.watch` 默认会热更新技能快照）。 2. 在技能根执行一次依赖安装： `npm install`（Node ≥18；可选依赖用于 HTML/Docx 等，见 `package.json` `optionalDependencies`）。 3. 重启会话或执行 `openclaw gateway restart` / 聊天中 `/new`，用 `openclaw skills list` 确认加载。 --- ## OpenClaw 宿主差异（相对 WorkBuddy） | 能力 | WorkBuddy | OpenClaw（本封装） | |------|-----------|-------------------| | 入口展示 | `intake-router --json` + 宿主消费 `userFacingOneLiner` | 同样执行脚本拿 JSON；向用户**只展示**脚本给出的一行摘要 + 最多 3 个选项，勿堆全文 | | 执行命令 | 宿主 bash / 终端 | 使用 OpenClaw **exec / shell**；**cwd 必须为技能根**（含 `package.json` 与 `scripts/`） | | 检索 | 宿主 `web_search` | 使用 OpenClaw 提供的 **联网搜索 / 浏览器**（若启用）；不可用则按 `search-policy` 与脚本离线降级 | | 文件工具 | `list_dir` / `read_file` / `search_file` | **勿用**仅按文件名搜索来探测 `.fbs/` 内文件（部分环境不索引点目录）；对 `.fbs/workbuddy-resume.json`、`esm-state.md` 等应 **`read_file` 已知路径** 或对书稿根 **`list_dir`** 确认 `.fbs` 存在 | | 市场清单 | `workbuddy/channel-manifest.json` 等 | **本包不包含**；不影响脚本化写作主链路 | --- ## 执行速查（每次会话） 1. **统一入口（必做）**（`bookRoot` 为用户书稿根目录的绝对路径）： ```bash node scripts/intake-router.mjs --book-root "" --intent auto --json --enforce-required ``` 需要完整在线场景包时再在命令中加 `--full`（可能较慢）。 若 JSON 返回 `projectAnchor.status=ambiguous`，先让用户确认项目根路径，再用确认后的 `--book-root` 重跑；确认前不要读取任意 `.fbs/*` 内容。 2. **恢复**：优先 **`read_file`** `/.fbs/workbuddy-resume.json`；若无则读 `chapter-status.md` 或进入 S0.5 引导。不要用「全库搜索文件名」代替存在性判断。 3. **退出**：用户说退出时先软询问，再执行： ```bash node scripts/fbs-cli-bridge.mjs exit -- --book-root "" --json ``` 回复须包含脚本 JSON 里的 **`userMessage`**（会话已记录、下次可继续）。 4. **阶段与门禁**：推进阶段前读 `.fbs/esm-state.md`；S3.5 扩写须先有用户确认的 `.fbs/expansion-plan.md`，扩写字数以 `node scripts/expansion-word-verify.mjs` 或 `expansion-gate.mjs` 实测为准（禁止纯模型估算）。 用户说“继续”时按推进优先阈值判断：S0 素材数达到“赛道数×2”、S2 具备章标题+目标字数、S3 已完成≥3章时，优先提议进入下一阶段。 推进 S0→S1 前可运行 `node scripts/s0-exit-gate.mjs --book-root "" --json --confirm-advance` 做强制门禁检查。 5. **写作约束**：串行优先；每轮默认最多改 **2** 个文件；详见 [`references/05-ops/agent-task-strategy.md`](./references/05-ops/agent-task-strategy.md)。 扩写/精修前先做源文件备份：`node scripts/source-write-backup.mjs --book-root "" --scope expansion --json`（`expansion-gate` 默认已自动备份）。 进入 S3.7 精修时优先执行 `node scripts/polish-gate.mjs --book-root ""`（先备份再质检），避免绕过门禁直接改稿。 交付收口前执行 `node scripts/release-governor.mjs --book-root ""`，自动保持唯一终稿并归档旧版本。 对外交付前执行 `node scripts/material-marker-governor.mjs --book-root "" --fix`，清理 `待核实-MAT` 与 `[DISCARDED-*]` 标注。 全稿/终稿/终审稿发布前必须执行 `node scripts/final-manuscript-clean-gate.mjs --book-root ""`，若检测到过程标注则不得交付。 任何“已完成/已通过”结论必须附脚本证据（命令或输出路径），禁止仅口头宣称。 --- ## 意图 → 脚本（节选） 完整表见仓库根目录随包分发的 **WorkBuddy 版 `SKILL.md` 镜像**或 [`references/01-core/intake-and-routing.md`](./references/01-core/intake-and-routing.md)。 | 场景 | 命令 | |------|------| | 初始化书房 | `node scripts/init-fbs-multiagent-artifacts.mjs --book-root ""` | | 环境预检 | `node scripts/env-preflight.mjs`（参数见脚本 `--help`；含 `glob`/`iconv-lite` 依赖检查） | | 章节合并 / 健康快照 / 一致性审计 | `merge-chapters.mjs`、`book-health-snapshot.mjs`、`consistency-audit.mjs` 等（`--book-root` / `--skill-root` 指向对应根） | | CLI 总线 | `node scripts/fbs-cli-bridge.mjs help` | --- ## 输出格式 - 对用户：短状态 + 可操作下一步（≤3 条），避免泄露内部规范条文与完整 JSON。 - 提到术语/文件名时补一句“用途+价值”（例如：`chapter-status.md`=进度台账，价值是避免漏章和重复写）。 - 落盘：以 `/.fbs/`、`deliverables/`、`releases/` 为真值；规范见 [`references/01-core/skill-full-spec.md`](./references/01-core/skill-full-spec.md)。 --- ## 错误处理 - **Node/脚本失败**：向用户说明失败步骤；若仅缺可选依赖，提示 `npm install` 或跳过非必需功能。 - **书稿根未就绪**：引导先 `init-fbs-multiagent-artifacts` 或走 S0 最小集（见 [`references/01-core/intake-and-routing.md`](./references/01-core/intake-and-routing.md) 脚本不可用降级节）。 - **沙箱无环境变量**：若 OpenClaw 在 Docker 沙箱中运行且未注入宿主 `env`，需在 `openclaw.json` 中为代理配置 `sandbox.docker.env` 或关闭沙箱（见官方 skills-config 文档）。 --- ## 权威文档索引 - 总规范：[`references/01-core/skill-full-spec.md`](./references/01-core/skill-full-spec.md) - 工作流：[`references/01-core/section-3-workflow.md`](./references/01-core/section-3-workflow.md) - NLU：[`references/01-core/section-nlu.md`](./references/01-core/section-nlu.md) - 运行时契约：[`references/01-core/runtime-mandatory-contract.md`](./references/01-core/runtime-mandatory-contract.md) --- *OpenClaw 封装维护说明：与 `pack:openclaw` 产物同步；`metadata.openclaw.skillKey` 与目录名 `fbs_bookwriter` 应对齐以便 `skills.entries` 配置。*