首页 › skills-review › golive-skill上千星:写件第一课

概述

本周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,建议从流程式入手:比说明书式有骨架,比工具箱式轻。

五条军规:官方规范里最值钱的写法

以下提炼自官方造件规范(anthropic-agent-skills市场的skill-creator所载),每一条都值得抄在便签上。

军规一:description是唯一的门牌

Skill能不能被唤起,几乎完全取决于frontmatter里的description——正文写得再好,门牌不醒目,件就永远在吃灰。官方对它的定义很直白:这是“主要触发机制”,必须同时写清做什么和何时用,而且官方明确承认模型有“欠触发”倾向,所以描述要写得主动一点。官方手册给过一组前后对比:与其写“如何给内部数据搭个简单快速的仪表盘”,不如写成“……只要用户提到仪表盘、数据可视化、内部指标,或者想以任何形式展示公司数据,即使用户没说出‘仪表盘’三个字,都要用这个技能”。

注意一个容易忽略的机制:模型只会为“自己搞不定的任务”去翻技能库。一句话能答的问题,描述写得再好也未必触发。所以别指望一件Skill去接管琐事,要让它接管难题。

军规二:三层加载,体积分级

官方规范里最重要的工程决策是体积分层,一张图看懂:

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,那是一面黄旗;今天的模型足够聪明,理解了“为什么要这么做”之后,执行得比死记硬背好得多。配套的三条笔法:指令用祈使句;产出格式直接给死模板;例子一律用“输入—输出”成对给出。比如报告格式就该这么写:

## 报告结构
ALWAYS use this exact template:
# [标题]
## 执行摘要
## 关键发现
## 建议

军规五:第一件也要考试

官方流程里,件写完不算完,要拿两三个真实用户会说的话当测试提示词,让“装了件的模型”和“裸跑的模型”各跑一遍对照,再看结果。能客观校验的件(文件转换、数据抽取)加断言打分;写作风格、美术这类主观件就别硬加断言,人眼评。更进一步,连描述本身也有考试:造20条查询,一半该触发、一半不该触发(负例专挑那些“沾边但其实不需要”的刁钻句子),六四分成训练集和测试集,跑多轮优化,按测试集得分定稿防过拟合。第一件不必全套照搬,但“装与不装各跑一遍”这一步,值得养成习惯——它会在五分钟内告诉你门牌写得行不行。

手把手:二十分钟写出launch-check

现在把golive-skill的需求砍到最小,当我们的考题:不管“上线一条龙”,只管交付前的最后一道检查。建目录:

mkdir -p launch-check/references

写 SKILL.md:

---
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,感受第三层怎么用:

# 上线检查清单
## 1. 演示保命项
- 首页断网依赖:拔掉外网能否打开核心页
- 演示数据已填充,不是空表空图
## 2. 公网加压项
- 无硬编码密钥(全库检索 key/secret/token)
- 404与500有友好页面

对着五条军规自检:description写了做什么加何时用,还写了“即使没说检查也要用”(军规一);细节全部下沉references,正文不到50行(军规二);目录三仓就位(军规三);正文解释了为什么、给死了报告模板(军规四);接下来拿两个真实提示词装与不装各跑一遍(军规五)。二十分钟,一件能用的流程式Skill就成形了。

flowchart TD
    S1["圈定一道真工序"] --> S2["写pushy的门牌"]
    S2 --> S3["正文只写主路"]
    S3 --> S4["细节沉入references"]
    S4 --> S5["重复动作写成脚本"]
    S5 --> S6["装与不装各考一遍"]
    S6 --> S7["按成绩改门牌"]

装进Claude Code:三条路

# 路线一:个人级,所有项目可用
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的那一层拷进去。

推荐排行榜

参考来源

  1. golive-skill — 本周主角,把“上线”做成一条龙工序的新件
  2. magpie — 本周上新榜头名,星数参照
  3. universal-modder — 上新榜次席,星数参照
  4. yomiyasu — 上新榜技能件,星数参照
  5. 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 等场景全覆盖。

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