SuperAPI AI 工具集

naming

通用与其它

查看项目

更新于 10-16 04:30

技能介绍

用途:把文件名本身当作语义绑定工具,通过统一命名让文件系统形成可读、可排序的语义网络。该技能封装 kernel/NAMING.yml,作为命名约定的参考入口。

主要能力与规则:核心模式为 TYPE-VARIANT.ext。TYPE 表示类别或角色,如 cat、staff、ROOM;VARIANT 表示具体实例,如 terpie、marieke;ext 为文件类型,如 .yml、.md。由此同类文件会聚集,例如查找“所有 cat”可用 cat-*.yml。示例目录中同一房间下会并存 ROOM.yml(仅类型,代表该房间本身)、cat-terpie.yml、cat-stroopwafel.yml、staff-marieke.yml、menu-strains.yml(menu 为类型、strains 为变体)。排序优势上,ls *.yml | sort 会按 cat-stroopwafel.yml、cat-terpie.yml、menu-strains.yml、ROOM.yml、staff-marieke.yml 的顺序输出,使类别成簇。

特殊文件名:ROOM.yml 用于房间定义,CHARACTER.yml 用于角色定义,SKILL.md 用于技能规范,README.md 作为人类可读的落地页,INDEX.yml 作为注册表。

使用方式:按上述模式为文件命名,并参考 kernel/NAMING.yml 获取完整命名规则、大端式命名的理由以及与 Minsky K-line 的关联。

适用场景:需要在文件或目录中表达分类与实例关系、希望命令行排序即可聚集同类项的场合。

限制:资料未提供自动重命名、校验工具或具体实现代码,仅给出命名约定与参考文件;实际采用需人工遵循规则。