fbs_bookwriter

FBS 福帮手长文档写作：书/手册/白皮书/长篇报道全流程；Node 脚本驱动 intake、会话恢复、S/P/C/B 质检与 MD/HTML 交付。用户提及写书、出书、章节、大纲、素材、质检、导出、扩写、退出保存时启用。

Safety Notice

This listing is from the official public ClawHub registry. Review SKILL.md and referenced scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "fbs_bookwriter" with this command: npx skills add duhongchao-fbsir/fbs-bookwriter

FBS-BookWriter（OpenClaw 封装版）

上游版本：2.1.2（与仓库 FBS-BookWriter 同源）
适配目标：OpenClaw 技能模型：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。

安装（OpenClaw）

从 ClawHub 安装（推荐，需已发布）： 在已登录环境下执行 openclaw skills install fbs-bookwriter 或 npx clawhub@latest install fbs-bookwriter，再于技能根执行 npm install。列表与版本见 ClawHub 上的 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 与 skills-config（load.watch 默认会热更新技能快照）。
  2. 在技能根执行一次依赖安装：
    npm install（Node ≥18；可选依赖用于 HTML/Docx 等，见 package.json optionalDependencies）。
  3. 重启会话或执行 openclaw gateway restart / 聊天中 /new，用 openclaw skills list 确认加载。

OpenClaw 宿主差异（相对 WorkBuddy）

能力WorkBuddyOpenClaw（本封装）
入口展示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 为用户书稿根目录的绝对路径）：

    node scripts/intake-router.mjs --book-root "<bookRoot>" --intent auto --json --enforce-required

    需要完整在线场景包时再在命令中加 --full（可能较慢）。 若 JSON 返回 projectAnchor.status=ambiguous，先让用户确认项目根路径，再用确认后的 --book-root 重跑；确认前不要读取任意 .fbs/* 内容。

  2. 恢复：优先 read_file <bookRoot>/.fbs/workbuddy-resume.json；若无则读 chapter-status.md 或进入 S0.5 引导。不要用「全库搜索文件名」代替存在性判断。

  3. 退出：用户说退出时先软询问，再执行：

    node scripts/fbs-cli-bridge.mjs exit -- --book-root "<bookRoot>" --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 "<bookRoot>" --json --confirm-advance 做强制门禁检查。

  5. 写作约束：串行优先；每轮默认最多改 2 个文件；详见 references/05-ops/agent-task-strategy.md。 扩写/精修前先做源文件备份：node scripts/source-write-backup.mjs --book-root "<bookRoot>" --scope expansion --json（expansion-gate 默认已自动备份）。 进入 S3.7 精修时优先执行 node scripts/polish-gate.mjs --book-root "<bookRoot>"（先备份再质检），避免绕过门禁直接改稿。 交付收口前执行 node scripts/release-governor.mjs --book-root "<bookRoot>"，自动保持唯一终稿并归档旧版本。 对外交付前执行 node scripts/material-marker-governor.mjs --book-root "<bookRoot>" --fix，清理 待核实-MAT 与 [DISCARDED-*] 标注。 全稿/终稿/终审稿发布前必须执行 node scripts/final-manuscript-clean-gate.mjs --book-root "<bookRoot>"，若检测到过程标注则不得交付。 任何“已完成/已通过”结论必须附脚本证据（命令或输出路径），禁止仅口头宣称。

意图 → 脚本（节选）

完整表见仓库根目录随包分发的 WorkBuddy 版 SKILL.md 镜像或 references/01-core/intake-and-routing.md。

场景命令
初始化书房node scripts/init-fbs-multiagent-artifacts.mjs --book-root "<bookRoot>"
环境预检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=进度台账，价值是避免漏章和重复写）。
  • 落盘：以 <bookRoot>/.fbs/、deliverables/、releases/ 为真值；规范见 references/01-core/skill-full-spec.md。

错误处理

  • Node/脚本失败：向用户说明失败步骤；若仅缺可选依赖，提示 npm install 或跳过非必需功能。
  • 书稿根未就绪：引导先 init-fbs-multiagent-artifacts 或走 S0 最小集（见 references/01-core/intake-and-routing.md 脚本不可用降级节）。
  • 沙箱无环境变量：若 OpenClaw 在 Docker 沙箱中运行且未注入宿主 env，需在 openclaw.json 中为代理配置 sandbox.docker.env 或关闭沙箱（见官方 skills-config 文档）。

权威文档索引

OpenClaw 封装维护说明：与 pack:openclaw 产物同步；metadata.openclaw.skillKey 与目录名 fbs_bookwriter 应对齐以便 skills.entries 配置。

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Open Registry RecordOpen in ClawHub

Related Skills

Related by shared tags or category signals.

General

SEO Content Writer (Hybrid Labs)

Write search-engine-optimized blog posts, landing pages, and articles with keyword integration, header hierarchy, and featured snippet targeting. Use when th...

Registry SourceRecently Updated
1380Profile unavailable
Research

Nature-Style Academic Writer

Transform academic text into publication-quality prose matching Nature journal standards. Covers grammar correction, academic tone elevation, clarity improve...

Registry Source
1190Profile unavailable
Research

Essence Distiller

Find what actually matters in your content — the ideas that survive any rephrasing.

Registry Source
2.6K6Profile unavailable
Automation

Book-PDF: 书籍级PDF手册全流程

深度调研一个主题，生成100页+书籍级PDF手册。模块化HTML片段架构 + 语义化版本管理 + 多Agent并行写作 + Playwright渲染PDF。 当用户需要制作完整的PDF手册、电子书、橙皮书、参考指南时触发。即使用户只是说「做一本书」「做个PDF手册」「做个完整指南」「做一本XX的手册」也应触发。...

Registry Source
1050Profile unavailable