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