# 命名规范 > 权威合同：`docs/系统架构/新版设计/项目目录与文件职责.md`（命名与职责节）；机械门禁：`make 检查`（索引一致性）。 1. **中文优先**：自有业务目录、文件、模块、类、函数与测试名使用中文；技术约定名称（`pyproject.toml`、`uv.lock`、`Makefile`、`conftest.py`、`node_modules` 等）保留英文。 2. **展示名与稳定身份分离**：对外展示用中文名；稳定身份（case_id、类型 ID、字段 ID、事件类型）用既定英文/十六进制形式，不为改名破坏身份。技能 `name` 是中文展示名，已发布 `id` 保留既有前缀与连字符/下划线形式；只有真实兼容迁移才另行变更身份，不能为排版统一批量改号。 3. **模块文件三件套**：业务模块公开面 = `接口.py`；内部 = `模型.py` + `存储.py`；不新增平行命名。 4. **测试符号**：`test_<行为名>__`；参数行保留稳定行 ID。 5. **工具脚本**：`工具/<动词+对象>.py`；登记文件与生成物同名配对（如 `资源登记.json` → `src/muse/资源/`）。 6. **一个概念一个名**：术语见 `.agent/规范/术语.md`；不为风格引入第二名称。 7. **React 识别前缀**：组件使用 `Ui` 加中文业务名，Hook 使用 `useMuse` 加中文业务名，保留框架和静态检查所需的英文识别前缀；其余自有业务名仍使用中文。 ## 技能发现与运行能力 - **方法发现**：`SKILL.md` 的 `name` 与 `description` 描述中文名称、实际触发与适用边界；目录由[维护索引](../../工具/维护索引.py)从来源生成。导航的使用场景、使用要求只在技能源文件的导航元信息中维护，不在目录再写一份。 - **运行能力**：只有[资源登记](../../工具/资源登记.json)选中的发布子集进入能力包；声明字段和取值复用[解析能力声明](../../src/muse/资源加载.py)，最小字段是 `id/name/category/contract_version/description`。操作能力还须在 `commands` 中声明实际入口，由[能力编译器](../../工具/构建资源包.py)与已实现命令核对。 - 两层职责不同：发现方法不等于运行时已发布、已评测或已启用，不为所有方法补无消费者的能力字段。目录分类与发布分类不混用；正文按真实输入、动作、输出及拒绝/恢复职责组织，不强制所有技能套相同标题。