Business Doc Skill Suite

当前版本：0.1.8

你是否遇到过这些问题？

• AI 写的文档"看起来完整，读起来空洞"，全是标题没有内容
• 写了一份建议书，但前后逻辑不通自己都没发现
• 文档交出去后被领导质疑"数据哪来的、依据是什么"
• 长文档写到一半断了，再也找不回之前的内容
• 写完后不知道该从哪里开始修改

Business Doc Skill Suite 正是为解决这些问题而设计的。

这是一套企业级商务文档智能化生产工具，专门用于生成高质量的：

• 📄 项目可行性研究报告（Feasibility Study Report）
• 📋 项目建议书（Project Proposal）
• 📝 产品需求文档（PRD / Product Requirements Document）
• 🏗️ 技术架构设计（Architecture Design）
• 📌 实施方案（Implementation Plan）
• 📊 管理层摘要（Executive Summary）

场景一：领导口头交代了一个想法

领导：我们要搞一个市级大数据平台，你帮我写个立项材料
你：好的，我先帮你梳理一下这个项目（启动Discovery）

场景二：手里有一份粗糙的需求文档

你：我有一个项目brief，帮我写一份项目建议书
AI：好的，我按项目建议书格式来写，包含详细功能描述

场景三：文档写到一半中断了

你：帮我继续写，之前存盘在sections目录
AI：好的，我读取之前的章节继续写

场景四：写完了需要专业评审

你：帮我review这份PRD，提问题
AI：从业务、技术、实施、风险四个角度给你审查

场景五：多轮修订后需要一致性检查

你：帮我做完整性检查
AI：检查术语一致性、数字准确性、逻辑闭环

场景六：使用自定义模板

你：用模板写一个方案，我的模板是公司标准模板.md
AI：好的，我按你的模板结构来写

用户：按照写作技能套件写一个智慧园区项目建议书，长文模式，分节写

AI（总入口）：我理解你要写智慧园区项目建议书，采用长文+分节写模式。
推荐流程：Discovery → Writer → Review → Integrity → Reviser

确认后：

1. Discovery阶段
AI：先帮你梳理项目brief，请提供项目基本信息
用户：好的，项目是XXX...
AI：Brief已生成，是否继续写项目建议书？

2. Writer阶段
AI：大纲如下，确认后开始写第1章：
- 第1章 项目概述
- 第2章 建设背景
...

用户：确认大纲
AI：开始写第1章...（写完）第1章完成，继续第2章吗？

用户：继续
AI：开始写第2章...（写完）第2章完成，继续第3章吗？

...（直到全部写完）

3. Review阶段
AI：文档已写完，是否需要Review？
用户：需要
AI：（输出详细Review报告）

4. Integrity阶段
AI：是否需要完整性检查？
用户：需要
AI：（输出一致性检查报告）

5. Revision阶段
AI：是否需要根据反馈修订？
用户：需要
AI：（生成v2版本）

用户：用模板写一个技术架构方案，我的模板是 公司技术方案模板.md

AI：好的，让我先读取你的模板文件
（读取模板结构）

模板结构：
1. 项目概述
2. 需求分析
3. 总体架构
4. 详细设计
5. 部署方案
6. 实施计划

开始按模板结构写作...

（输出完整方案）

用户：写一个电商APP的PRD，要包含用户模块、订单模块、商品模块

AI：好的，我按PRD格式来写
- 用户模块：注册、登录、个人中心...
- 订单模块：下单、支付、取消...
- 商品模块：列表、详情、搜索...

（输出完整PRD）

用户：写一个数据中台项目建议书，要详细功能描述，四级拆解

AI：好的，我按四级功能拆解规则来写

第4章 建设目标与内容

4.1 数据汇聚平台（L1）
    4.1.1 能力源管理（L2）
        4.1.1.1 能力源注册（L3）
            - 功能描述：...
            - 输入：...
            - 输出：...
            - 业务规则：...
            - 验收条件：...
        4.1.1.2 能力接入配置（L3）
            ...
    4.1.2 能力同步（L2）
        ...

功能清单：
| 编号 | 功能名称 | 模块 | 优先级 |
|-----|---------|-----|-------|
| AC-001 | 能力源注册 | 数据汇聚平台-能力源管理 | P0 |
...

它的核心价值不是"帮你快速写一篇文档"，而是把文档生产变成一个可控的工业化流程：

澄清需求（Discovery） → 结构化写作（Writing） → 多维度评审（Review） → 一致性校验（Integrity） → 修订定稿（Revision）

每一篇重要文档，都会经过这个流程的锤炼，确保：

• 内容扎实，不是空标题
• 逻辑自洽，不是前后矛盾
• 依据充分，不是凭空臆造
• 可追溯可修订，不是写完就丢

针对项目建议书、可行性研究报告等长文档，启用专门的深度写作模式：

• 目标字数：项目建议书 3000-6000 字，可行性研究报告 5000-10000 字
• 关键章节必须"写透"：背景、现状、必要性、建设目标、建设内容、实施路径、预算说明、风险分析、结论建议
• 每一章都要有"现状 → 问题 → 影响 → 方案 → 结论"的论证链条

AI 写文档最常见的问题是"标题很多，内容很少"。这套技能强制要求：

• 小标题后面必须有实质性叙述，不能只是一个短语
• 每一个分点都要回答：是什么、为什么、怎么运作、解决什么问题、有什么风险
• 避免"目录注释式"写法（只有一个标题，下面跟着一句解释）

交互式分节写（Interactive Mode）

• 先输出完整大纲，等你确认后再开始
• 每写完一章，让你审核后再继续下一章
• 适合：长文档、需要分步控制、想每章把关

触发关键词：分节写 / 一章一章写 / 交互式

存盘写作模式（Checkpoint Mode）

• 写作过程中自动每章存一个文件
• 文件保存在 ./sections/01-xxx.md, 02-xxx.md...
• 全部写完后自动合并成完整文档
• 适合：长文档、防止中断丢失、想看每章进度

触发关键词：存盘写 / checkpoint / 分节存盘

当需要详细功能描述时，支持 L1-L4 四级功能层级拆解：

每一级都必须展开写内容，不能只是列标题：

• L1（功能模块）：描述这个模块在整个系统中的作用、目标、量化指标
• L2（功能子系统）：描述子系统具体做什么、核心功能、与其它子系统的关系
• L3（功能点）：必须包含功能描述、输入、输出、业务规则、验收条件
• L4（功能细节）：具体操作的细节、参数说明、异常处理

L3 功能点标准格式：

#### 3.1.1 能力源注册

**功能描述**：支持注册新的能力源，包括能力源名称、能力源类型、连接信息等。

**输入**：能力源名称、能力源类型、连接地址等。

**输出**：能力源编号、注册结果。

**业务规则**：
- 能力源名称在同一平台内唯一
- 连接信息需要加密存储

**验收条件**：能够成功注册各类能力源；能够测试连接。

功能清单一致性规则：

• L3 功能点数量 = 功能清单中的条目数
• 功能清单的每一项都要能追溯到 L3
• 功能编号能对应到具体 L3

触发关键词：详细功能描述 / 拆解功能层级 / 四级 / 功能拆解

不是只有"语法检查"，而是从企业真实角色视角审查：

• 业务评审（Business Reviewer）：业务价值、必要性、战略契合度
• 产品评审（Product Reviewer）：用户价值、范围边界、需求清晰度
• 技术评审（Technical Reviewer）：架构可行性、技术复杂度、依赖关系
• 交付评审（Delivery Reviewer）：时间线可行性、资源需求、执行风险
• 风险评审（Risk Reviewer）：风险识别、假设条件、合规问题
• 魔鬼辩护（Devil's Advocate）：质疑整体方案，找出隐藏问题

不只是查错别字，而是深度检查：

• 术语是否一致（如：有的地方叫"网格员"，有的地方叫"网格工作人员"）
• 数字是否打架（预算前后不一致）
• 建议是否有支撑（结论有没有依据）
• Scope 是否漂移（范围有没有悄悄变大）
• 风险是否闭环（提到的风险有没有应对措施）

商务文档智能生产套件主入口，负责流程编排。

适用场景

• 从零开始生产完整文档
• 需要走完整流程（Discovery→Writer→Review→Integrity→Reviser）
• 用户说"按照写作技能套件写"

功能

• 需求识别与流程规划
• 阶段执行编排
• 最终文档交付

触发关键词

按照写作技能套件写
用完整流程写
走一套文档生产流程
用biz-doc套件写
start business doc workflow

把混乱的输入整理成结构化的项目brief。

适用场景

• 只有零散的想法
• 只有会议纪要
• 只有口头需求
• 不知道该写什么类型的文档

典型输出

• 项目背景与目标（Project Brief）
• 范围定义（Scope Definition）
• 干系人地图（Stakeholder Map）
• 需求种子（Requirements Seed）
• 风险列表（Risk List）
• 待确认问题（Open Questions）

触发关键词

帮我梳理这个项目
把会议纪要整理成brief
先澄清需求
需求梳理

把brief或现有材料写成正式的文档草稿。

支持文档类型

• 可行性研究报告（Feasibility Report）
• 项目建议书（Project Proposal）
• 产品需求文档（PRD）
• 架构设计（Architecture Design）
• 实施方案（Implementation Plan）
• 管理层摘要（Executive Summary）
• 长文模式（Dense-Longform）

支持分节模式

• 交互式分节写：写一章确认一章
• 存盘写（Checkpoint）：自动存盘最后合并

触发关键词

写一个项目建议书
写一份可研报告
写产品需求文档
写架构设计
分节写
存盘写
checkpoint

从企业多角色视角对文档进行深度评审。

评审维度

• 业务价值与必要性
• 产品范围与需求清晰度
• 技术可行性与复杂度
• 交付时间线与资源
• 风险与合规
• 魔鬼辩护（质疑整体）

触发关键词

帮我review
审一下这份文档
评审这份PRD
找风险
从业务视角审

深度检查文档的内部一致性和可信度。

检查重点

• 术语一致性
• 数据一致性
• 建议支撑度
• Scope 收敛性
• 风险闭环
• "骨架化"程度

触发关键词

完整性检查
一致性检查
integrity check
查前后冲突
校验

根据评审意见和校验结果修订文档。

支持模式

• 全文修订（Full Revision）
• 仅修订路线图（Roadmap Only）
• 章节重写（Section Rewrite）
• 修订回复（Response to Comments）

触发关键词

按意见修改
修成v2
重写这一章
根据反馈修订

组织文档生产的完整流程。

职责

• 判断当前阶段
• 推荐下一步
• 串联各技能

触发关键词

帮我走完整流程
从头到尾搞定
先写再review再修改

适合：手里只有零散材料，没有正式文档

Biz Discovery → Writer → Reviewer → Integrity → Reviser

典型场景

• 领导口头交代了一个想法，需要写成立项材料
• 只有一个项目brief或需求文档
• 第一次写这类文档，不知道结构

示例对话

用户：帮我梳理这个项目，后面我要写项目建议书
用户：基于brief写一份项目建议书
用户：帮我review这份建议书
用户：做完整性检查
用户：按反馈修订成v2

适合：已经有文档初稿，需要提升质量

Reviewer → Integrity → Reviser

典型场景

• 自己写了初稿，需要专业评审
• 文档需要提交审批，需要检查逻辑一致性
• 多人协作的文档，需要统一校验

示例对话

用户：帮我review这份PRD
用户：做完整性检查
用户：按反馈修订成v2

适合：知道要写什么，不需要完整流程

Writer

典型场景

• 需要快速出一个文档框架
• 自己有明确思路，只需要AI辅助写作
• 内部使用的小文档，不需要严格评审

示例对话

用户：写一个数据中台项目建议书
用户：帮我写一份智慧园区技术方案

适合：项目建议书、可研报告等长文档，需要分段控制

方式一：交互式（每章确认）

• 先输出完整大纲，用户确认后开始
• 每写完一章，用户审核后再继续下一章
• 适合：长文档、需要分步控制、想每章把关

触发方式

写一个项目建议书，分节写
写一份可研报告，一章一章写

方式二：存盘写（自动备份）

• 写作过程中自动每章存一个文件
• 全部写完后自动合并成完整文档
• 适合：长文档、防止中断丢失、想看每章进度

触发方式

写一份可研报告，存盘写
写一个方案，checkpoint

适合：需要详细功能描述的项目建议书、技术方案

典型场景

• 项目建议书需要详细的功能清单
• 技术方案需要完整的模块拆解
• 需要四级层级清晰的功能描述

拆解层级

触发方式

写一个项目建议书，要详细功能描述
写技术方案，拆解功能层级
帮我写一个四级功能拆解的PRD

适合：从零开始，希望完整流程自动化执行

Business Doc Suite（总入口skill）

典型场景

• 说一句话就启动完整流程
• 不需要关心具体步骤
• 信任自动化流程

触发方式

按照写作技能套件写一个智慧园区方案
用完整流程写一份可研报告
走一套文档生产流程

总入口会自动：识别需求 → 规划流程 → 分步执行 → 最终交付

适合：有特定文档模板，需要按模板结构写作

典型场景

• 有公司/部门的标准文档模板
• 需要按特定格式输出文档
• 有特殊的章节结构要求

触发方式

用模板写一个方案，我的模板是XXX.md
基于模板YYYY.md写一份可研报告
按这个模板的结构写：ZZZZ.md

使用步骤

1. 上传模板文件（Markdown格式）到工作区
2. 写作时指定模板文件名
3. AI按模板结构填充内容

追求章节内容扎实，而不是标题数量多。

信息不足时，不编造。会显式标注：

• 已知事实（Facts）
• 工作假设（Assumptions）
• 待确认问题（Open Questions）

评审的目标不是"写得不错"，而是输出：

• 具体问题
• 严重级别
• 修改建议
• 修订路线图

一致性校验不只是查语病，而是查：

• 建议是否成立
• 章节是否矛盾
• 数字是否一致
• 风险是否闭环

• 📌 产品经理：快速生成PRD、方案文档
• 📌 项目经理：编写项目建议书、可研报告
• 📌 架构师：撰写技术方案、架构设计
• 📌 售前顾问：制作解决方案、投标文件
• 📌 运营负责人：输出运营方案、执行计划

A: 需要生产高质量商务文档的企业员工、政务工作者、咨询顾问等。

A: 普通AI写作是"一键生成"，这套技能是"工业化生产"。它会帮你：

• 结构化思考（Discovery）
• 规范化写作（Writer）
• 多角度评审（Reviewer）
• 深度校验（Integrity）
• 迭代修订（Reviser）

A: 这是开源技能，免费使用。

A: 直接告诉它你要写什么，比如"帮我写一个智慧园区项目建议书"。

• 本地技能路径：~/.openclaw/skills/
• 设计文档：~/.openclaw/workspace/designs/
• 使用文档：~/.openclaw/workspace/README-business-doc-skill-suite.md

帮我梳理这个项目，后面我要写项目建议书

写一个XXX项目建议书

写一个XXX项目建议书，分节写

帮我review这份文档，再做完整性检查，最后按反馈修一版

• business-doc-writer 四级功能拆解规则优化
  • 新增智能工作量评估（总字数估算公式）
  • 新增分章节分文件写作策略（按字数分层）
  • 新增分文件目录结构示例
  • L3展开要求细化：描述100字+、输入具体字段、输出具体字段、业务规则3条+、验收条件2条+
  • 新增写作检查清单（6项检查）
  • 常见问题处理FAQ

• 自定义模板支持
  • 支持上传MD格式文档模板
  • 写作时指定使用哪个模板
  • 按模板结构填充内容
  • 新增触发关键词：用模板写、基于模板写、按模板写
  • 新增工作流G：自定义模板写作

• business-doc-writer 新增四级功能拆解规则
  • 支持 L1-L4 完整功能层级拆解
  • 每级展开写规则（不能只列标题）
  • L3 功能点必须包含：描述、输入、输出、业务规则、验收条件
  • 功能清单与四级拆解保持一致的规则
  • 新增写作检查清单

• Business Doc Suite（总入口skill）
  • 新增流程编排主入口skill
  • 当用户说"按照写作技能套件写"时触发
  • 负责识别需求、规划流程、逐步执行、产出最终文档
  • 支持完整流程和快速流程两种模式

• 优化技能触发词，使识别更精准

• 新增分节写作模式（交互式 + 存盘）

• 新增长文模式（dense-longform）
• 新增小标题分点展开规则
• 优化子代理执行策略

• 初始版本发布

• GitHub: https://github.com/zhenxuanshi-ship-it/business-doc-skill-suite
• 文档持续更新中...

一句话总结：一套让AI写出高质量企业文档的技能套件，不是"帮我写文档"，而是"帮我写好文档"。