Grill Pro 追问式设计评审
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_dc515faf/grill-stan。
技能介绍
要解决的问题
大型设计讨论常出现术语漂移、边界含糊、口头假设与代码行为不一致。工程师可能在“账户”、“取消”这类词上各说各话,导致后续实现反复返工。Grill Pro 不是直接给方案,而是把方案当成待验证对象,通过连续追问把模糊前提暴露出来。
技能如何工作
它按“一次一问”推进设计树:先确定依赖关系,再逐层追问决策理由。若问题能通过仓库探索回答,它会优先查看代码而不是继续提问。若发现代码与陈述冲突,会明确指出:“代码里取消的是整个 Order,但你说支持部分取消,哪个才是预期?”
会话中它会做几类检查:
- 术语校准:对照
CONTEXT.md中的领域词汇,发现不一致立即指出。 - 边界压测:用具体场景追问“取消”“账户”等概念是否指不同对象。
- 代码交叉验证:把用户描述映射回代码行为,避免口头设计覆盖真实实现。
- 文档落盘:术语确定后更新
CONTEXT.md,只维护项目特有名词,不写实现细节。 - ADR 谨慎提出:仅当决策难反悔、缺乏上下文时易被误读、且存在真实取舍时,才建议写入
docs/adr/。
适用边界
它适合架构设计、领域建模、接口边界、迁移方案等需要共识的讨论。对纯文案、一次性脚本、没有代码上下文的问题,价值有限。资料没有仓库时,它会跳过 CONTEXT.md 和 ADR 更新,但仍可进行访谈式追问。若团队已有更严格的文档规范,需要自行约定文件命名与 ADR 模板,避免该技能生成的轻量格式与既有流程不一致。
使用场景
- 在重构订单取消接口前,把用户意图、边界场景与代码现有行为逐项对齐。
- 评审支付账户模型时,澄清客户、用户与账户的边界并把定稿术语写入 CONTEXT.md。
- 迁移旧库存服务前,用具体场景压测超卖、回滚和幂等边界,并检查代码是否一致。
- 设计审批流程时,判断哪些决策难反悔且存在真实取舍,再决定是否补 ADR。
适合人员
- 负责订单域架构的工程师:需要在取消、退款等接口变更前提前对齐边界和术语。
- 主导领域建模的产品工程师:需要把模糊概念收敛为项目专属名词并维护 CONTEXT.md。
- 做服务迁移的技术负责人:需要用场景压测旧系统行为,并决定哪些决策写 ADR。
- 评审 API 契约的后端工程师:需要交叉验证接口语义与代码实际行为是否一致。