SuperAPI AI 工具集

grill-with-docs

编程与开发

查看项目

更新于 11-15 16:06

技能介绍

用途

grill-with-docs 是一个用于“计划拷问”的会话技能。它要求围绕计划的每个方面持续追问,直到用户与助手对设计达成共同理解。它按决策树逐层推进,逐一解决决策之间的依赖关系。

主要能力

  • 决策树循环:开始时从用户计划中识别决策树的初始分支,之后反复取出最深未解决分支,收集代码库、文档、数据库和既有回答作为上下文,提出一个问题并附推荐答案,等待用户反馈后再继续。用户回答若揭示新的子决策,会加入决策树;退出条件是所有叶子节点均已解决。
  • 领域意识:在探索代码库时同时查找现有文档。多数仓库使用单一上下文,结构为根目录下的 CONTEXT.md、docs/adr/ 和 src/;若根目录存在 CONTEXT-MAP.md,则说明仓库包含多个上下文,映射文件指向各上下文所在位置,每个上下文可有自己的 CONTEXT.md 和 docs/adr/。文件按需惰性创建:首次有术语确定时才创建 CONTEXT.md,首次需要 ADR 时才创建 docs/adr/。
  • 术语挑战与收敛:当用户使用的术语与 CONTEXT.md 中既有语言冲突时立即指出;对含糊或过载的术语,提出精确的规范术语并请用户确认。
  • 场景压力测试:讨论领域关系时,构造具体场景,重点探测边界情况,迫使用户厘清概念之间的界限。
  • 代码交叉验证:用户描述系统如何工作时,检查代码是否一致;发现矛盾时直接指出,例如“代码会取消整个订单,但你刚说支持部分取消——哪个正确?”
  • 即时更新文档:术语一旦确定,立即就地更新 CONTEXT.md,不批量延后,格式参照 CONTEXT-FORMAT.md。CONTEXT.md 只作为术语表,不得包含实现细节,也不能当作规格说明或草稿本。
  • 不确定时建议原型:当存在多种方案且仅靠推理无法选择时,建议调用 /prototype 技能构建可运行原型来验证决策。
  • 谨慎提议 ADR:只有同时满足三条才建议创建 ADR——后续更改代价显著、缺少上下文会让未来读者困惑、确实是在多个真实备选方案间做出的权衡;任一条件不满足则跳过。格式参照 ADR-FORMAT.md。

使用方式

以会话形式启动:提供你的计划,技能会一次只问一个问题并给出推荐答案,等待你对每个问题的反馈后再继续。可以回答的问题会优先通过探索代码库、数据库或文档来获取答案,而不是直接询问。会话默认使用中文回应。

适用场景

适合在开始实现之前澄清设计方案、统一领域术语、梳理决策依赖、沉淀 CONTEXT.md 术语表与 ADR 决策记录。适用于存在明确领域模型、需要长期维护文档的代码项目。

限制

资料未说明该技能的安装方式、运行环境、平台支持、收费模式或效果指标,暂未提供。技能本身不负责实现代码,只推动理解与文档沉淀;CONTEXT.md 与 ADR 的写入需遵循对应格式文件,资料未提供这两份格式文件的详细内容。