القائمة
为代码标识符（变量/函数/类/文件/API/数据库字段）决定名字时。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
需求模糊、含隐藏假设或 X-Y problem，需先澄清再动手时。
审查代码（自己的或别人的），需有重点、分层次地看时。
Git 改动需编写规范提交信息时。
遇到 bug、报错、崩溃或行为异常，需定位根因时。
设计或改进错误处理与日志时。
在 Lion-Skills 仓库创建或修改 skill 时。
| name | naming |
| description | 为代码标识符（变量/函数/类/文件/API/数据库字段）决定名字时。 |
名字要回答"它是什么/它做什么"，而不是"它在哪/什么类型"。好名字让代码自解释，坏名字逼读者来回跳转确认含义。
不该用：已在用团队既定规范（遵循即可）；纯格式问题（用 linter）。
套快速规则前先回答这四个问题，否则会在错的对象上取名。前两个是定性（决定名字的形态），后两个是收口（决定用哪个词）：
parseAndValidateCsv 不如 parseCsv + validateRecords）。login 又有 auth），先定以谁为基准——通常以领域模型/核心资源名为准，全项目统一。问题 1 的答案同时决定了下面「快速规则」第一条该走名词还是动词那一支。
fetchUser、validateEmailuser、emailAddressisLoggedIn、hasPermissionisEmpty 优于 isNotEmptydata/info/helper/manager/util，动词 process/handle/do——都说不清做啥id、url、http，以及 csv、json、xml 这类格式名）；usr、cfg、tmp 别用user/account/member 混用）| 不好 | 好 | 原因 |
|---|---|---|
processData(d) | parseCsvToRecords(text) | 说清做什么、入参是啥 |
flag | isLoggedIn | 布尔用 is，表意明确 |
userList | users | 复数即集合，去冗余类型后缀 |
strName | name | 去掉匈牙利记法前缀 |
handleStuff() | sendInvoice() | 动词具体，不抽象 |
UserInfoManager | UserProfile | 去掉无意义 Manager |
"把 A 变成 B"这类操作最容易被塞进万能的 process/handle，丢掉数据流向信息。按输入→输出的形态变化选最贴切的动词：
| 动词 | 数据流向 | 例子 |
|---|---|---|
parse | 文本 → 结构化对象 | parseCsv(text) → Record[] |
serialize | 结构 → 文本/字节 | serializeOrder(order) → JSON 字符串 |
convert / transform | 结构 → 结构（同层级换形态） | convertMsToSeconds、transformUserToDto |
format | 结构 → 展示用文本 | formatDate(date) → "2026-06-22" |
map / reduce | 集合 → 集合/标量 | mapToIds(users)、reduceToTotal(items) |
选名时问自己：**读者看到动词，能不能猜出输入和输出分别是什么形态？**猜不出（如 processData）就换。
/users、/orders/users/{id}/orders/{oid}/itemsDELETE /users/123 而非 /users/123/delete| 问题 | 修法 |
|---|---|
缩写成谜（usrCfg） | 写全，除非领域通用缩写 |
| 同概念多名（user/account/member） | 全项目统一一个 |
匈牙利记法（strName、intAge） | 去掉类型前缀 |
| 过度抽象（Manager/Handler/Util） | 用具体名词 |
| 否定布尔（isNotValid） | 改肯定（isValid） |