AI智能体技能:从文档到执行的认知革命

工程师从不爱写文档，

但AI智能体正在改变这一切。

不是因为它能凭空理解你的代码库，

而是因为一种名为“技能”的新标准，

能将沉睡在文档里的“部落知识”变成可执行的指令。

一场静默的认知革命

过去，一家公司的核心竞争力，

往往掌握在几个关键人物的脑子里。

一个POS机崩溃的排查流程，

一套内部API的设计规范，

一份值班应急的SOP手册。

这些被称为“部落知识”，

它们要么口口相传，

要么躺在只有3个人知道的文档里。

Block公司的AI赋能负责人Angie Jones，

正在领导一场静默的革命。

她将这种知识封装成超过100个“AI技能”，

放进一个内部的技能市场。

从此，文档不再是需要阅读的文本，

而是你的AI智能体可以直接调用的“外挂大脑”。

设计技能的3大铁律

第一铁律：明确AI智能体“不该”决定什么。

这是最反直觉却最重要的一条。

AI智能体天生具有不确定性，

你需要做的第一件事，

是剥夺它在关键环节的“自由裁量权”。

Angie举了一个“代码库就绪度评估”技能的例子。

如果让AI智能体直接打分，

每次结果都可能不同。

“所以我把所有评分逻辑都写进了一个独立的bash脚本里。”

“每个检查项都是二元的

——通过或失败，

对应固定分值。”

没有“差不多”，没有“感觉上”。

需要绝对一致性的地方

——无论是评分、SQL查询还是命令格式，

都必须用脚本、模板或硬性规则锁死。

第二铁律：明确AI智能体“应该”决定什么。

如果把一切都锁死，

你只是造了一个昂贵的命令行工具。

AI智能体的价值在于处理那些需要“智能”的部分：

解释结果、生成新内容、进行对话。

例如，

在评估后，

AI智能体可以解释“为什么你的AGENTS.md文件缺失”，

并直接根据你的代码库结构，

为你草拟一份个性化的文件。

“这形成了一个清晰的双区架构。”

“规则与执行交给脚本，

解释与行动交给AI智能体。”

“各司其职，发挥所长。”

第三铁律：撰写“宪法”，而非“建议”。

AI智能体天生是“讨好型人格”，

总想缓和坏消息、添加免责声明。

这恰恰会破坏你设计的确定性。

因此，

在技能说明文件（SKILL.md）中，

必须像制定宪法一样明确：

“永远不要覆盖、调整或重新计算脚本给出的分数。”

“如果脚本说检查失败，

就原样显示。”

“严格遵守指定的格式模板，

而非近似。”

“这是对AI智能体‘乐于助人’天性的防御性设计。”

“指令越具体，

AI智能体需要猜测的就越少，

每个用户的体验就越一致。”

对老板的终极启示：从SOP到AI技能

这篇文章的本质，

是为所有依赖“人脑”和“文档”来传承核心流程的公司，

指明了一条AI自动化的清晰路径。

如果你的销售SOP、客户服务流程、产品交付标准，

还停留在文档和培训阶段，

你正在浪费AI时代最大的效率红利。

Block的实践揭示了一个残酷现实：

未来公司的竞争力，

将不再取决于有多少“销冠”或“技术大牛”，

而取决于你能将多少“部落知识”

转化为标准化的、可被AI智能体执行的“技能”。

“技能”的本质，

是将模糊的经验，

转化为确定性的、可复制的、可迭代的自动化资产。

这不仅是技术升级，

更是组织认知和管理模式的彻底重构。

【好文推荐】

https://engineering.block.xyz/blog/3-principles-for-designing-agent-skills

Block公司AI赋能负责人Angie Jones，

用实战经验揭示了AI智能体技能设计的核心矛盾与解决之道，

为所有渴望将业务流程AI化的企业主，

提供了一份可即刻落地的行动蓝图。