Wink Pings

Agent skills 的麻烦不在写,在删

GitHub 的 Agent skills 指南背后,回复里暴露了更麻烦的问题:技能会过期、会加载错、会没有版本和测试。有人把 onboarding 从 9 小时压到 3.5 小时,也有人审计出 61 条从未写入记录。

GitHub 发了一条推文,介绍 Agent skills:把可重复的指令保存下来,让 agent 和你都能复用。推文附了一份实用指南,链接在这里,原推在这里。

这个描述听起来像提示词收藏夹。真正的问题是,收藏夹会烂。

先解决重复解释

有网友 Jon Cheney 说,以前每个 session 都要重打一遍指令,现在指令集中在一个地方,任务需要时才加载。Andrew 的说法更直接:写一次,每个 agent 都能拿到。

GitHub 的推文也把价值说得很清楚:capture repeatable instructions。目标是让 agent 别每次都从零开始。

麻烦从技能变多开始

Javi 提到一个很具体的点:技能只有加载对了才有用。几十个技能之后,挑哪个加载本身就是问题。他的办法是记录每次运行加载了哪个技能,这样能看出什么时候选错。

ShadowAguy 说技能只在 description 匹配时触发,最后他开始写正则。Buswe 提醒,description 是 agent 决定是否加载的依据,正文只有匹配后才进来。描述写歪,技能等于不存在。

过期是另一个坑。LaunchKit 还在解决规则变化后技能变 stale 的问题。MartinOL 说得更狠:没人重读的旧指令会把 agent 带向错误方向。Krrish 的做法是让 agents 开始删除旧笔记。技能库需要修剪,不然就是技术债。

Max Petrusenko 做了一次同步审计,发现 61 行从未写入,整个 fleet 加载的技能集并不一致。这个问题不花哨,但很致命。

版本、测试、权限

Tanisha Pritha 问,可复用的机构知识要不要像正常代码一样做版本管理,还是直接丢进文件夹。Yuna Han 的回答接近实践:versioned SKILL.md 让团队判断进入 repo,不用留在四个人的脑子里。

验证比写技能更难。Amy 说,独立的 verifier 只拿到 request 和 diff 是聪明的部分,不让它给自己批改作业。Nikolay Rodionov 说,用几百种 harness、model、environment 组合做验证通常最困难。Bhurva 提了一个区分:instructions portable 和 behaviour portable 是两份不同的 release notes,共享测试集应该覆盖同一任务、同一预期证据,也包括什么时候停。

权限也绕不开。波若波罗蜜提到,技能加载成功,换一个 client 仍可能不可用,可以加一个 capability preflight,在工作流开始前报告缺失工具。

Ignacio Ferro 给了一个小例子。他的 book-conversion skill 规定书稿文本放 Markdown,布局放 config。Agent 偶尔还是把章节标题塞进 config,所以 CLI 用 postext check --strict 检查,退出码 3,agent 先修好,人再看。

一个能算账的例子

Sam Woods 说,他第一个会写的技能是 onboarding。合作的一位虚拟助理 VA 把三个 prompt 放在一个 workspace,其中一个把新客户的 intake call 转成可用的 SOP。按她自己的日志,单个客户 onboarding 从大约 9 小时降到 3.5 小时,她多接了五个客户。

还有一条容易被忽略:doanbactam 说 copilot 也读 .claude/skills,一个 skills folder 可以服务两个 agent,不用复制。

Agent skills 看起来是提示词管理,实际更像发布软件。要有版本、测试、加载日志、权限检查和清理机制。写第一个技能可以先从 onboarding 这种重复最多、收益能算的流程开始。别急着堆几十个,先把删除和日志做出来。技能库不修剪,最后会变成 agent 的噪音源。

发布时间: 2026-11-17 15:31