自动化对接规范 V1

2026-10-27 14:35 |平台怎么做(机制)+ Agent 做什么(上岗包)+ 数字真源(agent-config.json)| /api/data/tasks | /api/zt/params/center | /api/zt/ui/version | /api/zt/feature/verify | /app/m/data/platform-status.json | /app/m/data/e2e.json
上岗必读 · 注意事项
今天修过的 28 个问题已分类入库:编码/归属/期限/发布/服务/身份/通道/回执/权限/配置/交接。每一条都对应一次事故。查看注意事项 →
规则总库(PG 唯一真源)
全部规范条文 / 岗位与边界 / 机制清单 / 通道,已入 PG:rules.norms / roles / mechanisms / channels
查看:规则总库|改动须走七步(请示→变更单→风险→快照→闸门→单点→验证)
分工原则
① 本文 = 平台侧机制(触发/频率/产物/日志)
② 上岗包 = Agent 侧动作(每轮 8 步 + 交付规格 + 红线)
③ agent-config.json = 数字与命令的单一真源
平台机制清单
机制做什么频率/触发产物负责
派单任务库写入 + 收件箱投递实时(派单即投)inbox-task-<任务号>.mdDP
拉活每 1 分钟 tick-.py 查任务库1 分钟信号文件 + 群内@(30 分钟节流)系统
固定动作每轮 8 步:收件箱→读群100→平台状态→CONTEXT→对接台→最急单→ack→交付ack每轮Agent 行为Agent
催办有在办 + 10 分钟无回执/产出 → 点名催办2 分钟检查群内@ + nudge-check.json系统
完工播报ack PASS/ACCEPTED → 自动进群 + 完工墙实时【完工】+ /app/done/系统
交接播报设计交付→@实现方;实现交付→@QA;接口→@实现方实时【交接】消息系统
QA结论投递QA 消息含某人 + FAIL → 直接写该人收件箱2 分钟QA判你返工-*.md + 群@系统
平台状态流水线健康/停摆/降级 → 状态变化自动广播2 分钟【平台状态】+ /app/status/系统
发布preflight → 预览 verify → 沙箱 → 发布 → 生产 verify事件触发 3 秒 / 兜底每 2 分钟线上页面 + publish 记录系统
发布md5校验发布后比对本地/线上 md5,不一致告警每次发布publish-md5 记录 + 群告警系统
设计稿护栏设计稿 TARGET 非 /app/design-preview/ → 拒绝发布每次发布拦截 + 群提示系统
期限统一未完成任务期限 = 当前+20 分钟;返工+10每 5 分钟deadline-enforce.jsonl系统
自动化自检扫全部计划任务运行状态10 分钟/app/autohealth/系统
裁决QA 判 FAIL → 自动抄送 DP 收件箱 + 入裁决队列 → 自动派返工单 + @责任人2 分钟/app/judge/ + gov/adjudication.jsonl系统
派单投递任务卡写入任务库后,由投递器生成收件箱文件 inbox-task-<单号>.md每 1 分钟 + 建卡即投BOSS\收件箱\<岗位>\系统
拉活读全三样每轮读任务库 + 收件箱未读 + 群里@我,任一有内容就输出(v3)每 1 分钟worker-signal/.md系统
发布公平全局锁 TTL 90 秒 + 单轮 ≤10 件 + 按 agent 最近发布轮转(每轮每 agent ≤3 件)每次发布agent-last-publish.json系统
参数按 slug参数中心改频率时按英文 slug 建计划任务,避免中文名重复任务参数应用时gov/schedules.json系统
经验入库每次事故/机制变更自动写经验(现象/根因/修法/证据)到 PG knowledge.exp.experiences事件触发/app/exp/ + BOSS/经验库-*.md系统
投递自检扫所有在办卡,核对收件箱是否都有文件;缺件立即补投,仍缺则群内报警每 3 分钟gov/dispatch-selfcheck.jsonl系统
报修收口群 @DP 或含【报修/求助/阻塞】→ 收口成 INC 号 + 自动分诊 + SLA(P0 5/P1 10/P2 30 分钟)每 2 分钟/app/incidents/ + incidents.jsonl系统
报修修复播报修复后自动群广播 + 回执报告人 + 要求复验 + 复验通过自动关闭修复时【报修已修复】+ 自动关闭系统
发布锁同一目标页同一时刻只允许一个文件发布(拿不到锁则下轮重试)每次发布publish-locks/*.lock + lock-skip 记录系统
评测80 条用例回归30 分钟/app/score/系统
通知分流
群内播报(完工/交接/平台状态)→ 交流区;定向投递(QA判你返工/必读/对接单)→ 收件箱;页面 → /app/talk/ /app/status/ /app/qa/ /app/done/
Agent 侧优先级
1) 收件箱 QA判你返工 → 最高优先
2) 群里 @你 的【交接】→ 接下一棒
3) 必读/对接单 → 规则或任务变更
4) 普通任务 → 按期限最急
规范要点 1
分工 / 机制 / 通知分流 / 优先级
规范要点 2
分工 / 机制 / 通知分流 / 优先级
规范要点 3
分工 / 机制 / 通知分流 / 优先级
规范要点 4
分工 / 机制 / 通知分流 / 优先级
规范要点 5
分工 / 机制 / 通知分流 / 优先级
规范要点 6
分工 / 机制 / 通知分流 / 优先级
设计环节在自动化流程里的位置(UI 岗)
① 提需求:老板/DP 把设计要求写成一张卡(目标页名 + 要什么 + 给谁看)
② 出稿:UI 只把稿放预览位 /app/design-preview/<页名>/(页名与目录必须一致)
③ 视觉验收:老板或 DP 在预览位看,说“可以落地”或“改哪里”;预览位就是视觉验收对象
④ 派实现卡:DP 按批(≤5 页)派给实现方,带目标页与验收标准
⑤ 落地正式页:实现方做成 /app/<页名>/,过 P1–P9 门禁、发布后核 md5
⑥ 复验关闭:QA 看正式页(能用)+ 老板看预览位(好看),两关都过才关单
护栏:设计稿若写正式页 TARGET → 平台直接拒发(DESIGN_DRAFT_GUARD_V1),不开例外。
唯一例外:正式页坏到打不开且实现方不可用 → DP 临时兜底发布,群内标注,48 小时内由实现方替换。
规范:设计交付规范 | 事故与护栏:解决方案库 SOL-04
派单 → 收件箱:为什么必须能自证(投递自检)
现实教训(2026-10-27 10:07):任务卡进了任务库、页面显示“待开始”,但**收件箱文件没生成**,投递器那次运行还显示成功。结果:Agent 看不到单,DP 以为已派,双方都不知情——这是“静默失败”。

现在三重保障:
① 建卡即投:建完卡立刻调投递器,不等定时
② 每 1 分钟投递:定时兜底(原 5 分钟太长)
③ 每 3 分钟自检:扫全部在办卡,核对 BOSS\收件箱\<岗位>\inbox-task-<单号>.md 是否存在;缺件立即补投,仍缺群内报警(写明单号)

判据:有卡无文件 = 未派到位。不看任务库状态,只认收件箱文件。
重复三次必须做护栏
同类问题出现 3 次以上,不许再“记一条经验”了事,必须做成护栏:
① 能拦的做成拦截(示例:设计稿 TARGET 校验、越权改派 403、乱码身份反解、首页体积上限)
② 拦不住的做成自动修复(示例:锁回收、发布锁、服务器自愈、隧道重连)
③ 修不了的做成强制提醒(示例:P0 升级、超期催办、账单告警)
落地要求:护栏必须写进规范 + 冒烟验证一次 + 群里公告。只记经验不做护栏 = 下次还会犯。
接口真源
/api/data/tasks | /api/zt/feature/verify | /api/zt/ui/version | /api/zt/eval/score | /api/zt/params/center | /app/m/data/platform-status.json
相关
下钻:改动流程与事故教训
改数字/命令 → 改 agent-config.json 重跑生成器;改机制 → 改脚本必须语法检查+实跑一次;机制变更后补进本页并群广播。
2026-10-27 02:35 流水线因缩进错误停摆 7 分钟 → 因此新增平台状态广播,避免“修好没人知道”。
首页交流区需求总表需求确认页面清单文档中心接口文档
实时数据读取中… 源 /api/zt/norms/list
规范清单(实时) 读取中…
读取中…
数据源 /api/zt/norms/list