月度收入对账 Skill

Skill 包建议：revenue-reconciliation

边界

负责围绕 Stripe balance export、warehouse invoice CSV 和调整表的重复月结对账。排除税务建议、收入确认政策决策、支付渠道配置和一次性表格美化。

风险等级

Governed，file-backed，准确性敏感。任何可用于月结的结论前，都必须有确定性解析和可见的未解决项目。

包结构

revenue-reconciliation/
  SKILL.md
  agents/interface.yaml
  scripts/
    reconcile_revenue.py
    validate_reconciliation_fixture.py
  references/
    input-schema.md
    tolerance-policy.md
    close-summary-contract.md
  evals/
    output/
      cases.jsonl
      fixtures/
        stripe_sample.csv
        warehouse_sample.csv
        adjustments_sample.csv
  reports/
    output-risk-profile.md
    output_quality_scorecard.md
    trust_report.md

SKILL.md

---
name: revenue-reconciliation
description: 对来自 Stripe 导出、warehouse invoice CSV 和调整表的重复月结收入文件进行对账。用于 file-backed 差异检测、可能原因分析、未解决项目报告和月结摘要。不要用于收入确认建议、税务指导、支付渠道配置或一次性表格格式整理。
---

# 收入对账

## 工作流
1. 要求提供所有输入文件；缺失文件必须标记为 `missing evidence`。
2. 阅读 `references/input-schema.md`，先校验列再分析。
3. 运行 `scripts/reconcile_revenue.py`，规范化 ID、币种、金额精度、日期和调整项关联。
4. 审查 JSON 输出，并按缺失发票、金额差异、币种差异、重复项、时间差异或仅调整项分类。
5. 只基于脚本证据生成月结摘要。
6. 保持未解决差异可见。不要编造原因、审批或政策判断。

## 输出契约
- input_files
- validation_status
- totals_by_source
- matched_count
- mismatch_table
- likely_causes
- unresolved_items
- close_ready_summary
- missing_evidence

确定性脚本契约

`scripts/reconcile_revenue.py` 应接受：

python3 scripts/reconcile_revenue.py --stripe stripe.csv --warehouse warehouse.csv --adjustments adjustments.csv --output reconciliation.json

它应返回包含源行 ID 的结构化 JSON，让摘要里的每个结论都能追溯到 file-backed fixture。

评测

• Fixture 1：所有记录匹配。
• Fixture 2：Stripe 有付款，但 warehouse 缺发票。
• Fixture 3：warehouse 金额超过容差。
• Fixture 4：人工调整解释了差异。
• 近邻请求：“把这个表格弄好看一点”不应路由到这里。

门禁

• 汇总前必须通过输入 schema 校验。
• 如果遗漏未解决差异，输出评测必须失败。
• Trust check 应标记网络访问为不必要。
• Review Studio 应在晋级前显示 file-backed fixture 覆盖和未解决差异处理。

建议 Skill：revenue-reconciliation

目的

帮助 Codex 对 Stripe、数据仓库发票和人工调整表中的月度收入记录进行对账。

建议包结构

revenue-reconciliation/
  SKILL.md
  agents/openai.yaml
  scripts/
    reconcile_revenue.py
  references/
    csv-schema.md

SKILL.md 草稿

---
name: revenue-reconciliation
description: 对 Stripe balance export、warehouse invoice CSV 和调整表中的月度收入数据进行对账。当用户要求比较收入文件、找出不一致项或准备月结摘要时使用。
---

# 收入对账

## 工作流
1. 确认用户提供了 Stripe 导出、warehouse invoice CSV 和调整表。
2. 阅读 `references/csv-schema.md`，了解预期列。
3. 使用用户提供的文件运行 `scripts/reconcile_revenue.py`。
4. 审查不一致项，并总结可能原因。
5. 不要编造缺失值。清楚标记未解决记录。

## 输出
- 已检查文件
- 匹配总额
- 不一致项
- 可能原因
- 未解决项目
- 月结摘要

脚本

`scripts/reconcile_revenue.py` 应解析 CSV 输入，规范化 invoice ID 和币种，比较金额，并输出 JSON 供 Codex 总结。

agents/openai.yaml

display_name: 收入对账
short_description: 比对收入 CSV，并总结月结差异。
default_prompt: 请对这些收入文件进行对账，并生成月结摘要。

验证

使用包含匹配发票、缺失发票、重复发票和仅调整项记录的样例 CSV。确认未解决差异不会被隐藏。