用 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 就是单一真相来源:
- 成员 A 在
skills/目录下开发一个新 Skill - 提交 PR,CI 自动跑验证
- 合入 main → GitHub Actions 自动打包上传到 Anthropic API
- 其他成员
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
评论区
登录后可评论。