大白话 · Plain Words

不讲开发术语，让 AI 讲大白话的 Agent Skill

_{An Agent Skill that translates AI's technical answers into plain language.}

---

这是什么？

把它放进你的项目，AI 就会自动把所有技术术语翻译成大白话。只要说"说人话"，AI 就会用零基础也能看懂的话来回答你。

What is this?

Put it in your project, and the AI will automatically translate all technical jargon into plain language. Say "explain like I'm five" and the AI answers in terms anyone can understand.

---

效果对比

没装时：

在终端执行 npm install，然后运行 npm run dev 启动开发服务器。确保环境变量配置正确。

装了后：

1. 打开终端（Terminal，就是电脑上输入命令的文字窗口）
2. 输入 npm install（下载项目需要的依赖包），按回车
3. 等命令行不再滚动，说明下载完了
4. 输入 npm run dev（启动开发模式），按回车
5. 看到 Local: http://localhost:3000，说明成功了

Before & After

Without: Run npm install in the terminal, then start the dev server with npm run dev.

With: 1. Open Terminal (the text window for commands) 2. Type npm install (downloads dependencies), press Enter 3. Wait until scrolling stops 4. Type npm run dev (starts dev mode), press Enter 5. See Local: http://localhost:3000 — it's working!

---

安装

"大白话"分两部分，需要都装上才能完整生效。第一步装系统规则，第二步装 Skill。

第一步：设置系统规则（必做）

这是每次对话都生效的基础规则，放在你 AI 工具的系统设置里。

1. 打开仓库里的 system-rules.md 文件
2. 复制里面"中文版"那段 8 条规则
3. 粘贴到你 AI 工具的系统设置（System Settings / Custom Instructions / 系统提示词 / 规则与记忆）里
4. 保存

为什么要先做这步？ 这 8 条规则很简短（约 500 tokens），不占多少上下文，但能保证 AI 每次对话都自动遵守"术语要注释、命令要解释、步骤要傻瓜化"这些底线。

第二步：安装 Skill（三选一）

方式一：使用AI自带的上传Skill功能，以TRAE为例，打开插件市场（推荐，最简单）

1. 下载本仓库的 plain-words-for-trae.zip
2. 打开 TRAE → 插件市场 → 上传技能
3. 选择下载的 zip 文件，点确认即可

方式二：手动放置

把 plain-language/ 文件夹复制到你项目的 .trae/skills/ 目录里。没有 .trae 文件夹就自己建一个（注意前面有个 .）。

方式三：其他平台（Claude Code、Codex 等）

把 plain-language/ 放到对应平台的 skills 目录。找不到目录？打开 SKILL.md，把内容复制粘贴到自定义指令（Custom Instructions）里，效果一样。

Installation

"Plain language" works in two parts. Step 1: set up system rules. Step 2: install the Skill.

Step 1: Set Up System Rules (Required)

These are baseline rules that apply to every conversation. Place them in your AI tool's system settings.

1. Open system-rules.md from this repo
2. Copy the 8 rules under "中文版" (or "English")
3. Paste into your AI tool's System Settings / Custom Instructions / System Prompt
4. Save

Why first? These 8 rules are short (~500 tokens) but ensure the AI always follows the basics: term annotations, command notes, beginner-friendly steps.

Step 2: Install the Skill (Choose One)

Method A (Recommended): Download plain-words-for-trae.zip → TRAE → Plugin Marketplace → Upload Skill → Select zip → Confirm.

Method B: Copy plain-language/ folder into your project's .trae/skills/ directory. Create .trae/ if it doesn't exist (note the leading dot).

Method C (Other platforms): Place plain-language/ in the platform's skills directory. Or copy SKILL.md content into Custom Instructions — same effect.

---

用法

安装后在对话里说任意一句即可触发深度模式：

"说人话" · "看不懂" · "太专业了" · "简单说一下" · "这是什么意思"

没说这些词也没关系——第一步的系统规则每次都在生效，只是不会加载完整术语表。

Usage

After installation, say any of: "explain like I'm five" · "too technical" · "what does this mean" · "simplify"

Even without these triggers, the system rules from Step 1 are always active — they just won't load the full glossary.

---

两层设计

	系统规则（第一步）	本 Skill（第二步）
放在哪	AI 工具的系统设置里	项目文件夹的 skills 目录里
什么时候生效	每次对话都生效	你说"不懂"时才触发
内容	8 条底线要求（很短）	60+ 术语、概念关联、弹窗权限（很长）
Token	~500	~1500–4000（按需加载）

一个打底，一个增强，互不冲突。系统规则是"每次都提醒 AI 照顾小白"，Skill 是"你说不懂了就给 AI 一份完整术语词典"。

Two-Tier Design

	System Rules (Step 1)	This Skill (Step 2)
Where	AI tool's system settings	Project folder's skills directory
When	Every conversation	When you say "I don't get it"
Content	8 short baseline rules	60+ terms, concept maps, permission guides
Tokens	~500	~1500–4000 (on-demand)

One sets the foundation, one provides the firepower. No conflict.

---

覆盖的术语

基础： API、SDK、框架、前端/后端、全栈开发流程

基础设施： 服务器、云服务器、CDN、Docker、虚拟机

网络： 域名、IP、DNS、HTTPS、SSL、端口、带宽

开发工具： 终端、IDE、环境变量、沙盒、Git、CI/CD、Token、Cookie、Session

数据存储： 数据库、SQL、JSON、缓存、依赖、构建、部署、回滚、灰度发布

弹窗权限： 允许/阻止/取消/白名单 + 8 种常见权限的风险说明

Terms Covered

Basics: API, SDK, Framework, Frontend/Backend, Full-Stack Flow

Infra: Server, Cloud Server, CDN, Docker, VM

Network: Domain, IP, DNS, HTTPS, SSL, Port, Bandwidth

Dev Tools: Terminal, IDE, Env Variables, Sandbox, Git, CI/CD, Token, Cookie

Data: Database, SQL, JSON, Cache, Dependency, Build, Deploy, Rollback

Permissions: Allow/Block/Cancel/Whitelist + 8 permission types with risk descriptions

---

贡献

术语库越全越好用，欢迎完善！

1. Fork → 修改 terms.md（加术语）或 SKILL.md（改规则）→ 提 PR
2. 新术语优先说"它是干嘛的"和"怎么用"，不要用生活比喻
3. 格式：中文（English，就是XXX）

Contributing

1. Fork → Edit terms.md or SKILL.md → Submit PR
2. Explain "what it does" and "how to use" first. Avoid metaphors.
3. Format: 中文（English，就是XXX）

---

License

MIT — 随便用、随便改、随便分享。

MIT License — Use, modify, share freely.

---

_{觉得有用？点个 ⭐ Star 让更多人发现它}