用 Makefile 管 Claude Skills 是什么体验?团队协作必备的自动化流水线

每次给团队新增一个 Claude Skill,都要手动复制粘贴、反复测试、上传 API——繁琐不说,还容易出错。

如果你也在被这个问题折磨,今天聊一个把整个流程自动化了的工具库:craig-ai-tooling/claude-skills。

它解决什么问题

这个仓库本质上是一套Skill 管理 + 自动化流水线,让你的 Skill 从创建、验证、测试到发布,全部跑在 GitHub Actions 里,不需要人肉操作。

核心能力:
– 一键初始化:make init SKILL=skill-name,自动生成标准目录结构和模板文件
– 本地快速测试:make sync,把 Skill 软链到 ~/.claude/skills,重启 Claude Code 就能用
– 自动化验证:make validate,跑一套检查清单(YAML 格式、文件行数、描述合法性等),PR 阶段就能卡住不合规的提交
– CI/CD 全自动发布:push 到 main 分支 → 自动打包 → 上传 Anthropic API,同时生成 .skill 文件挂到 GitHub Release

标准化带来什么

更重要的是,它强制了一套 Skill 开发的规范模板:

每个 Skill 必须包含:
– SKILL.md:核心定义,YAML frontmatter + 正文,严格限制行数和格式
– scripts/:可选的自动化脚本
– references/:可选的延伸文档
– assets/:可选的静态资源

这个约束本身就有价值——它逼着你在动手之前先想清楚这个 Skill 要做什么、什么时候触发,克制住往里堆内容的冲动。

团队协作场景

这套工作流对团队共享 Skill 特别有用。

传统的做法是每人维护自己的 .claude/skills/,团队成员想用别人的 Skill 得手动复制。用这个库之后,所有 Skill 集中管理,GitHub 就是单一真相来源:

  1. 成员 A 在 skills/ 目录下开发一个新 Skill
  2. 提交 PR,CI 自动跑验证
  3. 合入 main → GitHub Actions 自动打包上传到 Anthropic API
  4. 其他成员 make sync 拉取最新 Skill,直接用

整个过程没有手动操作,版本历史也在 Git 里。

怎么跑起来

# 克隆仓库
git clone https://github.com/craig-ai-tooling/claude-skills.git
cd claude-skills

# 初始化一个新 Skill
make init SKILL=my-awesome-skill

# 编辑内容
vim skills/my-awesome-skill/SKILL.md

# 本地测试
make sync

# 验证格式
make validate SKILL=my-awesome-skill

# 上传到 Anthropic API(需要设置 ANTHROPIC_API_KEY)
export ANTHROPIC_API_KEY=sk-ant-...
make upload SKILL=my-awesome-skill

团队接入只需要在 GitHub 仓库设置里添加 ANTHROPIC_API_KEY secret,之后所有成员 push 代码就会自动触发发布流程。

适合谁用

  • 有多个 Claude Skill 需要维护的团队或个人开发者
  • 想建立团队 Skill 规范,避免各写各的
  • 希望 Skill 开发跑上 CI/CD,减少手动发布出错

如果你现在还是手动管理 Skill 文件夹,这套工作流值得用起来——GitHub 地址贴在下方。

GitHub:https://github.com/craig-ai-tooling/claude-skills


GitHub: https://github.com/craig-ai-tooling/claude-skills

评论区

0 条评论

登录后可评论。

江望 1350 阅读