110 lines
5.6 KiB
Markdown
110 lines
5.6 KiB
Markdown
---
|
||
name: ltjt-business-operation
|
||
description: Process in-scope LTJT business requests and return one canonical business-system operation; block out-of-scope, ambiguous, incomplete, or unsafe requests.
|
||
---
|
||
|
||
# LTJT Business Operation
|
||
|
||
这是 LTJT 业务请求的唯一 Skill 入口。它接收用户原始业务指令，识别一个业务类型，读取对应 reference，生成并校验业务系统需要的标准输出。
|
||
|
||
本 Skill 只生成业务任务结构，不打开 ERP、不调用浏览器或接口、不读取附件内容，也不声称业务已经执行完成。
|
||
|
||
`agent_parse_passed` 表示“业务系统可以创建任务”，不表示“ERP 已经具备提交条件”。团队订单的产品模板派生和下拉精确匹配属于后续 ERP 预检。
|
||
|
||
## 何时使用
|
||
|
||
仅处理以下七类业务：
|
||
|
||
| action | 业务类型 | reference |
|
||
|---|---|---|
|
||
| `team_order_create` | 团队单个下单 | [create-orders.md](references/create-orders.md) |
|
||
| `team_order_batch_create` | 团队批量下单 | [create-orders.md](references/create-orders.md) |
|
||
| `shared_plan_create` | 散拼母团计划 | [create-orders.md](references/create-orders.md) |
|
||
| `shared_child_order_create` | 散拼子单 | [create-orders.md](references/create-orders.md) |
|
||
| `order_update` | 已有订单修改 | [updates-and-travelers.md](references/updates-and-travelers.md) |
|
||
| `passenger_list_import` | 旅客名单导入或补充 | [updates-and-travelers.md](references/updates-and-travelers.md) |
|
||
| `confirmation_export` | 确认件导出或恢复 | [export-and-recovery.md](references/export-and-recovery.md) |
|
||
|
||
普通咨询、非 LTJT 业务、系统诊断、登录问题、任意接口调用请求均不属于本 Skill。
|
||
|
||
## 输入
|
||
|
||
优先接收：
|
||
|
||
```json
|
||
{
|
||
"raw_text": "用户原始业务指令",
|
||
"task_context": {}
|
||
}
|
||
```
|
||
|
||
如果调用方已经提供 `operation`，只校验并规范化它，不再重复解析。旧的 `erp-task-v1` 只作为兼容输入，不是标准输出。
|
||
|
||
## 宿主调用约定
|
||
|
||
宿主 Agent 可以用任意平台的 Skill 机制调用本 Skill，不依赖 `$skill` 语法、`agents/openai.yaml` 或特定工具名。调用参数使用 [host-integration.md](references/host-integration.md) 定义的中性 JSON；调用结果必须直接作为最终业务 JSON 返回。
|
||
|
||
## 处理流程
|
||
|
||
1. 判断请求是否属于本 Skill，且是否只包含一个独立业务动作；否则返回阻断结果。
|
||
2. 确定一个 `action`，读取上表中对应的 reference。
|
||
3. 只提取用户明确提供的业务事实；日期、数字和已记录别名可以规范化，不能猜测缺失信息。
|
||
4. 按 [output-contract.md](references/output-contract.md) 生成一个标准 `operation`。
|
||
5. 检查该 action 的必填字段、冲突、歧义、附件边界和安全条件。
|
||
6. 返回标准结果；不输出解释，不生成第二种格式。
|
||
|
||
## 输出
|
||
|
||
成功：
|
||
|
||
```json
|
||
{
|
||
"status": "agent_parse_passed",
|
||
"blockers": [],
|
||
"operation": {
|
||
"action": "...",
|
||
"order_nature": "test|formal",
|
||
"submit_mode": "dry_run",
|
||
"data": {}
|
||
}
|
||
}
|
||
```
|
||
|
||
失败、范围外、缺字段、歧义或不安全：
|
||
|
||
```json
|
||
{
|
||
"status": "agent_parse_blocked",
|
||
"blockers": ["category:path"],
|
||
"operation": null
|
||
}
|
||
```
|
||
|
||
## 共同约束
|
||
|
||
- 一次只返回一个独立 action；创建、修改、名单和导出不能合并。
|
||
- 只使用标准契约声明的字段；不得添加任意字段、凭据、selector、隐藏 ID 或模型解释。
|
||
- `submit_mode` 固定为 `dry_run`。
|
||
- 团队单个/批量下单只要求 Agent 提取用户事实：产品、日期、人数、房型、价格、OP 和销售人；`customer`、`route`、`trip`、`order_number` 缺失时写入 `data.resolution.deferred_fields`，不要阻断，也不要猜值。
|
||
- 团队单个/批量下单的 `resolution.mode` 固定为 `task_ready`；Skill 没有 ERP 查询证据，不能自行输出 `erp_ready`。
|
||
- 测试性质的创建任务保留用户测试标记；缺失时按唯一出发日期生成 `RAWTEST-ERP-YYYYMMDD`。正式任务不得生成测试标记。
|
||
- 用户明确提供的客户、线路、行程或团号必须原样保留；ERP 预检需要将其与产品模板结果做一致性校验。
|
||
- 产品模板解析由 ERP 侧负责：`Find_product/GetProduct` 负责派生行程、专线、客户、币种和团号前缀；未经过精确 lookup 的字段不能标记为 `erp_ready`。
|
||
- 缺失、冲突、无法唯一确认或超出七类范围时，返回 `agent_parse_blocked`。
|
||
- 附件只保留名称、路径和元数据，不读取或复制旅客、证件、Excel/CSV 行内容。
|
||
- 任务 ID、session ID、Profile 版本等传输信息放在业务系统包装层，不放进 `operation`。
|
||
- 不把归档交接包的旧格式当作 Agent 标准输出；需要时只在 Skill 内部规范化。
|
||
|
||
## 参考资料
|
||
|
||
- [output-contract.md](references/output-contract.md)：最终输出结构。
|
||
- [operation-matrix.md](references/operation-matrix.md)：七类业务与最小字段。
|
||
- [create-orders.md](references/create-orders.md)：四类创建业务。
|
||
- [updates-and-travelers.md](references/updates-and-travelers.md)：订单修改和旅客名单。
|
||
- [export-and-recovery.md](references/export-and-recovery.md)：确认件与恢复导出。
|
||
- [safety-and-results.md](references/safety-and-results.md)：阻断和结果语义。
|
||
- [contract-alignment.md](references/contract-alignment.md)：当前 Schema 与运行时契约差异。
|
||
- [standard_system_operation.schema.json](references/standard_system_operation.schema.json)：随 Skill 一起分发的标准输出 Schema。
|
||
- [host-integration.md](references/host-integration.md)：跨平台宿主调用约定。
|
||
- [examples.md](references/examples.md)：标准通过和阻断样例。
|