| name | alipay-enterprise-scenario-integration |
| description | 支付宝企业码单场景接入标准方案 Skill。当用户希望接入企业码餐饮、地铁、公交、用车、酒店、商城、生活服务、票务、加油、医疗或其他文档已定义费用场景，或提出“企业码场景接入”“企业码标准方案”“按费用场景接入”等需求时必须使用。负责识别或确认单一业务场景，编排员企、费控、账单三个子 Skill，按需启用引用文档定义的可选扩展，输出方案或生成接入代码。 |
支付宝企业码场景接入标准方案 Skill
定位
本 Skill 是企业码单场景接入的方案编排器：每次只接入一个费用场景，负责场景决策、三域编排、跨域聚合和最终校验。底层接口字段和领域规则由三个同级子 Skill 提供：
alipay-enterprise-ec：企业入驻、员工签约、企业和员工管理alipay-enterprise-expense-control：制度、额度及外部费控 SPIalipay-enterprise-bill：账单、订单和对账
任务形态
- 方案设计：输出场景决策、模式、模块、接口清单、规则配置和验证要点，不生成代码。
- 代码生成：场景和方案范围明确后生成或修改代码，并执行 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>/。
场景闸门
- 每次只允许一个场景。用户一次提出多个场景时，必须让用户选择本次先接入哪一个。
- 用户明确费用类型、费用子类和因公场景时直接沿用，并按文档校验合法性；未明确因公场景时按场景决策规则使用默认值。
- 上下文可唯一推断时，展示推断结果后继续，不重复询问。
- 存在多个合法选择，或必用规则因子缺少业务值时，必须询问用户。示例：地铁必须确认城市或具体
CARD_TYPE。
- 文档找不到的费用类型、费用子类、规则因子或业务值不得自行补成
DEFAULT；因公场景仅按默认策略取“默认”或票务类“差旅”。
- 因公优先不是默认待确认项；用户没有明确提出“因公优先/企业码优先/因公支付优先”时，不得询问是否启用，不得把“启用/不启用”放入确认选项，直接写入关闭状态。
- 代码生成前必须生成
<项目>/.alipay-skill/scenario.json，且不得保留 NEEDS_USER_CONFIRM。
- 可选扩展不是默认待确认项；用户没有明确提出某项扩展能力时，不得询问是否接入，不得写入扩展决策字段，不得读取扩展 Skill。用户明确提出后，按 场景决策规则 判断适用场景、启用条件和覆盖范围。
默认范围
默认采用企业码标准方案的三域基础模块：
| 能力域 | 必选模块 | 按需模块 |
|---|
| 员企 | 企业入驻、员工签约、员工管理、企业管理 | 部门、核算主体、企业地址、企业消息任务 |
| 费控 | 制度管理 | 手工发放、额度管理 |
| 账单 | 账单管理 | 订单同步、对账单下载 |
- 员企默认邀请企业注册、邀请员工签约。
- 费控不默认内部或外部；无法从上下文推断时必须询问。
- 账单默认推模式。
- Java 默认 WebSocket；非 Java 默认 HTTP(S)，除非用户环境和文档明确支持其他方式。
- 用户只选择基础模块时，不得读取或实现未选择的扩展模块。
- 可选扩展的接入方式、预检和本域 validator 由对应引用文档定义；未启用时不得执行扩展预检或扩展校验。
执行阶段
- 依赖准备：安装并验证三个子 Skill。
- 场景决策：读取指南、决策规则和必要枚举文档，确认单一场景。
- 项目判断：按项目判断与衔接契约规则先自动判断新工程或已有项目；只有目录不可访问、证据冲突或上下文无法推断时才询问。新工程直接规划；已有项目先盘点、输出增量计划和衔接契约，等待用户确认。
- 代码生成准备：读取多 Agent 编排规则和主方案聚合质量门禁，完成 SDK 或 HTTP(S) 预检，并建立接口证据表。
- 分域生成：优先启动员企、费控、账单子 Agent，显式加载对应子 Skill；未完成启动或降级确认、未输出本域接口证据前，不得生成接口调用代码。
- 可选扩展：仅当场景决策已确认启用某项扩展时，按对应引用文档加载扩展 Skill 并生成扩展链路；未启用时该阶段必须跳过且保持静默。
- 聚合收口：所有子 Agent 返回最终回执后，主 Agent 统一处理公共配置、消息入口和主聚合校验。
证据闸门
代码生成必须证据驱动，不能按业务语义猜字段、类名或方法名。每个子域开始生成接口调用代码前，必须输出本域接口证据表，至少包含：接口方法名、已读取的接口 Markdown、示例代码位置或片段、SDK/接入方式确认结果、Request/Model/Response 或 HTTP 字段来源、关键字段路径。任一接口缺少证据时只能继续查文档或暂停说明，不能先生成再靠编译、反射或 validator 补救。
启用可选扩展时，还必须按扩展引用文档输出扩展接口证据表，覆盖该扩展的接入方式、关键字段来源、状态流转和本域 validator 结果；不得套用不适用的 SDK、协议模型或字段结构。
生成后校验
代码生成完成后必须执行官方主校验；退出码语义、SDK 预检来源和完成状态要求见 主方案聚合质量门禁。
node alipay-enterprise-scenario-integration/scripts/validate_codegen.js <生成项目目录>
