深知公文写作（skills.sh Public 版）

这是深知公文写作的 skills.sh 分发版本。功能逻辑与主干完整版保持一致，但不内置深知搜索 API Key。API Key 只对需要深知搜索的任务（查政策依据、数据支撑、案例参考、最新政策情况）是前置条件；不涉及搜索的简单通知、改写润色、只生成 Word 等任务可直接使用，不要求配置 Key。需要搜索时，由 Agent 通过 MaaS 注册接口完成手机号注册、验证码确认和 API Key 获取，并写入本机 ~/.zshrc 中的 DKNOWC_API_KEY。

能力范围

  • 深知可信搜索：通过 scripts/dkag_search.py 调用搜索接口获取政策、数据和案例素材。
  • 公文范文大纲：通过 scripts/outline_reference.py 在搜索前获取范文参考大纲和搜索建议。
  • 公文写作流程：由 SKILL.md 进行任务路由，按任务复杂度选择直接生成、追问、搜索、审查或严格流水线。
  • 搜索策略：reference/search_policy.md 保留深知搜索逻辑、素材四分类和来源限制。
  • 任务路由：reference/task_router.md 定义简单任务、常规任务、复杂任务和高风险任务的处理方式。
  • 质量审查：reference/review_checklist.md 定义公文内容、可信溯源、文种专项和 Word 输出检查项。
  • Word 排版：通过 scripts/format_document.py 生成普通格式 .docx，支持标准 Markdown 表格和宽表横向页面。
  • 可信溯源报告：执行过搜索时，通过 scripts/source_note_html.py 和 scripts/render_trace_html.py 生成独立 HTML 可信溯源报告。
  • 已有 Word 审查：通过 scripts/review_document.py 只读提取已有 .docx 的格式信息和待核验事实表述。
  • 红头文件：通过 scripts/template_generator.py 代码化生成红头和表尾，不依赖 templates/ 中的 Word 模板。
  • PDF：当前主干版本不支持自动生成 PDF；用户明确要求 PDF 时，交付 .docx 并建议用户使用本机 Word/WPS 另存或导出为 PDF。

依赖

pip3 install python-docx requests

Python、python-docx、requests 是运行本 Skill 的基础前置条件。初始化检查如显示 ready=false，应先完成缺失项处理，并重新检查通过后再继续执行搜索、写作、Word、红头或可信溯源报告 HTML 生成。有效 API Key 只对需要深知搜索的任务是前置条件；不涉及搜索的写作任务无需配置 Key。

标准公文字体不随 Skill 分发，字体也不作为初始化阻断项。Word 文档会写入公文常用字体名称；如打开端缺少对应字体，Word/WPS 可能自动替换，需以本机打开后的显示为准。

当前版本不内置 PDF 生成或转换依赖。正式公文主交付物为 .docx；如用户需要 PDF，应使用 Word/WPS 打开 .docx 后另存或导出。

还需要 Node.js 18+ 用于调用 MaaS 注册接口：

node --version

首次启动初始化

调用本 Skill 后，Agent 应先运行 python3 scripts/initialize.py 检查 Python、python-docx、requests 等基础运行环境。只要 ready=true 即可开始写作。

API Key 按需配置：

  • 不涉及搜索的任务（简单通知、改写润色、只生成 Word 等）：不要求配置 API Key，可直接使用。
  • 需要搜索的任务（查政策依据、数据支撑、案例参考、最新政策情况）：此时若初始化结果显示 api_key_configured=false 或 search_ready=false，先引导用户完成 MaaS 注册获取 Key，并将 Key 写入环境变量 DKNOWC_API_KEY，再继续执行搜索。注册成功后，本次任务应使用脚本返回的 Key 临时注入当前运行环境继续初始化；后续新对话如仍检测不到 Key，应提示用户重启 WorkBuddy。

需要搜索时，注册并配置深知搜索 API Key

只有当前任务需要深知搜索（政策依据、数据支撑、案例参考，或查最新政策、最新情况）时才需要配置 API Key。配置 API Key 后，深知公文写作可调用深知可信搜索，从权威文件库中检索政策依据、权威数据和典型案例，检索结果附原文来源，便于写作时引用和核验。不涉及搜索的写作任务无需配置 Key，可直接使用。向用户介绍搜索能力时可参考 reference/search_intro.md 中的说明素材。

skills.sh 版默认使用：

  • 接入点 type=6，即深知可信搜索。
  • 渠道码 8C8D411C-6A46-4E99-887D-87D9A1329930。
  • 统一环境变量 DKNOWC_API_KEY 保存 API Key，由公文范文大纲接口和深知可信搜索接口共用。

当任务需要搜索且当前环境变量 DKNOWC_API_KEY 未配置时，进入 MaaS 注册。第 1 步，发送短信验证码：

node scripts/register.mjs send --phone 13812345678

返回 status=true 后，暂停并请用户提供收到的 6 位验证码。

第 2 步，注册并获取 API Key：

node scripts/register.mjs register --phone 13812345678 --vcode 123456 --organ 个人 --name 用户

注册第二步会固定携带 source="agent"，并继续使用 skills.sh 渠道码。手机号已注册时，默认查回该账号已有可用 API Key；手机号未注册时，按 MaaS 注册流程创建账号并获取 API Key。成功后，脚本会把 API Key 写入 ~/.zshrc 中的 DKNOWC_API_KEY 配置块，并返回 envName=DKNOWC_API_KEY、API Key 和写入状态。返回的完整 Key 仅供 Agent 当前任务临时注入环境变量使用，不得向用户展示完整 API Key，不得要求用户手动复制 Key。

默认不重新生成 API Key。只有用户明确要求重新生成或新建 Key 时，才追加 --new-key：

node scripts/register.mjs register --phone 13812345678 --vcode 123456 --organ 个人 --name 用户 --new-key

--new-key 会先查回已有可用 Key，再调用 MaaS API Key 创建接口生成新 Key，并仅把新 Key 写入 ~/.zshrc 中的环境变量 DKNOWC_API_KEY。如新 Key 创建失败，不会把旧 Key 当作新 Key 使用。

如自动注册链路失败，可降级引导用户访问 MaaS 管理平台：

https://platform.dknowc.cn/

搜索接口固定为：

https://open.dknowc.cn/dependable/search/

API Key 只能通过环境变量 DKNOWC_API_KEY 引入，不得硬编码，不得写入公开包。注册脚本可将 Key 写入本机 ~/.zshrc；写入后如后续新对话仍检测不到环境变量，需要重启 WorkBuddy。

版本说明

当前 skills.sh Public 版基于 3.4.0。

常用测试

语法检查：

python3 -m py_compile scripts/outline_reference.py scripts/dkag_search.py scripts/merge_search_results.py scripts/format_document.py scripts/template_generator.py scripts/initialize.py scripts/source_note_html.py scripts/render_trace_html.py scripts/review_document.py
node --check scripts/register.mjs

范文大纲生成：

python3 scripts/outline_reference.py "请写一份关于基层治理工作的调研报告，重点包括背景、做法、问题和建议。"

普通 Word 生成：

python3 scripts/format_document.py official-docs/input/dknowc-test.md --output dknowc-test.docx

红头 Word 生成：

python3 scripts/template_generator.py 通知 --input dknowc-test.docx --org "XX单位" --doc-number "XX〔2026〕1号" --output dknowc-test-red.docx

搜索结果保存：

python3 scripts/dkag_search.py "人才服务政策" --area 某省 --purpose "核查当地人才服务政策依据" --clean --output result_gd.json

多次搜索合并：

python3 scripts/merge_search_results.py result_gd.json result_bj.json --output merged.json

可信溯源报告 HTML：

python3 scripts/source_note_html.py official-docs/input/trace-report.json --output trace-report.html

Public 版说明

  • 本版本不内置 API Key。API Key 只对需要深知搜索的任务是前置条件；不涉及搜索的简单通知、改写润色、只生成 Word 等任务可直接使用。
  • 需要搜索时，用户可通过 Agent 调用 scripts/register.mjs，用手机号和验证码注册 MaaS 账号并获取统一 API Key。
  • 注册成功后，脚本会把 API Key 写入 ~/.zshrc 中的环境变量 DKNOWC_API_KEY，用户不需要查看或手动配置 Key。
  • 写入后当前任务可使用返回的 Key 临时注入环境变量继续执行；后续新对话如仍检测不到 Key，提示用户重启 WorkBuddy。
  • 公文范文大纲、深知搜索、素材分类、Word 生成、表格排版、HTML 可信溯源、红头 Word 和异常处理等功能逻辑与主干完整版一致。
  • 3.3.0 起将“素材来源说明”升级为“可信溯源报告”：报告包含完整正文、可点击来源角标、来源卡片和知识专库链接，便于核验正文依据。
  • 3.3.1 起 API Key 改为按需前置：搜索类任务需要 Key，纯写作任务无需配置即可使用；需要 Key 时会给用户说明搜索能力价值。
  • 3.3.2 起搜索能力价值说明统一外移到独立参考文件，供 Agent 按需引用；SKILL.md 主说明文档不再内置营销性话术。
  • 3.3.3 起搜索能力说明统一为客观功能描述，手机号验证引导改为中性表达，相关参考文件更名为 reference/search_intro.md。
  • 3.4.0 起文种标准文件统一改为英文命名，避免中文文件名在部分环境引起路径错乱；新增决定/决议/命令/公报/议案、说明/申请/公示/采购公告、方案/总结/讲话稿/制度/调研/可研/审查/AI 算力等 17 个文种标准文件；新增 reference/fact_discipline.md 事实克制规则、reference/anti_ai_patterns.md 反 AI 味检查规则和 scripts/prose_lint.py 语言质检脚本；SKILL.md 按参考资料表渐进式加载重构。
  • 如搜索失败或提示 API Key 未配置，请重新执行注册流程或检查环境变量 DKNOWC_API_KEY 是否存在且有效。