grill-with-docs
通过持续追问来打磨计划或设计,同时也会顺带生成文档(ADR 和术语表)。
技能说明mattpocock/skills
通过持续追问来打磨计划或设计,同时也会顺带生成文档(ADR 和术语表)。
技能简介
grill-with-docs 是一个通过持续追问来打磨计划或设计的技能。它以面试官式的犀利提问暴露方案中的漏洞与盲点,同时在讨论过程中自动生成架构决策记录(ADR)和术语表,让产出既有深度又有文档沉淀。
使用场景
- 制定技术方案或产品规划时,需要更严谨地验证假设
- 架构设计评审前,先通过追问自查潜在风险
- 需要为项目快速生成 ADR(架构决策记录)
- 团队对关键概念定义不一致,需要形成统一术语表
- 将模糊想法逐步转化为可执行的详细计划
使用方法
该技能设置了 disable-model-invocation: true,因此模型不会自动调用它,需由用户主动请求。在支持 Claude Skills 的 Agent 环境中,请手动调用 Skill 工具,并选择 grill-with-docs。
按官方要求,需要调用 Skill 工具两次:
- 第一次调用用于
grilling:对计划或设计进行持续追问、压力测试,逐步澄清需求、约束和决策。 - 第二次调用用于
domain-modeling:基于刚才的讨论,提取领域模型,生成术语表和 ADR。
建议在对话中明确告知 Agent:“请使用 grill-with-docs 技能来连续追问,先 grilling,再 domain-modeling。” Agent 会据此执行两次调用。
注意事项
- 由于
disable-model-invocation: true,不要期待 Agent 自动套用该技能;必须显式请求。 - 完整流程需要两次 Skill 调用,缺一不可;仅执行一次会丢失领域建模和文档生成环节。
- 生成的 ADR 和术语表是随讨论迭代产生的,建议在过程中同步保存。