用 Skill 开发 Skill 并测试 Skill 趣事分享

用 Skill 开发 Skill 并测试 Skill

Vibe Coding 一阵子，对 skill 的认知一直保持在 “自带环境的 prompt 模版”的阶段。盲目装上一堆 skill 无疑会加大 token 消耗，且更大概率会触发语义矛盾让 agent 左右为难，但不用又显得太“过”装清高了，更不用说那 skill 是真有用啊。考虑到媒体放卫星式的噪音，我自己动手写了几个 skill，目前 CC 和 Codex 都使用一套 skill 配置。这篇文章简单记录一下过程中的有趣发现。

那个万星的 andrej-karpathy-skills 到底做了什么

有一个经媒体大力宣传，GitHub 上 Starred 过万的项目，叫 andrej-karpathy-skills。号称一个 skill 便能让你的 agent 按照 “vibe coding” 概念的提出者 Andrej Karpathy 的理念来写代码。听着很诱人对不对，颇有种请祖师爷上身的感觉。

Skill 本体很简单，一个 65 行纯文本 markdown 文件，没有附带任何娱乐，没有黑魔法，就像仓库介绍一样 “A single CLAUDE.md file to improve Claude Code behavior”。

这 65 行的内容，是对 Karpathy 在 2026 年 1 月发布的一条推文进行内容压缩、指令化，来指导 agent 行为。举例来说

[Karpathy’s Post] They also don’t manage their confusion, they don’t seek clarifications, they don’t surface inconsistencies, they don’t present tradeoffs, they don’t push back when they should, and they are still a little too sycophantic.

K 在这段话中列举了 agent 当前阶段一些表现不佳的方面，比如遇到模糊概念擅自作主，过于迎合用户（You’re absolutely right!）等等。

[Skill.md] Don’t assume. Don’t hide confusion. Surface tradeoffs.

Before implementing:

• State your assumptions explicitly. If uncertain, ask.
• If multiple interpretations exist, present them - don’t pick silently.
• If a simpler approach exists, say so. Push back when warranted.
• If something is unclear, stop. Name what’s confusing. Ask.

Skill 针对 Karpathy 的吐槽反向要求，表达成这四条。核心很简单，要求 agent 对一切模糊概念与用户进行“交互式确认”。

我完整阅读完原始 Post，并使用了这个 Skill 两天。诚然，它确实能缓解一些问题，但还是太粗暴太naive了，毕竟压缩是有代价的，而且对 Karpathy 所述内容的理解因人/agent而异。我自己重新写了个 Karpathy Behavioral Guidelines (KBG) skill。倒不是吹嘘自己的理解比原仓库更好（不可能，毕竟都用了差不多的 model 哈哈哈），我个人的建议是这样的，每个人都应当重新读一下原始 Post，并根据你自己的理解/喜好，edit/rewrite/write 一套适合自己的 KBG skill。想想看，你就像在指导一个知识储备很丰富但理解不了你意图的实习生一样，最重要的是让 ta 和你合作更加融洽。拷贝一个上万 star 的 skill只能说你克隆了原始作者的理解，但你和他的行为方式一样吗？他命令的风格是你的风格吗？他认定放弃自由度和效率换取准确度的 tradeoff 和你完全一致吗？对我而言，答案是否定的。

Agent 用 Skill 来写 Skill

Codex 系统自带的 skill 中有一个叫 Skill Creator。功能不仅包含构建新的 skill，还可以用来更新现有 skill，进行迭代。比如我的 git-commit-assist skill 首版运行状况不及预期，就通过这个 “元 skill“ 进行修改。

细想还是挺有趣的，用 Skill 来写 Skill，像是 agent 领域的自我指涉（self-reference）。这个说法不准确，可能用 Skill Creator 来修改 Skill Creator 才算。

请好好写 description

之前编写项目 description 或者仓库 description 时我总是不够用心，因为这个描述对实际功能不造成影响。Agent skill 不一样，description 决定了 agent 什么时候会调用这个 skill，并影响 skill 的实际效果。

比如下面这段 skill 描述：

--- name: git-commit-assist description: Draft Angular-style git commit messages and complete git commit workflows with explicit AI participation metadata. Use when the user asks to create a commit, says "git commit", "commit this", "write a commit message", "will commit", "help me commit" in English or Chinese, or needs to choose AI attribution and Co-authored-by (coauthor) trailers for a commit. ---

意料之外的事

分享一个有趣的意料之外的事，当我进行 git-commit-assist 这个 skill 时，修改完成但还没有推送更新，即编辑的 /tmp/skills 包含新版本 git-commit-assist 但是 ~/.claude/skills 中的还是旧版本。新版本主要功能就是调用了一个 AskUserQuestion 来让 agent 和用户进行交互式确认。当我在 claude 中敲出 help me commit 的时候 Claude 使用了新版本的功能。至于原因，可能是我太傻了没意识到哈哈哈我还问了下他，各位可以按自己理解解释下。

skill 也可以关闭自动调用功能. 例如用来代替原来的cmomand. description 随便写也不影响.

嗯是的，我写文的时候好像不小心删了这段内容。比如 Claude Code 可以在抬头处标记disable-model-invocation: true 来命令禁止 skill 的自动唤醒，这样只能通过/skill-name来主动启用。不过 A 社的策略还是让 agent 自主决定 skill 的使用方式，且这个标准目前没统一。我就没在 codex 相关文档中找出对这个字段的支持。