Waffle 的 clear-naming 技能先读代码上下文,再修改 Agent 硬译出来的命名和说明,比如把 in_flight 译成「在飞任务」这类问题
让 Agent 写代码或解释改动时,中文说明常变成「等在飞任务排空后再退出」「provider 抖了重规划没走通」这种机翻黑话,变量名也不分得清是正在执行的任务还是等待响应的请求。中文社区作者 Waffle(@Jiaoao1024,GitHub ox01024)开源 clear-naming(MIT):纯指令 skill,先读定义、调用和状态变化,再决定要不要改、改成什么。同一个 in_flight,已开始且未结束的任务可考虑 running_tasks,已发出、等待响应的请求则更接近 requests_awaiting_response;HTTP、SQL、事务等有明确含义的术语可以保留。用法分四档:只把当前解释说清楚、先审查不改文件、在指定范围改名并更新引用、把两条原则合并进 AGENTS.md。安装:npx skills add ox01024/clear-naming。我们阅读了 SKILL.md 与 examples.md,核对原帖例句都在文档里;无运行时脚本可跑,也未让 Agent 对真实仓库做重命名。
访问官网 clear-naming ↗- 定价
- 免费
- 地区
- 海外
- 出自哪里
- 中文社区
- 上架日期
- 2026 年 11 月 8 日
- 实测日期
- 2026 年 11 月 8 日
- 用的版本
- clear-naming @ 3cd4fa1 (instruction-only)
- 我们实测
- 部分实测
- 成本 / 耗时
- 仓库 MIT 免费,纯指令、无脚本和外部服务。需要能加载 SKILL.md 的 Agent(Codex / Claude Code 等)订阅或额度。
要解决的事
把 Agent 写出来的机翻式中文说明和含糊标识符,改成读者不用猜内部比喻就能看懂的名称与解释,同时保住技术含义和对外接口兼容。
步骤
- 安装:npx skills add ox01024/clear-naming(按提示选 Codex、Claude Code 等)。也可以 git clone 到 ~/.agents/skills/clear-naming 或项目内 .agents/skills/clear-naming。仓库根目录就是 skill 目录,包含标准 SKILL.md。
- 只想听懂当前那句黑话,不要全仓改名时,直接说:使用 $clear-naming,解释刚才的「在飞任务」,用直接、自然的中文说明它在做什么。
- 要先看建议再动手:使用 $clear-naming 检查当前改动的命名、注释和说明。先给出建议,不修改文件。审查结果应写清位置、实际含义、原表达、建议表达和理由。
- 确认要改时,限定范围,例如:使用 $clear-naming 改善 scheduler.py 中难懂的命名和注释,保持行为一致,更新相关引用并运行必要检查。公开接口、配置键、持久化字段和协议字段要单独考虑兼容,不能当局部变量乱改。
- 若希望以后每次编码都带上这两条原则,可以让它合并进项目的 AGENTS.md 或 CLAUDE.md;已有类似章节时原地合并,避免重复一份。修改全局指导文件需要你在请求里写明全局范围。
提示词
使用 $clear-naming 检查当前改动的命名、注释和说明。先给出建议,不修改文件。
原文怎么说
作者 @Jiaoao1024:受不了 Agent 写出「等在飞任务排空后再退出」「provider 抖了重规划没走通」以及分不清请求还是任务的 in_flight,于是写了这个 skill——会先看上下文再改名和润色说明。安装命令 npx skills add ox01024/clear-naming;此前写过的 pink-elephant(治「粉红大象效应」)可以一起用。README 还给出 in_flight 在不同上下文里的对照表,并强调信息不足时要保留不确定性,改持久化字段前要考虑兼容。
我们实测
克隆 ox01024/clear-naming(commit 3cd4fa1)。阅读 README、SKILL.md、references/examples.md 与 agents/openai.yaml。仓库无测试脚本或运行时依赖。未安装到 Codex/Claude Code,未对真实代码执行审查或重命名。
我们亲自试下来:SKILL.md 含标准 frontmatter(name: clear-naming,MIT)和四档工作范围。examples.md 收录了原帖两条例句:「等在飞任务排空后再退出」建议改为「等待正在执行的任务全部结束,然后退出」;「provider 抖了,重规划没走通」在日志仅证明 503 时应改成「模型服务返回 503,本轮未能生成后续方案」。openai.yaml 显示名为「清晰命名与表达」。
怎么用上
GitHub 公开,MIT。文档以中文为主,SKILL.md 的 description 中英都有。npx skills add ox01024/clear-naming 可装到 Codex / Claude Code 等。作者同时提到可搭配 ox01024/pink-elephant。
适合谁
经常让 Agent 用中文解释代码、又被机翻黑话烦到的人;纯英文仓库、或不在乎命名的可跳过。
踩坑提示
- 这是纯指令 skill,改得准不准取决于当前模型和它是否真的去读了上下文,没有附带自动测试。
- 普通写代码请求默认不会触发全仓命名审查;作者特意写了这一点,免得 Agent 擅自大改。
- 持久化字段、配置键和协议字段不能只改名字,旧数据可能读不回来;审查时应把它们和局部变量分开。
- 我们只核对了文档与原帖例句,没有让 Agent 在真实项目里执行重命名。
同类用例
- 文档每页配演示视频,界面一改就报红视频创作ScreenplayClaude Code工具免费;需 Claude 等 agent 额度◐ 部分实测海外
- 让 AI 写后端时默认防并发、越权和改表事故编程开发backendskillsClaude CodePostgreSQL免费;每次任务多花约一倍额度◐ 部分实测海外
- 一个下午让 AI 做出能在浏览器里玩的 3D 动作游戏编程开发Claude CodeTripo即梦技能免费;需 Claude 额度,素材工具另计◐ 部分实测国内
- 长期让 AI 写同一个项目,仓库也不乱编程开发ClaudeCodexoil-delegate需 Claude 和 Codex 订阅◐ 部分实测国内
- 边用一个网页产品,边让 AI 写出它的工作原理调研搜索REAClaude CodeChrome工具免费;需 Claude 或 Codex◐ 部分实测海外