结合实现上下文检查代码命名和技术说明,区分任务、请求与不同状态;审查时先给建议、不改文件,避免逐词直译和黑话。
来源信息
- 仓库
- ox01024/clear-naming
- 最近来源活动
- 2026年10月29日 08:08
- 检测到的 SKILL.md 语言
- 中文
- 星标
- 0
- Forks
- 0
相关案例
源文档示例:in_flight 是已经开始且尚未结束的任务集合。“调度器会等在飞任务排空后再退出”改为“调度器会等待正在执行的任务全部结束,然后退出”。只改善解释时不必改代码;只有用户要求重命名并核实集合成员条件后,才可考虑 running_tasks 并更新引用。这是文档中的完整对照,不是本轮执行结果。 文档示例
用途
适合命名审查、清理黑话、解释某个术语或按要求补充项目规则。普通编码请求不会自动变成命名审计。方法会区分正在执行的任务与等待响应的请求,保留含义准确的领域术语。
必要前提
需要能读取本地 SKILL.md 的宿主;README 说明 Codex 可显式调用。提供相关代码或说明,并区分只要建议还是允许修改。它是纯指令 Skill,README 明确运行时无需脚本、额外依赖或外部服务;检查由实际改动和项目要求决定,不是内置测试运行器。
操作说明
README 的 Codex 审查请求使用 $clear-naming 检查当前改动的命名、注释和说明,并要求先给建议、不改文件。方法检查定义、调用、类型和状态变化,汇报位置、实际含义、建议表达及理由。明确要求修改时,才在范围内更新相关引用并运行相称检查;只有要求长期规则时,才把两条原则合并进指定指导文件,已有等价规则保持单份。
限制
含义证据不足时保留现名并提出待核问题,不猜替代词。对外接口、持久化字段、配置键和协议字段需检查兼容,不能当作局部变量处理。说明必须保留前置条件、失败原因、时间范围和不确定性。局部解释不授权全仓重命名或改全局指导文件;长期规则的效果仍需使用反馈。来源没有新增外部运行服务,但未规定宿主或模型服务商如何处理代码,不能据此保证资料只在本机或绝对保密。已保存 MIT LICENSE。
安装方式
默认使用会先检查来源的 Prompt;你也可以切换为直接命令,或下载本地副本。
检查来源文件
决定是否安装前,请先阅读 SKILL.md,以及 SkillsMP 当前展示的配套文件。
正在显示 SKILL.md
| name | clear-naming |
|---|---|
| description | Review and improve confusing code identifiers and technical explanations. Use for naming reviews, jargon cleanup, clearer explanations, or adding naming and communication guidance to AGENTS.md / CLAUDE.md. 中文触发:命名审查、消除黑话、解释通俗一点、不要直译变量名、添加清晰表达规则。 Ordinary coding requests alone do not require a naming audit or repository-wide renaming. |