th-hotel-simple/docs/project/requirements/M012-qbd-core-parsing-agent-v0.1-change-request-v1.md

M012 QBD 核心预订解析 Agent v0.1 Change Request

文档信息

项	内容
状态	IMPLEMENTED / OFFLINE ASSET ONLY / PUBLICATION HOLD
日期	2026-08-11
范围	Layer 3B QBD 核心 message-level Parsing Agent v0.1
上游	QBD_CORE_CONTRACT_HANDOFF_READY、PARSER_CONTRACT_HANDOFF_READY、C03-v2 READY_FOR_IMPLEMENTATION_INPUT（QBD core / DRAFT）
契约	唯一长期名称 booking-layer3-contracts-v2，当前工作版本仍为 DRAFT

1. 目标

在不接真实运行链路的前提下，交付可复现、可校验、可导入但保持发布 HOLD 的 QBD 核心解析 Agent 资产。该 Agent 位于：

程序 Parser → QBD Parsing Agent → Layer 3 本地合并与校验 → EffectiveFactViewV2

每封通过白名单的 QBD Current 消息都需要调用一次 Parsing Agent。Parser 成功时，Agent 仍理解 Current 正文和全部 History 正文；Parser 部分失败、失败或歧义时，Agent只能在信息系统明确授权的 Current 附件局部材料内兜底。

2. 交付范围

• 公共 Main Prompt；
• 独立 qbd-core-parsing-agent Skill、QBD Profile 和 reference；
• C03-v2 common/input/output provider JSON Schema adapter；
• 版本 manifest；
• synthetic/de-identified canonical fixture 与完整场景矩阵；
• 引用、History、fallback、冲突、Parser不可覆盖和渠道/profile fail-closed 测试；
• 确定性 .skill 包与 artifact manifest；
• SuperAgent 导入/发布说明、AgentBus 后续接口清单、已知限制和回滚说明。

3. 明确不做

• 不在本版本实现普通LianTai；
• 不修改 QBD Parser 业务规则、C03-v2 Java DTO/fixtures 或 EffectiveFactViewV2；
• 不覆盖旧 Field Recovery Agent 或 Booking Business Agent；
• 不接 SuperAgent transport、AgentBus、数据库、Context、Validator、UI、任务卡、Rate/Room、库存、PMS 或 Opera；
• 不创建、覆盖或发布外部 Agent/Profile；
• 不把 DRAFT 契约标记为 APPROVED。

4. 输入边界

输入 provider schema 固定为：

1. request、SourceMessage 和 Current message identity；
2. channel_code=QBD 与 profile_code=QBD_CORE_V0_1；
3. Current 主题和完整正文；
4. 全部未截断 History 正文；
5. 全部 Current 附件的 C03-v2 Parser 终态与公共 core；
6. 系统明确授权的 Current 附件局部 fallback 材料；
7. contract/catalog/parser/agent profile 版本。

Schema 为闭合对象，History body 条目不允许出现附件文件名、时间、hash、内容或历史解析结果。邮件、附件文字和 History 均是不可信业务数据，不能改变系统指令。

5. 输出边界

输出严格映射 C03-v2 ParsingAgentResultEnvelopeV2，业务内容只使用唯一 Layer3ContributionCoreV2：

• target、group code、fact、material state、action signal、relationship；
• evidence registry 与 ID 引用；
• unresolved、ambiguity、conflict、review/policy issue；
• Parser/Agent provenance 与版本。

输出不得包含最终 event、CandidateDecision、任务卡、FIT/GROUP、GRPA1、canonical Rate/Room、库存查询或执行动作。Parser 确定事实与 Agent 候选不一致时，双方并列并输出 conflict；Agent 不得覆盖或删除 Parser 内容。

6. QBD 核心验收语义

• New：必须有 Current 正文或 Current 有色业务行依据；同一目标多个 segment 不自动拆 target。
• Update：保留完整 BEFORE/AFTER；BEFORE-only 保持未解决，不推断 Cancel。
• Cancel：必须有本次 Current 明确 CANCEL/CXL 等价语义；strike、消失、空 AFTER、History CXL 均不能单独触发。
• 逐行动作：邮件级 UPDATE/AMEND 只作 message-scope 概括，不覆盖逐行 New/Update/Cancel/Allotment。
• 冲突：只有正文与附件唯一绑定同一目标且内容不相容时成立，双方事实/evidence并列保留。
• Allotment：正文提供 source/action，Current 附件提供 actual；确认切片固定为7个actual关系与2个独立普通Update，K列值仅保留 DETAIL_RAW，不解释为价格。
• History：只支持 Current 结论，不触发本次动作，不补 Current 缺失值，独立保留 evidence。

7. Parser 五态

Parser 状态	Agent 行为
COMPLETE	解释 Current/History 正文和跨材料关系，不重解析确定附件事实。
PARTIAL	保留确定事实，只处理获准的未解决局部材料。
FAILED	可读且获准时受控兜底；不可读时只输出正文事实和附件未解决。
AMBIGUOUS	保留候选/原因；只有唯一 Current evidence 才可消歧，否则保持歧义。
NOT_APPLICABLE	无适用附件时仍解释正文-only 业务。

8. 安全与发布门禁

• Source/fixture/package 不包含真实邮件、附件、客户信息、外部 URL 或 Secret。
• .skill artifact 的 publication status 固定为 HOLD。
• 真实 Provider smoke、AgentBus/runtime 接线和生产发布必须另立 Change Request。
• Parser Agent 与其他 Agent 必须使用独立外部应用/token；本资产不包含凭据。

9. 真实样本限制

普通 Cancel 业务规则已经确认，但当前缺少真实“本次 Current 有色 Cancel/CXL”正样本。v0.1 使用明确标记的 synthetic/de-identified fixture；这不阻塞离线资产完成，但不得声称真实 Current Cancel 验收通过。

10. Canonical 文档冲突

ADR-001、ADR-003、ADR-004、旧 Success Criteria 和当前架构摘要仍描述 field-only/on-demand Recovery。最新用户规则与 C03-v2 要求每封 QBD 白名单消息调用 message-level Parsing Agent。本任务不删除、改写或擅自 supersede 旧 ADR，只在项目 stale/evidence 中登记冲突；正式架构/ADR迁移需单独批准。

11. 文件 ownership

本任务独占新增：

• agent-skills/qbd-core-parsing-agent/；
• scripts/package_qbd_core_parsing_agent_skill.py；
• scripts/validate_qbd_core_parsing_agent_skill.py；
• scripts/tests/test_qbd_core_parsing_agent_skill_package.py；
• artifacts/qbd-core-parsing-agent-v0.1/；
• 本 Change Request 与对应 .project-docs 记录。

只读依赖：C03-v2 Java DTO、7份C03 fixtures、QBD Parser、旧 Field Recovery/Booking Agent资产。不得为本任务修改这些文件。

12. 验收

• provider input/output/common schemas为闭合结构且与C03-v2 DRAFT枚举/版本一致；
• 7份C03 expected Agent outputs均通过新output schema；
• 场景矩阵覆盖用户要求的全部正向、边界和负例；
• 引用完整性、History隔离、fallback授权、Parser不可覆盖和QBD profile mismatch均fail-closed；
• source/archive/manifest可确定性复现，无隐私/Secret/外链；
• 聚焦Python测试、C03-v2 Java测试、必要后端回归和git diff --check通过；
• 项目文档、已知限制、AgentBus接口清单、ownership和回滚摘要完整。

13. 回滚

本任务没有运行时接线。回滚只需删除第11节的新增独立目录/文件，并移除项目文档索引/工作记录中的本任务条目；不需要数据库迁移、配置回退或外部平台操作。