用途:把一份已批准的 PRD 转换为可追踪的 issue 集合,每个需求 ID 一个 issue,并记录 issue 之间的依赖。资料强调这是机械翻译,思考已在 PRD 中完成。
主要能力:每个需求 ID(如 PRD-FR-001)生成恰好一个 issue,ID 写入标题,作为回溯规格的唯一链接;依赖信息来自 PRD 自身顺序与已声明的前置条件,不自行臆造;产出报告说明创建、跳过与受阻情况。正文需原样保留需求文本、Given/When/Then 验收标准,并标注 PRD 文件名。
使用方式:先通读 PRD,记录需求 ID、非目标及所有 [NEEDS CLARIFICATION] 标记。创建前先按需求 ID 搜索是否已存在,例如:bd list --json | grep -o 'PRD-[A-Z]-[0-9]' 或 gh issue list --search "PRD-FR-001" --state all --json number,title。对剩余需求逐个创建,优先用 bd(brew install beads,再 bd init 安装初始化),不可用时回退 gh。命令示例:bd create "PRD-FR-001: <requirement title>" -d "$(cat body.md)" -p 2;bd dep add <child-id> <parent-id>;gh issue create --title "PRD-FR-001: <requirement title>" --body-file body.md。创建完记录依赖,若依赖指向被跳过的 issue 则报告,不猜测绕过。
适用场景:规格已定稿、需要把需求落到追踪器并排定依赖顺序的团队。
限制:只创建,不关闭、重开、合并或编辑已有 issue;不估点、不超出 PRD 做优先级;含未解决澄清的需求不创建;非目标不建 issue;按需求 ID 幂等,重复运行不应新建任何 issue。边界:止于已创建的 issue,票内排序属于 project-planner,撰写或修订 PRD 属于 product-prd;若追踪器自身同步到 GitHub(bd github sync),应避免双路径重复创建。