带文档拷问
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kunlungrowth/kg-grill-with-docs
技能介绍
打破前期设计的模糊与断层
在软件工程的早期构思阶段,工程师的想法往往是碎片化且模糊的。直接跳过思考过程编写代码或规格说明,常常导致后期的大量返工与设计缺陷。此外,缺乏纸面痕迹使得团队在后续迭代中无法复用当时的决策上下文。本技能旨在解决这一痛点,通过高强度的结构化访谈,将模糊的计划逼问到清晰,并在过程中同步沉淀领域文档。
核心工作流与能力
该技能扮演严苛的访谈者与领域建模师双重角色,其核心工作流分为以下几个关键步骤:
- 逐个问题拷问:启动
/grilling模式,一次只提出一个问题,直击计划中的模糊地带,直到所有设计细节都变得清晰可执行。 - 即时领域建模:每当核心术语被敲定,立即更新
CONTEXT.md以记录领域词汇;每当遇到难以逆转或有真实权衡的决策,当场撰写一条 ADR(架构决策记录)。 - 产出标准化工件:访谈结束后,不攒批更新,而是实时落盘。最终生成一个
GrilledDesign结构化工件,包含决策列表、术语更新、ADR 索引以及下一步建议(如转规格或拆工单),方便下游流程消费。
适用边界与注意事项
需要注意的是,本技能专注于打磨与记录,而非生成实现代码。它适用于拥有明确想法且希望留下详尽架构上下文的场景。如果你当前没有代码库,且不需要保留任何文档痕迹,建议改用无状态的 grill-me 技能。此外,访谈过程依赖于高质量的问题库与文档模板,确保拷问的深度与文档的规范性。
使用场景
- 对模糊产品想法进行高强度访谈,同步沉淀领域术语至CONTEXT.md,理清设计细节
- 将架构决策过程转化为ADR记录,确保可追溯的决策上下文,便于团队后续复盘
- 需要将想法转化为标准化GrilledDesign工件,供下游转规格或拆工单消费
- 在有代码库的场景下,通过逐个问题访谈优化计划,同时更新CONTEXT.md文档
适合人员
- 软件架构师,需要通过结构化访谈完善设计方案并沉淀领域文档
- 研发团队负责人,希望将模糊计划逼问清晰,留下可复用的决策记录
- 技术文档工程师,需要从访谈中提取术语和决策,更新CONTEXT.md和ADR
- 需要将想法转化为标准化工件的工程师,便于下游流程消费GrilledDesign