笔锋（PenFlow）— 企业公文智能撰写助手

根据用户输入的关键信息，自动生成符合中国公文规范的正式情况说明文档（.docx）。

核心能力

触发条件

当用户需要撰写正式公文/情况说明时使用此技能。典型触发语：

• "帮我写一个情况说明"
• "生成一份情况说明"
• "出具一份书面说明"
• "帮写个说明文档"
• "写个公文"
• "笔锋生成"

使用方式

方式一：对话式（推荐）

直接向 AI 描述需要撰写的情况说明，AI 会引导您逐步确认各要素并直接生成 .docx 文件。

示例对话：

用户：「帮我写一个关于房屋租赁的情况说明，致送对象是XX公司。」 AI：「好的，我来帮您收集关键信息：1. 租赁背景是？2. 需要说明的具体问题是？……」

方式二：表单式（可视化填写）

打开技能目录下的 assets/form.html，在浏览器中填写各要素，生成 JSON 配置文件后运行脚本。

步骤：

1. 用浏览器打开 assets/form.html
2. 按表单提示填写：文档类型、受众类型、标题、正文段落、落款信息等
3. 点击「生成配置文件」，下载 config.json
4. 运行：python scripts/generate_doc.py config.json

表单界面支持动态添加/删除正文段落和落款单位行，并会根据受众类型自动提示默认结尾语。

工作流程

步骤 1：收集关键信息

向用户确认以下要素（用户已提供则跳过，未提供则基于上下文合理推断并标注）：

受众类型判定规则：

• 致送对象为企业、院校、机构 → partner
• 致送对象为本系统上级单位 → superior
• 致送对象为政府行政机关 → government
• 无法判断时询问用户

步骤 2：语义解析与内容撰写

根据收集到的信息，按以下结构撰写正文：

1. 背景段：说明涉及的协议、关系、事件背景
2. 问题段：解释当前无法按常规流程推进的原因
3. 措施段：说明已采取的过渡性安排和达成的一致意见
4. 计划段：说明后续正式流程的启动条件和计划
5. 结尾段（可选）：表达希望得到的理解、支持或配合

行文规范——按受众类型加载 references/tone_guide.md 获取详细规则：

详细语气适配规则见 references/tone_guide.md。

步骤 3：生成 JSON 配置并调用脚本

将撰写好的内容组织为 JSON 配置文件，然后调用生成脚本：

python scripts/generate_doc.py  [output.docx]

JSON 配置文件格式：

{
    "doc_type": "situation_report",
    "audience": "partner",
    "title": "关于XXX的情况说明",
    "greeting": "u897fu53ccu7248u7eb3u804cu4e1au6280u672fu5b66u9662uff1a",
    "paragraphs": [
        "u7b2cu4e00u6bb5u6b63u6587u5185u5bb9...",
        "u7b2cu4e8cu6bb5u6b63u6587u5185u5bb9..."
    ],
    "closing": "u4ee5u4e0au60c5u51b5uff0cu7279u5411u8d35u9662u8bf4u660eu3002u671bu8d35u9662u4e88u4ee5u7406u89e3u4e0eu652fu6301u3002",
    "company": ["u4e2du56fdu79fbu52a8u901au4fe1u96c6u56e2u4e91u5357u6709u9650u516cu53f8", "u897fu53ccu7248u7eb3u5206u516cu53f8"],
    "date": "2026u5e746u670827u65e5"
}

字段说明：

JSON 编码注意事项：

• JSON 中的中文双引号必须使用 u201c（左）和 u201d（右）转义，不可直接书写 "" 字符
• 所有中文内容使用 UTF-8 编码
• 确保 JSON 格式合法（无尾逗号、引号闭合）

步骤 4：呈现结果

脚本执行成功后，使用 present_files 向用户展示生成的 .docx 文件，并简要说明文档结构和核心内容。

公文格式规范

生成的文档遵循中国公文标准格式，详细规范见 references/format_spec.md。

核心格式参数：

页面设置： A4纸，上边距2.54cm，下边距2.54cm，左边距3.17cm，右边距3.17cm。

依赖环境

• Python 3.8+
• python-docx

安装命令：

pip install python-docx

注意事项

• 生成的 .docx 文件保存在用户当前工作目录
• 如致送对象为合作方，需在正文中体现尊重和协商态度
• 所有称谓在首次出现时写全称并附简称说明
• 避免口语化表达，使用正式书面语
• 脚本路径为技能目录下的 scripts/generate_doc.py，调用时使用相对路径