首页 › skills-review › 起名即路由:Skill门面设计学

起名即路由:从装机注册表提炼 Skill 门面层设计模式

概述

一、为什么门面层值得单开一期

门面的经济学结构也不对称。名字是注册表里的免费常驻位:一行一个词,装四百件也不为名字付上下文税。描述是按 token 收租的常驻位——本栏《Skill的上下文经济学》算过这笔账,r2 又立过「付钱最多、读得最少」的描述税概念。所以门面设计的总原则可以一句话说尽:名字往短里省,描述往准里花。往下拆开,就是两条通道各自的写法纪律。

flowchart LR
    U["用户意图"] --> A{"走哪条通道"}
    A -->|"自动路由"| D["description 匹配<br/>前60字符黄金地段"]
    A -->|"手动点名"| N["目录名 / name 字段"]
    D --> D1["触发词 = 用户原话"]
    N --> R{"名字解析"}
    R -->|"叶子名唯一"| T["触发成功"]
    R -->|"叶子名撞车"| C["按命名空间消歧<br/>用户拿到哪一个看运气"]
    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 里,门面上全是噪音。

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 宣传名三者一致吗?不一致时第一屏说明了吗?(安装陷阱)
# 动手前先装两个「门面范本」对照着抄
npx skills add mattpocock/skills      # domain-modeling 的 description 路由表写法(存档实测 4.4)
npx skills find pdf                   # 用市场 CLI 查你的候选名字有没有撞车

# 官方范本库:看 description 如何在截断线前自证
git clone https://github.com/anthropics/skills

推荐排行榜

门面层的全部设计,最后可以收成一句话:名字是用户替你记住的,描述是模型替你匹配的——前者要短到不会拼错,后者要准到不必读完。正文写得再好,路由包没设计好,你的 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 等场景全覆盖。

51学通信知识星球海报-扫码加入