Files
docs/独立任务协作登记.md
T
2026-08-11 18:06:30 +08:00

17 KiB
Raw Blame History

独立任务协作登记

本文件登记用户可独立打开和查看的 Codex 任务/对话,不登记子代理。长期复用通道负责创建前路由,执行历史只负责追溯;任务名称始终只是展示标签。

长期复用通道

总控下发独立工作前必须先查本表。idle、active、blocked 都表示通道可复用;只有 archived 表示不可继续下发。同一 routing_key 只能保留一个未归档任务。

routing_key task_id display_name durable_scope owner status last_update notes
phase3.control.release-acceptance 019fdf57-2f16-7cf1-88f0-a75854ed7629 三期总控|发布与验收 三期发布、测试环境验收、阻断分类与最终汇总 三期总控 idle 2026-08-11 后续三期发布与验收优先向此 ID 续发;一次性复验或部署默认使用子代理
finance.control 019feaa3-9f10-7ab0-8023-4b121ff9662c 财务模块-总控 财务范围、跨端契约、后端/Admin/Client 协调与汇总 财务总控 active 2026-08-11 Finance一期最终验收FAIL;正在协调11个一期P0 operation返工与独立复验
database-comments.control 019fef70-b644-7071-8b76-975b8940985c 数据库注释治理 数据库中文注释规范、模块分派、统一 SQL 集成与总体验收 数据库注释总控 idle 2026-08-11 后续数据库注释工作优先向此 ID 续发;模块盘点和修改默认使用子代理

通道路由规则

  • routing_key 按长期职责确定,格式为 <domain>.<unit>.<responsibility>;不包含序号、日期、批次、提交号或本轮动作。
  • 命中未归档通道后直接使用其 task_id 通信;标题相同或不同均不影响寻址。通道开始新一轮工作时改为 active,一轮工作结束后回到 idle。
  • completed 只用于下方一次性执行历史,不是长期通道状态。长期通道不得因为一轮工作完成而失去复用资格。
  • 用户未明确要求新增独立对话时,未命中通道也不自动创建;使用当前任务或子代理完成工作。
  • 永久停用才标记 archived。创建替代通道时,在新旧记录备注中互相写明 ID,不覆盖或复用旧 ID。

登记规则

  • 下表只保存既有一次性任务和已结束轮次,不作为新任务的复用路由;可长期复用的任务必须同时登记到上方“长期复用通道”。
  • 独立任务创建成功并获得平台返回的稳定 ID 后立即登记;没有稳定 ID 不得写入临时名称或自行生成替代 ID。
  • 任务名称可以修改,task_id 不得复用、改写或转给另一项工作。历史任务完成后保留记录,不删除历史 ID。
  • 跨任务共享契约由总控记录在备注中;独立任务回复必须带回自身 task_id、状态、变更文件、验证结果和阻断项。

执行历史状态值

planned、active、blocked、completed、archived。

执行历史

task_id display_name scope owner status worktree/branch last_update notes
019feb17-b5de-7d63-a0e4-5a8c2181e323 PDA 后端作业链收口 baiyue-firstleg/firstleg PDA 拣货事务、原子批量提交和相关测试 三期总控 completed 后端 test 2026-08-11 40171b7 已推送;根因是 operation CHECK 未允许 BATCH,统一SQL与模块SQL已补幂等迁移;定向17/17、Firstleg 524项无失败
019feb17-c56c-7e02-8f9c-0b74f960df34 三期验收 fixture 审计 baiyue-firstleg/scripts/admin-test-env-modules 三期总控 completed 后端 test 2026-08-11 df0f05c已推送:修正customs同一来源fixture配对及loading-finalize失败后误标LOADED;4/4契约测试通过,仅脚本无需部署
019feb17-d3c2-7480-802a-498db11c7d3c Admin 装柜工作流页面 apps/admin-web 统一订单、智能装柜、预装清单、装柜清单、证据与完成入口 三期总控 completed Admin release/test 2026-08-11 装柜9b99404、服务中心接线17d483b、出仓空态af30c0c均已部署;103 files/535 tests、typecheck/build、浏览器真实页面通过
019feb2a-419b-7161-8174-5aed7e84a047 PDA 原子批量提交契约 PDA 后端 Controller/DTO/OpenAPI/调用方只读契约梳理 三期总控 completed 后端 test 2026-08-10 只读阶段完成;等待 S0500 修复后进入实现
019feb29-ef52-7f83-96d7-42d963d2ae34 PDA uni-app 前端验收 apps/pda-uniapp 登录、领取、广播扫码、设备草稿、批量提交、证据和真实 API 映射 三期总控 completed PDA release/test 2026-08-11 功能提交be776c8已推送,远端f83a0c4;43/43 PASS,A0409刷新和失败回滚已验证;HBuilderX/Android真机仍为最终gap
019febc3-8735-7e53-b797-a8af24bcc0ec Firstleg 单余量装柜闭环 baiyue-firstleg/firstleg 单余量结算、PDA pick、装柜完成与跨服务幂等/补偿 三期总控 completed 后端 test 2026-08-11 9b3ff06 修复 loading/complete 更新目标表自引用;定向14/14、Firstleg 524项无失败,无SQL,仅需部署Firstleg
019feeb5-6c6b-7f50-9bcd-eba8c7057b24 Gateway 与 Order 测试环境发布 Jenkins backend-java 的 gateway + order 定向发布与健康检查 三期总控 completed 后端 test 2026-08-11 backend-java #100、gateway #36、order #41 成功;部署 166ebfb7,未执行 SQL,未部署 Firstleg/Admin
019feec0-008e-72e2-95d6-8e99d604b5c0 Admin 服务中心三期页面 apps/admin-web 订舱、拖车、船期、报关与出仓模块页面 三期总控 completed Admin release/test 2026-08-11 服务中心模块与出仓空态修复已推送;订舱41条、拖车51条真实页面通过,最终由接线任务统一部署
019feed6-edeb-7da3-aa75-8c40aa5fb305 Firstleg P0 测试环境发布 Jenkins backend-java 的 firstleg 定向发布与健康检查 三期总控 completed 后端 test 2026-08-11 backend-java #101、firstleg #71 成功;部署 9f455b6,包含 7aa2b50 与 PDA 原子 /batch;无 SQL,已通知全量复跑
019feeee-e042-73b0-ba84-c6b8e21fa6c9 Loading-finalize 测试环境发布 Jenkins backend-java 的 firstleg 定向发布与健康检查 三期总控 completed 后端 test 2026-08-11 backend-java #102、firstleg #72成功,部署3f301e3;消费者单跑缺同轮fixture,需随生产者链最终复验
019feef5-59e3-7110-b87f-4aea14bb67c6 PDA BATCH SQL 与 Firstleg 发布 测试库统一SQL、Jenkins firstleg 定向发布和健康检查 三期总控 archived 后端 test 2026-08-11 执行前卡在工具审批,未开始备份或写库;已由新任务019fef02-863b-7413-84f7-36593aac0c4e替代
019fef02-863b-7413-84f7-36593aac0c4e PDA BATCH SQL 与 Firstleg 发布(替代) 测试库统一SQL、Jenkins firstleg 定向发布和健康检查 三期总控 completed 后端 test 2026-08-11 统一SQL连续两次唯一PASS,CHECK含BATCH;backend-java #103、firstleg #73成功,部署40171b7,健康/OpenAPI通过,已通知最终全量
019fef67-b9b5-7f20-a19f-0f2bb9e91a68 Loading complete 最终阻断修复 baiyue-firstleg/firstleg 装柜完成首次提交、幂等重放与事务状态收口 三期总控 completed 后端 test 2026-08-11 bf7c214已推送:修复普通注解SQL误用XML实体导致MySQL语法异常;定向13/13、Firstleg 527项无失败,无SQL,仅需部署Firstleg
019fef75-68c8-7d63-9f28-d2f5ac068c8b Loading complete 修复发布 Jenkins firstleg 定向发布、健康与OpenAPI核验 三期总控 completed 后端 test 2026-08-11 backend-java #104、firstleg #74成功,部署cb308399(包含bf7c214与df0f05c);无SQL,Gateway健康与Firstleg OpenAPI通过,已通知最终全量复跑
019fef90-4707-7c62-af0d-8b3395ef1e80 柜次与计划状态机复验分类 三期柜次push、计划推进、预装门禁及验收fixture顺序 三期总控 completed 后端 test 2026-08-11 已确认双缺口:cb308399正确引入WAIT_LOADING/推送后EDITING,但错误地在首笔写库而非claim时推进LOADING;脚本仍按旧push即LOADING顺序,需后端claim推进与fixture重排后再部署复验
019fef9a-e00d-7ea2-8450-5a5930e5279d PDA claim 推进装柜中 baiyue-firstleg/firstleg 任务领取、计划LOADING推进、历史与幂等 三期总控 completed 后端 test 2026-08-11 16a2f83已推送:claim首次及同作业员重入幂等推进LOADING,保留pick/batch兜底且START_LOADING历史不重复;定向10/10、Firstleg 531项无失败,无SQL,仅需部署Firstleg
019fef9b-046a-7062-bcfd-8069f02a4822 三期装柜状态验收脚本重排 phase3-container-loading、phase3-loading及级联fixture 三期总控 completed 后端 test 2026-08-11 远端386eae6已收口:WAIT_LOADING→EDITING→claim后LOADING→真实pick/batch→COMPLETED,customs/finalize同轮fixture;脚本契约6/6、node check、diff check通过,仅脚本无需部署
019fefb4-ef2e-7db2-a698-a65f185df8f8 PDA claim 状态修复发布 Jenkins firstleg 定向发布、健康与OpenAPI核验 三期总控 completed 后端 test 2026-08-11 backend-java #105、firstleg #75成功,部署a59f4634(包含16a2f83与386eae6);无SQL,健康/OpenAPI通过,已放行完整生产者链与默认全量
019fef9f-0a38-7523-bb40-33256352505b Firstleg claim 推进装柜状态 LoadingPickService.claim 原子推进计划至LOADING并保持幂等 三期总控 completed 后端 test 2026-08-11 16a2f83已推送origin/test;claim成功/同作业员重入调用startPicking,仅首次写START_LOADING历史;LoadingPickService定向10/10、Firstleg 531项0失败2跳过、diff check通过;无SQL,仅需部署Firstleg
019fef8f-8134-7380-b112-33ba490fa911 柜次推送状态机阻断排查 baiyue-firstleg/firstleg 柜次推送、计划状态与预装确认门禁 三期总控 completed 后端 test 2026-08-11 后端契约完整无需改动:push-preload保持EDITING,PDA task claim后才推进LOADING;失败为脚本旧顺序,已交fixture任务修正
019fef8f-994b-75c0-a3a2-0c76574567b4 三期最终fixture稳定性审计 baiyue-firstleg/scripts/admin-test-env-modules 生产者链marker与跨模块fixture 三期总控 completed 后端 test 2026-08-11 386eae6已推送:按push EDITING、claim EDITING、首笔PICK/BATCH启动装柜的真实顺序修正3个脚本;静态3/3、契约6/6通过
019fefae-09e8-7993-906e-95b073ffc0b7 预装确认与装柜启动门禁矛盾修复 baiyue-firstleg/firstleg 入库预装确认、柜次启动与主状态同步 三期总控 completed 后端 test 2026-08-11 a59f463已推送:confirming允许INBOUNDED或LOADING,LOADING仍强制关联柜次已启动;定向4/4、Firstleg 532项无失败,无SQL
019fefb7-d33d-7521-ae9d-1ef268755b9c 预装门禁修复发布 Jenkins firstleg 定向发布、健康与OpenAPI核验 三期总控 completed 后端 test 2026-08-11 backend-java #105、firstleg #75成功,部署a59f463;Firstleg 533项0失败2跳过,Gateway health与Firstleg OpenAPI HTTP200,未执行SQL,已通知最终全量复跑
019ff02d-924c-7290-a34e-b2c3704601b8 三期最终验收状态与finalize fixture修正 baiyue-firstleg/scripts/admin-test-env-modules claim/CONFIRMING真实状态与订舱拖车报关到finalize柜次关联 三期总控 archived 后端 test 2026-08-11 发布任务越权创建但未下发业务工作;已归档,范围交回现有全量任务019fdf0a-4933-7903-8a0c-10018c379f6f处理
019ff034-87cb-7d32-8c93-3e8aa992b082 三期最终脚本与全量收口 baiyue-firstleg/scripts/admin-test-env-* 状态断言、finalize实际柜次关联、定向与默认全量 三期总控 active 后端 test 2026-08-11 因原全量任务被Finance独占而建立的唯一替代任务;修复后直接跑定向和默认全量,完成即归档,不再拆分
019fdf0a-4933-7903-8a0c-10018c379f6f 后台真实全量测试 baiyue-firstleg/scripts/admin-test-env-* 与测试环境真实 HTTP 验收 三期总控 active 后端 test 2026-08-11 当前基线复跑与下一批 PDA batch/Admin 终验分两轮执行;禁止 mock、放宽断言或 gap 伪装 PASS
019febc3-704f-7c72-8e82-dc317f69dc9b Finance 后端与数据库 baiyue-firstleg/finance、Finance 依赖的 file/firstleg/gateway/iam 契约、模块 SQL 与统一 SQL 财务总控 active 共享工作区 2026-08-11 最终专项判定11个一期operation缺失;已返工账户/流水、来源审核与纳入结算、对账单和应收应付结算单正式闭环
019febc3-7c39-7ec2-8051-a4cce8d5f104 Finance F1 接口契约 docs/财务管理/ 的 OpenAPI、接口契约、门禁和状态文档 财务总控 active 共享工作区 2026-08-11 11个NOT_IMPLEMENTED已判定一期P0;正在冻结DTO、状态、权限、幂等、错误码和验收用例并跟踪实现
019febc3-89f3-7991-b7eb-6c697fd9f032 Admin 人工财务模块 apps/admin-web/src/modules/finance/ 及其路由、权限和测试 财务总控 active Admin 当前工作区 2026-08-11 五路由已存在但后三页仍为旧能力映射;返工正式生成、详情、状态动作和来源审核/结算纳入交互
019febc3-9519-7982-81dd-bc048819bf48 Client 财务只读模块 apps/client-web/src/modules/finance/ 及财务权限映射和测试 财务总控 active Client 当前工作区 2026-08-11 Client交付已完成;因原全量ID被三期持续占用,复用本独立ID执行Finance一期五页最终只读专项,禁止修改文件
019fef83-0763-7930-8c00-c42d5398b0f1 数据库注释全库盘点 baiyue-firstleg/*/src/main/resources/db/ 与统一 SQL 的只读盘点 数据库注释总控 completed 共享工作区 2026-08-11 155个建表定义、约2339字段;字段注释覆盖约69%,缺失724;Finance缺164、Firstleg缺461;未修改文件
019fef83-2697-7062-a902-a0e9791d75ea 数据库注释规范与门禁 数据库中文注释规范、静态审计脚本和 CI/验收门禁 数据库注释总控 completed 共享工作区 2026-08-11 规范与离线门禁完成;多行CHECK假阳性已按MySQL数据类型白名单修复并补SelfTest;Order/Finance Issues=0
019fef8b-9f95-7102-a57b-dc4960ff5ffa Firstleg 二期数据库注释 firstleg 基线、入库、测量、计费、价格及托盘相关模块 SQL 数据库注释总控 completed 共享工作区 2026-08-11 7文件新增47个注释、修正1个英文状态;范围内Issues=0、结构不变、聚合构建成功;完整测试被并行Finance测试编译错误阻断
019fef8b-a844-75c1-9ed3-85dfca8a89f1 Firstleg 三期船期数据库注释 firstleg 船司查询与港口船期模块 SQL 数据库注释总控 completed 共享工作区 2026-08-11 两文件补齐/中文化113字段;覆盖100%;SQL契约测试6/6、BUILD SUCCESS;仅COMMENT变更
019fef8b-afb6-7342-a707-f014f7baa785 Order Auth IAM 数据库注释 order、auth、iam 模块 SQL 数据库注释总控 completed 共享工作区 2026-08-11 26表389字段覆盖100%;Auth/IAM测试通过;Order 125/126,唯一失败为统一SQL旧注释镜像待集成同步
019fef8b-b84f-70e2-b312-bebdce157ad0 Warehouse File Audit Event 数据库注释 warehouse、file、audit-service、event-bridge-service 模块 SQL 数据库注释总控 completed 共享工作区 2026-08-11 28个表定义、433字段注释100%;四模块Maven测试BUILD SUCCESS;未改统一SQL
019fef9d-ddf6-7963-b683-46bab7685bee Firstleg 三期报关数据库注释 phase3-customs-schema.sql 数据库注释总控 completed 共享工作区 2026-08-11 8表107字段中文注释完成;CustomsSqlContractTest通过;仅COMMENT变更,未改统一SQL
019fef9d-e7df-7bd2-9d07-ef22bbac1e6a Firstleg 三期订舱拖车数据库注释 phase3-ocean-booking-schema.sql、phase3-truck-appointment-schema.sql 数据库注释总控 completed 共享工作区 2026-08-11 两文件Issues=0且结构不变;订舱/拖车定向测试20/20、BUILD SUCCESS;未改统一SQL
019fef9d-f2f1-7e12-8f70-63e54a855851 Firstleg 三期装柜PDA数据库注释 三期装柜、出仓、PDA、分柜、排柜及桥接脚本 数据库注释总控 completed 共享工作区 2026-08-11 七文件完成;Firstleg 89表1443字段覆盖100%、Issues=0;相关SQL测试33项通过、1跳过;统一SQL待同步
019fefb9-fce8-78e3-8270-dd569546ae9d 数据库注释统一SQL集成 deploy/sql/头程数据库统一增量-MySQL8.sql 与相关SQL契约测试 数据库注释总控 completed 共享工作区 2026-08-11 150唯一表2456字段;每表最多一次DDL并验签;九库断言/唯一PASS;DryRun PASS;Firstleg549、Finance35通过;未执行真实MySQL

通信与汇总格式

总控下发消息至少包含:

routing_key: <长期职责键>
task_id: <已登记 ID>
目标: <单一交付目标>
范围: <目录/模块>
共享契约: <依赖的接口、模型或文件>
回传: <状态、变更文件、验证命令/结果、阻断项>

汇总时按 routing_key + task_id 聚合,不按 display_name 聚合;同一 ID 的最新状态覆盖旧状态,但保留重要阻断和验证记录。