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 澄清需求
描述完初步想法后，立即触发：
/grill-me
我要做【功能名称】。请按决策树逐个追问，直到需求边界清晰。
grill-me 通常会追问：
- 数据模型：有哪些实体、字段、关系？
- 交互流程：用户如何触发？系统如何响应？
- 边界情况：空数据、超大数据、无权限怎么办？
- 异常处理：失败、超时、重复提交如何处理？
- 依赖关系：依赖哪些模块、接口、第三方服务？
- 优先级：哪些必须做，哪些可以后置？
目标：把模糊想法变成可决策的问题清单。
阶段二：用 show-me 把共识画成需求蓝图
在 grill-me 结束后，紧接着触发：
/show-me
请根据我们刚才讨论的需求，用 Mermaid 时序图展示主流程，
用组件树展示 UI 结构，用伪代码展示核心业务规则。
按需求维度选择视图：
| 需求维度 | 推荐 show-me 视图 | 能回答的问题 |
|---|---|---|
| 业务流程 | Mermaid 时序图 | 用户、前端、后端、服务之间如何交互？ |
| 功能逻辑 | 伪代码 | 核心规则、判断、算法是什么？ |
| 系统结构 | 组件树 / 文件树 | 前端页面、组件、后端模块如何划分？ |
| UI 与交互 | HTML 产物 | 页面布局、状态变化、复杂交互长什么样？ |
| 变更影响 | Diff 视图 | 这次需求改动了哪些组件、文件、调用链？ |
目标：把口头共识变成可评审、可分享、可开发的视觉契约。
阶段三：评审与迭代
基于 show-me 生成的图进行评审。
如果发现新的模糊点：
- 再次使用
/grill-me针对性追问； - 然后再次使用
/show-me更新图表； - 直到图能准确回答开发所需的关键问题。
阶段四：进入开发，并继续用 show-me 理解代码
开发阶段可以继续用 show-me 辅助：
/show-me 用调用树解释这个函数的触发链路。
/show-me 用组件树展示这个页面的状态和组件边界。
/show-me 用伪代码说明这段核心逻辑。
这样，图表不仅是需求文档，也能成为代码理解工具。
3. 示例：用户导出数据
grill-me 阶段
它可能追问：
- 导出触发方式：按钮、定时任务还是 API？
- 导出范围：当前页数据还是全部历史数据？
- 文件格式：CSV、Excel 还是 JSON？
- 大数据量：同步等待还是异步邮件通知？
- 权限控制：哪些角色可以导出？
- 失败处理：部分失败如何反馈？
show-me 阶段
澄清后，可以生成：
- Mermaid 时序图：用户点击导出 → 前端请求 → 后端查询 → 文件生成 → 下载或邮件通知。
- 组件树：导出按钮、进度提示、结果反馈、错误提示之间的关系。
- 伪代码：导出权限判断、数据范围过滤、异步任务触发逻辑。
- 文件树：新增或修改的模块、服务、工具文件。
最终得到一份经过逻辑拷问、并已视觉化的需求蓝图，再进入开发，能显著减少返工。
4. show-me 视图速查表
| 视图 | 用途 |
|---|---|
| 伪代码 | 展示逻辑、算法、业务规则 |
| 调用树 | 展示程序运行时调用关系 |
| 组件树 | 展示前端 UI 结构、状态和模块边界 |
| Mermaid 图 | 展示流程、时序、交互、数据流 |
| 文件树 | 展示项目结构、文件职责 |
| Diff 视图 | 展示变更内容，忽略未改动部分 |
| HTML 产物 | 展示特别复杂的概念、布局或交互 |
5. 触发方式
主动触发（推荐）
/grill-me
/show-me
用 show me 图解一下这个需求
先拷问我，再帮我画图
自动触发
输入中包含相关关键词时可能自动唤起：
show meopen in browserlook at my screengrill me先拷问我
建议：先对话，后图解。让 AI 具备上下文后，生成的图会更准确。
6. 最佳实践
- 先 grill，再 show：不要一上来就画图，先澄清需求。
- 每次聚焦一个决策分支：避免问题爆炸。
- 图要回答具体问题：不要为了画图而画图。
- 把图保存到文档或仓库：作为需求契约和开发依据。
- 迭代更新：需求变，图也要变。
- 开发中继续用 show-me：理解代码、审查变更、解释调用链。
- 复杂项目可配合其他工具：如交互式知识图谱、架构图工具、视觉评审工具。
7. 常见误区
| 误区 | 后果 |
|---|---|
| 直接让 show-me 画需求，没有先澄清 | 可能画出错误理解，误导开发 |
| grill-me 问得太泛，不落地 | 问题很多，但无法形成决策 |
| 图太复杂，信息过载 | 失去“快速理解”的价值 |
| 图与代码不同步 | 文档失效，团队不再信任 |
| 只画一次，不再迭代 | 需求变化后图变成历史包袱 |
8. 一句话总结
grill-me 把需求问清楚，show-me 把需求画明白；先拷问、后图解、再开发，是理解需求、减少返工的高效组合。
