技能

技能是一个可重复的、分步骤的流程，旨在完成特定任务，无需标准的来回交互。

Agent A 在任务与技能描述相匹配时按需读取它，然后遵循其中包含的任何说明。

点击预览查看实际说明、所需的输入内容以及示例输出。

预构建技能（由 Ahrefs 精选）

Agent A 提供不断增长的技能库，由 Ahrefs 团队定期维护和更新。通过这些技能，Agent A 开箱即用，执行效果堪比世界级营销人员。

工作区技能（您的技能）

第二层技能存在于您自己的工作区中，位置为 ~/workspace/skills/<skill-name>/SKILL.md。这些是您团队、产品、声音和工作流程独有的规则。您可以编写、编辑和管理它们。

您也可以在聊天中请求获取完整的技能文件以进行内联编辑。

如何添加新技能

询问的形式：

"创建一个名为 <name> 的技能，用于捕获 <rules>。触发器描述应为 <one-line>。参考示例：<paste or attach>。"

代理 A：

1. 起草 SKILL.md，包含规则，结构化便于检索。
2. 将其放在 ~/workspace/skills/<name>/。
3. 通过提出代表性问题并在执行过程中读取该技能来测试它。

如何更新技能

直接编辑文件，或"更新品牌声音技能：添加规则，我们从不使用破折号。"代理会追加或就地修改。下次聊天会自动应用该更改。

技能的结构方式

~/workspace/skills/<skill-name>/
  SKILL.md            ← required; description in frontmatter, body is the playbook
  reference.md        ← optional supporting docs
  examples/...        ← optional examples
  assets/...          ← optional images, templates, CSS

SKILL.md 前置元数据如下所示：

---
name: ahrefs-brand-voice
description: Voice rules and review checklist for any Ahrefs copy. Load when writing or reviewing copy for landing pages, emails, ads, video scripts, or briefs.
---

description 是代理匹配的内容。如果描述模糊不清，技能就不会在您需要时触发。如果描述精确，它会在相关时准确激活。

当代理使用技能时

在对话开始时，代理会看到可用技能列表（包括预构建和工作区技能）及其描述。当请求匹配时，它会在执行工作前读取正文。

• 编写着陆页 → 读取 ahrefs-brand-voice 和 ahrefs-design-manual。
• 生成 PDF → 读取 PDF（必需；沙箱会阻止多个常见库）。
• 调用第三方 API → 读取 connectors。
• 编写调用 LLM 的 Console 页面 → 读取 llm 和 pydantic。

您也可以强制加载一项技能："在回答前使用品牌声音技能"。

幕后原理。技能并非魔法。它们是代理根据描述匹配决定读取的 markdown。成本是读取；收益是一致性。预构建的技能来自平台的只读存储；工作区技能存在于您的工作区中，您可以不断完善。如果规则只需应用于一次对话，只需在对话中说明即可。如果规则需要应用于今后的每次对话，请将其放在技能或记忆中。