linhut/document-ai-assistant/skill

gongwen-optimizer（公文优化 Skill）

本项目为「AI 公文智能优化助手」的 Agent 可调用发行版。它把文档处理引擎打包成 可供 Claude Code / Codex / OpenCode / Kimi / Trae / ZCode 等 Agent 直接调用的 Skill： 克隆仓库即用，不依赖桌面端与数据库。

能力范围

快速开始（命令行）

要求：Python 3.12+，安装依赖 pip install -r backend/requirements.txt。

# 从仓库根目录执行
python backend/wfp_cli.py check 输入.docx --doc-type notice
python backend/wfp_cli.py format 输入.docx --doc-type notice -o 输出.docx
python backend/wfp_cli.py optimize 输入.docx --doc-type notice -o 优化.docx --apply-fixes

常用参数：

• --doc-type：notice/report/request/meeting/decision/letter 等 22 种文种
• --apply-fixes：同时应用修复规则（默认关闭，仅检查）
• --selected-rules：只应用指定规则 ID（逗号分隔）

规则体系（证据链）

• 规则文件：rules/official/*.yaml（公共基础层 _common.yaml + 各文种层，三级优先级官方 < 自定义 < 用户）
• 每条检查规则关联 GB/T 9704-2012 条款（standard_ref），证据矩阵见 docs/gbt9704-audit-matrix.md
• 语义校验规则见 backend/core/rules/semantic.py

重要约定

1. 生成/修改文档必须通过 backend/core/document/modifier.py（单一变更点），勿直接改模型。
2. 中文字体必须走 backend/core/document/font_utils.py 的 set_run_font()（同时设置 ascii/hAnsi/eastAsia/cs 四属性）。
3. 标准字体：标题=方正小标宋简体、正文=仿宋_GB2312、西文=Times New Roman；目标机缺字体时生成器会警告。
4. 检查结果中的 standard_ref 为 GB/T 9704-2012 条款号，供审计与人工复核。

安装到各 Agent 平台

bash skill/scripts/install.sh --all          # macOS / Linux（符号链接，源目录只维护一份）
powershell -File skill/scripts/install.ps1 -All   # Windows（复制，避免符号链接权限问题）

支持的平台目录（随版本可能变化，可用环境变量 SKILL_DIRS 覆盖）： Claude Code、Codex、OpenCode、Trae Code、Kimi Code、ZCode、TraeWork、WorkBuddy、Cursor。

许可

MIT。字体文件（方正小标宋简等）按其各自授权使用。