show-me + grill-me 结合使用总结

核心公式 ：

grill-me 澄清需求 → show-me 图解需求 → 评审迭代 → 开发落地

1. 两个技能分别解决什么

技能	核心作用	典型触发	主要输出
grill-me	像严格导师一样拷问需求，按决策树逐层追问，澄清边界、数据、交互和异常情况	`/grill-me`、`grill me`、`先拷问我`	共识、决策记录、被澄清的需求
show-me	将复杂信息可视化，把需求、逻辑、代码结构画成图	`/show-me`、`用 show me 图解......`	伪代码、调用树、组件树、Mermaid 图、文件树、Diff、HTML 产物

关键区别：

grill-me 负责"问清楚"。
show-me 负责"画明白"。
只问不画，理解仍抽象；只画不问，可能把错误理解画得很漂亮。

2. 推荐工作流：先拷问，后图解

阶段一：用 grill-me 澄清需求

描述完初步想法后，立即触发：

text 复制代码

/grill-me
我要做【功能名称】。请按决策树逐个追问，直到需求边界清晰。

grill-me 通常会追问：

数据模型：有哪些实体、字段、关系？
交互流程：用户如何触发？系统如何响应？
边界情况：空数据、超大数据、无权限怎么办？
异常处理：失败、超时、重复提交如何处理？
依赖关系：依赖哪些模块、接口、第三方服务？
优先级：哪些必须做，哪些可以后置？

目标：把模糊想法变成可决策的问题清单。

阶段二：用 show-me 把共识画成需求蓝图

在 grill-me 结束后，紧接着触发：

text 复制代码

/show-me
请根据我们刚才讨论的需求，用 Mermaid 时序图展示主流程，
用组件树展示 UI 结构，用伪代码展示核心业务规则。

按需求维度选择视图：

需求维度	推荐 show-me 视图	能回答的问题
业务流程	Mermaid 时序图	用户、前端、后端、服务之间如何交互？
功能逻辑	伪代码	核心规则、判断、算法是什么？
系统结构	组件树 / 文件树	前端页面、组件、后端模块如何划分？
UI 与交互	HTML 产物	页面布局、状态变化、复杂交互长什么样？
变更影响	Diff 视图	这次需求改动了哪些组件、文件、调用链？

目标：把口头共识变成可评审、可分享、可开发的视觉契约。

阶段三：评审与迭代

基于 show-me 生成的图进行评审。

如果发现新的模糊点：

再次使用 /grill-me 针对性追问；
然后再次使用 /show-me 更新图表；
直到图能准确回答开发所需的关键问题。

阶段四：进入开发，并继续用 show-me 理解代码

开发阶段可以继续用 show-me 辅助：

text 复制代码

/show-me 用调用树解释这个函数的触发链路。
/show-me 用组件树展示这个页面的状态和组件边界。
/show-me 用伪代码说明这段核心逻辑。

这样，图表不仅是需求文档，也能成为代码理解工具。

3. 示例：用户导出数据

grill-me 阶段

它可能追问：

导出触发方式：按钮、定时任务还是 API？
导出范围：当前页数据还是全部历史数据？
文件格式：CSV、Excel 还是 JSON？
大数据量：同步等待还是异步邮件通知？
权限控制：哪些角色可以导出？
失败处理：部分失败如何反馈？

show-me 阶段

澄清后，可以生成：

Mermaid 时序图：用户点击导出 → 前端请求 → 后端查询 → 文件生成 → 下载或邮件通知。
组件树：导出按钮、进度提示、结果反馈、错误提示之间的关系。
伪代码：导出权限判断、数据范围过滤、异步任务触发逻辑。
文件树：新增或修改的模块、服务、工具文件。

最终得到一份经过逻辑拷问、并已视觉化的需求蓝图，再进入开发，能显著减少返工。

4. show-me 视图速查表

视图	用途
伪代码	展示逻辑、算法、业务规则
调用树	展示程序运行时调用关系
组件树	展示前端 UI 结构、状态和模块边界
Mermaid 图	展示流程、时序、交互、数据流
文件树	展示项目结构、文件职责
Diff 视图	展示变更内容，忽略未改动部分
HTML 产物	展示特别复杂的概念、布局或交互

5. 触发方式

主动触发（推荐）

text 复制代码

/grill-me
/show-me
用 show me 图解一下这个需求
先拷问我，再帮我画图

自动触发

输入中包含相关关键词时可能自动唤起：

show me
open in browser
look at my screen
grill me
先拷问我

建议：先对话，后图解。让 AI 具备上下文后，生成的图会更准确。

6. 最佳实践

先 grill，再 show：不要一上来就画图，先澄清需求。
每次聚焦一个决策分支：避免问题爆炸。
图要回答具体问题：不要为了画图而画图。
把图保存到文档或仓库：作为需求契约和开发依据。
迭代更新：需求变，图也要变。
开发中继续用 show-me：理解代码、审查变更、解释调用链。
复杂项目可配合其他工具：如交互式知识图谱、架构图工具、视觉评审工具。

7. 常见误区

误区	后果
直接让 show-me 画需求，没有先澄清	可能画出错误理解，误导开发
grill-me 问得太泛，不落地	问题很多，但无法形成决策
图太复杂，信息过载	失去"快速理解"的价值
图与代码不同步	文档失效，团队不再信任
只画一次，不再迭代	需求变化后图变成历史包袱

8. 一句话总结

grill-me 把需求问清楚，show-me 把需求画明白；先拷问、后图解、再开发，是理解需求、减少返工的高效组合。