Skill 的两种构建路径

路径 A:翻译已有知识(领域专家路线)

适合领域专家 —— 那些已经把机构知识写在某处的人(合规手册、HR 入职指南等):

---
name: cafe-preparation
description: |
  Calculates daily ingredient needs and generates prep sheets for cafe operations.
  Use when the user asks to estimate daily quantities, convert drinks to ingredients, 
  or generate shopping lists.
  Do NOT use for employee shift scheduling or financial accounting.
---

命名规范: - 目录名:snake_case(如 bigquery_ingestion) - Skill 名:kebab-case(如 pdf-processing) - 优先使用动名词形式(如 managing-databases) - 避免通用名(utilstools)和内部术语

description 字段是最重要的路由算法 —— 模型靠它决定是否加载 Skill: - 前置触发关键词 - 明确说明何时使用、何时不使用 - 如果模型触发不足,可以更 “激进” 地描述

路径 B:固化 Agent 的成功执行(开发者路线)

当 Agent 成功完成一个非平凡、可重复的任务时,将其转化为 Skill:

Agent 完成成功 → 观察到工作流可复用 → 将执行轨迹转化为 Skill → 人工审查 → 入库

相关工具: - Anthropic’s skill-creator - Nous Research’s Hermes Agent - self-improving-agent-skills 模式

⚠️ 重要: Agent 生成的草稿 Skill 必须经过人工审查。未经审查的 Skill 往往比没有 Skill 更糟糕。