# 起名即路由：从装机注册表提炼 Skill 门面层设计模式 ## 概述 ## 一、为什么门面层值得单开一期 门面的经济学结构也不对称。名字是注册表里的免费常驻位：一行一个词，装四百件也不为名字付上下文税。描述是按 token 收租的常驻位——本栏《Skill的上下文经济学》算过这笔账，r2 又立过「付钱最多、读得最少」的描述税概念。所以门面设计的总原则可以一句话说尽：**名字往短里省，描述往准里花**。往下拆开，就是两条通道各自的写法纪律。 ```mermaid flowchart LR U["用户意图"] --> A{"走哪条通道"} A -->|"自动路由"| D["description 匹配
前60字符黄金地段"] A -->|"手动点名"| N["目录名 / name 字段"] D --> D1["触发词 = 用户原话"] N --> R{"名字解析"} R -->|"叶子名唯一"| T["触发成功"] R -->|"叶子名撞车"| C["按命名空间消歧
用户拿到哪一个看运气"] D1 --> T ``` ## 二、名字形态学：装机注册表里的五个流派 对注册表四百余条名单做逐条形态归类，能收拢出五个命名流派。评测对象从「件」换成「写法」，所以本期的对比表评的是流派而非产品——单位变了，维度跟着换，不硬套五维权重。 | 门面写法 | 路由命中面 | 自解释度 | 家族扩展性 | 撞名风险 | 漂移风险 | |---|:---:|:---:|:---:|:---:|:---:| | 人名-skill 模板 | ★★ | ★★★★ | ★★★★ | ★★ | ★★★★ | | X-to-Y 管线名 | ★★★★★ | ★★★★★ | ★★★ | ★★★★★ | ★★★★★ | | 平台前缀 | ★★★ | ★★★★ | ★★★★★ | ★★★ | ★★★ | | 动词锁定 | ★★★★ | ★★★★ | ★★★★ | ★★★★ | ★★★★ | | 变体后缀 | ★★ | ★★ | ★★★★★ | ★★★ | ★★ | > 计分口径：星多=优（撞名风险、漂移风险两维也是星多=风险低）。依据为一手名单的形态观察与存档旁证，属门面层估分※，与正文层的五维分不可比。 **流派一：人名-skill 模板，人设件的工业标准。** 装机普查存档早就数过：人设件占装机的三分之二。名单层面的观察比数量更有意思——这二百多件几乎全走同一个模板 `<人名拼音>-skill`：caocao-skill、libai-skill、zhouxingchi-skill、moyan-skill、liucixin-skill。-template 的纪律性极强，强到 `-skill` 后缀在本注册表里已经** functions 成了人设类的类标记**：工具件几乎不带这个后缀（deep-research 不叫 deep-research-skill）。但模板内部有三条转写裂缝：中文名人用拼音（liudehua），国际名人用英文名（jackie-chan、donnie-yen），日漫角色用罗马字（naruto、luffy）。用户心里念的是「成龙」，盘上的名字叫 jackie-chan——手动通道在转写层断裂※。想写人设件的读者，抄模板没问题，但转写方案要一开始就定死并在 README 里写明检索词。 **流派二：X-to-Y 管线名，自解释度的天花板。** 名字直接写 I/O 契约：zlib-to-notebooklm、ebook-to-article、arxiv-paper-to-wechat-article、article-to-excalidraw、book-to-short-videos、content-to-video、txt-to-video、3gppspec-to-video、knowledge-to-slides、knowledge-to-course、notion-spec-to-implementation——至少十一件。r7 拆 NotebookLM 系时给 zlib-to-notebooklm 起过「管线名」的名字，本期把它扩成普查：这是一个成型流派。它的厉害之处在于**描述缺位时仍然能路由**：一个叫 arxiv-paper-to-wechat-article 的件，哪怕 description 一个字没有，用户和模型也能从名字里读出「输入 arXiv 论文、输出公众号文章」。这是 r6 增长线「交付物具体>能力大而全」结论在命名层的完整体现。代价是名字长，且只能覆盖「单进单出」的工具，流程型件用不上。 **流派三：平台前缀，家族的门牌。** obsidian- 四件独立（markdown/mermaid/bases/cli）、notion- 四件、pcap- 三件（analyzer/generator/modifier）、gh- 三件、zlib- 两件。前缀的价值是**在用户的目录里圈地**：`ls ~/.claude/skills/` 时一个家族视觉上聚团。但 r7 已观察到一个反例：Obsidian 家族的 json-canvas 和 defuddle 两个成员**不带前缀**——家族纪律在边界成员上失守，招插件进贡的家族（obsidian: 命名空间）反而自家有两个「外姓」。 **流派四：动词锁定，职责写进词根。** gh-fix-ci 的 fix、planning-with-files 的 planning，是本栏提炼过的「动词锁定职责」模式；openstoryline-install/openstoryline-use 把**阶段**写成动词对，pcap-analyzer/generator/modifier 把**职能**写成动词三连——动词选得好，名字就是用法说明。 **流派五：变体后缀，最方便也最危险的一派。** 后缀系统承载版本与方言：course-video-maker 家族摆出一个干净的 2×2 矩阵（基础 / -link / -zh / -zh-link）；ericsson-ppt-writer 摆出三连（基础 / -sc / -v2）；chart-craft-plus、gstack-local 各占一格。语言后缀 -zh、-sc 是中文生态的刚需发明。但后缀是五个流派里**唯一会主动制造歧义**的：用户分不清 -v2 和 -plus 哪个是推荐版、-link 和无 link 差在哪——后缀的含义只活在 README 里，门面上全是噪音。 ```mermaid mindmap root((门面命名五流派)) 人名-skill 模板 caocao-skill jackie-chan-skill 转写裂缝 X-to-Y 管线名 arxiv-paper-to-wechat-article zlib-to-notebooklm 平台前缀 obsidian- 四件 pcap- 动词三连 动词锁定 gh-fix-ci openstoryline-install/use 变体后缀 course-video-maker 2x2 ericsson-ppt-writer 三连 ``` ## 三、撞名现场：叶子名不是你的 流派讲完，讲三个失败案例——门面层的教训全在现场里。 **案例一：huluwa 家族的模板裂缝。** 注册表里葫芦娃家族整整七件：huluwa-erwa、huluwa-liuwa、huluwa-qiwa、huluwa-sanwa、huluwa-siwa、huluwa-wuwa，外加 huluwadawa。六个兄弟严格走「拼音+数字序号+wa」模板，唯独大娃破了功——fuse 成一个词、没有连字符、不占序号位。这不是敷衍，是**模板没给边界成员留位置**：序号体系天然容不下「第零个」。克隆流水线（先做老大、再批量复制兄弟）的通病在命名层暴露无遗：模板是在第一个成员身上长出来的，不是设计出来的。给写家族件的人的教训：**克隆之前先写命名规范，特别是把排序体系装不下的成员怎么叫先定好**。 **案例二：泛名单词的重灾区。** 数一遍注册表的双重注册位：pdf 与 example-skills:pdf 并存；pptx 与 example-skills:pptx 并存；deep-research 独立件与插件命名空间变体并存；最夸张的是 skill-creator——独立位出现两次（可能是重复安装或同名不同源，未能核验※），再加 example-skills:skill-creator 和 obsidian:skill-creator，**一件四注册、三个身份**。叶子名（冒号后面那截）不是你独占的资产，命名空间才是名字的一部分。用户敲「pdf」命中的是哪一个，取决于宿主的解析顺序——r7 拆过的「官方范本被反复再打包是品类常态」在命名层的推论就是：**越通用的单词名，越保不住**。作者侧的自保动作只有两条：名字自带限定词（像 gstack 用 -local 标注变体），以及让 `name:` 字段与目录名严格一致——taste-skill 的教训（安装参数认 `name:` 不认目录名，大量用户栽在这里，08-28 存档单源）值得每个作者贴在 README 第一屏。 **案例三：蹭牌与梗名，门面的暗面。** 《新星榜暗面》报道过梗件、蹭牌、书改三类内容型问题，落到命名层就是两条禁令：一禁**商标伪装**——名字让人误以为是官方出品（notebooklm-skill-master 这种「产品名+说明书体」的杂交名，r7 已标注上游未经核实）；二禁**梗名**——梗是发送者与接收者的共谋，路由是陌生人之间的契约，梗名在门面上等于自断自动通道。人名-skill 模板反而是「借用名字」的合法形态：借的是**内容**（人设），不是**信誉**（出品方）——这条边界，人设件和蹭牌件隔着一条线。 ## 四、描述开头样本库：六个开场白模板 1. **交付物开场**（goldie）：「agentic app store previews and screenshots」——六个词说完产出物。r6 已论证这是它综合分第一的门面原因：验收物越具体，模型发挥翻车的空间越小。 2. **隐喻开场**（scroll-craft）：「Scroll becomes the timeline」——一句话给模型一个编排坐标系。隐喻开场赌的是**标题党式的记忆度**，适合方法论即卖点的件。 3. **契约开场**（deep-research）：「Deep research harness — fan-out web searches, fetch sources, adversarially verify claims」——动词序列即架构图，r2 逐句拆过，不重复。 4. **门禁开场**（claude-api）：「TRIGGER when: … SKIP when: …」——把触发与豁免条件直接写进描述，路由器做的是显式排除法，本栏引为教科书的写法。 5. **原话开场**（update-config）：描述里直接引用用户会说的话——「Automated behaviors ("from now on when X", "each time X")」——原话就是触发词，用户不需要学任何咒语。 6. **旗标开场**（code-review）：「Pass --comment to post as inline PR comments, or --fix to apply」——把调用旗标写进描述，描述兼当 usage 文档，适合有参数面的件。 ## 五、预检五问：动笔给门面起名之前 沿用 r8-1228「评分表翻面即预检清单」的方法，把门面层的设计纪律压成起名前自答的五个问题： 1. **点名卷**：用户凭记忆敲出这个名字的成功率有多高？转写方案（拼音/英文/罗马字）定了吗、写进 README 了吗？（手动通道） 2. **撞名卷**：这个叶子名在主流仓库和插件市场里有没有同名字？泛名单词（pdf/pptx 级别的通用词）加限定词了吗？（命名空间） 3. **家族卷**：要做家族件，前缀、后缀、序号体系定好了吗？边界成员（第零个、本地版、方言版）的命名写进规范了吗？（克隆漂移） 4. **截断卷**：description 第一句在前 60 字符里说清「什么时候用我」了吗？六个开场白模板选哪个？（自动通道） 5. **一致卷**：`name:` 字段、目录名、README 宣传名三者一致吗？不一致时第一屏说明了吗？（安装陷阱） ```bash # 动手前先装两个「门面范本」对照着抄 npx skills add mattpocock/skills # domain-modeling 的 description 路由表写法（存档实测 4.4） npx skills find pdf # 用市场 CLI 查你的候选名字有没有撞车 # 官方范本库：看 description 如何在截断线前自证 git clone https://github.com/anthropics/skills ``` ## 推荐排行榜 - **最自解释的门面**：X-to-Y 管线名——描述缺位仍可路由，工具件首选。 - **最适合家族化**：平台前缀+格式名词——Obsidian 家族证明了圈地价值，但记得给所有成员戴上前缀。 - **最低成本起步**：人名-skill 模板——人设件照抄即可，先定转写方案。 - **最需要纪律**：变体后缀——好用但会漂移，每个后缀的含义必须在 README 立法。 - **本期的头号反面教材**：huluwadawa——不是写错了，是模板没给边界留位置；以及 skill-creator 的四注册三身份——通用单词名在再打包生态里保不住。 门面层的全部设计，最后可以收成一句话：**名字是用户替你记住的，描述是模型替你匹配的——前者要短到不会拼错，后者要准到不必读完**。正文写得再好，路由包没设计好，你的 Skill 就死在被打开之前。 ## 参考来源 > [!tip] 51学通信知识星球 > **星主：爱卫生**（微信：gprshome201101）——公众号「51学通信」创办者，19 年通信行业运维与讲师经验，著有《GPRS网络信令实例详解》《EPC原理与实践》《5G核心网原理与实践》三本纸质书（各大电商平台有售）。 > **星球定位**：深耕 5G 核心网、IMS、NFV/AI、云原生等 ICT 领域，主打运维岗位与信令分析。 > **当前规模**：5200 篇主题 / 990 个回答，198 元/年。 > **加入福利**：加入星球后请加爱卫生微信，拉您进知识星球年度陪伴与答疑群——不限量回复您的各种问题，另有群内分享。 > **AI 加持**：51学通信知识星球已作为 skill 接入 WorkBuddy，使用 deepseek-4-flash 在海量星球帖子中精准找贴、找视频、找 FAQ 和案例，做总结、找文档和 PPT 等场景全覆盖。