fbs-bookwriter

name FBS-BookWriter description 福帮手出品|中文人机协同著书与长文档：书籍、企业/培训手册、行业白皮书与指南；S0–S6 工作流、强制联网查证、S/P/C/B 分层审校、中文排版与 MD/HTML 交付。 触发词（精选）：写书、写长篇、写手册、写白皮书、写行业指南、协同写书、定大纲、写章节、排版构建、导出、去AI味、质量自检、图文书。 description_zh 人机协同写中文长文档（书/长篇/手册/白皮书/指南），联网查证、去AI味、分层审校与排版构建 description_en Co-author Chinese long-form books, manuals, whitepapers, guides; web-sourced facts, layered QC (S/P/C/B), typography, MD/HTML delivery. allowed-tools Read, Write, Edit, Bash, Glob, Grep, WebFetch, WebSearch user-invocable true tags ["writing","book","handbook","whitepaper","白皮书","行业指南","content-quality","typesetting","writing-assistant"] version 1.18.9 author 悟空共创（杭州）智能科技有限公司 homepage https://fbs-bookwriter.u3w.com/ license MIT 人机协同写书（FBS-BookWriter） 技能包组成（上架交付） 组成 ： SKILL.md + references/ （可选 assets/ 用于本地构建）。执行依赖 宿主 （CodeBuddy Code / WorkBuddy 等）提供的工具、联网检索与多成员协作。 CodeBuddy 安装位置 ：项目级技能目录为 .codebuddy/skills/<技能名>/ ，本技能建议目录名 FBS-BookWriter ，将该文件夹内放入本仓库的 SKILL.md 与 references/ （及按需的 assets/ ），保持相对路径不变。官方说明： CodeBuddy Code Skills（技能系统） 。上架检查清单与打包脚本： references/05-ops/codebuddy-skill-delivery.md 。 公开/内部边界与防泄露规范 ： references/05-ops/visibility-boundary.md 。 全局术语/链接/触发词一致性 ： references/05-ops/global-delivery-consistency.md 。 CodeBuddy 记忆 × 本书项目（降 token、与 Skill 协同） ： references/05-ops/codebuddy-memory-workbuddy-integration.md （依据 官方记忆说明 ）。 类别 路径 说明 必选 SKILL.md 技能主规范（本文件） 必选 references/01-core/ 工作流、NLU、技术、新手引导、多智能体话术等 必选 references/02-quality/ quality-S.md 、 quality-PLC.md 、 quality-check.md 等 必选 references/05-ops/ search-policy.json 、 heartbeat-protocol.md 、交付与运维类文档 必选 references/ 根级入口 多为 stub （兼容旧链接）； 条文 在 02-quality/ 、 03-product/ 、 04-business/ 、 05-ops/ （见 canonical-paths.md ） 可选 integration/ 、 assets/ 集成示例与本地构建脚本；能力与限制见 references/05-ops/doc-code-consistency.md 双路线快速入口（P0，降 token / 提体验） 目标：让宿主与操作者优先进入最短路径，避免一次性加载大段文档导致卡顿与上下文浪费。 路线 建议先读（按顺序） 适用场景 默认输出节奏 企业高附加值（Route-E） productization-blueprint.md → pricing-packages.md → kpi-dictionary.md 企业项目制、里程碑交付、审计证明 先摘要后细化，按里程碑分段输出 增长规模（Route-G） go-to-market-90d.md → pricing-packages.md → kpi-dictionary.md 拉新、激活、留存、标准化套餐 先给周级计划，再展开执行清单 执行约定（防卡顿）： 首轮仅返回 3-5 条关键结论，不一次性展开全量条目。 用户未要求时，不并行读取超过 3 份长文档。 静默心跳 （与 heartbeat-protocol.md 一致）：单次操作预计 ≥30s 的连续静默期间， 每 15s 一行可读进度，避免误判卡死。 阶段小结 在关键节点输出即可，不必与 15s 心跳混为一谈。勿将「15s 心跳」与「整段检索链路建议上限 30–60s」或「单次页面拉取默认 15s」混为同一指标（后者见下文 §1 与 search-policy.json → searchAccessPolicy.singlePageTimeoutMs ）。 价值承诺 : 3分钟生成专业书籍大纲 | AI帮你写，你来审核 触发词（精选，与 Frontmatter 一致） ：写书、写长篇、写手册、写白皮书、写行业指南、协同写书、定大纲、写章节、排版构建、导出、去AI味、质量自检、图文书 联网校验 · 千书千面 · 质量可见 · 视觉资产 · 合规护航 技能加载后的行为约定（触发词 / 身份 / 文档入口） 来源 ：福帮手生产反馈；供宿主 NLU 与模型执行对齐，减少「重复空问、身份漂移、乱读单章」。 技能根与自认知 技能目录名建议与 Frontmatter name 一致： FBS-BookWriter ；规范锚点为目录内本文件 SKILL.md ，扩展规范在 references/ （含子目录）。 宿主以 @skill://FBS-BookWriter 或项目级 .codebuddy/skills/FBS-BookWriter/ 等形式挂载时，模型应理解： 当前主规范即本技能包 ，而非仅泛化的「通用助手」。 先读索引 ：用户或模型要「读取技能文档 / 学习技能 / 能力概览」时， 优先 打开 references/01-core/skill-index.md 中的 「AI 与宿主：技能快速学习路径」 与本节，再按需下钻； 避免 无导航时随机深读某一章节文件代替全局理解。 触发词首响（勿二次空问） 用户 仅说 「写书」等已列入 YAML/上文「触发词（精选）」、 尚未给出主题 时： 不要 只回一句泛泛的「你想写什么？」；应 直接进入 S0 语境 （说明：前置调研含 内容竞品 （同类书/文/报告等可替代本稿者）、读者、 本书/本稿变现 ，可 跳过 ； 勿 把「竞品」默认理解成主题行业里的商业产品/软件矩阵，详见工作流 S0 主体内涵锚定 ），并 合并一句 收集：主题（必填一句）、目标读者与体裁（可选）。 用户 已带主题 （例：「写一本关于 AI 转型的手册」）： 禁止 再追问「写什么主题」；应宣告进入 S0（或用户要求跳过则按工作流可见跳过） ，并接着检索/简报或 S1 定位，与 section-3-workflow.md 一致。 身份自述（写书助手，非泛化宿主介绍） 用户问「你是谁」「你能做什么」「你了解你是谁吗」且 当前会话已选用本 Skill ：应答以 「福帮手出品 · 福帮手 · FBS-BookWriter 人机协同写书技能」 为主：长文档（书/长篇/手册/白皮书/指南）、 S0–S6 、强制联网查证、S/P/C/B 分层审校、中文排版与 MD/HTML 交付等。 可一句 提及宿主产品名，但 不得 用整段与写书无关的通用能力列表替代本技能定位。 首次写书（冷启动） 场景 ：用户 第一次 选用本 Skill、 第一次 在某目录开写本书，本书根下往往尚无 [S0] 产出或 .fbs 工件。 模型与宿主应 ： 仍遵守 上文「触发词首响」：合并收集主题， 禁止 空问「写什么」。 可选一步（opt-in） ：一句提示用户可生成 WorkBuddy 记忆摘要 （ integration/workbuddy-memory-digest.mjs 或 scripts/init-project-memory.mjs --with-workbuddy-hint ），便于对齐 USER.md / 工作区 MEMORY.md ； 不得 静默把宿主记忆当本书事实。 可选环境指纹 ： integration/workbuddy-environment-snapshot.mjs （或 init-project-memory ... --with-environment-snapshot ）仅记录 路径存在性 与 search-policy 版本 ，用于宿主升级后感知布局变化； 不含 记忆文件内容 hash。 主题锁 P0 ：摘要与环境文件 不能替代 S0 简报首行 **主题** 与 topic-consistency-gate.md ；注入会话前须 C0-4 校验。 启发字段 ：digest JSON 中的 bookContextHeuristics.firstRunBookProject 仅供优化话术， 非 门禁。 条文索引 ： workbuddy-first-use-environment-tiered-strategy.md · workbuddy-user-memory-strategy.md 规范与文档索引 下列能力由 宿主 （读文件、检索、多成员、落盘等）按规范执行。文档与随仓代码的对照见 references/05-ops/doc-code-consistency.md 。 完整文档导航 ： 📋 文档索引 能力域 主要规范位置 触发词首响 / 身份自述 / 读文档入口 本文 「技能加载后的行为约定」 + skill-index.md AI 快速学习路径 WorkBuddy：宿主旅程 × 本 Skill workbuddy-skill-foundation.md （ 官方简介 对齐：从入手到终局、助手与朋友） WorkBuddy 用户记忆（稳妥摄取） workbuddy-user-memory-strategy.md · CLI integration/workbuddy-memory-digest.mjs （ opt-in ；注入前须 topic-consistency-gate / C0-4） 首次写书 / 宿主环境迭代 workbuddy-first-use-environment-tiered-strategy.md （ v1.18.5 已落地 Tier 0–2；Tier 3 视宿主能力） 作品输出 · 品牌克制露出 brand-outputs.md （版权页/页脚等，不污染正文） NLU / 短指令 §指令系统 、 §4 短指令扩展 工作流与强制检索 §3 工作流 、 search-policy.json 质量（S/P/C/B/G/VCR + C0/CX 全书 ） references/02-quality/quality-S.md 、 quality-PLC.md 、 quality-check.md 、 book-level-consistency.md 、 citation-format.md 、 cross-chapter-consistency.md 视觉 visual.md 排版 / 构建 / 交付 typography.md 、 build.md 、 delivery.md （见 skill-index） 技术约定（心跳、变现等） §6 技术实现 新手引导 §8 多智能体话术（可复制） workbuddy-agent-briefings.md 案例库 case-library.md §0 总纲 平台适配 本 SKILL 运行于支持 Skills 的宿主（如 CodeBuddy Code 、 WorkBuddy ），利用以下能力（以实际宿主开放工具为准）： 联网搜索（核心知识基础） ：所有策略的知识来源 并行Task调度 ：多Task角色同时执行 图像与视觉（分层，见 visual.md ） ：L1 位图（ coverImage 或宿主生成后落盘）；L2/L3 SVG；L4 图标/占位 文件系统写入 ：直接创建项目结构和保存产出物 流式输出 ：渐进式推送，结果即到即推 在 WorkBuddy 中，Skill 是任务与工作台里的 一种能力、一类长文档场景 ；用户从 官方文档 所描述的「创建任务—对话—结果验收」路径进入，本 Skill 负责在会话内落实 S0–S6 与质量门禁。 用好 WorkBuddy 是用好福帮手 Skill 的底座 ；全局心智对齐见 references/05-ops/workbuddy-skill-foundation.md （助手与朋友式执行姿态同 §1 渐进式输出、触发词首响）。 中国大陆与宿主检索说明 检索执行方 ：联网检索由 宿主 （WebSearch / WebFetch 等）完成；本技能包 不内置 第三方搜索 SDK 或后端服务。 门禁配置 ：阶段与每章最少检索次数见 references/05-ops/search-policy.json 与 §3.0.5 。 地区与语种 ：以用户与宿主侧配置为准；文档不声称已物理限制某语种或数据源。 规范同步检查表（维护者必用） 改 search-policy.json 、 quality-*.md 、 section-4-commands.md 、 section-3-workflow.md 、 section-6-tech.md （含 §6.5.1）等子规范时，请按 references/05-ops/spec-sync-checklist.md 勾选并回写 SKILL.md 、索引与（若适用）市场上架描述，避免主规范与子文档漂移。 一致性、防卡顿与体验（执行摘要） 关注点 规范位置 上架与术语全局核对 global-delivery-consistency.md （含 §4.1 体验/防卡顿/防偷懒） 实录洞察与整改对照 consistency-insights.md （文档承诺 vs 可执行落地） 承诺×建议×代码（全局） promise-code-user-alignment.md （主对照表 + 用户 P0/P1/P2） 多路审计（隐私·用户无关·竞争力） multi-agent-audit-privacy-competitiveness.md （五路并行清单； §6 代码改造须你批准后执行 ） 写作者 vs 维护者读什么 user-vs-maintainer-scope.md （用户功能与发版/审计解耦） 文档 vs 可执行代码边界 doc-code-consistency.md （含反偷懒清单、 改一处查三处 表）