SuperAPI AI 工具集

grill-with-docs

设计与创作

查看项目

更新于 10-15 21:08

技能介绍

用途:在动手写代码之前,结合项目设计文档对 issue 或 PRD 做深入审查,扮演友善但毫不手软的“恶魔代言人”,找出疏忽、模糊之处和潜在边界问题。核心理念是:在纸上修正设计远比在代码中修正便宜。

主要能力:识别设计层面的偏差(功能是否与最近 ADR 冲突、是否重复已被否决的做法);挖掘边缘情况(空输入、操作中途失败、并发);发现遗漏的备选方案;找出用户旅程中的断裂。审查以具体问题呈现,每个问题都引用所审查的文档,并附说明解释为何可能成为问题,而非写成检查清单。

使用方式:先阅读待审查的 issue(正文、评论、标签及 PRD 引用);再列出并读取可能相关的文档,格式参考 ADR-FORMAT.md 与 CONTEXT-FORMAT.md;核心文档包括 PRD、最近的相关 ADR、全局上下文(CONTEXT.md / CONTEXT-MAP.md 中的领域术语表与高层架构图)。随后提出具体问题,总结反复出现的模式(可能是架构问题而非功能问题),最后把发现写入相应 issue 的评论中。

适用场景:triage 或诊断之后对 issue 进行“拷问”;审查 PRD 与设计文档的一致性;在编码前评估设计风险。

限制:资料未提供具体安装命令、平台支持、收费方式或效果数据;文档相关性需自行判断,不应假设哪些文档相关。