SuperAPI AI 工具集

handoff-protocol

通用与其它

查看项目

更新于 10-16 09:30

技能介绍

该技能用于在多工作流协作项目中定义工作流之间的交接协议,目标是通过规范交接内容来避免交接质量问题引发的返工,适用于跨阶段交付(设计→开发→测试→上线)等场景。

核心原则:交接是项目失败的高发区,每次交接质量决定下游工作流的执行成本。

交接三要素:1)产物,即上游工作流的具体输出文件、文档或代码,格式和位置明确且可被下游直接使用;2)上下文,说明为什么这样做、做了哪些决策及原因、已知限制或风险、下游需注意事项;3)验收标准,即下游如何判断上游产物合格、不合格时的退回机制及修复责任归属。

常见交接点及产物清单:产品经理→项目经理(PRD含14节标准结构、功能清单加优先级、验收标准、风险清单、未决问题);项目经理→API设计(功能清单、业务实体清单、权限要求、异常场景清单);项目经理→UI/UX设计(用户角色和场景、核心流程清单、页面目标、状态说明);API设计→前端加后端(OpenAPI文档、Mock服务地址、错误码表、鉴权方式说明);UI/UX设计→前端(页面清单加用户流程、组件清单加状态说明、交互规则、响应式规则、可访问性要求);后端→QA(接口代码加接口说明、测试账号和数据、异常场景清单、权限矩阵);QA→DevOps(测试报告、Bug修复确认、已知风险清单);DevOps→SRE(部署文档、健康检查端点、监控配置、回滚方案)。每个交接点均需附上下文与验收标准。

使用方式:先识别项目中的所有交接点,再对每个交接点列出产物清单、上下文要点和验收标准,输出交接计划;执行中每次交接时验证三要素;交接失败则标注问题、退回上游(状态变为 rework)、由项目经理评估影响、上游修复后重新交接,并记录到 field-journal。交接前自检:下游能否直接开始工作、是否有需猜测之处、是否遗漏异常场景、验收标准是否可测试、未决问题是否标注清楚。

限制与常见坑:只传文件不传上下文、没有验收标准、交接清单不完整、退回机制不明确、上下文写成废话、未决问题不标注、交接单向缺少下游确认。配套模板为 templates/handoff-plan-template.md。上游依赖 wbs-decomposition 与 orchestration,下游可对接 progress-tracking 与 change-control。具体收费、价格等信息暂未提供。