aps-agent/docs/round-76-kangni-real-data-t...

6.0 KiB
Raw Blame History

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

更新日期:2026-08-17

1. 实施总览

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

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

2. 依赖图

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。完成后先向用户报告主要结论、关键洞察、特别注意事项和工作区状态,再等待下一步授权。