SuperAPI AI 工具集

grill-me-with-docs

写作与研究

查看项目

更新于 10-16 07:24

技能介绍

用途:这是一个需用户主动调用的技能,在普通“拷问式访谈”循环基础上加入文档维护。它通过不断提问来挑战你的计划,使计划与既有领域模型一致,统一术语,并就地更新 CONTEXT.md 与 ADR 文档。

主要能力与使用方式:技能会围绕计划的每个方面持续访谈,逐一走完设计树的各分支,消解决策间依赖。每次通过 AskUserQuestion 只问一个问题,绝不批量提问,因为每个回答都可能改变下一个问题。每题给三个基于代码库与计划分析得出的具体选项,外加第四个“Chat about this”。推荐项放在首位并在标签后加 (Recommended),且始终要有推荐。AskUserQuestion 自带自由填写的“Other”,所以不要自己再加,也不要因已有“Other”而省掉“Chat about this”。若选“Chat about this”,只问“What would you like to chat about?”,不猜测话题,讨论后按需修订并重问。若问题能通过探索代码库回答,就探索代码库而不提问。

领域文档:探索代码库时也寻找既有文档。多数仓库为单一上下文,根目录含 CONTEXT.md 与 docs/adr/;若有 CONTEXT-MAP.md 则表示多上下文,每个上下文各有自己的 CONTEXT.md 与 docs/adr/,系统级 ADR 在顶层 docs/adr/。文件按需创建:无 CONTEXT.md 时,在首个术语确定时创建;无 docs/adr/ 时,在首个 ADR 需要时创建。

会话中:当用户用词与 CONTEXT.md 冲突时立即指出;用词模糊时提出精确规范术语;讨论领域关系时用具体场景压力测试边界;用户陈述与代码不符时当面提出矛盾。术语确定后就地更新 CONTEXT.md,不要批量延迟,格式见 CONTEXT-FORMAT.md。CONTEXT.md 仅为术语表,不得含实现细节,也不能当规格或草稿。ADR 仅在同时满足三点时才提议:难以逆转、脱离上下文会令人困惑、是真实权衡的结果;缺一即跳过,格式见 adr-format.md。