用途:作为 ATDD 流程第三阶段 SYNC,读取已通过 spec-review 且人工在检查点批准后的规格产物,通过 gh CLI 生成 GitHub Issues 层级。适用于规格评审返回 VERDICT: OK 之后。
主要能力:构建固定层级——[Goal] 父议题、[US] 用户故事、每个 .feature 场景一个 [Scenario] 子议题;所有议题带全局标签 atdd 与 us/<us-slug>,场景议题另带测试级别标签(level/use-case、level/e2e、level/ui)、分支标签(branch/nominal、branch/violation、branch/auth、branch/technical、branch/limit)和规则标签 rule/<R-NN>,context.md 中非 TBD 的里程碑可选。输出 specs/<us-slug>/issues.json。
使用方式:需先 gh auth status 认证,当前目录在含 GitHub 远端的 git 仓库内或传 --repo owner/name。输入为 specs/<us-slug>/context.md、*.feature、review.md。幂等约定:创建前用 gh issue list --label "atdd" --label "us/<us-slug>" --state all --json number,title,labels 查找同名同标签议题,存在则复用编号,正文漂移则评论新正文而不覆盖或重复;每个产物只映射一个议题编号。还会按 .atdd-pipeline.json:integration_branch_pattern 从 trunk_branch 创建集成分支,缺失标签用 gh label create --force 补齐。
限制:不创建 PR、不指派评审人、不修改规格产物。与 mattpocock 的 to-issues(通用任务拆分)不同,本技能层级、标签固定;若项目使用 triage 状态机,可先对场景子议题做 triage。