## 概述 本周Skills生态最扎眼的新面孔，是一件叫 golive-skill 的新货：截至10月4日，上架没几天就冲到1198星。它干的事说出来毫不性感——把Agent造好的产品“推上线”：托管、数据库、域名、邮箱、收款，一条龙。火成这样，说明一件事：大家已经受够了“Agent什么都能写，就是交不出去”。本期就借这件千星新件当考题，把官方造件规范里最值钱的几条写法提炼成五条军规，再手把手带你写出自己的第一件Skill。 ## 本周明星：脏活才配千星 先看本周上新榜的星数（均为截至10月4日的GitHub数据）：magpie 4458星领跑，universal-modder 2627星、jevgrep 2168星、logo-design-skill 1697星、onetake 1445星、yomiyasu 1310星，golive-skill以1198星排在第七。榜单前列各有来头，但对想动手写件的读者来说，golive-skill是最值得研究的一个样本——因为它的选题思路本身就是第一课。 市面上大量Skill在抢“更高难度的智能”，golive-skill反着来，挑了一道最低频、最没人爱干、但每次交付都躲不掉的工序：产品写完了，怎么从“我机器上能跑”变成“用户手里能用”。托管、建库、配域名、挂邮箱、接收款，每一步都不难，每一步都烦，加起来正好是Agent能力的空白带。千星不是给提示词技巧投的票，是给“选题”投的票。 这是写件的第一条隐形军规：**先选一道真工序，再谈写法**。伪需求写得再漂亮也不会被触发，真工序哪怕写得粗糙也会被人需要。 ## 四种写法流派：动笔前先看清件是怎么写的 | 流派 | 典型样本 | 功能完整度 | 设计质量 | 实战效果 | 上手难度 | 社区活跃度 | |------|---------|-----------|---------|---------|---------|-----------| | 说明书式 | 大量单文件角色/风格件 | ★★ | ★★ | ★★ | ★★★★★ | ★★★★ | | 流程式 | golive-skill这类工序件 | ★★★★ | ★★★★ | ★★★★ | ★★★★ | ★★★★ | | 工具箱式 | 官方pdf/docx等办公件 | ★★★★★ | ★★★★★ | ★★★★ | ★★★ | ★★★★★ | | 教材式 | skill-creator（官方造件器） | ★★★★★ | ★★★★★ | ★★★★★ | ★★ | ★★★★ | - **说明书式**：一个SKILL.md讲完，装了就懂，写起来最快，但件一大就糊。 - **流程式**：围绕一道工序写步骤、边界、产出物，golive-skill是本周最佳样本。 - **工具箱式**：SKILL.md之外还带脚本和参考文档，官方办公件全是这个路数，重、但稳。 - **教材式**：件本身就是一套方法论，官方的skill-creator是天花板——它不光教你写，还自带考试和评分。 第一件Skill，建议从流程式入手：比说明书式有骨架，比工具箱式轻。 ## 五条军规：官方规范里最值钱的写法 以下提炼自官方造件规范（anthropic-agent-skills市场的skill-creator所载），每一条都值得抄在便签上。 ### 军规一：description是唯一的门牌 Skill能不能被唤起，几乎完全取决于frontmatter里的description——正文写得再好，门牌不醒目，件就永远在吃灰。官方对它的定义很直白：这是“主要触发机制”，必须同时写清**做什么**和**何时用**，而且官方明确承认模型有“欠触发”倾向，所以描述要写得主动一点。官方手册给过一组前后对比：与其写“如何给内部数据搭个简单快速的仪表盘”，不如写成“……只要用户提到仪表盘、数据可视化、内部指标，或者想以任何形式展示公司数据，即使用户没说出‘仪表盘’三个字，都要用这个技能”。 注意一个容易忽略的机制：模型只会为“自己搞不定的任务”去翻技能库。一句话能答的问题，描述写得再好也未必触发。所以别指望一件Skill去接管琐事，要让它接管难题。 ### 军规二：三层加载，体积分级 官方规范里最重要的工程决策是体积分层，一张图看懂： ```mermaid flowchart TD A["用户一句话需求"] --> B{"描述门牌匹配？"} B -->|匹配| C["SKILL.md正文进场"] B -->|不匹配| D["裸跑，不装技能"] C --> E{"需要细节？"} E -->|是| F["references按需读取"] E -->|否| G["直接干活"] C --> H["scripts直接执行不占上下文"] ``` 第一层，名称加描述，约百词，**常驻**上下文——这是你件里唯一永远在线的部分；第二层，SKILL.md正文，触发后才进场，官方给的红线是**500行以内**；第三层，随件捆绑的资源，按需取用，不设上限，而且脚本可以只执行、不读入——这意味着你可以塞一个很重的数据处理脚本进件里，却几乎不花上下文成本。写第一件时最容易犯的错，就是把所有细节都堆进正文，结果件还没干活，预算先花光了。 ### 军规三：目录三仓，各司其职 官方给的标准件形制是一个目录，三个专仓： ``` skill-name/ ├── SKILL.md # 必须：frontmatter + 主干指令 ├── scripts/ # 确定性、重复性动作的可执行代码 ├── references/ # 按需载入的参考文档 └── assets/ # 产出时要用的模板、图标、字体 ``` 多领域件按域拆参考文件——官方给的例子是cloud-deploy件把aws、gcp、azure各写一个文件放在references里，模型只读当下相关的那份。还有一条细节级规定：超过300行的参考文件，必须在文件头写目录。这些规定的共同指向是一件事：**让模型每次只读它需要的那一小块**。 ### 军规四：讲why，别喊MUST 官方写作规范里最反直觉的一条：与其用高压句式，不如解释原因。原话的警告是——如果你发现自己通篇是大写的ALWAYS和NEVER，那是一面黄旗；今天的模型足够聪明，理解了“为什么要这么做”之后，执行得比死记硬背好得多。配套的三条笔法：指令用祈使句；产出格式直接给死模板；例子一律用“输入—输出”成对给出。比如报告格式就该这么写： ```markdown ## 报告结构 ALWAYS use this exact template: # [标题] ## 执行摘要 ## 关键发现 ## 建议 ``` ### 军规五：第一件也要考试 官方流程里，件写完不算完，要拿两三个真实用户会说的话当测试提示词，让“装了件的模型”和“裸跑的模型”各跑一遍对照，再看结果。能客观校验的件（文件转换、数据抽取）加断言打分；写作风格、美术这类主观件就别硬加断言，人眼评。更进一步，连描述本身也有考试：造20条查询，一半该触发、一半不该触发（负例专挑那些“沾边但其实不需要”的刁钻句子），六四分成训练集和测试集，跑多轮优化，**按测试集得分定稿**防过拟合。第一件不必全套照搬，但“装与不装各跑一遍”这一步，值得养成习惯——它会在五分钟内告诉你门牌写得行不行。 ## 手把手：二十分钟写出launch-check 现在把golive-skill的需求砍到最小，当我们的考题：不管“上线一条龙”，只管交付前的最后一道检查。建目录： ```bash mkdir -p launch-check/references ``` 写 `SKILL.md`： ```markdown --- name: launch-check description: 在把Agent写好的产品交给用户之前，跑一遍交付前检查：链接可达、 密钥没有硬编码、报错不是白屏、README里的启动命令能跑通。只要用户提到"上线"、 "发布"、"交付"、"给客户演示"，或者刚写完一个Web产品准备收尾，都先用这个 技能过一遍，即使用户没有明确说"检查"。 --- # Launch Check：交付前最后一道闸 为什么需要你：Agent写产品很快，但"能跑在我机器上"和"能交给别人用"之间 隔着一条沟。这道技能把这条沟变成一张清单，逐项打钩，杜绝"我觉得好了"。 ## 工作方式 1. 先问交付对象：客户演示 / 公网用户 / 内部同事，检查强度随之不同。 2. 按需读取 references/checklist.md：演示场景只读第1节，公网场景全读。 3. 每项结论只能是：通过 / 不通过 / 无法验证，不许跳过不提。 4. 不顺手改代码，检查完交报告，修复另行确认。 ## 报告结构 ALWAYS use this exact template: # 交付检查报告 ## 结论（可交付 / 修完这三处再交） ## 未通过项（每项附最小修复建议） ## 无法验证项（说明缺什么信息） ``` 再放一个最小 `references/checklist.md`，感受第三层怎么用： ```markdown # 上线检查清单 ## 1. 演示保命项 - 首页断网依赖：拔掉外网能否打开核心页 - 演示数据已填充，不是空表空图 ## 2. 公网加压项 - 无硬编码密钥（全库检索 key/secret/token） - 404与500有友好页面 ``` 对着五条军规自检：description写了做什么加何时用，还写了“即使没说检查也要用”（军规一）；细节全部下沉references，正文不到50行（军规二）；目录三仓就位（军规三）；正文解释了为什么、给死了报告模板（军规四）；接下来拿两个真实提示词装与不装各跑一遍（军规五）。二十分钟，一件能用的流程式Skill就成形了。 ```mermaid flowchart TD S1["圈定一道真工序"] --> S2["写pushy的门牌"] S2 --> S3["正文只写主路"] S3 --> S4["细节沉入references"] S4 --> S5["重复动作写成脚本"] S5 --> S6["装与不装各考一遍"] S6 --> S7["按成绩改门牌"] ``` ## 装进Claude Code：三条路 ```bash # 路线一：个人级，所有项目可用 mkdir -p ~/.claude/skills/launch-check # 把 SKILL.md 和 references/ 放进该目录 # 路线二：项目级，只对当前仓库生效 mkdir -p .claude/skills/launch-check # 路线三：社区CLI，直接从GitHub装别人的件 npx skills add mikehasa/golive-skill ``` 走路线三时有个小坑：多数技能仓库根目录就是件本身，整仓拷进skills目录即可；若仓库里还套着子目录，把含SKILL.md的那一层拷进去。 ## 推荐排行榜 - **最值得抄的选题**：golive-skill——千星证明真工序压倒一切技巧 - **最值得抄的结构**：官方办公件的工具箱式三仓 - **最值得抄的笔法**：讲why、给模板、成对举例 - **第一件的最短路径**：本文的launch-check，二十分钟可复现 - **本周上新星数榜**（截至10月4日）：magpie 4458 > universal-modder 2627 > jevgrep 2168 > logo-design-skill 1697 > onetake 1445 > yomiyasu 1310 > golive-skill 1198 ## 参考来源 1. [golive-skill](https://github.com/mikehasa/golive-skill) — 本周主角，把“上线”做成一条龙工序的新件 2. [magpie](https://github.com/yetone/magpie) — 本周上新榜头名，星数参照 3. [universal-modder](https://github.com/rehan-remade/universal-modder) — 上新榜次席，星数参照 4. [yomiyasu](https://github.com/nanaism/yomiyasu) — 上新榜技能件，星数参照 5. [anthropics/skills](https://github.com/anthropics/skills) — 官方技能库，本文五条军规所本（skill-creator所在仓库） > [!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 等场景全覆盖。