这是一个面向 Windows、本地 agent 工作流和 GitHub 公开协作的决算报表仓库。它基于一份《决算编制摘要》统一生成 7 张决算表和 1 份竣工决算报告，并把模板、夹具、回归、打包与统一编排代码一起公开出来。

这个仓库的目标不只是“能跑”，而是让后续的 Codex、Claude Code 或其他 agent 能快速理解：

• 哪一张表由哪个子 skill 负责
• 某个字段口径是从哪里取值
• 某个模板或单元格要去哪里改
• 修改后应该跑哪组回归
• 发布 ZIP 时哪些内容会被带出去

• 输入 1 份《决算编制摘要》Markdown 或 TXT
• 输出 7 个 .xlsx 正式表格
• 输出 1 个 .docx 正式报告
• 统一入口为 scripts/run_all.py
• 默认只保留正式产物
• 报告 sidecar 仅在 --keep-debug-artifacts 时保留
• 每个子 skill 仍保留原始模板、脚本、参考资料和回归夹具

1. 项目概况表（1-1）
2. 39.宝安区建设工程竣工决算申报表
3. 40.工程项目财务审计申报表
4. 41.财政拨款明细表
5. 43.宝安区建设工程财务决算收支明细表
6. 工程造价比较分析表（1-4）
7. 46.建设单位管理费明细表
8. 竣工决算报告-<项目名>.docx

这个版本是 direct-layout + orchestration：

• skills/ 下保留各子 skill 的独立目录和原始模板逻辑
• src/qibiao_v1/ 负责统一编排、产物协议、回归和适配器
• 顶层不重写各 skill 的业务内核，只在它们外层补统一入口

这样做的原因很明确：

• 先保证可运行、可验证、可打包、可公开
• 不把已验证规则在公开前再做高风险重构
• 让后续 agent 可以从“总入口层”和“单 skill 层”两边进入修改

.
├─ AGENTS.md
├─ ABOUT.md
├─ README.md
├─ docs/
├─ dist/
├─ scripts/
│  ├─ run_all.py
│  └─ build-release-zips.ps1
├─ skills/
│  ├─ 自动填写项目概况表V1.5/
│  ├─ 自动填写工程竣工决算申报表V1.2/
│  ├─ 自动填写审计决算申报表V1.0/
│  ├─ 自动填写收支明细表V1.0/
│  ├─ auto-fill-fiscal-appropriation-detail-v1/
│  ├─ auto-fill-cost-comparison-management-fee-v1/
│  └─ auto-fill-completion-report-skill/
├─ src/
│  └─ qibiao_v1/
└─ tests/

python .\scripts\run_all.py fill `
  --summary <摘要路径> `
  --current-date 2026-04-14

默认输出目录：

<摘要所在目录>\generated\<项目名>\

默认正式产物：

• 7 个 .xlsx
• 1 个 竣工决算报告-<项目名>.docx

python .\scripts\run_all.py fill `
  --summary <摘要路径> `
  --targets tables `
  --current-date 2026-04-14

python .\scripts\run_all.py fill `
  --summary <摘要路径> `
  --targets report `
  --current-date 2026-04-14

python .\scripts\run_all.py fill `
  --summary <摘要路径> `
  --targets overview completion audit appropriation revenue cost management

支持的 --targets：

• all
• tables
• report
• overview
• completion
• audit
• appropriation
• revenue
• cost
• management

python .\scripts\run_all.py fill `
  --summary <摘要路径> `
  --targets all `
  --keep-debug-artifacts

开启后会保留：

• 事实提取-<项目名>.json
• 字段来源追踪-<项目名>.json
• 缺失信息清单-<项目名>.md
• 模板资产说明.json

python .\scripts\run_all.py regression `
  --fixtures-root .\tests\integration\fixtures `
  --output-root .\tests\output\regression

统一回归包含两层：

• 7 张表按夹具答案做结构化精确对比
• 报告走总入口 smoke + 报告 skill 自带 regression

powershell -ExecutionPolicy Bypass -File .\scripts\build-release-zips.ps1

dist/ 中至少包含：

• 决算报表报告编制专家V1.0.zip
• auto-fill-completion-report-skill.zip
• 其余 6 个子 skill ZIP

先看这些文件：

• AGENTS.md
• ABOUT.md
• docs/01-仓库总览与快速上手.md
• docs/02-统一编排与运行机制.md
• docs/03-七表一报告总览.md
• docs/11-字段口径与修改导航.md

单表/报告详解：

• 项目概况表
• 竣工决算申报表
• 财务审计申报表
• 财政拨款明细表
• 收支明细表
• 造价比较表与管理费明细表
• 竣工决算报告

本仓库公开包含：

• 7 个子 skill 源码
• 7 张表模板
• 报告标蓝模板
• references 夹具与参考答案
• 顶层统一编排代码
• regression 测试
• dist/ 打包产物

本仓库明确不包含：

• web/
• package.json / package-lock.json
• 离线启动器
• 运行缓存、调试目录和无关临时文件

• 保留 direct-layout 结构
• 报告继续由摘要直接生成
• 本轮不做“由 7 张表反写报告正文”的耦合改造
• 子 skill 仍是主要业务规则载体，统一入口只负责编排和结果汇总

更详细的背景说明见 ABOUT.md。