编写 Agent Skills 的 8 个技巧
本文是 Philipp Schmid 关于如何编写高效 AI Agent Skills(技能)的实用指南。文章指出技能虽然灵活但难以掌握,并提出了 8 个核心建议:明确技能定义(能力型 vs 偏好型)、精确描述触发条件、编写指令而非冗长文章、保持内容精简、给予 Agent 适当的自由度而非死板的步骤、定义负向触发条件、通过多轮测试评估效果,以及当模型能力提升时及时淘汰冗余技能。
本文是 Philipp Schmid 关于如何编写高效 AI Agent Skills(技能)的实用指南。文章指出技能虽然灵活但难以掌握,并提出了 8 个核心建议:明确技能定义(能力型 vs 偏好型)、精确描述触发条件、编写指令而非冗长文章、保持内容精简、给予 Agent 适当的自由度而非死板的步骤、定义负向触发条件、通过多轮测试评估效果,以及当模型能力提升时及时淘汰冗余技能。
文章提供了极其详实、可落地的Agent技能开发指南,结构清晰且发布时间非常接近当前日期,具有很高的技术参考与时效价值。
文章提出 Skill 本质是一个微型 Harness,一个完整 AI 工作系统包含六层:信息边界、执行编排、记忆与状态、工具系统、约束恢复、评估观测。作者给出六步写作法:先写 description 作为触发开关,再按任务脆弱程度定正文松紧,超过 500 行的资料拆成参考文件,重复操作固化为脚本,写明失败时的默认行为,最后用真实任务验证迭代。文章强调 description 是主要触发机制、模型天生欠触发、上下文窗口是公共资源、卡的下限由失败处理决定等实战经验,并提供最小可用卡模板和发布前检查清单。
作者基于 Anthropic 工程师删除 Claude Code 80% 系统提示词却无性能损失的事实,反思提示词与 Agent Skill 的实践方法。提出提示词不是八股文,应聚焦任务三要素(目标、规则、完成标准),减少角色铺垫和冗余规则,多给思考方向而非僵硬示例,并设定明确验收标准。关于 Skill 沉淀,强调只有高频且流程稳定的任务才值得做成 Skill,要写入独特经验而非通识废话,严格控制单一职责与边界,主文件精简并渐进式加载,且必须内置自检环节形成质检闭环。
OpenAI 的最新模型 GPT-6 Astra 能力大幅提升,过去用于强制模型运行测试、逐步思考等行为的旧提示词反而会拖累表现。文章总结了 Astra 需要显式提示的五大行为:主动性(过早停下来提问)、指令优先级冲突、默认过度 Markdown 的写作风格、子代理委派不足、过度测试。作者提出一个 8 块提示框架(目标、上下文、优先级、自主性、工具、输出、验证、停止条件),并强调按需选用。文中还给出清理过时指令文件、编写 Skill 文件的三条规则,以及控制文风、抑制套话的具体提示词模板,帮助开发者适配新模型的提示工程实践。
文章系统讲解如何编写 AI Skill:从用一句话加 SOP 封装出第一个 60 分的 skill,到通过把目标改写为动作、补充约束、设计自由度和提高词表颗粒度来提升到 90 分。作者拆解了摄影 skill 和封面 skill 两个开源案例,指出高手的秘诀在于将模糊概念拆成可执行的词表和明确的「不要」清单。还介绍了如何让 AI 递出陌生领域的行话词表,并澄清了 skill 与提示词、智能体的区别。全文强调约束和颗粒度决定 skill 的专业程度。
文章面向新手讲解如何为 Claude Code 和 Codex 制作个人 Skill,解决每天重复向 Agent 解释工作流程的问题。作者介绍 Skill 的本质是一个包含 SKILL.md 的目录,依赖渐进式披露机制;提出判断任务是否值得封装为 Skill 的三个信号(重复出现、依赖专有知识、错误成本高);建议从成功协作会话中逆向工程提取 Skill,或先跑无 Skill 基线记录失败点再写规则;并详细分析三大坑:description 模糊导致不触发、把任务写成死板 SOP、SKILL.md 过长,给出 SKILL.md、references、scripts、assets 的合理拆分方式及三层验证与维护方法。
本文作者作为Superpowers插件早期用户,分析了该插件中14个skill在当前前沿模型(如GPT 5.6 Sol)日益强大的背景下的适用性。作者认为,虽然每个skill本身具有合理的软件工程依据,但作为强制工作流组合使用时,会导致流程复杂化、过度设计、时间和token消耗增加,反而降低开发效率。建议开发者根据实际需求提炼使用,而非全盘套用。
本文是 Claude 官方文章的译文,探讨在构建 agent 系统时何时应将子 agent 折叠进主 agent 循环。文章指出,配备 skill 的单一 agent 在质量、成本和延迟方面常常优于多 agent 设计。作者分析了大型组织构建 agent 的常见失败模式(上下文管理、子 agent 泛滥、Frankenprompt、延迟等),介绍通过渐进式披露 skill 和 MCP 工具的 agent 循环设计,并给出将子 agent 迁移为单循环的分阶段方法:构建任务完成评估、合并领域 agent、将子 agent 转为工具调用、用 skill 和工具替代子 agent,以及多团队协作的治理模式。
文章针对普通人收藏大量 AI 教程却始终没学会的问题,提出按可上手顺序排列的六阶段学习路线:先搞懂大模型、Agent、MCP、Skill 四个基础概念;再学会高效提问;然后选一个通用 AI 助手用熟;之后分创作者路线(做图、视频、语音)和开发者路线(MCP 与 Agent 开发)深入;最后选读书籍论文进阶。作者强调'卡住你的不是资源不够,而是顺序不对',并附上 30 天打卡表、53 个免费资源和五个避坑建议,倡导边用边学、动手实践。
作者分享了使用 Claude Code(Opus 5.5)批量制作资讯类竖屏短视频的完整工作流。核心步骤包括:选题(AI 粗选、人工精选,信息源以推特和 Hacker News 为主)、素材准备(Gemini API 写脚本和 TTS 配音、Suno 背景音乐、背景图、logo 等)、编写初始提示词、让 Agent 撰写脚本并派子 agent 做对抗式审查、反复修改脚本与成片。文中提供了可直接复用的提示词模板,并开源了包含 18 套竖屏视频风格的 Claude Code skill(creator-style-kit),可用于固定视频的字体、配色、动效与音效风格。