SuperAPI AI 工具集

grill-with-docs

写作与研究

查看项目

更新于 10-15 20:27

技能介绍

用途:对一份计划进行持续追问式评审,直到双方达成共识。它会沿着设计树的每个分支逐项推进,逐个解决决策之间的依赖关系,并对每个问题给出推荐答案。

主要能力:

  • 一次只问一个问题,等待反馈后再继续。
  • 若问题可通过探索代码库回答,则改为探索代码库。
  • 领域感知:探索代码库时同时查找已有文档。
  • 对照术语表提出质疑:当用户用词与 CONTEXT.md 中既有语言冲突时立即指出。
  • 锐化模糊语言:对含糊或含义过载的术语提出精确的规范术语。
  • 讨论具体场景:用具体场景压力测试领域关系,探测边界情况。
  • 与代码交叉核对:用户描述某行为时检查代码是否一致,发现矛盾就提出。
  • 内联更新 CONTEXT.md:术语确定后立即更新,不批量处理,格式见 CONTEXT-FORMAT.md。
  • 谨慎提供 ADR:仅当难以逆转、缺少上下文会令人意外、且是真实权衡的结果三者同时成立时才建议创建,格式见 ADR-FORMAT.md。

文件结构:多数仓库只有一个上下文,根目录含 CONTEXT.md、docs/adr/ 与 src/。若根目录存在 CONTEXT-MAP.md,则仓库有多个上下文,该映射指向各自位置,例如 src/ordering/ 与 src/billing/ 各自带 CONTEXT.md 和 docs/adr/。文件按需惰性创建:没有 CONTEXT.md 时,在第一个术语确定时创建;没有 docs/adr/ 时,在需要第一个 ADR 时创建。

限制:CONTEXT.md 不应耦合实现细节,只收录对领域专家有意义的术语。资料未提供安装命令、收费、平台与效果信息。