【第 3713 期】Perplexity Agent 技能设计、打磨与维护完全指南

📌 一句话摘要

本文是 Perplexity Agents 团队的生产实战指南，系统阐述 Agent 技能的设计原则、构建步骤与长期维护方法，强调技能与代码编写的根本差异。

📝 详细摘要

文章来自 Perplexity 研究团队，由前端早读课编译。核心观点是：编写 Agent 技能与编写传统代码截然不同，许多代码最佳实践在技能创作中是反模式。文章首先定义了技能的四个维度：技能是一个目录（包含 SKILL.md、scripts、references 等）、一种格式（SKILL.md 的 name 和 description 是路由触发器）、可调用的（按需加载）、渐进式的（索引层、加载层、运行时层三级上下文开销）。随后，文章给出了判断是否需要技能的实用标准：只有当 Agent 在缺少特定上下文时会犯错，或需要保持高度一致性时才需要技能；每项技能都是一笔 token 税。构建步骤包括：先写评估用例、撰写描述（最难的部分，以「当……时加载」开头）、编写正文（跳过显而易见的内容，聚焦「坑」和反例）、善用层级结构、迭代与发布。维护方面，强调「坑」的飞轮效应和评估套件的重要性。

💡 主要观点

- 编写 Agent 技能与编写代码遵循截然不同的原则。 Python 之禅中的「简单优于复杂」「显式优于隐式」等在技能创作中是反模式。技能需要复杂性、隐式激活和高度浓缩的上下文。

技能的核心是上下文构建，而非逻辑实现。 技能为模型及其运行环境构建上下文，包含目录结构、格式定义、按需加载和渐进式披露。目标是让模型以最少的 token 获得最大能力。

技能描述是路由触发器，不是功能文档。 描述应以「当……时加载」开头，控制在 50 词以内，描述用户意图而非工作流。糟糕的描述会导致技能在不该加载时被加载，产生副作用。

每项技能都是一笔 token 税，需要精打细算。 技能在每次会话、每个用户中都要消耗 token。索引层每个技能约 100 token，加载层约 5，000 token。冗余内容会拖累其他技能和整体 Agent 能力。

「坑」和反例是技能中价值最高的内容。 通过实际运行积累 Agent 的失败案例，以「坑」的形式记录，信噪比极高。维护阶段以追加「坑」为主，而非修改描述或增加指令。

💬 文章金句

- 写好 Agent 技能与写好代码截然不同——Python 之禅中的箴言在此恰恰是反模式。

• 如果容易解释，模型早就知道了。删掉它。
• 每项技能都是一笔税。
• 如果没有这条指令，Agent 会出错吗？如果这句话不必存在，那它就不能存在。
• 对人类好的文档，对模型而言往往是糟糕的文档。

📊 文章信息

AI 初评：87

来源：前端早读课

作者：前端早读课

分类：人工智能

语言：中文

阅读时间：32 分钟

字数：7821

标签： AI Agent, Agent 技能, 提示工程, AI 工程实践, Perplexity

阅读完整文章