写 AI Agent Skill 的实战指南：像写文档一样写、像维护代码一样养

adnan_hashmi · x · 2026-10-21

Eugene Meidinger 与 Ruben Van de Voorde 发表长文，系统讲解如何为 AI agent 编写 skills（如 Claude Code、GitHub Copilot 等 harness 所用的开放标准）。

核心观点

• Skill 本质是一个含 SKILL.md 的文件夹加可选参考文件和脚本，就是给 agent 的上下文打包，没有魔法；但它能让 agent 做到原本做不到的事。
• Frontmatter（name + description）是始终加载的部分，决定 agent 是否调用该 skill；正文指令和参考文件只在被调用后才读取。
• 该写什么：现代 agent 擅长自己搞清代码和工具的技术细节，但无法推导你业务的流程、定义与偏好——这些才是 skill 应承载的内容。
• 怎么写：迭代式写作——让 agent 执行任务、记录遇到的问题、再改进；过度规定细节的 skill 反而制造混乱，很多时候该考虑删减和改写而非堆砌。
• 配图强调方法论：像文档一样写（散文而非语法、为读者写、解释 why），像代码一样维护（进 Git、走 PR 评审、用 evals 测试后迭代）。

原文链接 →

「编程与Agent」频道最新

• Compaction hooks 实战:保留末尾消息原文+摘要压缩,实现 agent 记忆连续性 — MoonL88537 · 2026-10-21
• 「空白输入框的隐性成本」：当操作负担经由语言重新回到用户身上 — _AustinCalvert_ · 2026-10-21
• DeepMind 论文：自进化 Agent 学新任务最快，忘掉旧知识也最多 — rohanpaul_ai · 2026-10-21
• arXiv 原文:《自进化 Agent 是持续学习者吗?》——可塑性代价是稳定性 — rohanpaul_ai · 2026-10-21
• PM OS、Team OS、Company OS:三层 AI 工作系统怎么搭、先搭哪个 — aakashgupta · 2026-10-21
• TorchTPU 实测演示：vLLM 与 SGLang 统一后端跑 TPU 服务 — Rob_Mulla · 2026-10-21

更多「编程与Agent」频道 AI 资讯 →