如何为开发团队配置共享 Agent Skills

团队里 5 个人用 Claude Code，5 种写法。一个人的"重构一下"和另一个人的"重构一下"出来的东西完全不一样。这篇文章教你三种方法，让全团队共享同一套 Agent Skill，从第一天起就统一标准。

前提条件

已安装 Claude Code v2.1+
团队 Git 仓库
了解 Agent Skill 基础概念

为什么团队需要共享 Skill

一致性

每个人用同一份代码审查 Skill，审查标准就不再是"看审查者心情"。Skill 文件就是唯一标准。

# .claude/commands/code-review.md
# 团队每个人跑的审查清单完全一样
# 再也不会出现"忘了检查 SQL 注入"的情况

新人上手

新人 clone 仓库，Skill 就在 .claude/commands/ 里。不需要口口相传的"部落知识"。

git clone git@github.com:your-org/your-app.git
cd your-app
# Skill 已经在 .claude/commands/ 里了
claude

代码审查标准化

当 Skill 定义了"好代码"长什么样，PR Review 就变成了客观检查，不再是主观意见。

如果你还不了解 Skill 是什么，先看如何创建你的第一个 Agent Skill。想了解 Skill 和 MCP 的区别，看三者完整对比。

方法一：Git 仓库直接提交

最简单的做法——把 Skill 文件直接提交到项目仓库。

目录结构

your-project/
├── .claude/
│   └── commands/
│       ├── code-review.md
│       ├── pr-description.md
│       ├── debug-production.md
│       ├── deploy-checklist.md
│       └── write-tests.md
├── src/
└── package.json

工作原理

Claude Code 自动发现 .claude/commands/ 目录下的所有 .md 文件。团队成员 clone 仓库时，Skill 跟着一起过来。

# 创建 Skill 目录
mkdir -p .claude/commands

# 创建团队代码审查 Skill
cat > .claude/commands/code-review.md << 'EOF'
---
name: 团队代码审查
description: 按团队标准审查代码
---

按以下标准审查暂存区的代码改动：

1. **安全**: 无硬编码密钥、无 SQL 注入、无 XSS
2. **性能**: 无 N+1 查询、无不必要的重渲染、无无限循环
3. **测试**: 每个新函数至少有一个测试
4. **命名**: 遵守团队规范（JS 用 camelCase，Python 用 snake_case）
5. **文档**: 公开 API 有 JSDoc/docstring

输出 Markdown 检查清单，每项标注通过/不通过。
EOF

版本控制的好处

# Skill 变更走正常 Git 流程
git add .claude/commands/code-review.md
git commit -m "feat: 新增团队代码审查 Skill"

# 在 PR 里审查 Skill 变更
git diff main -- .claude/commands/

优点： 零配置，版本可控，离线可用，Skill 变更在 PR 里审查。

缺点： 按项目隔离。如果团队有 20 个仓库，需要手动同步。

💡

方法二：TokRepo 集合

TokRepo 可以创建 Skill 集合，团队成员一条命令全部安装。适合多仓库的组织。

第一步：筛选团队需要的 Skill

去 TokRepo Skill 库挑选合适的 Skill，也可以自建 Skill 发布上去。

第二步：创建安装脚本

#!/bin/bash
# team-skills-install.sh
# 在任何项目里运行，一键配置团队 Skill

echo "正在安装团队 Skill..."

# 项目管理
tokrepo install e108cf5c-c34e-4d27-a694-66a693301e87  # GSD

# 调试
tokrepo install 78ed006e-b022-4e92-bf65-df8b53afd2f4  # Systematic Debugging

# SEO（前端项目用）
tokrepo install cb068086-1c7d-408e-90a1-c39cfc6ffe87  # Claude SEO

# Skill 创建（高级开发者用）
tokrepo install 0b7c0a41-97e1-4187-9cc5-4dc32d91a9cd  # Skill Creator

# 规划
tokrepo install 034be597-c361-45a2-b143-41cce0ec8ad8  # Planning

echo "安装完成。运行 'claude' 开始使用。"

第三步：分享给团队

# 把安装脚本放到组织公共仓库
chmod +x team-skills-install.sh

# 新成员一条命令搞定
./team-skills-install.sh

优点： 集中管理，一键安装，支持自动更新，跨仓库生效。

缺点： 首次安装需要网络，需要 TokRepo CLI。

方法三：自建 Skill 注册中心

大团队需要完全控制时，在内部基础设施上自建注册中心。

架构

┌─────────────────┐     ┌──────────────────┐     ┌─────────────┐
│  Skill 作者      │────▶│  内部 Git 注册中心 │────▶│  开发者机器   │
│  （资深开发者）    │     │                  │     │             │
└─────────────────┘     └──────────────────┘     └─────────────┘
                              │
                              ▼
                        ┌──────────────────┐
                        │  CI/CD 流水线     │
                        │  （验证 & 分发）   │
                        └──────────────────┘

实现方式

# internal-skill-registry/
# ├── skills/
# │   ├── code-review.md
# │   ├── deploy-checklist.md
# │   └── incident-response.md
# ├── validate.sh          # 校验 Skill frontmatter
# ├── distribute.sh        # 推送到所有项目仓库
# └── README.md

# validate.sh — 确保每个 Skill 有必填字段
#!/bin/bash
for skill in skills/*.md; do
  if ! grep -q "^name:" "$skill"; then
    echo "错误: $skill 缺少 'name' 字段"
    exit 1
  fi
done
echo "所有 Skill 校验通过。"

# distribute.sh — 同步 Skill 到所有团队仓库
#!/bin/bash
REPOS=("app-frontend" "app-backend" "app-mobile" "shared-lib")

for repo in "${REPOS[@]}"; do
  echo "同步 Skill 到 $repo..."
  cp -r skills/ "../$repo/.claude/commands/"
done

优点： 完全可控，防火墙内可用，可自定义校验，有审计追踪。

缺点： 维护成本高，需要自建工具，无法使用社区 Skill。

实战案例：5 人团队配置全过程

以下是一个真实 5 人创业团队在一个下午完成 Claude Code 标准化的全过程。

团队构成

角色	名字	负责方向
技术负责人	Sarah	架构、代码审查
前端	Jake	React, Next.js
后端	Mira	Go, PostgreSQL
全栈	Alex	功能开发、集成
初级开发	Tom	Bug 修复、测试

第一步：技术负责人创建 Skill 集（30 分钟）

Sarah 梳理了团队最头疼的 5 个问题，每个对应一个 Skill：

# Sarah 的电脑
mkdir -p .claude/commands

# 1. 安装社区 Skill
tokrepo install e108cf5c-c34e-4d27-a694-66a693301e87  # GSD
tokrepo install 78ed006e-b022-4e92-bf65-df8b53afd2f4  # Systematic Debugging
tokrepo install 034be597-c361-45a2-b143-41cce0ec8ad8  # Planning

# 2. 创建团队专属 Skill
cat > .claude/commands/our-pr-review.md << 'EOF'
---
name: PR Review（团队标准）
description: 按团队12项标准审查代码
---
审查当前 diff，检查：
1. 生产代码中无 console.log
2. 所有 API 端点有限流
3. 数据库查询使用参数化语句
4. React 组件有错误边界
5. Go 函数返回 error（不用 panic）
...
EOF

第二步：团队安装 Skill（每人 5 分钟）

# 每个成员只需：
git pull origin main
# Skill 已经在 .claude/commands/ 里了

第三步：效果衡量（两周后）

指标	Skill 前	Skill 后	变化
PR 审查时间	45 分钟	15 分钟	-67%
线上逃逸 Bug 数	3 个/周	1 个/周	-67%
新人上手时间	2 周	3 天	-79%
代码风格违规	12 处/PR	2 处/PR	-83%

收益最大的是初级开发 Tom——调试 Skill 教会了他系统化调试方法，代码审查 Skill 在资深开发者审查前就拦住了大部分问题。

常见问题

团队成员的 Skill 冲突了怎么办？

走正常 Git merge 流程。两个人改了同一个 Skill，在 PR 里解决冲突。通过 TokRepo 安装的社区 Skill，可以在 .claude/commands/ 里保留一份本地副本，锁定版本不自动更新。

能限制成员安装哪些 Skill 吗？

原生不支持。但方法三（自建注册中心）可以实现白名单。方法一（Git 仓库）可以用 pre-commit hook 拒绝未授权的 Skill：

# .husky/pre-commit
ALLOWED_SKILLS="code-review.md pr-description.md debug-production.md"
for file in $(git diff --cached --name-only -- .claude/commands/); do
  basename=$(basename "$file")
  if ! echo "$ALLOWED_SKILLS" | grep -q "$basename"; then
    echo "错误: 未授权的 Skill: $basename"
    exit 1
  fi
done

每个人用 Skill 的效果一样吗？

相同的 Skill 文件加相同的 Claude Code 版本，输出基本一致。模型版本不同可能有细微差异，但结构和检查项保持不变。

下一步

创建你的第一个 Agent Skill — 为团队定制专属 Skill
15 个最佳 Claude Code Skill — 浏览精选推荐
Skills vs MCP vs Rules 对比 — 理解哪种扩展方式适合团队
浏览 TokRepo Skill 集合 — 发现 500+ 开箱即用的 Skill