Agent 设计规范
当前维护入口:
- 项目文件治理规则:规定唯一源、目录边界、同步矩阵、验证和历史治理。
- 业务适配登记表:跨会话定位每个业务的输入、ERP、Skill 入口和状态。
- 业务行为识别注册表:仅负责业务行为到内部 Skill/action 的路由映射。
- 运营业务 AI 输入模板总表:业务人员可直接复制的“模板 + 示例”双段式输入目录;模板首行是业务指令,后续逐行业务字段。
- 业务适配模板:新增业务的一页式交接模板。
- AgentBus 用户回复契约:执行完成后的受理通知、成功回执、失败回传和文件交付边界。
- 确定性业务路由注册表:手工与 AgentBus 共用的 18 项程序解析路由、兼容指令、唯一完整字段签名、必填项、类型、action、对象类型和版本的唯一机器源。
第一个已真实验证的参考业务是独立团批量下单。
本目录集中管理云端 Agent 数字员工的业务行为路由、生命周期业务 Skill 和业务契约参考。
目录
agent-prompt.md:云端 Agent 的业务识别、字段提取和标准 JSON 返回提示词。business-behavior-registry.md:维护人员使用的业务行为与内部实现映射参考,不直接作为云端 Agent Prompt 内容。templates/business-input-templates.md:当前 18 项运营输入的统一契约;每项都有相邻的模板和示例,按“最小必填 + 其余选填”区分字段。独立团信息修改和安排变更归入修改类;暂缓需求与测试删除不进入当前生产用户入口。skills/lwlt-newbooking/SKILL.md:解析独立团批量/单个下单、散拼母团计划和散拼具体子单输入。skills/lwlt-updating/SKILL.md:解析三类修改输入中的全部用户明确业务目标;插件按已验证能力自动执行或转人工复核。skills/lwlt-arrangement/SKILL.md:解析五类新增安排和酒店离店日/房间数变更输入。skills/lwlt-lifecycle/SKILL.md:维护独立团/散拼子单名单、取消和恢复契约;名单运行时固定走 Program Parser + Excel 附件规范化,不编排完整生命周期。skills/lwlt-confirmation/SKILL.md:解析导出团队文件的客户/日期检索字段、可选单号、文件类型和接机牌游客姓名,并区分独立团/子单游客名单与散拼母团整团游客信息。test-fixtures/:宿主输入、示例和回归夹具;只供维护与测试使用,不进入运行时.skill包。../control-plane/src/business-routes.ts与program-parser.ts:业务系统确定性解析的机器路由与编译器;测试强制核对本目录的运营模板和业务登记表。
边界
云端 Agent Prompt 及对应 Skill 与业务系统确定性解析器通常是并列的解析实现,均只输出解析态 operation。两项名单 route 是明确例外:固定走 Program Parser,原始 Excel 先由控制面程序规范化,不进入 AI Prompt。两类解析共享最终契约,不查询业务对象,不读取当前值,不生成内部引用,也不描述任务如何执行。控制面在任务创建时固化解析策略;后续执行层负责对象解析、候选匹配和实际操作。本目录不负责调用或操作业务系统。
运行时 Skill 包只保留 SKILL.md、必要的 agents/openai.yaml 和按需加载的业务 references;宿主接入说明、示例和维护路线放在 test-fixtures/ 或维护文档中。
输出事实标准
对应 Skill 生成 agent_parse_passed/agent_parse_needs_input/agent_parse_blocked 包装和解析态 operation。agent_parse_needs_input 表示等待用户补充,且 operation 必须为 null;agent_parse_passed 只表示业务输入已经完整结构化,不表示对象已匹配、任务已执行或结果已完成。解析态契约见 schemas/agent_operation.schema.json,执行态安全契约继续独立维护在 schemas/standard_system_operation.schema.json。