SuperAPI AI 工具集

grill-with-docs

写作与研究

查看项目

更新于 10-16 03:44

技能介绍

用途:对方案进行持续的“拷问式”评审,逐一走完设计树的每个分支,解决决策之间的依赖关系,直到达成共识。

主要能力:

  • 每次只提一个问题,等待反馈后再继续;每个问题附带推荐答案。
  • 若问题可通过探索代码库回答,则直接探索代码库而非提问。
  • 领域觉察:探索代码库时查找已有文档(CONTEXT.md、CONTEXT-MAP.md、docs/adr/ 等)。
  • 挑战术语表:当用户用词与 CONTEXT.md 中已有语言冲突时立即指出。
  • 锐化模糊语言:对含糊或过载的术语提出精确规范术语(如区分 Customer 与 User)。
  • 具体场景压力测试:用边界场景检验领域关系与概念边界。
  • 与代码交叉核对:用户描述与代码矛盾时提出质疑。
  • 即时更新 CONTEXT.md:术语确定后立即写入,使用 CONTEXT-FORMAT.md 的格式;CONTEXT.md 只是术语表,不写入实现细节。

文档结构:单一上下文仓库在根目录放 CONTEXT.md 与 docs/adr/;多上下文仓库在根目录放 CONTEXT-MAP.md,指向各上下文的 CONTEXT.md 与 docs/adr/。文件惰性创建:首次解析术语时创建 CONTEXT.md,首个 ADR 需要时创建 docs/adr/。

ADR 使用限制:仅在同时满足三条时提议创建——难以逆转、缺乏上下文会令人意外、是真实取舍的结果;否则跳过。使用 ADR-FORMAT.md 格式。

适用场景:方案评审、领域建模术语统一、架构决策记录。

限制:未提供具体安装命令、收费标准、支持平台或效果保证。