# 月度收入对账 Skill - Skill 盲测评审

## 场景

一个财务运营团队每个月结账前都要比对 Stripe 导出、数据仓库发票 CSV 和人工调整表，找出金额、币种、发票和调整项的不一致。

### 用户请求

请创建一个用于月度收入对账的可复用 skill。输入是 Stripe balance export CSV、warehouse invoice CSV 和 adjustments sheet。输出需要标出不一致项、解释可能原因，并生成可用于月结的摘要。准确性比速度更重要。

### 评审标准

1. 是否识别出这是 file-backed 且准确性敏感的任务。
2. 是否定义了确定性脚本和资源边界。
3. 是否说明输入/输出 schema 与对账容差。
4. 是否包含 fixture 和失败用例验证。
5. 是否避免编造财务事实或隐藏未解决差异。

## 方案 A

来源已隐藏

## 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 覆盖和未解决差异处理。

## 方案 B

来源已隐藏

## 建议 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。确认未解决差异不会被隐藏。

## 你的判断

只根据评审标准和页面里可见的两个输出做判断。选择会保存到当前浏览器的本地存储里，也可以回到入口页导出。

方案 A 更好 方案 B 更好 平局 / 没有明显胜出
信心程度
理由