阅读要点Agent负责理解、规划和执行。Skill把领域方法封装成可复用说明书。MCP提供访问外部系统与数据的能力。Hook在固定生命周期节点自动触发动作。一、Agent 与 Skill 的基本认识Agent 是执行者Skill 是专业说明书。Agent 本身具备理解意图、拆解任务、选择工具和完成操作的能力Skill 则把某个领域的知识、步骤、脚本和素材整理成标准化工作包让 Agent 面对同类任务时更稳定。这和新同事入职很像。能力强的人能处理陌生问题但如果同时拿到审核标准、操作 SOP、检查清单和现成脚本结果会更快、更一致也更容易复盘。Skill 的价值就是把“高手经验”变成“任何合适的 Agent 都能调用的工作方法”。1.1 一个 Skill 通常包含什么常见 Skill 以SKILL.md为入口再按需携带脚本、参考资料和素材。不同宿主可能对文件名或目录约定略有差异应以对应平台的安装说明为准。my-skill/├── SKILL.md # 必需名称、触发场景、工作流与边界├── scripts/ # 可重复执行的 Python、Bash 等脚本├── references/ # 详细规范、接口说明、检查清单└── assets/ # 模板、图片和交付素材SKILL.md回答“这是什么、什么时候用、怎么做、什么时候停止”。scripts承接自由度低、容易出错或需要反复执行的步骤例如格式校验、批量转换和结果检查。references保存不必每次全部加载的细节例如标签规范、接口参数和长检查清单。assets保存交付时直接复用的模板、示例图片或品牌素材。不是每个 Skill 都必须有四类目录。最小可用形态只有一个写清楚的SKILL.md当任务变复杂再把确定性步骤下沉为脚本把大段细节移到参考资料中。1.2 Skill 如何工作Skill 的核心机制是渐进式披露progressive disclosure先暴露少量元数据只有在任务匹配后才加载完整说明执行中再按需读取更细的资料。Agent 启动时扫描已安装 Skill 的名称与描述知道自己“会什么”。用户提出需求后Agent 将意图与 Skill 描述进行匹配。匹配成功后Agent 读取对应的SKILL.md理解 SOP、输入输出和限制。任务需要复杂细节时再读取references或执行scripts。全部步骤结束后Agent 校验并整合结果再返回给用户。这套机制避免了两个极端一是把全部知识长期塞进上下文导致信息冗余二是只给 Agent 一个工具却不给它判断何时使用、如何使用以及如何验收的方法。二、Skill、MCP 与 Hook三者解决的是不同层级的问题Skill 管方法MCP 管能力Hook 管自动触发时机。概念主要作用典型内容触发方式Skill告诉 Agent 怎样完成专业任务指令、知识、脚本、模板、检查项根据用户意图按需加载MCP让 Agent 访问外部系统和数据工具名称、参数定义、返回结构Agent 根据任务主动调用Hook在固定节点自动执行动作命令、脚本、检查、通知或回调命中生命周期事件后自动运行以内容审核为例Skill 规定标签标准、审核步骤和边界案例的处理方法MCP 读取待审数据集并提交审核结果Hook 在提交前检查敏感字段在任务结束后记录审计日志。三者组合后Agent 才同时拥有方法、工具和自动防线。MCP 不是必选项。若任务只需要调用一个简单命令可以直接在 Skill 中写清参数和验收方式。只有当外部系统接入复杂、接口需要复用或权限与返回结构需要统一管理时才值得单独建设 MCP。三、Skill 的安装与卸载Skill 通常不会自动跨平台同步。即使目录格式兼容同一份 Skill 也需要分别安装到 Aime、豆包、Trae 或自建 Agent 的对应宿主中。3.1 从技能市场安装最省事的方式是进入技能市场搜索目标能力选择安装到对应 Agent。安装页通常会给出支持的平台、版本、权限和具体命令。The Agent Skills Directory3.2 通过安装命令添加有些技能市场会提供终端命令。命令通常会检测本机已安装的 Agent并询问目标宿主或安装路径。也可以把完整命令发给支持执行安装的 Agent。示例npx -y --registry https://bnpm.byted.org byted/taelatest \ skills add skill_namenpm_config_registryhttps://bnpm.byted.org \ npx agentbuddylatest skill add \ skills.byted.org/test_infra/bits_ut \ --skill bits-unit-test-gen命令执行成功只代表下载或安装步骤完成。最终还要检查目标 Agent 是否识别到 Skill、描述能否被正确匹配以及一次真实任务能否跑通。也可以直接选择要安装的agent就行安装界面有的话3.3 在豆包中安装豆包办公的本地工作区通常会区分系统预置目录与用户技能目录workspace/.skills/系统预置 Skill。workspace/.user_skills/用户自己安装的 Skill。手动放入用户目录可以作为调试方式但更推荐直接把安装包、技能名、仓库地址或安装命令交给 Agent由它完成安装并验证识别结果。3.4 在 Aime 中安装Aime 常见的输入方式包括 ZIP 压缩包、Skill 名称、安装命令、Git 仓库和从零创建。只提供 Skill 名称时可先搜索当前空间和技能市场再从候选中确认目标提供仓库时还要明确版本和仓库内路径。支持安装方式需要提供处理方式ZIP 压缩包完整 Skill 压缩包将skill.zip上传给aime,aime会自动解压安装到技能空间Skill 名称名称或希望实现的能力aime会调用skill查找的skill先查当前空间再搜索技能市场内部skills.byted.org外部skills.sh生成候选并让用户确认候选安装命令完整命令及必要参数在skill广场获取目标skill的下载安装命令将命令发送给agent即可示例cli: npx skills add https://github.com/firebase/agent-skills --skill firebase-security-rules-auditorprompt:Run npx skills use https://github.com/firebase/agent-skills --skill firebase-security-rules-auditor and follow the generated skill instructions now. Read its complete output, redirecting it to a temporary file first if necessary. Resolve relative paths from the supporting-files directory it provides.ps:自己在终端执行下载后需要继续上传命令成功不一定代表空间安装成功Git 仓库仓库、版本、仓库内 Skill 路径字节仓库可绑定同步其他仓库通常先下载再上传从零创建目标能力、触发场景、输出和边界创建、验证后上传到空间在 Aime 中安装完成的判断不是“某条下载命令返回成功”而是目标 Skill 已上传到当前技能空间并可被识别。这个区别能避免“终端里装过了但 Agent 仍然不会用”的假成功。3.5 卸载与更新卸载优先使用宿主的技能管理页或让 Agent 执行卸载流程本地调试环境才直接删除用户 Skill 目录。删除属于破坏性操作应先确认目标名称与安装位置必要时备份自定义脚本和素材。更新后也要重新检查描述匹配、依赖版本和关键用例。四、在自建平台中接入 Skill自建平台不只是“扫描一个文件夹”。要让 Skill 稳定工作至少需要五个环节发现扫描 Skill 的名称、描述和版本等元数据。路由根据用户意图匹配合适的 Skill并处理多个候选的优先级。加载先读入口说明再按需加载参考资料和脚本。执行为脚本、网络访问和文件操作设置权限边界与超时。验收记录调用过程、检查输出并提供版本更新和回滚能力。如果平台缺少权限隔离和可观测性Skill 越多排查成本反而越高。先把安装、路由、日志和失败处理做扎实再扩充技能数量。五、怎样写好一个 Skill一个可用的SKILL.md至少要回答三个问题它是谁、什么时候触发、触发后怎么完成任务。--- name: my-skill description: 说明这个 Skill 能做什么、何时触发以及关键关键词。 --- # Skill 标题 ## 适用场景 ## 输入与输出 ## 工作流 ## 注意事项与边界name是 Skill 的唯一标识通常与文件夹名一致description是路由入口决定 Agent 能否在正确时机找到它正文则负责把操作步骤、工具选择、校验标准和停止条件讲清楚。5.1 Description 决定“能不能被找到”“这是一个很有用的 Skill”几乎没有路由价值。好的描述要写出能力、触发场景和用户常用表达。例如name: content-risk-boundary-review description: 为内容风控、模型评测和标注质检生成最小边界对照样本当用户提到误杀、漏放、边界 case、规则冲突或回归样本时使用。这段描述同时告诉 Agent要做什么、服务于哪个领域、哪些关键词应触发。描述越具体误触发和漏触发越少。5.2 工作流要写到可执行、可验收“分析数据并给出建议”不是 SOP。可执行的写法会明确输入检查、处理顺序、异常分支和验收条件。例如边界样本 Skill 可以规定先确认原标签与规则再一次只改变一个变量随后输出成对样本、风险翻转假设、预期标签和复核重点。可重复且确定的步骤适合放进脚本大段规范适合放进参考资料模板和示例图片放进素材目录。入口文件只保留路由信息和任务主干避免越写越长。5.3 明确边界比堆功能更重要写清不适用场景避免 Skill 抢到不属于自己的任务。涉及删除、发布、发消息等外部写操作时规定确认机制。涉及业务规则时注明版本、来源和待确认项不让 Agent 自行补全。定义成功标准例如文件生成、平台识别、用例通过或结果回填。 Agent Skill 学习手册：从概念安装到使用指南
阅读要点Agent负责理解、规划和执行。Skill把领域方法封装成可复用说明书。MCP提供访问外部系统与数据的能力。Hook在固定生命周期节点自动触发动作。一、Agent 与 Skill 的基本认识Agent 是执行者Skill 是专业说明书。Agent 本身具备理解意图、拆解任务、选择工具和完成操作的能力Skill 则把某个领域的知识、步骤、脚本和素材整理成标准化工作包让 Agent 面对同类任务时更稳定。这和新同事入职很像。能力强的人能处理陌生问题但如果同时拿到审核标准、操作 SOP、检查清单和现成脚本结果会更快、更一致也更容易复盘。Skill 的价值就是把“高手经验”变成“任何合适的 Agent 都能调用的工作方法”。1.1 一个 Skill 通常包含什么常见 Skill 以SKILL.md为入口再按需携带脚本、参考资料和素材。不同宿主可能对文件名或目录约定略有差异应以对应平台的安装说明为准。my-skill/├── SKILL.md # 必需名称、触发场景、工作流与边界├── scripts/ # 可重复执行的 Python、Bash 等脚本├── references/ # 详细规范、接口说明、检查清单└── assets/ # 模板、图片和交付素材SKILL.md回答“这是什么、什么时候用、怎么做、什么时候停止”。scripts承接自由度低、容易出错或需要反复执行的步骤例如格式校验、批量转换和结果检查。references保存不必每次全部加载的细节例如标签规范、接口参数和长检查清单。assets保存交付时直接复用的模板、示例图片或品牌素材。不是每个 Skill 都必须有四类目录。最小可用形态只有一个写清楚的SKILL.md当任务变复杂再把确定性步骤下沉为脚本把大段细节移到参考资料中。1.2 Skill 如何工作Skill 的核心机制是渐进式披露progressive disclosure先暴露少量元数据只有在任务匹配后才加载完整说明执行中再按需读取更细的资料。Agent 启动时扫描已安装 Skill 的名称与描述知道自己“会什么”。用户提出需求后Agent 将意图与 Skill 描述进行匹配。匹配成功后Agent 读取对应的SKILL.md理解 SOP、输入输出和限制。任务需要复杂细节时再读取references或执行scripts。全部步骤结束后Agent 校验并整合结果再返回给用户。这套机制避免了两个极端一是把全部知识长期塞进上下文导致信息冗余二是只给 Agent 一个工具却不给它判断何时使用、如何使用以及如何验收的方法。二、Skill、MCP 与 Hook三者解决的是不同层级的问题Skill 管方法MCP 管能力Hook 管自动触发时机。概念主要作用典型内容触发方式Skill告诉 Agent 怎样完成专业任务指令、知识、脚本、模板、检查项根据用户意图按需加载MCP让 Agent 访问外部系统和数据工具名称、参数定义、返回结构Agent 根据任务主动调用Hook在固定节点自动执行动作命令、脚本、检查、通知或回调命中生命周期事件后自动运行以内容审核为例Skill 规定标签标准、审核步骤和边界案例的处理方法MCP 读取待审数据集并提交审核结果Hook 在提交前检查敏感字段在任务结束后记录审计日志。三者组合后Agent 才同时拥有方法、工具和自动防线。MCP 不是必选项。若任务只需要调用一个简单命令可以直接在 Skill 中写清参数和验收方式。只有当外部系统接入复杂、接口需要复用或权限与返回结构需要统一管理时才值得单独建设 MCP。三、Skill 的安装与卸载Skill 通常不会自动跨平台同步。即使目录格式兼容同一份 Skill 也需要分别安装到 Aime、豆包、Trae 或自建 Agent 的对应宿主中。3.1 从技能市场安装最省事的方式是进入技能市场搜索目标能力选择安装到对应 Agent。安装页通常会给出支持的平台、版本、权限和具体命令。The Agent Skills Directory3.2 通过安装命令添加有些技能市场会提供终端命令。命令通常会检测本机已安装的 Agent并询问目标宿主或安装路径。也可以把完整命令发给支持执行安装的 Agent。示例npx -y --registry https://bnpm.byted.org byted/taelatest \ skills add skill_namenpm_config_registryhttps://bnpm.byted.org \ npx agentbuddylatest skill add \ skills.byted.org/test_infra/bits_ut \ --skill bits-unit-test-gen命令执行成功只代表下载或安装步骤完成。最终还要检查目标 Agent 是否识别到 Skill、描述能否被正确匹配以及一次真实任务能否跑通。也可以直接选择要安装的agent就行安装界面有的话3.3 在豆包中安装豆包办公的本地工作区通常会区分系统预置目录与用户技能目录workspace/.skills/系统预置 Skill。workspace/.user_skills/用户自己安装的 Skill。手动放入用户目录可以作为调试方式但更推荐直接把安装包、技能名、仓库地址或安装命令交给 Agent由它完成安装并验证识别结果。3.4 在 Aime 中安装Aime 常见的输入方式包括 ZIP 压缩包、Skill 名称、安装命令、Git 仓库和从零创建。只提供 Skill 名称时可先搜索当前空间和技能市场再从候选中确认目标提供仓库时还要明确版本和仓库内路径。支持安装方式需要提供处理方式ZIP 压缩包完整 Skill 压缩包将skill.zip上传给aime,aime会自动解压安装到技能空间Skill 名称名称或希望实现的能力aime会调用skill查找的skill先查当前空间再搜索技能市场内部skills.byted.org外部skills.sh生成候选并让用户确认候选安装命令完整命令及必要参数在skill广场获取目标skill的下载安装命令将命令发送给agent即可示例cli: npx skills add https://github.com/firebase/agent-skills --skill firebase-security-rules-auditorprompt:Run npx skills use https://github.com/firebase/agent-skills --skill firebase-security-rules-auditor and follow the generated skill instructions now. Read its complete output, redirecting it to a temporary file first if necessary. Resolve relative paths from the supporting-files directory it provides.ps:自己在终端执行下载后需要继续上传命令成功不一定代表空间安装成功Git 仓库仓库、版本、仓库内 Skill 路径字节仓库可绑定同步其他仓库通常先下载再上传从零创建目标能力、触发场景、输出和边界创建、验证后上传到空间在 Aime 中安装完成的判断不是“某条下载命令返回成功”而是目标 Skill 已上传到当前技能空间并可被识别。这个区别能避免“终端里装过了但 Agent 仍然不会用”的假成功。3.5 卸载与更新卸载优先使用宿主的技能管理页或让 Agent 执行卸载流程本地调试环境才直接删除用户 Skill 目录。删除属于破坏性操作应先确认目标名称与安装位置必要时备份自定义脚本和素材。更新后也要重新检查描述匹配、依赖版本和关键用例。四、在自建平台中接入 Skill自建平台不只是“扫描一个文件夹”。要让 Skill 稳定工作至少需要五个环节发现扫描 Skill 的名称、描述和版本等元数据。路由根据用户意图匹配合适的 Skill并处理多个候选的优先级。加载先读入口说明再按需加载参考资料和脚本。执行为脚本、网络访问和文件操作设置权限边界与超时。验收记录调用过程、检查输出并提供版本更新和回滚能力。如果平台缺少权限隔离和可观测性Skill 越多排查成本反而越高。先把安装、路由、日志和失败处理做扎实再扩充技能数量。五、怎样写好一个 Skill一个可用的SKILL.md至少要回答三个问题它是谁、什么时候触发、触发后怎么完成任务。--- name: my-skill description: 说明这个 Skill 能做什么、何时触发以及关键关键词。 --- # Skill 标题 ## 适用场景 ## 输入与输出 ## 工作流 ## 注意事项与边界name是 Skill 的唯一标识通常与文件夹名一致description是路由入口决定 Agent 能否在正确时机找到它正文则负责把操作步骤、工具选择、校验标准和停止条件讲清楚。5.1 Description 决定“能不能被找到”“这是一个很有用的 Skill”几乎没有路由价值。好的描述要写出能力、触发场景和用户常用表达。例如name: content-risk-boundary-review description: 为内容风控、模型评测和标注质检生成最小边界对照样本当用户提到误杀、漏放、边界 case、规则冲突或回归样本时使用。这段描述同时告诉 Agent要做什么、服务于哪个领域、哪些关键词应触发。描述越具体误触发和漏触发越少。5.2 工作流要写到可执行、可验收“分析数据并给出建议”不是 SOP。可执行的写法会明确输入检查、处理顺序、异常分支和验收条件。例如边界样本 Skill 可以规定先确认原标签与规则再一次只改变一个变量随后输出成对样本、风险翻转假设、预期标签和复核重点。可重复且确定的步骤适合放进脚本大段规范适合放进参考资料模板和示例图片放进素材目录。入口文件只保留路由信息和任务主干避免越写越长。5.3 明确边界比堆功能更重要写清不适用场景避免 Skill 抢到不属于自己的任务。涉及删除、发布、发消息等外部写操作时规定确认机制。涉及业务规则时注明版本、来源和待确认项不让 Agent 自行补全。定义成功标准例如文件生成、平台识别、用例通过或结果回填。