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

一句话：团队共享 Skill 有三种方法——把 Skill 提交到 Git 仓库的 .claude/commands/（最简单，10 分钟搞定）、在 TokRepo 建团队集合并用 tokrepo install 同步、或自建 Skill 注册中心（大团队才需要）。

为什么团队需要共享 Skill

一致性：所有人用同一份代码审查 Skill，审查标准就不再「看审查者心情」，Skill 文件就是唯一标准
新人上手：clone 仓库后 Skill 已经在 .claude/commands/ 里，不用口口相传
代码审查标准化：Skill 定义了「好代码」长什么样，PR Review 从主观意见变成客观检查

方法一：Git 仓库直接提交（推荐起步）

把 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 流程，在 PR 里审查：

git add .claude/commands/code-review.md
git commit -m "feat: 新增团队代码审查 Skill"
git diff main -- .claude/commands/

✅ 零配置、版本可控、离线可用、变更在 PR 里审查
❌ 按项目隔离，20 个仓库要手动同步

方法二：TokRepo 集合（跨项目）

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

#!/bin/bash
# team-skills-install.sh — 在任何项目里运行，一键配置团队 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

把脚本放进组织公共仓库，新成员 ./team-skills-install.sh 一条命令搞定。

✅ 集中管理、一键安装、跨仓库生效
❌ 首次安装需要网络

方法三：自建注册中心（50+ 人大团队）

需要完全控制时在内部基础设施自建，包含 skills/ 目录 + 校验脚本 + 分发脚本：

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

# distribute.sh — 同步到所有团队仓库
REPOS=("app-frontend" "app-backend" "app-mobile")
for repo in "${REPOS[@]}"; do
  cp -r skills/ "../$repo/.claude/commands/"
done

✅ 完全可控、防火墙内可用、可白名单、有审计
❌ 维护成本高，中小团队不值得造轮子

Skill	用途	安装
Get Shit Done (GSD)	项目管理骨架，里程碑+进度追踪	`tokrepo install e108cf5c-c34e-4d27-a694-66a693301e87`
Systematic Debugging	四阶段调试：复现→隔离→诊断→修复	`tokrepo install 78ed006e-b022-4e92-bf65-df8b53afd2f4`
Claude SEO	全面 SEO 审计	`tokrepo install cb068086-1c7d-408e-90a1-c39cfc6ffe87`
Skill Creator	把团队「暗知识」打包成 Skill	`tokrepo install 0b7c0a41-97e1-4187-9cc5-4dc32d91a9cd`
Planning with Files	跨会话持久化规划	`tokrepo install 034be597-c361-45a2-b143-41cce0ec8ad8`

实战案例：5 人团队的效果

一个真实 5 人团队的做法：技术负责人花 30 分钟装 3 个社区 Skill + 写 1 个团队专属 PR 审查 Skill，其他成员 git pull 即得。两周后的效果：

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

常见问题

成员的 Skill 冲突了怎么办？
走正常 Git merge 流程，在 PR 里解决。TokRepo 安装的社区 Skill 可以在本地保留副本锁定版本。

能限制成员装哪些 Skill 吗？
原生不支持。Git 方案可用 pre-commit hook 白名单；自建注册中心可完整实现白名单。

每个人用 Skill 的效果一样吗？
相同 Skill 文件 + 相同 Claude Code 版本，输出基本一致；模型版本不同可能有细微差异，但结构和检查项不变。

防止共享 Skill 被改坏？
把 .claude/commands/ 纳入 CODEOWNERS 保护，修改必须走 PR Review——Skill 定义了「好代码」的标准，和生产代码一样重要。