关于 tk-grill
通过结构化提问和确认后的总结,帮助梳理初步想法、决策或计划。状态保留在当前对话中,不会继续执行实现工作。
主要功能
- 01梳理决策及其依赖
- 02分轮提出未决问题
- 03区分事实与假设
- 04总结前请求确认
- 05提供相关后续路线
适用场景
- 01梳理项目决策
- 02厘清计划中的假设
- 03实现前比较备选方案
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ mtgvim/ tiger-kit --skill tk-grill安装后在 Claude Code 中输入/tk-grill确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
LICENSE.txtagents/openai.yamlassets/html-theme.csshtml-theme.jsreferences/artifact-paths.mdauthentication.mdquestions.mdvisual-questions.md详细介绍
决策梳理
仅通过明确的 /tk-grill、$tk-grill 或宿主技能选择启动。用户要求快速发表意见、一般性头脑风暴、解释仓库或制定实现计划时,不要自动调用。
边界
从粗略想法、决策或计划开始访谈,直到双方确认理解一致。所有状态均保留在当前对话中。
不要创建或修改源代码、测试、配置、Git 状态、工单、Seed、SDD、领域工件、通用临时文件、台账或任务图。只有 Visual questions 分支允许在 .tigerkit/tmp/tk-grill/<run-id>/ 下创建一个 HTML 对比文件,并设置其所需的忽略规则。不要自动调用其他技能或开始实现。
综合结论后,只提供相关的可选后续路径:
- 当结果已变成实现请求或工单时,使用
tk-prep; - 当用户需要仓库原生词汇或持久化决策时,使用
tk-domain; - 如果不需要进一步行动,则停止。
如果用户要在当前会话中使用下一项技能,只需用一行写出 /<skill>,并说明当前对话内容会延续过去。只有切换到其他会话时,才提供完整的交接提示;遵守 disable-model-invocation,不要尝试调用或模拟其流程。
决策树与前沿
将主题映射为一棵决策树。只有先决条件确定后,某个分支才可能得到解答。当前的前沿包含所有现在无需猜测其他未决答案即可回答的未决决策。
分轮进行:
- 区分已确认事实、未决假设和由用户决定的事项。
- 根据对话、用户提供的文件、仓库、已连接的工具或范围有限的公开来源,查证可安全研究的事实。不要向用户询问现有证据可以回答的事实。将 Shell 查询限制在已验证的仓库根目录内;为搜索 glob 加引号(例如
rg --glob '*.ts'或grep --include='*.ts'),并省略仅用于分隔的命令,尤其是在 zsh 中以=开头且未加引号的单词。 - 在一轮中询问当前前沿中的所有问题。只将彼此独立的问题分组;不要强行规定问题数量或每轮大小。在本轮首次提问前,先阅读 问题轮次,并将其中的格式应用于每一轮。如果前沿中的任何问题涉及布局、层级、密度或导航方案的比较,则在同一轮中附上可视化问题辅助材料。
- 如果某个问题的答案取决于尚未解决的先决条件,则暂缓提问。未解决的研究事实只会阻塞其依赖的分支,不会阻塞前沿中的其他部分。
- 用户回答后,更新决策树,找出矛盾或新显露的假设,重新计算前沿,然后继续。
不要将事实调查变成无止境的研究。只调查可能实质性改变当前决策树的事实。
对于影响重大的备选方案,依据其决定性假设和优先事项检验建议:在有依据的情况下,指出什么条件变化会使另一选项更合适。通过研究核实可查证的限制,不要询问用户;只询问由用户决定的优先事项。如果尚不清楚什么条件会改变选择,就保留这种不确定性,不要凭空设定阈值。对于轻微且容易撤销的选择,跳过这项分析。
可视化问题
对于尚未解决的空间方案,阅读可视化问题,并在编号文本轮次中附上一份 HTML 对比文件。每项决策都必须在对话中完整解决;该辅助材料也会收集同一轮中的非可视化选择。边界仅允许使用此问题辅助材料及其规范的工件设置。
问题约定
目标、优先级、取舍偏好、范围、含义、语气和可接受的风险由用户决定。绝不默默替用户做出选择。能够给出有用建议时,应说明建议及理由,而不是只列出中立选项并把所有判断都交给用户。
如果建议取决于现有机制或数据何时存在,应引用能够证实这一点的 path:line;否则,应先调查再提出建议。
不要为了显得周全而追问后续问题。穷尽探究意味着不留下未明说的决策分支,而不是尽可能多地提问。
完成
待决事项似乎已全部解决时:
- 检查整个树,确认没有未访问的分支、隐藏假设、矛盾或有意留存的风险。
- 简要总结当前的理解,并请用户确认双方理解一致且完整。
- 确认前不要根据结果采取行动。如果用户提出修正,请更新决策树,并从新的待决事项继续。
- 用户确认后,简要综合目的或结论、关键决策及其理由、有意保留的假设或风险,以及可选的后续路径。若已识别出重要的转向条件,也应一并说明。不创建其他产物;仅保留已获授权的可视化问题辅助材料。
来源
改编自 mattpocock/skills 在提交 6654f6b60cd9d5be8b54c6fafe44346dabeb3b76 中的 skills/productivity/grilling,借鉴了其中的决策树、考虑前置条件的待决事项边界、全边界轮次、事实与决策的归属划分、建议,以及共享理解确认机制。
TigerKit 移除了对必需子 Agent 运行时的假设、grill-me 和 grill-with-docs 等包装器、自动转入实现阶段的机制,以及持久状态。原始版权声明和 MIT 许可声明见 LICENSE.txt。
产物路径
产物操作需要任务授权。在写入/检出/传输/设置忽略规则之前,请先阅读 产物路径,检查 Git 排除规则、路径和所有权。重复利用上下文中完全相同的内容;对不确定性进行哈希校验,并在发生变更/丢失时重新读取;始终再次检查安全性。除非明确指定目标位置,或符合可用的持久根目录分支,否则使用 .tigerkit/。仅限聊天的任务:跳过文件/忽略规则设置和此参考文档。这不授予任何无关的修改/发布权限。经授权的非机密清理应优先使用新建目录和受支持的回收站;目标只能是有记录的、字面值明确且已解析的绝对路径,且必须属于本次运行;不得使用 cd 再配合通配符/相对路径删除。
面向读者的结果摘要
简要汇报结果,包括结论、实际验证情况、重要限制以及可直接访问的交付物链接。区分计划执行的检查/跳过的检查与实际执行的工作;保留尚待人工完成的检查,以及真实的清理、阻碍或人工操作详情。绝不声称已完成或已清理,除非经过验证。保留所有者要求的产物、发布预览、审批边界、机器返回内容、精确状态/页脚和最终问题块;嵌套返回内容应简洁,并省略空白章节。
输出格式
使用 ASCII 编号(1. Item、(1) Item)和 - Item,不要使用带圈/键帽数字。
完整显示可点击的绝对文件路径,包括示例,不要使用省略号。
除非获准编辑,否则应保留代码、命令、标识符、URL、引文和经验证的 UI 标签原样。
对于在聊天中比较多个共同属性的情况,使用窄型 GFM 管道表格(约四列,包含表头,单元格内容简短);其他情况使用列表。不要使用框线字符、围栏表格或空表格。所有者专用预览优先;发布正文和文件产物应保留各自的表格格式。
在渲染后的 Markdown 正文中,范围使用连字符表示,字面量波浪号应转义为 \~;代码、引文和标识符必须原样保留。
对于经授权创建和使用的临时输入文件,创建和使用前应遵循“产物路径”要求;预填模板不等于已完成的输入。这不授予写入权限。
用户问题
调查事实;重用授权。对于由用户决定的事项,请阅读
问题轮次;否则继续处理。
普通聊天中,即使只有一个审批,也要单独添加 ---,然后
为每项添加 ❓ **Q<n> · <title>**: <question> 和 ➡️ <recommendation>。
只询问已确定的前置问题;审批需单独询问。
问题放在最后;先说明状态、风险和计划。
技能反馈
对于可复用的事件,在当前对话中保留最少量的非机密证据,
并建议使用 tk-retro;除非用户提出要求,否则不要写入持久记忆。
调用、反馈产物、已安装技能的编辑和发布都需要通过所属工作流单独授权;此处的说明不授予任何权限。