Agent-Skills 仓库

这是一个集中管理和共享 Claude Code Skills 的部门级仓库，支持多团队协作。

📁 仓库结构

Agent-Skills/
├── skills/
│   ├── infrastructure/  # Infrastructure 团队（技术设施建设）专属skills
│   ├── upstream/        # Upstream 团队（上游开发贡献）专属skills
│   ├── operation/       # Operation 团队（社区运营）专属skills
│   └── shared/          # 跨团队共享的skills
├── templates/           # Skill模板
└── docs/               # 文档和使用指南

🚀 快速开始

1. 上传 Skills

方式一：直接上传到对应团队目录

# 克隆仓库
git clone <repository-url>
cd Agent-Skills

# 将你的skill文件放入对应的团队目录
# 例如：将 my-skill.md 放入 team-a 目录
cp /path/to/your/skill.md skills/infrastructure/

# 提交更改
git add skills/infrastructure/my-skill.md
git commit -m "Add my-skill for team-a"
git push origin main

方式二：使用 PR 流程（推荐）

# 创建新分支
git checkout -b feature/add-new-skill

# 添加skill文件到对应目录
cp /path/to/your/skill.md skills/infrastructure/

# 提交并推送
git add skills/infrastructure/
git commit -m "Add new skill: skill-name"
git push origin feature/add-new-skill

# 在 GitHub 上创建 Pull Request

2. 使用 Skills

在 Claude Code 中配置

有两种方式使用仓库中的 skills：

方式一：本地克隆使用

# 1. 克隆仓库到本地
git clone <repository-url> ~/agent-skills

# 2. 在 Claude Code 配置文件中添加技能目录
# 编辑 ~/.claude/config.json 或在项目的 .claude/config.json 中添加：
{
  "skills": {
    "directories": [
      "~/agent-skills/skills/team-a",
      "~/agent-skills/skills/shared"
    ]
  }
}

# 3. 重启 Claude Code 或重新加载配置

方式二：直接引用 GitHub 上的 Skills

# 在 Claude Code 配置中使用 Git URL
# 编辑 ~/.claude/config.json：
{
  "skills": {
    "repositories": [
      {
        "url": "https://github.com/<org>/Agent-Skills.git",
        "path": "skills/team-a"
      },
      {
        "url": "https://github.com/<org>/Agent-Skills.git",
        "path": "skills/shared"
      }
    ]
  }
}

验证 Skills 已加载

在 Claude Code 中运行：

/help

你应该能看到仓库中的 skills 列在可用技能列表中。

3. 更新 Skills

# 如果使用本地克隆方式
cd ~/agent-skills
git pull origin main

# Claude Code 会自动检测到更新，或手动重新加载

📝 Skill 开发规范

Skill 文件命名规范

• 使用小写字母和连字符：my-skill-name.md
• 名称要描述性强，简洁明了
• 避免使用空格或特殊字符

Skill 文件结构

每个 skill 应该包含以下部分：

# Skill Name

## 描述
简要描述这个 skill 的功能和用途

## 使用场景
说明何时使用这个 skill

## 参数（如果有）
列出所有可用参数及其说明

## 示例
提供使用示例

## 作者
@your-github-username

## 更新日期
YYYY-MM-DD

目录选择指南

• infrastructure/: Infrastructure 团队（技术设施建设）的专属 skills
• upstream/: Upstream 团队（上游开发贡献）的专属 skills
• operation/: Operation 团队（社区运营）的专属 skills
• shared/: 放置所有团队都可能用到的通用 skills

🔍 Skills 分类建议

为了更好地组织，建议在各团队目录下按功能分类：

Infrastructure 团队示例：

skills/infrastructure/
├── devops/            # DevOps 相关
├── monitoring/        # 监控和告警
├── deployment/        # 部署相关
└── automation/        # 自动化工具

Upstream 团队示例：

skills/upstream/
├── contribution/      # 贡献相关
├── code-review/       # 代码审查相关
├── testing/          # 测试相关
└── documentation/    # 文档相关

Operation 团队示例：

skills/operation/
├── content/           # 内容创作相关
├── events/            # 活动策划相关
├── analytics/         # 数据分析相关
└── automation/        # 运营自动化工具

🤝 贡献指南

1. 创建 Skill 前：检查是否已有类似功能的 skill
2. 编写文档：确保你的 skill 有清晰的使用说明
3. 测试：在提交前测试你的 skill
4. 代码审查：通过 PR 方式提交，至少需要一位团队成员审查
5. 版本控制：重大更新时在 skill 文件中注明版本号

📋 常见问题

Q: 如何共享一个 skill 给其他团队？

A: 将 skill 从团队目录移动到 skills/shared/ 目录。

Q: 多个团队需要同一个 skill 的不同版本怎么办？

A: 在各自团队目录下维护各自的版本，文件名可以加上版本后缀，如 deploy-v1.md, deploy-v2.md。

Q: 如何废弃一个 skill？

A: 不要直接删除，而是在文件开头添加 [DEPRECATED] 标记，并说明替代方案，保留至少一个版本周期。

Q: 配置文件在哪里？

A: Claude Code 的配置文件通常在：

• 全局配置：~/.claude/config.json
• 项目配置：<project-root>/.claude/config.json

📞 联系方式

如有问题或建议，请：

• 提交 Issue
• 在团队频道讨论
• 联系仓库维护者

📜 许可证

[根据你的组织政策添加许可证信息]

---

维护者: [添加维护者信息] 最后更新: 2026-02-03