SuperAPI AI 工具集

bmad-handoff

通用与其它

查看项目

更新于 10-15 19:53

技能介绍

用途:扫描规划输出目录中所有状态为 ready-for-dev 的故事,编译成单个 handoff-manifest.json,任何下游开发工具都可读取,不与特定执行器耦合。这是规划插件产出的最后一个产物,后续由外部开发工具负责。

使用时机:故事编写阶段完成后,且确认至少一个故事状态为 ready-for-dev 时运行。清单是时间点快照,需刷新时重新运行并覆盖原文件。运行时用 TodoWrite 跟踪进度。

工作流程:1)定位输出目录,默认 bmad-output/,依据 project-context.md 或询问用户;2)用 glob 发现 **/{epic}.{story}..story.md,若为空可接受 stories/.story.md 等扁平布局;3)读取每个故事头部 Status: 字段,只保留值恰为 ready-for-dev 的故事,若没有则报告所见状态并停止,不产出空清单;4)逐故事提取 id、storyFilePath、status、epic、storyNumber、title、ownedScope、wave、parallelSet、dependencies、acceptanceCriteriaSummary、lockedSectionsNote、devAgentRecord;5)若无显式 wave 注解则计算波次:依赖为空者为 wave 1,所有依赖处于 wave N 或更低者为 wave N+1,未注解时 parallelSet 为 null;6)按模板 schema 写入 {outputFolder}/handoff-manifest.json,schemaVersion 为 1.0,按 wave 升序、同波次按 id 升序排序;7)打印紧凑摘要,列出缺失必填章节的警告。

字段要求:schemaVersion、generatedAt、projectName、outputFolder、stories 为必填;每个故事的 id、storyFilePath、status、epic、storyNumber、title、ownedScope、wave、dependencies、acceptanceCriteriaSummary、lockedSectionsNote、devAgentRecord 必填,parallelSet 可为 null。lockedSectionsNote 固定为提示外部工具不得编辑验收标准、开发笔记和测试章节,只填充 Dev Agent Record。

子代理策略:故事不超过 15 个时单线程运行;16 个以上时并行分片提取,各代理返回不含 wave 的 JSON 数组,由协调者合并、计算波次、排序并写入。

限制与准则:不得编造字段值,缺失字段输出 null 并加警告;不得修改故事文件,技能对故事内容只读;ownedScope 必须逐条保留,不可压缩或概括,以免并行冲突;清单是稳定版本化接口,增删字段需单独提升 schemaVersion;不得按 ready-for-dev 之外的条件过滤故事,依赖解析由开发工具负责。以上依据公开资料整理,收费、价格及具体运行环境等信息暂未提供。