SuperAPI AI 工具集

to-prd

通用与其它

查看项目

更新于 10-16 03:14

技能介绍

用途:将已有对话上下文与代码库理解综合为一份 PRD 产物,默认是 markdown 文件,也可通过标志提交为 GitHub issue。它不进行访谈,而是从上下文、代码库探索和先前决策中提取信息;产物就地迭代,用户确认后提交。

输出模式:默认文件模式写入 <project-root>/docs/prd/<feature>.md,可重复运行并覆盖;无标志、离线、仓库无 GitHub 远程或用户明确要跟踪文件时使用。标志模式(--emit-issue)通过 gh issue create --title "PRD: <feature>" --body-file <tmp> 提交,仅在用户明确选择或项目约定使用 issue 跟踪 PRD 时使用(检查 <project-root>/CONTRIBUTING.md 和 .github/ISSUE_TEMPLATE/)。有歧义时默认文件模式,并向用户提一个针对性问题。

流程:1)若上下文已覆盖领域语言、命名约定和模块形态则跳过探索,否则派发 Explore 代理,读取 CONTEXT.md、AGENTS.md、docs/adr/ 和 UBIQUITOUS_LANGUAGE.md,可用 fd -e md . docs/ 与 bat -P -p -n -r 做定向阅读。2)识别深模块,优先大功能配窄而稳定接口,列出 3-7 个候选及其接口,推荐哪些模块值得独立测试。3)仅在受阻时验证意图,一次只提出一个未决轴并给建议。4)按模板撰写 PRD,包含问题陈述、解决方案、用户故事、实现决策、测试决策、范围外和进一步说明。

迭代与交接:每次重跑对比当前产物与最新上下文,扩展或修订章节,不静默删除已有内容,更新 Last-revised: <ISO date> 页脚。产出的 PRD 文件是下游实现规划的输入契约,需明确交接路径或 issue URL。限制:资料未提供具体收费、平台支持范围或效果保证。