aps-agent/docs/round-76-kangni-real-data-trial-parallel-implementation-plan.md

# 第 76 轮多智能体实施方案：康尼真实数据本地全流程试排

更新日期：2026-08-17

## 1. 实施总览

本轮为中型任务：三个独立代码/验证工作片并行，一个真实数据集成点，一个浏览器验收点。用户已明确创建 Goal、复用已有智能体、允许智能体互相通信并允许新建智能体。

```text
W1（已有）：MPS trace 与本地排产版本接线
W2（已有）：五策略与订单/设备导出核验
W3（新建）：10 订单 Sheet2-Sheet9 工艺/BOM 导入修复
主 agent：计划、真实数据只读预检、集成、回归、进度与审计
T1（后置新建）：浏览器真实流程验收，只读测试
```

## 2. 依赖图

```text
W1 MPS 接线 ---------\
W2 策略/导出核验 ----+--> 主 agent 集成 --> 隔离真实数据试排 --> T1 浏览器验收 --> 独立审计
W3 10 订单导入 ------/
```

W3 的 10 订单只读门禁必须在集成前通过。W1/W2 不得根据当前 2 订单占位结果固化数量假设。

## 3. 工作区策略

- 工作目录：当前仓库根目录（`<repo-root>`）
- 当前分支：`main`
- 基线：大量 Round 71-75 未提交改动，且这些改动是本轮能力前提。
- 多智能体工具在当前共享工作区工作，无法从 `main` 提交态建立包含全部未提交基线的干净 worker worktree。
- 因此本轮采用“共享受保护工作区 + 互斥文件所有权 + 主 agent 集成”的显式例外：禁止 reset、checkout 覆盖、clean、commit、push、merge 和部署。
- 每名智能体交回精确修改文件、diff、自检和验证结果；主 agent 发现范围重叠立即暂停相关工作片。

## 4. 智能体登记

| ID | 智能体 | 工作片 | 写入范围 | 状态 |
|---|---|---|---|---|
| W1 | `01a00bc6-091a-7110-a7d7-22604e1cdd85` | MPS 接线 | `server/aps_domain/mps_planning.py`、`server/gateway/mps_api.py`、`tests/golden/test_mps_planning.py` | resumed |
| W2 | `01a00bc6-2106-7831-bbcc-f722bcdf37ff` | 策略/导出 | `server/aps_domain/flex.py`、`server/aps_domain/reports.py`、`tests/golden/test_kangni_flex.py`、`tests/golden/test_schedule_exports.py` | resumed |
| W3 | `01a00fb4-bfaa-7f10-9a33-4645c3dc8fdd` | 10 订单导入 | `server/aps_domain/kangni_intake.py`、`scripts/load_kangni.py`、`tests/golden/test_kangni_intake.py`、`tests/golden/test_kangni_mapping_validation.py` | running |
| T1 | 待创建 | Web 验收 | 只读；测试失败仅回传 | planned |

## 5. 工作片边界

### W1：MPS 与本地排产追溯

目标：复用既有 `link_schedule` / `link_publish` / `link_feedback` 能力，把 MPS trace 与本地 schedule/采用或发布事实安全接线，不触发 MES。

验收：作用域隔离、版本绑定、漂移失败关闭、无外部副作用；`test_mps_planning.py` 通过。

停止：需要修改 flex/reports/intake 或公共 schema 时先回报。

### W2：五策略和导出

目标：对 10 订单口径核验五策略和两类 XLSX，补足确定性、数据不足诚实降级和版本一致性测试。

验收：五策略均可调用；导出与采用版本一致且稳定；相关 focused tests 通过。

停止：需要修改 MPS/intake/API 公共类型时先回报。

### W3：10 订单导入

目标：保持精确订单名 sheet 兼容；generic routing 通过订单命名工时 sheet 的规范工序序列匹配，多个候选仅在内容完全相同时允许复用；BOM 独立按 `工单编号` 跨 sheet 筛选。工艺/BOM 不串单，工时来源可追溯。

验收：合成测试覆盖 exact/generic/missing/ambiguous；真实数据 `--no-persist` 导入 10/10；原始 Excel 哈希不变。

停止：发现源表没有可唯一定位订单的结构化字段，或必须修改原始 Excel。

### T1：浏览器验收

目标：使用隔离环境按操作手册走上传/选择、分析、MPS、策略比较、采用、冲突查看和导出；核对 console、网络和结果。

验收：关键 UI 和 API 均成功；无 console error；不触发 MES；形成可复跑脱敏测试资产。

## 6. 通信规则

- W3 完成解析契约后，向 W1/W2 同步 10 订单、工序/BOM/工时计数及占位映射口径。
- W1 向 W2 同步 trace、scheduleVersion、publish/adopt 关联字段，避免导出引用错误版本。
- W2 向 T1/主 agent 同步五策略标识、导出入口和结果断言。
- 智能体优先直接使用 `multi_agent_v1__send_input`；若子智能体未暴露通信工具，由主 agent 转发并记录。
- 禁止智能体回滚或“顺手修复”范围外文件。

## 7. 主 agent 集成与验证

1. 检查每个工作片的 impact 报告、修改范围和 focused tests。
2. 在现有共享工作区审阅 diff，处理必要的跨片接线。
3. 使用临时 `APS_HOME` 执行 10 订单只读/隔离试排和五策略/导出验证。
4. 运行 focused、相邻回归、Web build 和全量黄金测试。
5. 启动隔离服务并交给 T1 做真实浏览器验收。
6. 运行 `git diff --check` 和 GitNexus `detect_changes(compare main)`；保留累计 CRITICAL 风险标签。
7. 分派只读审计智能体，修复 P0/P1 后复验。

## 8. 冲突表

| 共享面 | 所有者 | 其他智能体 | 处理 |
|---|---|---|---|
| `kangni_intake.py` 数据契约 | W3 | W1/W2 只消费 | W3 发结构化口径，其他人不得修改 |
| MPS trace/version | W1 | W2 只消费 | W1 发字段契约，W2 不改 MPS 文件 |
| 策略与导出 | W2 | T1 只验证 | T1 失败回传，不直接修改 |
| `app.py`、前端 API 类型、共享 schema | 主 agent | 所有人禁改 | 必要接线由主 agent impact 后处理 |
| 康尼真实 Excel | 只读 | 所有人 | SHA-256 前后对比，严禁覆盖 |

## 9. 完成与收口

- 每个智能体按实施回传模板报告 completed/partial/blocked、修改文件、命令结果、关键洞察和残余风险。
- 多片集成后必须进行正式审计和浏览器实测。
- 不将占位设备能力、非零延期或 Mock 外部系统描述为生产完成。
- 本轮不 commit/push/merge。完成后先向用户报告主要结论、关键洞察、特别注意事项和工作区状态，再等待下一步授权。