技能共享 — 智能体技能入门

你将学到什么

预计时间：20分钟

通过本课程你将掌握：

通过提交到Git仓库与团队共享技能
通过插件和市场跨项目分发技能
使用企业级管理设置在全组织部署技能
配置自定义子代理使用特定技能

共享技能

(4分钟)

当技能在团队或组织内共享时，其价值会大幅提升。本视频涵盖三种主要分发方式——仓库提交、插件和企业管理设置——并讲解如何配置自定义子代理使用技能。你将了解每种方法适用的场景，以及如何处理一个重要问题：子代理不会自动继承技能。

关键要点

项目技能在. claude/skills中通过Git自动共享——任何克隆仓库的人都会获得它们
插件让你可以通过市场跨仓库分发技能，供更广泛的社区使用
企业级管理设置以最高优先级在全组织部署技能，适合强制性标准和合规要求
子代理不会自动获取你的技能——必须在自定义代理的frontmatter skills字段中明确列出
内置代理(探索者、计划、验证)完全无法使用技能——只有. claude/agents中定义的自定义子代理可以

共享后的技能价值倍增。一个仅供你使用的PR审查技能固然有用，但当这个技能被整个团队共享时，就能标准化代码审查流程，为组织创造一致的体验。让我们看看不同的技能分发方式。

提交技能到仓库

最简单的共享方式是直接将技能提交到仓库。将它们放在. claude/skills目录中，任何克隆该仓库的人都会自动获得这些技能——无需额外安装。

当你推送更新时，所有人都会在下次拉取时获取。这种方式特别适合：

团队编码规范
项目特定工作流
涉及代码库结构的技能

.claude目录包含你的代理、钩子、技能和设置——全部通过常规Git工作流进行版本控制和团队共享。

通过插件分发技能

插件是扩展Claude Code功能的方式，设计用于跨团队和项目共享。在你的插件项目中，创建一个skills目录，其文件结构与. claude目录类似——每个技能都有独立文件夹，内含SKILL. md文件。

将插件发布到市场后，其他用户可以发现并安装到他们的Claude Code中。

当你的技能不局限于特定项目，且对社区其他成员也有用时，这是最佳选择。

通过管理设置进行企业级部署

管理员可以通过管理设置全组织部署技能。企业级技能具有最高优先级——会覆盖同名的人员、项目和插件技能。

管理设置文件支持strictKnownMarketplaces等功能来控制插件安装来源：

"strictKnownMarketplaces": [ { "source": "github", "repo": "acme-corp/approved-plugins" }, { "source": "npm", "package": "@acme-corp/compliance-plugins" } ]

这适用于必须全组织统一的强制性标准、安全要求、合规工作流和编码规范。关键词是"必须"。

技能与子代理

有个常令人惊讶的事实：子代理不会自动继承你的技能。当你委派任务给子代理时，它会从一个全新的上下文开始。

需要理解几个重要区别：

内置代理(如探索者、计划和验证)完全无法使用技能
自定义子代理可以使用技能，但必须明确列出
技能在子代理启动时加载，不像主会话那样按需加载

要创建带技能的自定义子代理，在. claude/agents中添加代理markdown文件。你可以使用Claude Code中的/agents命令交互式创建：

生成的代理文件包含skills字段列出要加载的技能。frontmatter示例如下：

--- name: 前端安全可访问性审查员 description: "当前端代码需要可访问性审查时使用此代理... " tools: Bash, Glob, Grep, Read, WebFetch, WebSearch, Skill... model: sonnet color: blue skills: accessibility-audit, performance-check ---

当你委派给这个子代理时，它会加载这两个技能并应用于每次审查。首先确保技能存在于. claude/skills目录中，然后要么创建新子代理，要么在现有代理的markdown文件中添加skills字段。

这种模式在以下场景特别有效：

需要具有特定专业知识的独立任务委派
不同子代理需要不同技能(前端审查员vs后端审查员)
希望在委派工作中强制执行标准而不依赖提示词

课程反思

对你正在考虑构建的技能而言，哪种共享方式(仓库/插件/企业)最合适？
在哪些工作流中，使用带特定技能的自定义子代理可以提升委派工作的一致性？

下一步

在最终课程中，你将学习如何排查常见技能问题——从未触发的技能、优先级冲突到运行时错误——并获取一份实用检查清单。

反馈

在学习过程中，我们很想知道你如何应用技能，以及任何反馈建议。请在此分享你的反馈。