Agentic AI 技能设计的十大设计原则

Introduction: The Recipe Book That Writes Itself

引言：自我编写的食谱书

When people discover that AI systems can be dramatically more effective — not 2x better, but 10x or 100x — they assume it's because of a smarter model. Better algorithms. More parameters. Secret sauce inside the AI itself.

当人们发现 AI 系统可以 dramatically 更有效——不是 2x 更好，而是 10x 或 100x——他们假设是因为更聪明的模型。更好的算法。更多参数。AI 内部的秘方。

It's not. The people getting extraordinary results are using the same models everyone else uses. The difference is how they wrap those models — specifically, how they write skills.

不是的。获得非凡结果的人使用的是和其他人相同的模型。区别在于他们如何包装这些模型——具体来说，如何编写技能。

A skill is a reusable document that teaches an AI how to do something. Not what to do in one specific situation, but how to approach an entire category of tasks. Think of it as a recipe rather than an order. "Here's how to investigate a whistleblower complaint" rather than "Tell me if Dr. Smith was silenced."

一个 skill 是一个可重用的文档，它教 AI 如何做某事。不是在一种特定情况下做什么，而是如何处理整个一类任务。把它想象成食谱而不是订单。“这是如何调查举报人投诉”而不是“告诉我 Dr. Smith 是否被噤声。”

The same skill, invoked with different inputs, can turn an AI into a medical research analyst, a forensic investigator, or a policy compliance auditor. The skill describes the process. The invocation supplies the world.

同一个 skill，用不同的输入调用，可以将 AI 变成医学研究分析师、法医调查员或政策合规审计员。skill 描述了流程。调用提供了世界。

This essay distills ten principles for designing these skills well. These aren't tricks or hacks. They're structural insights about how AI systems work — and once you understand them, the practices feel obvious.

这篇文章提炼了设计这些技能的十个原则。这些不是技巧或黑客方法。它们是关于 AI 系统如何运作的结构洞见—一旦你理解它们，这些实践就显得显而易见了。

Principle 1: Skills Are Recipes, Not Orders

原则 1：技能是配方，不是命令

A common mistake is writing skills that look like this:

一个常见的错误是编写看起来像这样的 skills：

"Analyze the customer feedback and summarize the key themes."

"分析客户反馈并总结关键主题。"

This isn't a skill. It's an order. It works once, for one situation, and then it's gone. You can't reuse it because everything specific is baked in.

这不是一个 skill。它是一个订单。它只适用于一次、一种情况，然后就没了。你无法重用它，因为所有具体内容都已硬编码在内。

A skill looks...