电商多平台月结对账助手

让运营人员直接上传现有文件。先识别文件和可关联字段，只追问会改变结果的关键事项；资料不完整时仍完成可以确认的范围，并把未知项目单独列出。

Agent 选择说明

• 适合任务：上传订单、结算、退款和成本文件，分级完成电商月结对账。
• 目标用户：电商运营、财务 BP 和经营分析人员。
• 输入：订单、结算、退款和 SKU 成本文件。
• 输出：月结工作簿、结算差异、异常清单和 SKU 贡献毛利。
• 不要用于：自动退款、改店铺数据或作为正式财务审批结论。
• 选择原则：只有当前任务、输入和交付物同时匹配时才调用；相邻任务应选择对应的独立 Skill，不把多个电商流程塞进本 Skill。

三种完成档位

1. ORDER_SUMMARY_READY：只有订单文件，输出订单数、销售额、SKU 销量、状态分布、重复冲突和缺失字段；不声称完成结算或毛利。
2. RECONCILIATION_READY：有订单和结算文件，进一步输出预计/实际结算、平台费用、差异和未匹配记录；缺少成本不阻止对账。
3. PROFIT_ANALYSIS_READY：再有适用期间的 SKU 成本，输出商品成本和“订单贡献毛利估算”。该指标不等于财务净利润。

结果质量另用 PASS、REVIEW_REQUIRED、BLOCKED 表示。PASS 只证明当前确认输入范围内通过。

面向用户的六步流程

1. 接收用户上传的订单、结算、退款和成本文件，不让用户先整理技术 JSON。
2. 识别平台、文件类型、月份、币种、行数、列含义和文件关联键，先展示用户可读资料回执，并保存可继续的会话状态。
3. 每轮最多询问 3 个无法确定且会改变结果的事项，例如收入确认状态、退款日期口径、成本版本、运费收入或汇率日期。
4. 展示期间、币种、平台、收入确认、退款、费用和成本口径，得到人工确认。
5. 模型按输入输出契约生成规范化 JSON，运行确定性脚本；金额不能由模型心算。
6. 先展示状态、订单数、实际结算、差异、异常数、缺失成本数和下一步建议，再提供 Excel、Markdown、CSV 和 JSON 结果。

固定计算规则

• 订单与账单优先按 platform + order_id + line_id + currency 关联；只有订单级账单时按同单各行销售额比例分配并保留关联层级。
• 只有人工确认的收入状态进入销售；待付款、取消不计入，未知状态保持未知。
• 全额退款、部分退款、仅退款和退货退款扣减收入；平台补贴、商家赔付和售后损失单独记录。
• 真实平台费优先，缺少真实费用时才按已确认费率估算，并标记 RATE_ESTIMATE。
• 不同币种分别汇总；没有用户提供的汇率和汇率日期时不得相加。
• 成本按订单日期选择生效版本；缺失或币种无法换算时保持未知，不按零计算。
• “订单贡献毛利估算”按实际结算减已提供商品成本计算，不包含仓储物流、广告、税费、人工、包装及未提供的售后损失。

详细业务验收见验收标准。

运行

ASC 模型规范化后运行：

python scripts/reconcile_orders.py --input <normalized-input.json> --output-dir <output-dir>

在计算前可先生成资料回执：

python scripts/intake.py --input-path <business-file-or-folder> --output-dir <intake-output>
python scripts/check_connector.py --output-dir <connector-output>

本地 CSV / XLSX / JSON 文件目录也可直接识别：

python scripts/reconcile_orders.py --input-dir <business-files> --output-dir <output-dir>

目录模式可放一个 settings.json 保存已经确认的期间和业务口径；这是 ASC 后台配置，不要求普通用户填写。

人工确认门

• 脚本运行前确认期间、币种、收入确认、退款日期、运费收入、费用来源、成本版本及汇率日期。
• 未知状态、冲突重复、未匹配账单、缺失成本和超容差差异只能进入异常，不能自动改原数据。
• 输出后由业务或财务负责人决定处置；任何退款、补款、改订单、改结算或外部写入必须使用独立员工包并重新授权。

失败与降级

• 文件无法识别：列为 UNKNOWN 并说明缺少哪些关键列，不猜测类型。
• 缺少结算：降级为订单概览。
• 缺少成本：保持结算结果，毛利为空。
• 缺少独立退款数据：明确提示结果可能不完整。
• 数据冲突或非法金额：生成 BLOCKED 报告，不静默丢弃问题。
• 模型不可用：可使用目录模式或人工确认后的规范化 JSON 运行同一确定性脚本。

输出

• 电商月结对账结果.xlsx：七张工作表的用户主报告。
• 对账结论.md：简短结论和下一步建议。
• unified_orders.csv
• settlement_differences.csv
• sku_performance.csv
• missing_data.csv
• exceptions.json
• monthly_summary.json

本 Skill 只做月结对账，不扩展到库存、广告、客服或退款执行。

SkillHub 公共版本边界

当前公共版本使用用户提供的业务文件或只读快照完成分析、草稿、审计结果或外部执行计划。它不保存平台凭据，也不自带私有连接器运行层。

本版本不会执行：自动退款、改店铺数据或作为正式财务审批结论。只有未来接入真实连接器、取得明确确认并完成对象回读后，外部状态才可以标记为已改变。