alipay-enterprise-scenario-integration

name	alipay-enterprise-scenario-integration
description	支付宝企业码单场景接入标准方案 Skill。当用户希望接入企业码餐饮、地铁、公交、用车、酒店、商城、生活服务、票务、加油、医疗或其他文档已定义费用场景，或提出“企业码场景接入”“企业码标准方案”“按费用场景接入”等需求时必须使用。负责识别或确认单一业务场景，编排员企、费控、账单三个子 Skill，按需启用引用文档定义的可选扩展，输出方案或生成接入代码。

支付宝企业码场景接入标准方案 Skill

定位

本 Skill 是企业码单场景接入的方案编排器：每次只接入一个费用场景，负责场景决策、三域编排、跨域聚合和最终校验。底层接口字段和领域规则由三个同级子 Skill 提供：

• alipay-enterprise-ec：企业入驻、员工签约、企业和员工管理
• alipay-enterprise-expense-control：制度、额度及外部费控 SPI
• alipay-enterprise-bill：账单、订单和对账

任务形态

• 方案设计：输出场景决策、模式、模块、接口清单、规则配置和验证要点，不生成代码。
• 代码生成：场景和方案范围明确后生成或修改代码，并执行 SDK 预检、分域生成和工程校验。

必读索引

• 场景接入指南：方案设计和场景准备参考，不是完整代码生成流程
• 场景决策规则：费用类型、子类、因公场景、规则因子和因公优先 opt-in 状态
• 多 Agent 代码生成编排规则：代码生成前必须读取，决定分域生成、子 Skill 加载和汇合验收
• 项目判断与已有项目衔接契约：代码生成前读取，用于自动判断新工程/已有项目和已有项目增量接入
• 主方案聚合质量门禁：代码生成前必须读取，决定 SDK 预检、完成交付和主聚合校验

依赖闸门

如果运行环境支持访问 GitHub，可在开始前执行 tools/check_version.js 检查本地 Skill 是否落后。发现新版本时只提示用户更新，不得自动下载或覆盖本地 Skill；网络不可用或检查失败时不阻断接入流程。

读取任何 reference、执行场景识别或区分方案设计与代码生成之前，必须先执行：

node alipay-enterprise-scenario-integration/tools/install_subskills.js

方案设计和代码生成都依赖该安装步骤。脚本会把缺失的 subskills/*.zip 安装为本方案 Skill 平级的独立 Skill 目录，例如 <skillsRoot>/alipay-enterprise-ec/，并验证三个基础子 Skill。失败时必须停止并请求用户授权或修复环境；不得在子 Skill 不完整时猜测场景。

可选扩展不属于默认依赖。只有引用文档明确确认扩展启用时，才通过 tools/install_subskills.js --with <extension-id> 安装对应 Skill；未启用时不得安装、读取、询问、生成或校验扩展。不得手工 unzip subskills/*.zip -d <skillsRoot>，所有子 Skill 和扩展都必须安装为 <skillsRoot>/<skillName>/。

场景闸门

1. 每次只允许一个场景。用户一次提出多个场景时，必须让用户选择本次先接入哪一个。
2. 用户明确费用类型、费用子类和因公场景时直接沿用，并按文档校验合法性；未明确因公场景时按场景决策规则使用默认值。
3. 上下文可唯一推断时，展示推断结果后继续，不重复询问。
4. 存在多个合法选择，或必用规则因子缺少业务值时，必须询问用户。示例：地铁必须确认城市或具体 CARD_TYPE。
5. 文档找不到的费用类型、费用子类、规则因子或业务值不得自行补成 DEFAULT；因公场景仅按默认策略取“默认”或票务类“差旅”。
6. 因公优先不是默认待确认项；用户没有明确提出“因公优先/企业码优先/因公支付优先”时，不得询问是否启用，不得把“启用/不启用”放入确认选项，直接写入关闭状态。
7. 代码生成前必须生成 <项目>/.alipay-skill/scenario.json，且不得保留 NEEDS_USER_CONFIRM。
8. 可选扩展不是默认待确认项；用户没有明确提出某项扩展能力时，不得询问是否接入，不得写入扩展决策字段，不得读取扩展 Skill。用户明确提出后，按 场景决策规则 判断适用场景、启用条件和覆盖范围。

默认范围

默认采用企业码标准方案的三域基础模块：

能力域	必选模块	按需模块
员企	企业入驻、员工签约、员工管理、企业管理	部门、核算主体、企业地址、企业消息任务
费控	制度管理	手工发放、额度管理
账单	账单管理	订单同步、对账单下载

• 员企默认邀请企业注册、邀请员工签约。
• 费控不默认内部或外部；无法从上下文推断时必须询问。
• 账单默认推模式。
• Java 默认 WebSocket；非 Java 默认 HTTP(S)，除非用户环境和文档明确支持其他方式。
• 用户只选择基础模块时，不得读取或实现未选择的扩展模块。
• 可选扩展的接入方式、预检和本域 validator 由对应引用文档定义；未启用时不得执行扩展预检或扩展校验。

执行阶段

1. 依赖准备：安装并验证三个子 Skill。
2. 场景决策：读取指南、决策规则和必要枚举文档，确认单一场景。
3. 项目判断：按项目判断与衔接契约规则先自动判断新工程或已有项目；只有目录不可访问、证据冲突或上下文无法推断时才询问。新工程直接规划；已有项目先盘点、输出增量计划和衔接契约，等待用户确认。
4. 代码生成准备：读取多 Agent 编排规则和主方案聚合质量门禁，完成 SDK 或 HTTP(S) 预检，并建立接口证据表。
5. 分域生成：优先启动员企、费控、账单子 Agent，显式加载对应子 Skill；未完成启动或降级确认、未输出本域接口证据前，不得生成接口调用代码。
6. 可选扩展：仅当场景决策已确认启用某项扩展时，按对应引用文档加载扩展 Skill 并生成扩展链路；未启用时该阶段必须跳过且保持静默。
7. 聚合收口：所有子 Agent 返回最终回执后，主 Agent 统一处理公共配置、消息入口和主聚合校验。

证据闸门

代码生成必须证据驱动，不能按业务语义猜字段、类名或方法名。每个子域开始生成接口调用代码前，必须输出本域接口证据表，至少包含：接口方法名、已读取的接口 Markdown、示例代码位置或片段、SDK/接入方式确认结果、Request/Model/Response 或 HTTP 字段来源、关键字段路径。任一接口缺少证据时只能继续查文档或暂停说明，不能先生成再靠编译、反射或 validator 补救。

启用可选扩展时，还必须按扩展引用文档输出扩展接口证据表，覆盖该扩展的接入方式、关键字段来源、状态流转和本域 validator 结果；不得套用不适用的 SDK、协议模型或字段结构。

生成后校验

代码生成完成后必须执行官方主校验；退出码语义、SDK 预检来源和完成状态要求见 主方案聚合质量门禁。

node alipay-enterprise-scenario-integration/scripts/validate_codegen.js <生成项目目录>