skillcrew Skill 技能

技能简介

Skillcrew 是一个面向 AI 编码代理的统一技能注册中心，把团队级别的 SKILL.md 技能同步分发到每位开发者本地的每一种 AI 编码代理（Claude Code、Codex、GitHub Copilot、Cursor、Gemini CLI，以及所有读取 ~/.agents/skills 的代理），并保持始终最新，无需开发者手动干预。项目目标是把零散的 SKILL.md 资产收编进一个受 Git 版本控制的市场，所有代理都从同一处读取，避免"版本漂移、多代理分散、缺乏治理、手动更新"四个痛点。当前处于早期开发阶段，MVP 端到端已通，v1 前仍可能有破坏性变更。

核心能力

• 跨代理分发：一份技能在 Claude Code、Codex、GitHub Copilot、Cursor、Gemini CLI 等代理之间共用，运行时把 SKILL.md 实体复制到 ~/.agents/skills/，并在 Claude Code 的 ~/.claude/skills/ 放置 symlink，单点维护、全员生效。
• 零操作后台同步：skillcrew init 会在每个检测到的代理里注册 session-start hook，并设置用户级定时器（macOS launchd / Linux systemd）。无守护进程、无需管理员权限，开发者不需要主动执行 update 命令。
• 治理分级：每个技能可标注为 required / recommended / available / deprecated / blocked，按组织（org）和团队（team）两级粒度强制，确保安全审查技能人人都有、危险技能无人可用。
• 团队版本为基准：本地对团队技能的小修改会被先备份、再用团队版本覆盖；修改团队技能需走 skillcrew propose，自动生成 PR 走代码评审，个人空间始终归个人。
• 复用现有 Git 凭证：注册中心就是一个普通的 Git 仓库（Claude Code marketplace 布局 + skillcrew.yaml），用开发者已有的 Git 凭证 git fetch，不引入新凭据体系。
• 默认安全：原子更新，注册中心任何内容都不会被 Skillcrew 自身执行；离线时仍可用上次拉取的注册中心缓存运行；发布产物用 Sigstore cosign keyless 签名，install.sh 在安装时自动校验。

安装配置

• Homebrew（macOS / Linux）：brew install yoanbernabeu/tap/skillcrew。
• 一键脚本：curl -fsSL https://raw.githubusercontent.com/yoanbernabeu/skillcrew/main/install.sh | sh，脚本会在检测到 cosign 时自动校验 release 签名。
• Go 安装：需 Go 1.26+，执行 go install github.com/yoanbernabeu/skillcrew/cmd/skillcrew@latest。
• 依赖：macOS 或 Linux（Windows 走 WSL2），系统已安装 git；propose 子命令在装了 gh（GitHub）或 glab（GitLab）时自动启用。
• 初始化注册中心：在新建或已有的 Claude Code marketplace 目录里执行 skillcrew registry init --org acme（GitLab 用户加 --ci gitlab，不接 CI 加 --ci none），会生成示例 plugin、示例 skill、skillcrew.yaml、CI 配置和 AGENTS.md。
• 新增技能：skillcrew skill new git:commit-message --status required --description "..."，一条命令即可写好 SKILL.md 并登记到注册中心。

使用步骤

1. 安装二进制：按上述三种方式之一安装 Skillcrew，确认终端执行 skillcrew --version 能输出版本号。
2. 初始化注册中心：在团队仓库根目录运行 skillcrew registry init --org，按提示选择 CI（GitHub Actions / GitLab CI / 无），提交并推送生成的目录结构到远端。
3. 登记技能：用 skillcrew skill new : --status [--team ] --description "..." 逐个登记技能，先把"安全审查、提交信息格式、PR 描述模板"这类必备技能标为 required。
4. 团队成员拉取：每位开发者首次接入时执行 skillcrew init，注册中心会作为 session-start hook 在每个被检测到的 AI 编码代理里自动 sync 到本地（默认后台每整点跑一次，可关定时器）。
5. 提出改动：需要变更团队技能时在本地修改后运行 skillcrew propose，命令会自动生成 PR（用 gh / glab），评审合并后下次 session-start 即可全员生效。
6. 核验签名（可选）：从 GitHub Releases 下载 checksums.txt 和 checksums.txt.sigstore.json，用 cosign 校验 Sigstore 签名后 shasum -a 256 --ignore-missing -c checksums.txt 校验归档完整。

适用场景

• 多代理混合团队：团队里既有 Claude Code 用户也有 Codex、Cursor、GitHub Copilot 用户，需要同一份编码规范在所有代理里保持一致。
• 强制合规技能：希望"安全审查 Skill""敏感信息扫描 Skill"在每位工程师的每个代理里都强制启用，且新成员入职立即生效。
• 下架危险技能：发现某第三方技能有缺陷，希望组织范围内立即停用，而不是等每个人手动删除本地副本。
• 技能版本化协作：希望技能本身走代码评审 + Git 版本控制，而不是散落在每个开发者的 ~/.claude/skills/ 里漂移。
• 离线 / 弱网开发：跨国或出差场景下网络不稳定，仍希望团队技能可用（注册中心可走 Git 缓存，离线 fallback）。

适用人群

• 中大型研发团队的 Tech Lead / 平台工程团队，需要统一团队编码规范与安全基线。
• 安全合规负责人，要求"AI 编码代理必装安全审查技能"并能强制生效。
• 多 AI 代理混用的独立开发者 / 小团队，厌倦了为每个代理分别维护技能副本。
• 关心发布供应链安全、要求 Sigstore 签名验证才能安装开源工具的安全敏感用户。

工作原理

Skillcrew 把团队仓库组织成 Claude Code marketplace 布局：一个 Git 仓库里包含若干 plugin，每个 plugin 目录下放置若干 SKILL.md。本地安装时，skillcrew init 检测到哪些代理存在（Claude Code / Codex / GitHub Copilot / Cursor / Gemini CLI 等），并在每个代理对应的技能目录下做差异化处理——Claude Code 用 ~/.claude/skills/ 的 symlink，其它代理用 ~/.agents/skills/ 的实体副本。后台通过 session-start hook + 用户级定时器触发 skillcrew sync，从远端 Git 拉取最新注册中心，再以原子操作覆盖到本地。技能状态（required/recommended/available/deprecated/blocked）和团队归属记录在 skillcrew.yaml 中，sync 时按 org→team→个人三层叠加。注册中心的所有内容从不被 Skillcrew 执行，只作为文本同步；发布链路用 Sigstore cosign 做 keyless 签名，确保下游 install.sh 验证后才能落地。

官方链接

• GitHub 仓库：https://github.com/yoanbernabeu/skillcrew
• Release 下载与签名校验：https://github.com/yoanbernabeu/skillcrew/releases
• AGENT 技能标准：https://agentskills.io
• Sigstore 签名规范：https://docs.sigstore.dev/