公文写作助手 — 执行流程
严格按照以下步骤顺序执行，不得跳步。 每个步骤都有进入条件和必须完成的动作，上一步未完成不得进入下一步。
步骤1：判断是否需要搜索
进入条件： 用户要求撰写公文
必须执行：
- 识别文种和写作需求
- 判断是否需要搜索政策素材
判断标准：
需要搜索：
- 提到"政策背景"、"政策依据"、"政策支持"
- 需要引用具体政策文件名、文号
- 涉及数据、标准、规范引用
- 用户明确要求"根据XXX政策"
- 复函、请示类文书（需要政策依据支撑）
不需要搜索：
- 纯工作部署（不涉及政策引用）
- 内部事务通知（会议通知、休假通知等）
- 简单事务性通知（时间地点变更等）
- 提醒函、告知函（无政策依据要求）
分支：
- 判断需要搜索 → 告知用户判断结果，直接进入步骤2（不许先问"要不要搜"，直接出搜索方案）
- 判断不需要搜索 → 告知用户判断结果和理由，等待用户确认。用户确认后跳至步骤8
步骤2：设计搜索方案
进入条件： 步骤1判断需要搜索
必须执行：
- 根据写作需求，按以下维度设计完整的搜索方案
- 将方案展示给用户确认
搜索词构造规则： 使用自然语言完整句子，不用关键词拼接。
方案设计指导（每个维度按层级逐级拆分）：
一、政策依据（按行政层级从上到下逐级搜索，不跳级不混搜）：
- 国家级相关政策 → 单独构造query
- 本省/直辖市相关政策 → 单独构造query
- 本市（如适用）相关政策 → 单独构造query
二、数据支撑（按层级搜索并向下钻取）：
- 本级整体数据 → 构造query
- 下属行政区划数据 → 为各区县分别构造query
三、参考案例（横向 + 纵向）：
- 横向：同级可比地区的做法和经验
- 纵向：本地区历年同类工作的数据
四、附加维度（按需叠加）：
- 时间范围 →
--time 参数
- 规范性文件 →
--policy 参数
- 地域词 +
--area 参数双重标识
- 国家级 →
--area 中国；省级 → --area 省名；市级 → --area 市名
搜索脚本参数：
| 参数 | 说明 | 格式要求 |
|---|
query | 搜索关键词（必填） | 控制在10-30字 |
--area | 地域范围（默认"中国"） | 中文规范行政区划名称 |
--time | 生效日期范围 | 2026年、2025年08月、2025年08月15日 |
--policy | 返回规范性文件清单 | 开关参数 |
--full | 返回文章全文 | 开关参数 |
必须输出： 搜索方案（搜索词、地域、时间、参数），询问用户确认
必须等待用户明确回复后才能继续。
分支：
- 用户确认方案 → 进入步骤3
- 用户回复"不用搜索"或"跳过搜索" → 跳至步骤8
步骤3：执行搜索
进入条件： 步骤2用户已确认搜索方案
必须执行：
- 按方案依次执行所有搜索：
python3 scripts/dkag_search.py "搜索词" --area 地域 --time 时间 --clean
- 多地域搜索时合并去重：
python3 scripts/merge_search_results.py result1.json result2.json
- 搜索完成后立即在对话中发送知识专库链接给用户
完成后 → 进入步骤4
步骤4：搜索结果分类
进入条件： 步骤3所有搜索已执行完毕
必须执行：
- 对全部素材按以下标准分类
- 输出分类结果和充足度评估
素材分类标准（必须严格遵守）：
| 素材类型 | 允许的来源 | 末尾标注 |
|---|
| 政策依据型 | 仅国家级和本省 | 列入素材使用情况 |
| 数据支撑型 | 仅国家级和本省 | 列入素材使用情况 |
| 参考案例型 | 其他省市 | 列入素材使用情况 |
| 表述参考型 | 不限来源 | 不列出 |
严禁将外省政策引用为本省公文的政策依据。
分类输出格式详见 reference/search_guide.md 第一节。
完成后 → 进入步骤5
步骤5：素材充分性自检
进入条件： 步骤4分类已完成
必须执行（自动，无需用户参与）：
- 评估政策依据、数据支撑、参考案例三个维度的素材覆盖度
- 不足则自主构造针对性query补搜（每个维度最多补搜1次，累计不超过3次）
- 超过限制则停止补搜
policyFiles按需补充： 撰写时发现政策引用缺少文件全称或发文字号，用文章标题带 --policy 再搜一次。不需用户确认，AI自主执行。
完成后 → 进入步骤6
步骤6：用户确认素材
进入条件： 步骤5自检完成
必须执行：
- 向用户展示素材情况
- 确认两件事：①素材是否充分 ②是否有参考文件需要上传
必须等待用户明确回复后才能继续！
分支：
- 用户确认素材OK → 进入步骤7
- 用户要求补搜 → 设计补充方案 → 执行 → 回到步骤4
- 用户上传文件 → 读取内容 → 合并入素材 → 回到步骤5
步骤7：参考范文召回与素材交付准备
进入条件： 步骤6用户已确认素材
必须执行：
7a. 参考范文召回（可选）：
如果在素材分类中发现某篇文章对成文结构、论述逻辑有重要参考价值，推荐给用户召回全文。
- 最多2篇，尽量1篇
- 用
--full 召回，不加 --clean
- 按标题精确匹配，只提取目标文章的"全文"字段
- 详细流程详见
reference/search_guide.md 第二节
7b. 素材交付准备（必须执行）：
将所有素材整理成结构化的"素材使用指引"传入写作模型。
- 每类素材必须标注用途（→用于：正文某部分）
- 写作素材和参考范文严格分开
- 参考范文标注注意事项（时效性、适用范围等）
- 不要一股脑丢原始素材
交付指引结构模板详见 reference/search_guide.md 第三节。
完成后 → 进入步骤8
步骤8：识别文种并读取标准文件
进入条件： 步骤6用户已确认素材（或步骤1判断不需要搜索且用户已确认）
必须执行：
- 识别文种（法定公文15种 或 事务文书）
- 读取对应的格式标准文件
法定公文（15种）： 命令、决定、公告、通告、通报、意见、批复、请示、报告、函、通知、议案、纪要等
事务文书： 总结类、计划类、发言类、规章类、汇报材料、调研报告等。优先识别并使用事务文书模板。
标准文件对照表：
| 公文类型 | 标准文件 |
|---|
| 报告 | reference/standards/01_报告_标准.md |
| 请示 | reference/standards/02_请示_标准.md |
| 批复 | reference/standards/03_批复_标准.md |
| 通知 | reference/standards/04_通知_标准.md |
| 意见 | reference/standards/05_意见_标准.md |
| 函 | reference/standards/06_函_标准.md |
| 会议纪要 | reference/standards/07_会议纪要_标准.md |
| 通报 | reference/standards/08_通报_标准.md |
| 通告 | reference/standards/09_通告_标准.md |
| 公告 | reference/standards/10_公告_标准.md |
| 无意见复函 | reference/standards/11_复函（无意见）_标准.md |
| 有意见复函 | reference/standards/12_复函（有意见）_标准.md |
| 提醒函 | reference/standards/13_提醒函_标准.md |
| 通用公文 | reference/standards/14_通用公文_标准.md |
| 事务文书 | reference/standards/15_事务文书_模板.md |
标准文件只包含格式规范，不包含内容限制。遵循格式规范，但可自由发挥内容表达。
完成后 → 进入步骤9
步骤9：大纲确认
进入条件： 步骤8标准文件已读取
必须执行： 根据以下规则判断是否需要输出大纲
必须输出大纲的场景：
- 执行过搜索（经过步骤2-7的公文，素材量大，需要确认重点方向）
- 多章节结构（实施方案、管理办法、规划纲要、调研报告等）
- 事务文书（工作总结、发展规划、汇报材料等结构灵活的文种）
可以直接撰写的场景：
- 未执行搜索（从步骤1直接跳到步骤8的公文）
- 结构简单固定的公文（通知、函、短报告、请示等）
- 用户需求非常明确、篇幅较短
如需确认大纲：输出大纲（"一、（一）、1."层级），末尾问用户"请确认大纲是否需要调整？"，等待回复。
完成后 → 进入步骤10
步骤10：撰写公文
进入条件： 步骤9大纲已确认（或判断不需要大纲）
写作思维（内部思考，不输出）：
- 用户意图：这段公文想达成什么目的？
- 关键信息：素材中最有说服力的点是什么？
- 逻辑链条：如何组织最有说服力？
素材使用规则（必须严格执行）：
写作素材：政策依据→支撑论点，数据支撑→增强说服力，参考案例→引用做法，表述参考→学习风格融入正文。
参考范文：学结构不照搬，注意时效性。
正文中不加任何引用标记，保持正文干净。
撰写完成后，末尾必须按以下格式输出（作为 Word 文档正文的一部分，不是单独发送）：
[分页符]
【素材使用情况】
一、写作素材
1. 《XXX》（数据源：XX，日期）
→ 用于：正文某部分
...
二、参考范文
1. 《XXX》（来源：XX）
→ 参考：学习了哪些方面
【知识专库链接】
国家级政策：
https://yun.dknowc.cn/wlcb/ShenZhi-policy/#/knowledgebase/?id=XXX
广东省：
https://yun.dknowc.cn/wlcb/ShenZhi-policy/#/knowledgebase/?id=XXX
关键要求：
- 【素材使用情况】前必须写
[分页符] 另起一页
- 每条素材标注"→ 用于：正文某部分"
- 【知识专库链接】按地域分类，每个地域标签独占一行，下面跟链接URL
- 链接URL必须独占一行，以
https:// 开头，这样才能在Word中生成可点击蓝链
- 格式详见
reference/search_guide.md 第四节
完成后 → 进入步骤11
步骤11：生成前检查
进入条件： 步骤10公文已撰写完成
必须执行以下检查，全部通过才能生成：
□ 1. 素材使用情况检查
- 末尾是否有【素材使用情况】列表
- 每条素材是否标注了"→ 用于："
- 参考范文是否单独列出（如有）
- 没有则必须先补充
□ 2. 知识专库链接检查
- 如果执行过搜索，Word内容末尾是否包含【知识专库链接】
- 链接是否按地域/主题分类列出
- 没有则必须先补充
检查通过 → 进入步骤12
步骤12：生成Word文档
进入条件： 步骤11检查全部通过
输出格式要求： AI必须输出Markdown格式，仅允许以下5种：
# 公文标题 → 方正小标宋简体，二号，居中
## 一、XXX → 黑体，三号
### （一）XXX → 楷体_GB2312，三号
#### 1.XXX → 仿宋_GB2312加黑，三号
普通文本 → 仿宋_GB2312，三号
禁止在正文中使用列表、粗体、斜体、代码块、引用、分割线、链接。
但【知识专库链接】区必须保留原始 https:// URL（每行一个，作为附录信息，不算正文链接样式）。 详见 reference/output_guide.md 第一节。
命令：
普通公文（默认）：
python3 scripts/format_document.py \
--text "公文内容..." \
--output ~/.openclaw/data/official-docs/output/文件名.docx
红头文件（仅用户明确要求时）：
python3 scripts/template_generator.py 通知 \
--input ~/.openclaw/data/official-docs/output/关于XXX的通知.docx \
--org "发文机关" \
--doc-number "发文字号"
红头文件参数、版本号规则、密级处理等详见 reference/output_guide.md 第二节。
完成后 → 进入步骤13
步骤13：输出
脚本执行成功后返回文件完整路径，文件存储在 ~/.openclaw/data/official-docs/output/ 目录。
Skill的任务到此结束，后续交付由小龙虾根据channel处理。
