关于 show-dont-tell
show-dont-tell 是一项指导 Agent 清晰呈现结构化信息的技能，适用于需要组织说明、比较和操作步骤的场景。它依据内容选择表格、列表、树形结构、流程图或代码块，并强调先给结论。
主要功能
- 01按信息类型选择呈现形式
- 02用表格比较同维度选项
- 03以编号列表组织操作步骤
- 04用代码块呈现可执行内容
- 05先给结论并补充必要依据
适用场景
- 01整理多个参数或选项的比较
- 02说明有先后顺序的操作流程
- 03呈现目录、状态转换或可执行命令
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/show-dont-tell确认已加载。
附带文件agents/openai.yaml
详细介绍
来自项目 README清晰呈现结构化信息
选择能帮助读者理解和使用信息的形式。用户指定的格式优先；一两句话即可说清的内容直接回答，因果解释和观点论证用自然段落。
| 内容 | 可选形式 |
|---|---|
| 多个选项、参数或属性需要按相同维度比较 | 表格 |
| 有顺序的操作 | 编号列表，必要时附关键命令 |
| 目录或包含关系 | 树形结构或简短列表 |
| 流程、调用关系、状态转换 | 环境支持时使用 Mermaid |
| 可复制执行的代码、命令或配置 | 标明语言的代码块 |
先表达结论，再给支撑它的结构和必要说明。表格不适合承载长段落；短命令可以内联。图示不能代替缺失的数据或证据，也不应强制使用额外工具。
若需要交互探索或正式导出的图表，使用目标环境中适用的可视化工具；静态信息不必升级为交互产物。不要假定所有客户端都能渲染 Mermaid，必要时提供等价文字。
不需要每次回复都运行格式清单，也不向全局 AGENTS.md 注入本技能。完成时以内容正确、结构便于阅读且符合用户格式要求为准。
评论
支持 Markdown