通用 Agent Skill，用于根据《决算编制摘要》自动生成《竣工决算报告》Word 文档。
这个版本采用“标蓝模板定点填充”模式：
- 只读取一份摘要 Markdown 或 TXT
- 只修改模板中的蓝色内容
- 黑色正文永久锁定，不做自由改写
- 附表保持模板原样，不再自动填表
- 模板资源内置在 skill 中，方便在 Codex、Claude Code 等 agent 环境直接分发和复用
传统“整段生成 + 多表联动 + 自由改写正文”的方式，在真实项目里容易出现这些问题：
- 语序漂移，和模板行文不一致
- 黑色固定内容被误改
- 附表注入导致版式和样式污染
- 项目类型稍有变化就需要大量人工返工
这个 skill 的目标不是一次性做到“完美自动化”，而是先稳定产出一份可用的蓝字初稿，让人工修改成本明显下降，并为后续迭代留下清晰边界。
输入一份《决算编制摘要》后，skill 会：
- 提取项目名称、金额、日期、参建单位、审价信息、付款信息等事实
- 读取内置的标蓝版报告模板
- 只重写蓝色 run，对应蓝字槽位定点填充
- 在缺值时保留原占位语义并追加
（未找到） - 输出报告、事实 JSON、字段来源追踪、缺失信息清单、模板资产说明
这个 skill 设计成通用文件型 skill，可在支持本地文件读写和命令执行的 agent 中使用，包括但不限于：
- Codex
- Claude Code
- 其他兼容
SKILL.md工作流的本地 agent
只需要一份摘要文件：
*.md*.txt
摘要应尽量使用当前的新格式《决算编制摘要》，因为金额汇总、多标段展开和字段来源追踪都依赖该结构。
运行后会生成以下文件：
竣工决算报告-<项目名>.docx事实提取-<项目名>.json字段来源追踪-<项目名>.json缺失信息清单-<项目名>.md模板资产说明.json
模板中的蓝色内容是唯一允许自动改写的区域。
- 黑色内容视为模板真值
- 黑色编号标题不复制、不重排
- 封面和正文中的固定黑字不做自由生成
附表完全保留模板原样：
- 不复制 Excel 表
- 不把表格注入 Word
- 不清空模板中的附表结构
- 不改附表中的黑字占位
当摘要中缺少某个蓝字槽位需要的事实时，skill 不会硬写红字提示，也不会删除占位语义，而是输出为：
【原占位符】（未找到）
整段新增内容仍保持蓝色，方便人工继续修改。
多标段施工时：
- 不复制黑色标题
- 在现有“施工单位”标题下按标段追加蓝色段落
- 在现有“预结算情况”标题下按标段追加蓝色段落
- 单标段时清空作者备注
- 多标段时把作者备注替换成正式蓝字提示
以下分支不再自动改写正文结构：
代建直接发包
遇到这两类情况时，skill 只会在事实追踪和缺失信息里标记，正文结构由人工后续处理。
仓库内置了以下模板资源：
assets/决算报告参考模板（标蓝版）.docassets/空白竣工决算报告模板.docxassets/template-fingerprint.json
这意味着：
- skill 自带原始标蓝模板
- skill 也自带预构建的空白 docx 模板
- 如果目标环境没有安装 Word，也通常可以直接使用现成的 docx 模板运行
- 当模板指纹不匹配或缺少资产时，脚本会尝试重新构建模板
推荐环境：
- Windows
- Python 3.11+
python-docxpywin32openpyxlxlrd
模板重建依赖以下任一条件：
- Microsoft Word COM
- LibreOffice /
soffice
如果仓库中已保留构建好的 空白竣工决算报告模板.docx，常规生成流程通常不需要重新转换 .doc 模板。
python scripts/fill_completion_report.py `
-SummaryPath "D:\path\to\决算编制摘要.md" `
-OutputPath "D:\path\to\output"可选日期参数：
python scripts/fill_completion_report.py `
-SummaryPath "D:\path\to\决算编制摘要.md" `
-OutputPath "D:\path\to\output" `
-CurrentDate "2026-04-13"python scripts/build_template.pypython -m pytest tests -qpython scripts/run_regression.pyassets/
决算报告参考模板（标蓝版）.doc
空白竣工决算报告模板.docx
template-fingerprint.json
references/
scripts/
tests/
SKILL.md
README.md
如果你要把这个仓库接入自己的 agent：
- 把
SKILL.md放到 agent 的技能发现目录 - 保持 skill 根目录结构不变
- 让 agent 通过
python scripts/fill_completion_report.py调用 - 不要把模板拆到外部绝对路径，仓库已内置模板
- 当前版本优先追求“稳定可用”，不是“全自动完稿”
- 黑字内容不会根据摘要自动纠偏
代建与直接发包不支持自动分支改写- 摘要缺值时仍需要人工补改
- 多标段识别依赖摘要中的当前结构和出现顺序
GitHub About 可使用这段描述：
Generic agent skill for generating Chinese completion/final-account reports from settlement summaries with a bundled blue-template locked-fill workflow.