不能错过的 Skill！ /show-me：让 AI 把“我懂了”画出来

图片解读

按要求整理第 1 张图的可见内容。

事实（图中可直接读取或肉眼可见的元素）

- 顶部左上角红色圆角标签文字：深度拆解

- 大标题（白色＋荧光黄/绿混合）：

- 白色：不能错过的

- 大字（荧光黄/绿）：Skill

- 中部偏左英文/中文混合行：/show-me: 让AI把

- 引号内中文（大字，荧光黄色）：“我懂了” 画出来

- 左下部三项小图标及文字（从左到右）：

1. 圆形靶心图标；文字：少解释一点 把系统画出来

2. 结构/树状图图标；文字：图让隐含判断 清晰可见

3. 盾牌图标；文字：复杂问题 变成可验证的结构

- 画面右侧为一张流程/结构示意图（深色半透明面板，带荧光连线和方框），其中可读框内文字（从上到下、从左至右）：

- 顶部小框：入口

- 下一个框：验证权限

- 在“验证权限”下方有分支/连线指向三块：

- 左：读取配置

- 中（高亮，带数据库图标）：保存配置

- 右：写入数据库

- 从“保存配置”向下有连线到：发布事件

- 从“发布事件”向下到：返回结果

- 在该流程右侧有若干虚线边框的附属框（从上到下）：

- 顶部：调用树（旁有小的树状图标）

- 中部：? 待确认（盒子中有问号）

- 中下：缓存失效

- 最右下角有一个框：差异视图 PR风险路径（框内左侧有代码符号 “</>”）

- 左侧靠近流程的两个浮动标签框：

- 上方：组件树（图标为立方体），下方小字：状态归属与边界

- 下方：文件树（文件/文件夹图标），下方小字：模块职责与结构

- 视觉/样式元素：

- 主色调为深色背景配荧光黄/绿色高亮

- “保存配置”一项被明显高亮（荧光黄色背景/描边）

- 流程框之间用黄绿色箭头或连线连接；某些连接为虚线框（表示待确认或外部）

- 画面右下有类似发光圆形底座或平台的三维效果（光束从中心向上照亮流程面板）

- 整体为科技风格、发光效果、多层透视浮动面板

推测（基于图像布局与常见含义的合理推断，非图中直接文字）

- 流程表示一个“保存配置”或“配置保存/写入”的后端/系统处理流程，验证权限后会读取/保存/写入相关配置并发布事件、返回结果。

- 虚线框（? 待确认、缓存失效、调用树等）可能表示该流程的外部影响、异常情况或需要进一步确认的模块。

- 组件树/文件树/调用树等浮动标签可能表示检视系统不同维度的工具或视角（组件状态、模块结构、调用关系）。

- 差异视图（PR风险路径）可能用于展示变更差异与潜在风险路径（用于代码审查/PR分析）。

- 底部三项（少解释一点、图让隐含判断、复杂问题）可能是该页要传达的三条要点或设计原则。

无法辨认 / 不确定的内容（建议标注为不可读或图像不清晰处）

- “调用树”下方的小字部分不完全清晰，推测为“宏/函数与副作用”或“宏/函数与副作用类”之类表述，但字迹不够清楚而无法完全确认。

- 流程中“读取配置”和“写入数据库”与其他连接的精确箭头走向在某些细节点上略有重叠，部分连线方向（例如写入数据库之后是否直接指向“待确认”或“缓存失效”）不完全明确。

- 某些极小字号的辅助说明文字（例如在面板边缘或图标下的小字）分辨率不足，内容无法逐字确认。

- 图片右侧靠近顶部和底部的若干小图标旁边的细小注释文字有模糊，无法完整抄录。

可选操作建议：

- 可将上面每一项用更结构化的表格列出（例如把流程的各节点按顺序编号并标注方向不确定性），或

- 放大并对右侧流程区域逐节点逐连线做更细致的逐项描述（并标注每条连线的确定/不确定性）。

SkillPI 作品解读

作品用途：

- 本视频与展示（HumanLayer 的 show-me 技能）旨在把 AI 代理的理解“表示”出来：通过时序图、调用路径、组件边界与审查地图，把模糊的自然语言解释转成可核查的结构化视图，帮助开发者在编码前、编码中与完成后进行三步检查（先表示、再实现、再验证）。

图像证据要点（来自 image_text）：

- 流程面板突出“保存配置”节点，并显示从入口→验证权限→读取/保存/写入→发布事件→返回结果的处理路径；右侧有调用树、待确认项、缓存失效等辅助视图；右下有“差异视图 PR风险路径”。

- 视觉强调：深色科技风、荧光黄/绿高亮，表示关注点是系统边界与高风险节点（如“保存配置”）。

关联 Skill 的使用步骤（基于视频与 show-me 插件仓库）：

1) 表示（要求代理先画图）

- 请求代理用时序图或流程图描述问题场景（示例：保存配置后回退到旧值），包含入口、权限验证、读取/写入、事件发布与返回结果。

- 要求同时输出组件树、文件树与调用树视角，标注状态归属与模块职责。

2) 实现（把图转成具体契约与编码指引）

- 基于图定义“变更契约”（谁有权限改、哪些模块会受影响、事件语义、回滚条件）。

- 在代码中明确决策点（例如写入顺序、事务边界、重试策略、缓存失效点）。

3) 验证（回到源码、测试与运行记录）

- 用审查地图标注必须核查的记录（单元/集成测试、日志、事件总线、数据库写入/双写情形、缓存一致性）。

- 将 PR 差异与风险路径映射到审查清单，便于代码审查时核实关键断言。

复现前提（需要的资源与假设）：

- 访问代码仓库与运行/测试日志（例如能查看 CI 日志、应用日志和事件流）。

- 能与 AI 代码代理交互，且该代理或 show-me 插件支持生成时序图/结构图（可输出 Mermaid、PlantUML、JSON 流程结构或能渲染图像）。

- 对系统的基本架构与权限模型有读权限与理解，以便把代理绘制的图与源码对齐。

- 推荐参考仓库：https://github.com/humanlayer/skills/tree/main/plugins/show-me/skills/show-me

待核实项与风险（图表输出不能替代的检查点）：

- 动态调用、重试与双写风险：图可能展示逻辑路径，但不会自动证明重试次数、幂等性或在并发下的双写条件，需通过运行日志、事务/锁机制与测试用例验证。

- 外部系统与异步边界：虚线框（待确认、缓存失效、调用树）表明这些是外部依赖或不确定模块，必须检查外部系统的可靠性/重试策略与事件保证。

- 代理生成的图是否完整或有偏差：确认代理使用的数据源（是仅基于描述、还是解析了源码/调用跟踪）；若仅基于描述，则可能遗漏关键实现细节。

- show-me 插件能力细节：需验证该 Skill 可否直接读取仓库/日志、支持何种图表格式、以及生成图后的可编辑性。

输出兑现范围说明：

- 本解读基于视频摘要与图像可见信息（并引用 show-me 的仓库链接）。图像文字与布局用于推断展示逻辑与关注点，但不能替代对源码、测试和运行记录的核验；任何实现或修复决策应以代码与运行数据为准。