clear-naming部分实测🇨🇳 中文

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)
分类
编程开发写作文案
原作者
Waffle @Jiaoao1024 ↗
我们实测
部分实测
成本 / 耗时
仓库 MIT 免费,纯指令、无脚本和外部服务。需要能加载 SKILL.md 的 Agent(Codex / Claude Code 等)订阅或额度。
来源
X @Jiaoao1024 ↗X @Jiaoao1024 ↗GitHub ox01024/clear-naming ↗

要解决的事

把 Agent 写出来的机翻式中文说明和含糊标识符,改成读者不用猜内部比喻就能看懂的名称与解释,同时保住技术含义和对外接口兼容。

步骤

  1. 安装:npx skills add ox01024/clear-naming(按提示选 Codex、Claude Code 等)。也可以 git clone 到 ~/.agents/skills/clear-naming 或项目内 .agents/skills/clear-naming。仓库根目录就是 skill 目录,包含标准 SKILL.md。
  2. 只想听懂当前那句黑话,不要全仓改名时,直接说:使用 $clear-naming,解释刚才的「在飞任务」,用直接、自然的中文说明它在做什么。
  3. 要先看建议再动手:使用 $clear-naming 检查当前改动的命名、注释和说明。先给出建议,不修改文件。审查结果应写清位置、实际含义、原表达、建议表达和理由。
  4. 确认要改时,限定范围,例如:使用 $clear-naming 改善 scheduler.py 中难懂的命名和注释,保持行为一致,更新相关引用并运行必要检查。公开接口、配置键、持久化字段和协议字段要单独考虑兼容,不能当局部变量乱改。
  5. 若希望以后每次编码都带上这两条原则,可以让它合并进项目的 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 在真实项目里执行重命名。

同类用例