SuperAPI AI 工具集

grill-with-docs

写作与研究

查看项目

更新于 10-15 19:58

技能介绍

用途:这是一个“拷问式”设计评审技能。它通过反复、逐条追问,帮助你与既有领域模型对齐,澄清设计分支上的依赖关系,并把达成的共识即时写入文档。

主要能力:一次只问一个问题,等待反馈后再继续;每个问题都给出推荐答案;能用代码库回答的问题改为直接探索代码库;探索时查找现有文档,识别单上下文(CONTEXT.md)与多上下文(CONTEXT-MAP.md)结构,并处理 docs/adr/ 目录。

会话中的做法:当用户用词与 CONTEXT.md 既有语言冲突时立即指出;对模糊或含义过载的术语提出精确的规范用词(如区分 Customer 与 User);用具体场景压力测试领域关系与边界;用代码交叉验证用户描述,发现矛盾时当面提出;术语一旦确定就立即更新 CONTEXT.md,格式见 CONTEXT-FORMAT.md。CONTEXT.md 只作为术语表,不写实现细节,也不当作规格或草稿。

ADR 的取舍:仅当同时满足三点才提议创建 ADR——难以撤销、缺少背景会令人困惑、来自真实权衡;任一不满足则跳过。格式见 ADR-FORMAT.md。文件按需创建:首个术语确定时创建 CONTEXT.md,首个 ADR 需要时创建 docs/adr/。

适用场景:需要在编码前理清领域概念、统一术语、记录关键架构决策的团队或个人。限制:资料未提供收费、价格、平台支持与具体安装步骤,暂未提供。