superSkill Skill 技能

技能简介

superSkill 是一款面向多 Agent 的技能、命令、子代理、magent、钩子与 MCP 配置的分发与创作 CLI，由 gobing-ai 团队开发。它的定位是「一次编写、处处安装」——把一份 Claude Code 插件资产（技能、命令、子代理、钩子、规则）分发到几乎所有主流编程 Agent，并提供从脚手架、校验、评估到精炼、演进的完整命令行工作流。对于同时使用 Claude Code、Codex、Grok、OpenCode 等多套工具的开发者，superSkill 用一个 CLI 抹平了各家技能格式与目录的差异。

核心能力

• 跨 Agent 一键分发：superskill install --targets all 可把插件资产装入所有受支持目标，且无需克隆仓库。
• 多类型实体统一管理：技能（Skills）、命令（Commands）、子代理（Subagents）、magent、钩子（Hooks）、MCP 配置一并分发与生成。
• Skill 全生命周期工具链：scaffold → validate → evaluate → refine → evolve，从脚手架到自动精炼，覆盖技能从零到成熟的每一步。
• 兼容不支持实体类型的 Agent：对原生缺少某些实体类型的 Agent，superSkill 会自动把命令与子代理适配为 Skills 2.0 技能目录，保证每个 Agent 都拿到完整能力面。
• Hook 精准投递：superskill hook emit --target 可把钩子只发往单个目标 Agent。
• 技能打包与合并：package 可把技能打包分发，migrate 可把多个源技能合并进目标技能。
• 健康检查与诊断：superskill doctor --targets 做文件系统健康检查，报告注册状态与后续步骤。

安装配置

1. 使用 Bun（推荐）：bun add -g @gobing-ai/superskill；也可免安装运行 bunx @gobing-ai/superskill --help。
2. 使用 npm：npm i -g @gobing-ai/superskill。
3. 从源码安装（贡献者）：proto use 安装锁定工具版本，然后 bun install && bun run build，再 cd apps/cli && bun link。
4. 环境要求：Bun ≥ 1.3.14（源码构建）。
5. 安装说明文档：详见 docs/help/installation.md。

使用步骤

1. 一键安装内置 cc 插件到所有目标：superskill install cc --targets all。
2. 安装 cc 并附带主代理配置：superskill install cc --magent team-stark-children。
3. 创作技能：superskill skill scaffold my-skill --description "..." 生成脚手架。
4. 校验技能：superskill skill validate my-skill。
5. 评估技能：superskill skill evaluate my-skill --save；随后 superskill skill refine my-skill --auto 自动精炼。
6. 打包或合并：superskill skill package my-skill，或用 superskill skill migrate ./a ./b ./dest 合并。
7. 精准投递钩子：superskill hook emit my-hook --target pi。

支持的 Agent

Claude Code、Grok、Codex、Pi、omp、OpenCode 均支持技能/命令/子代理/钩子；Antigravity IDE、Antigravity CLI、Hermes 支持技能/命令/钩子；Grok Bot 为可选安装目标（发布扁平技能目录，斜杠形式为 /plugin-skill-name）。

适用场景

• 团队同时使用多套编程 Agent，需要统一分发同一份技能资产。
• Skill 作者需要一套标准化工具链来脚手架、校验与评估技能。
• 希望把命令/子代理适配给原本不支持这些实体类型的 Agent。
• 需要集中管理 Hook 与 MCP 配置并跨平台投递。
• 想要基于评估指标而非直觉来精炼与演进技能。

适用人群

• 多 Agent 混用的开发者与 DevOps 工程师；
• Agent Skill / 插件的作者与维护者；
• 需要统一团队级 Agent 配置与规范的技术负责人。

工作原理

superSkill 在运行时定位自身打包内的 cc 插件与主代理配置，因此从任意目录都能安装，无需克隆或额外参数。对原生支持插件的目标（如 Claude Code、Grok、omp、Pi）直接走原生安装路径；其余目标则通过 rulesync 的 per-target 生成器做适配。对不支持某些实体类型的 Agent，它会把命令与子代理转化为 Skills 2.0 技能目录，从而保证能力面对齐。Pi 从插件的 plugin.json 的 extensions.pi 数组原生加载扩展；没有该字段时回退到 @vahor/pi-hooks 的钩子投递路径。Grok 以原生方式加载 Claude 格式插件，斜杠形式为 /plugin:command。

官方链接

• npm 包：https://www.npmjs.com/package/@gobing-ai/superskill
• GitHub 仓库：https://github.com/gobing-ai/superskill
• 快速上手文档：docs/help/quick_start.md