用途:本 Skill 是企业码单场景接入的方案编排器,每次只接入一个费用场景,负责场景决策、分域编排、跨域聚合和最终校验。每次只允许一个场景;用户一次提出多个场景时需先选择其一。
主要能力:
- 方案设计:输出场景决策、模式、模块、接口清单、规则配置和验证要点,不生成代码。
- 代码生成:场景与方案范围明确后生成或修改代码,并执行 SDK 预检、分域生成和工程校验。
- 依赖三个基础子 Skill:alipay-enterprise-ec(入驻、签约、管理)、alipay-enterprise-expense-control(制度、额度、外部费控 SPI)、alipay-enterprise-bill(账单、订单、对账)。
- 可选子 Skill:alipay-enterprise-invoice(企业抬头、开票规则等),仅地铁场景明确选择时启用。
使用方式: 读取 reference、执行场景识别或区分方案设计与代码生成前,必须先执行: node alipay-enterprise-scenario-integration/tools/install_subskills.js 该脚本将缺失子 Skill 安装到当前用户 Skills 根目录下的平级 Skill,优先使用 --skills-root 或 ALIPAY_SKILLS_ROOT。失败时必须停止并请求用户授权,不得手工解压。地铁场景若接入发票,通过 tools/install_subskills.js --with alipay-enterprise-invoice 安装。若支持访问 GitHub,可执行 tools/check_version.js 检查版本,但不得自动下载或覆盖。
代码生成前必须生成 <项目>/.alipay-skill/scenario.json,且不得保留 NEEDS_USER_CONFIRM;需先读取多 Agent 编排规则、项目衔接契约和主方案聚合质量门禁,完成预检并建立接口证据表。生成后必须执行主校验: node alipay-enterprise-scenario-integration/scripts/validate_codegen.js <生成项目目录>
默认范围:员企、费控、账单三域基础模块,费控不默认内部或外部(无法推断时须询问),账单默认推模式,消息通道按上游方案、用户指定、存量入口、新项目默认的优先级决策。
限制:代码生成必须证据驱动,不得按业务语义猜测字段、类名或方法名;文档找不到的费用类型、子类或规则因子不得自行补成 DEFAULT;未启用的可选扩展不得安装、读取、生成或校验。版本检查失败不阻断接入流程,但子 Skill 安装失败须停止。