Codex Speak Human

让 AI 说人话。一个把"上一条 AI 回答"用最简单的中文重新讲一遍的 Skill。

---

这是什么？

Codex Speak Human 是一个给 AI 编程助手使用的 Skill（技能）。

Codex最令人头疼的是：给出的回答里有一堆专业术语，新手完全看不懂。这个 Skill 的作用就是：

让 AI 刚才说的那段话，用最朴素的语言，重新讲给一个完全不懂编程的人听。

它不会改变原回答的结论，只会换一种讲法，让任何人都能看明白。

---

适用场景

• 看不懂 AI 刚才给出的代码评审意见
• 看不懂 AI 给的排查报告 / 安全审计 / 架构建议
• 想把 AI 的英文回答翻译成"人话版"的中文
• 想把结论讲给不懂技术的同事、老板、家人听

一句话总结：AI 说了一堆术语，你想让它"说人话"的时候，就用它。

---

核心特点

• 只换说法，不改结论：忠于原回答的事实、严重程度、建议。
• 自动输出简体中文：即使原回答是英文，也会翻译成中文。
• 术语自动加注解：不得不出现的术语，会在括号里补一句人话解释。
• 阅读友好的排版：自动使用标题、列表、加粗、分割线，避免一大段挤在一起。
• 默认解释上一条回答：不需要你再复制粘贴。

---

安装方法

这是一个标准格式的 Agent Skill，可以放在任何支持 Skills 的 AI 编程助手里。

1. Codex CLI

把整个 codex-speak-human/ 文件夹复制到：

~/.codex/skills/codex-speak-human/

Windows 下对应路径是：

C:\Users\<你的用户名>\.codex\skills\codex-speak-human\

2. Claude Code

把整个 codex-speak-human/ 文件夹复制到：

~/.claude/skills/codex-speak-human/

3. Cursor

把整个 codex-speak-human/ 文件夹复制到：

~/.cursor/skills-cursor/codex-speak-human/

小提示：不管放在哪里，目标目录下都应该看到 codex-speak-human/SKILL.md 这个文件，路径对了就能自动生效。

---

使用方法

安装好之后，在你和 AI 的对话里直接输入触发词即可：

最常用的用法

$codex-speak-human

效果：把 AI 最近一条回答用最简单的中文重新讲一遍。

带补充说明的用法

$codex-speak-human 用最简单的话解释上一条回答

$codex-speak-human 不要术语，重新讲一遍

$codex-speak-human 讲给完全不懂代码的人听

你会得到什么样的回答？

• 总结：一两句话讲清楚"刚才到底做了什么 / 发现了什么"。
• 每个问题：会按下面这个固定结构来讲：
  • 问题：用生活化的比喻讲这是个啥问题。
  • 原因：为什么会出现，哪里没处理好。
  • 后果：如果不修，真实使用中会发生什么坏事。
  • 修复建议：用大白话说该怎么改。

---

一个简单的例子

AI 原本的回答（看不太懂）

The authentication middleware doesn't validate the JWT signature before decoding the payload, which makes it vulnerable to token forgery. Consider using jwt.verify() instead of jwt.decode().

触发 $codex-speak-human 之后的回答（人话版）

---

总结

你的登录验证代码里有一个安全漏洞，坏人可以伪造"通行证"进入系统。建议换一个更严格的验证方法。

---

问题 1（高危）

• 问题：就像门卫只看了通行证上的名字，却没有检查印章是不是真的。
• 原因：代码里用了 jwt.decode()，这个方法只会把通行证上的内容读出来，不会检查印章真伪。
• 后果：任何人只要随便伪造一张通行证，就能冒充别的用户登录。
• 修复建议：把 jwt.decode() 换成 jwt.verify()，这个方法会同时检查印章，是假的就会直接拒绝。

---

工作原理

这个 Skill 本质上就是一份写给 AI 看的"说明书"（见 codex-speak-human/SKILL.md），告诉 AI：

1. 收到 $codex-speak-human 触发词时该做什么。
2. 必须输出简体中文。
3. 必须保持原结论不变。
4. 必须按什么结构、什么排版来写。

AI 读到这份说明书后，就会按规则改写上一条回答。没有任何代码、没有任何后台服务，就是纯文本规则。

---

目录结构

codex-speak-human/
├── README.md                       # 你正在看的这个文件
├── README.en.md                    # 英文版简介
├── LICENSE                         # MIT 许可证
├── CHANGELOG.md                    # 版本更新记录
├── .gitignore
└── codex-speak-human/              # Skill 本体，直接复制这个文件夹去安装
    └── SKILL.md                    # 给 AI 看的说明书

---

常见问题

Q1：这个 Skill 会消耗额度吗？

它本身只是一段规则文本，不会单独消耗额度。实际消耗来自 AI 模型处理这段规则时的正常 token 消耗，和你平时提问一样。

Q2：我可以改里面的规则吗？

完全可以。 欢迎 fork 之后根据自己的习惯修改 SKILL.md，比如：

• 改成输出繁体中文
• 改成输出其他语言
• 修改"问题 / 原因 / 后果 / 修复建议"这套结构
• 换不同的触发词

Q3：为什么要写成 Skill，而不是一句普通的"请用简单中文解释"？

• Skill 的规则更严格、更稳定，不会因为一次对话就忘掉。
• 可以跨项目、跨对话统一使用。
• 支持 Skills 的 AI 助手会按规则执行，比普通 prompt 更可靠。

Q4：非中文用户能用吗？

这个 Skill 的输出被强制要求是简体中文。如果你需要英文版或其他语言版本，请 fork 之后修改 SKILL.md 中的语言规则。

---

参与贡献

欢迎提交 Issue 和 PR：

• 发现规则有漏洞或改写效果不好 → 提 Issue
• 有更好的改写结构、更清晰的比喻 → 提 PR
• 想加其他语言版本（繁中、英文、日文 …）→ 欢迎新开一个目录

请先阅读 CHANGELOG.md 了解最近改动。

---

许可证

本项目采用 MIT License 开源，你可以自由使用、修改、二次分发。

---

致谢

• 灵感来自日常"AI 讲的话我看不懂，能不能说人话"的真实场景。
• 感谢 Codex / Claude Code / Cursor 提供的 Agent Skill 机制。