SuperAPI AI 工具集

issue-to-prd

编程与开发

查看项目

更新于 10-15 21:41

技能介绍

用途:把新到的 GitHub issue 整理成结构化 PRD,或在 issue 描述不充分时发布澄清问题。适用于新 issue 需要结构化(challenge-new-issue 事件触发)、人工回答 open-questions 后重新挑战(rechallenge-after-answers 触发),以及手动对特定 issue 进行结构化。

用法:/issue-to-prd {repo} {issue_number},例如 /issue-to-prd fellowship-dev/pylot 123。11 阶段顺序执行:00-automation-guard(无自动化/epic/已关闭 issue 直接拒绝,不读取任何内容);01-read-issue 拉取标题、正文、标签、评论;01b-triage-challenge 搜索已有同类机制并对照,给出 delete-retire/close/re-scope/prd 判定,非 prd 则停止;02-context-completeness 审查新 agent 会遗漏的隐性上下文缺口;03-assess-clarity 按 8 节缺口清单判定 clear 或 needs-questions;04-failure-modes 预测 agent 可能出错的方式并给出护栏;05-test-plan 测试策略与前置条件;05b-prototype-gate 判定是否 UI 探索;05c-outcomes-baseline 检测 issue 中是否存在因果目标/评估/结果契约,仅存在时获取该指标基线(fail-open);06-ask-or-structure 决定发布问题(退出)或起草 PRD;07-publish 重写 issue 正文并打标签。

退出路径:防护路径(阶段 00,不读不写,status=success 并停止);分诊路径(阶段 01b,发布一条含判定与引用证据的评论,打 wontfix 或 needs-rescope,停止,无引用绝不触发);提问路径(阶段 06,发布评论并加 open-questions 标签后停止);PRD 路径(阶段 07,重写正文并加 prd-ready,若无待定原型变体再加 ready-to-work)。

原型变体:阶段 05b 可派发任务推送 proto/<issue>-a|b|c 分支并发布含截图与启动说明的选项评论,供负责人选择;仅显式负责人信号(prototype-options 标签或“build the prototype”回答)才触发派发。各阶段写入 output/handoff.md,下游读取上游交接。执行须顺序进行并先读各阶段 CONTEXT.md;阶段 00 与 01b 为硬门,05c fail-open 不拦截阶段 06,阶段 06 若已发布问题则跳过阶段 07。参考文件包括 shared/prd-template.md、shared/failure-modes.md、shared/prototype-mission-brief.md 及各阶段参考清单。限制:暂无平台、价格或效果方面的公开信息。