SuperAPI AI 工具集

grill-with-docs

写作与研究

查看项目

更新于 10-16 07:16

技能介绍

用途:在压力测试一个方案的同时,把讨论结果写成文档。它不是普通问答,而是延续 grill-me 的一问一答式访谈,边问边把已解决的问题、已作出的决策和遗留问题记录下来,形成 CONTEXT.md 或架构决策记录(ADR)。

主要能力:逐题追问,一次只问一个问题,并给出推荐答案;在适用时探索代码库;每解决一个分支就把决策追加进正在维护的文档,而不是等到最后才写;沿用项目已有的 ADR 模板(如 docs/decisions/ 或 adr/ 中存在的模板),否则使用默认 CONTEXT.md 大纲。

默认文档结构:问题(在决定什么、为何重要)、目标与非目标、已探索的分支(每个分支含问题、选项、推荐、决策)、依赖关系、风险与缓解、最终决定的做法、开放问题(含负责人与重访触发条件)、引用。

使用方式与触发语:用户说“grill me and write it up”“grill this and produce a CONTEXT.md”“grill with docs”“stress-test this and write an ADR”“interview me and capture the decisions”等时启用。示例流程为先就“缓存层要解决什么用户可见问题”提问并给出建议,用户回答后追加为文档目标,再逐分支推进,最后写入指定路径并请用户复核。

限制与规则:先运行 grill-me 再写文档;增量写入;记录决策而非聊天记录,文档需能独立成立;已存在同一主题的 CONTEXT.md 或 ADR 时应更新而非新建平行文件;结尾列出被搁置的分支或未解决风险,并注明负责人与重访触发条件;需用户复核接受最终成稿。文档格式、模板位置与验证清单以资料所述为准;默认输出仅返回结果、阻塞项与所需证据,不加前言、过程叙述,通常不超过五条要点。