SuperAPI AI 工具集

grill

写作与研究

查看项目

更新于 10-15 17:19

技能介绍

用途:Grill 是一个决策访谈与文档记录技能,仅当用户明确要求进行 grilling 并要求持久文档,或直接调用该技能时启用。仅因复杂度、模糊性或“可能需要文档”都不足以触发;它自带访谈与文档契约,运行时不加载 domain-modeling。

主要能力:先在仓库 issue、文档和代码中研究可发现的事实,只向用户询问无法查明的判断性事实;一次只问一个迫使决策的问题,先给出推荐答案与简短理由再等待回答;用普通文本提问,不用问题工具;当决策有界时给出 2-3 个互斥选项,推荐项在前,允许用户选择、修改或讨论;仅在用户明确要求或问题涉及智能体产品行为时使用对比表;沿着依赖决策追问直至决策树穷尽,不问“我们完成了吗”这类元问题;最后汇总目标、非目标、决策、约束、风险、验证与未决项。

范围契约:访谈在书面固定范围且用户明确接受该文本后才算结束,包括制品边界(在范围内的文档、目录、PR、代码路径,以及范围外的后续规格、测试、运行时代码或任务计划)与完成条件清单(已落地提交、已关闭 issue、已验证证据)。分阶段设计逐阶段批准,执行性话语(如“go”“do it all”)不放宽范围。接受的范围契约需发布在执行方与监督者可见处(仓库工作则为所属 issue),引述用户原话、渠道与时间;该评论只是协作证据,持久决策写入本技能所写记录。结束访谈不授权实现,实现需单独明确请求。

文档契约:首个提问前,依据用户指定目标与仓库既有文档惯例确定目标文档,检查本地说明、索引、规格、ADR、术语表与邻近文档;无法确定时只问一个问题,绝不凭空创建统一路径。以 Draft 创建或更新目标,每条已定决策立即写入 Draft 并保留未决问题标记;中断或取消时保留草稿与文件改动、标记未决问题、不自动回滚。仅在确实撰写该类型文档时读取 CONTEXT.md、ADR、术语表等格式参考。Write/Edit 工具事件即为文档工作的实时证明,不重复输出状态行。明确要求文档是硬性完成条件,零文件改动无法满足;只有用户明确接受才能从 Draft 改为 Final,决策树穷尽不意味着接受;最终回复需列出所有改动的文档路径及其 Draft/Final 状态。

来源与限制:技能名称与访谈方法来自 Matt Pocock(@mattpocockuk)的 grilling skill,仓库 https://github.com/mattpocock/skills,本处技能文本为自有内容,详见包内 CREDITS.md。目标项目提供适用的形式化检查器时,需按其本地文档准备声明的访谈输入并在选择大纲前后运行检查,记录结果与来源绑定;缺失或过期证据会限制依赖结论,但独立允许的工作可继续。其他限制、收费或平台信息资料未提供。