内容
# 全能技能
[](https://www.npmjs.com/package/ai-omni-skills)
[](https://www.npmjs.com/package/ai-omni-skills)
[](LICENSE)
[](https://github.com/moatazhamada/ai-omni-skills)
> **我尝试使用每种 AI 工具。我的技能分散在各个地方。这个工具统一了它们。**
一个 CLI + MCP 服务器，收集您在所有 AI 编码工具中积累的技能，并将它们统一到一个规范存储中。然后，它将这些技能同步到您使用的每个工具中 —— Claude、Codex、Kimi、Gemini、Cursor、Zed、Cline、Z.AI 以及其他支持的工具。
---
## 该工具解决的问题
我就是那种人，我会安装每一个新的 AI 编码工具。Claude Code、Codex、Gemini CLI、Kimi、Cursor、Cline、Continue.dev、Zed —— 我都试过。而且每个工具都需要自己的指令文件、技能目录和配置。
在我使用这些工具之前，我的系统是这样的：
| 混乱 | 我发现的问题 |
|------|--------------|
| **重复的 AGENTS.md 文件** | 16 个项目中有 70 个相同的 1649 字节模板副本 |
| **孤立的技能** | 15 个技能隐藏在工具的技能目录中 —— 没有其他工具能看到它们 |
| **市场倾倒** | 203 个通用技能克隆到项目中，从公共市场复制 |
| **过时的模板** | 每个仓库都有旧的项目特定规则，而我的实际规则在不同的文件中 |
| **私人技能泄露** | 项目特定技能与通用技能混合在同一个仓库中 |
| **铁律漂移** | 一个 98KB 的指令文件在两个重写仓库中手动复制粘贴 |
| **新工具 = 手动设置** | 每个新的 AI 工具都需要手动复制配置文件，一个一个地进行 |
每个工具都有我知识的一小部分。没有一个工具能看到全部内容。我尝试的工具越多，我的设置就越分散。
---
## 该工具的作用
**全能技能** 是一个单一目的的工具：它找到您积累的所有技能和指令文件，将它们放在一个地方，并将它们连接到您使用的每个 AI 工具中。
```bash
# 一个规范存储。所有工具都能看到它。
omni-skills sync all # Claude、Codex、Kimi、Gemini、Cursor、Cline、Zed 等
```
### 三个可移植性层级
| 层级 | 内容 | 机制 |
|------|------|-----------|
| **A** | `SKILL.md` 技能 + 共享指令 + MCP 服务器 | 符号链接 + 本地 MCP 服务器暴露 `list_skills` / `read_skill` |
| **B** | 钩子 | 规范钩子转换为每个工具的原生钩子格式 |
| **C** | 其他资产 | 符号链接从您的配置仓库到每个工具的路径 |
### MCP 服务器
每个支持 MCP 的 AI 工具都会注册此服务器并可以调用：
```json
// list_skills — 发现可用的技能
{
"name": "list_skills",
"result": [
{"name": "clean-code", "description": "务实的编码标准..."},
{"name": "refine-requests", "description": "通过比较验收标准来完善任务..."}
]
}
// read_skill — 在执行前加载完整指令
{
"name": "read_skill",
"arguments": {"name": "systematic-debugging"},
"result": "# 系统调试\n\n没有根本原因就不进行修复..."
}
```
技能从您的私人技能仓库中发现，当文件更改时实时重新加载，并作为 **工具** 和 **提示** 公开。
---
## 快速入门
### 安装
```bash
npm install -g ai-omni-skills
```
每个版本都 [使用 npm 凭证发布](https://www.npmjs.com/package/ai-omni-skills) —— 可验证链接到 GitHub 提交和 GitHub Actions 工作流程。
### 先决条件
您需要一个自己的 **私人** 仓库来存放您的技能。此工具不包含技能 —— 它将您已有的技能连接到您使用的每个 AI 工具中。
```bash
# 1. 克隆此工具（代码，不是技能）
git clone https://github.com/YOURUSER/ai-omni-skills.git
cd ai-omni-skills
npm link
# 2. 运行自动扫描设置
omni-skills setup
# 自动检测已安装的 AI 工具，找到您的技能目录，
# 建议清理并生成 ~/.config/skills/config.json
# 3. 同步到每个 AI 工具
omni-skills sync all
# 4. 验证健康状况
omni-skills doctor
# 5. 运行验证套件
node verify.js
```
### 设置标志
```bash
# 覆盖默认值而无需提问
omni-skills setup --public=~/my-skills-public --private=~/my-skills-private
omni-skills setup --toolkit=/path/to/this/repo
```
---
## 26 个支持的 AI 工具
| 工具 | 类型 | 配置 | 技能目录 | MCP |
|------|------|--------|------------|-----|
| **Claude Code** | CLI | `~/.claude/CLAUDE.md` | ✓ | ✓ |
| **OpenAI Codex** | CLI | `~/.codex/AGENTS.md` | ✓ | ✓ |
| **Kimi** | CLI | `~/.kimi/AGENTS.md` | ✓ | ✓ |
| **Gemini CLI** | CLI | `~/.gemini/GEMINI.md` | — | ✓ |
| **Cursor** | 编辑器 | `~/.cursor/rules/` | — | ✓ |
| **Kilocode** | VS Code | `~/.kilocode/rules/` | ✓ | ✓ |
| **OpenCode** | CLI | `~/.config/opencode/` | — | ✓ |
| **Aider** | CLI | `~/.aider.conf.yml` | — | — |
| **Continue.dev** | VS Code | `~/.continue/config.yaml` | — | ✓ |
| **Cline** | VS Code | `~/.cline/rules.md` | ✓ | ✓ |
| **Roo Code** | VS Code | `~/.roo/rules.md` | ✓ | ✓ |
| **Windsurf** | 编辑器 | `~/.windsurf/rules.md` | — | ✓ |
| **Zed** | 编辑器 | `~/.config/zed/settings.json` | — | ✓ |
| **Tabby** | 自托管 | `~/.tabby/config.toml` | — | — |
| **PearAI** | 编辑器 | `~/.pearai/config.json` | — | — |
| **Void** | 编辑器 | `~/.void/config.json` | — | — |
| **JetBrains Junie** | IDE | `.junie/guidelines.md` | — | — |
| **JetBrains AI Assistant** | IDE | `.aiassistant/rules/` | — | — |
| **Claude Desktop** | 桌面端 | `~/Library/…/Claude/…` | — | ✓ |
| **Devin** | 桌面端 | — | — | — |
| **Factory Droid** | CLI | — | — | — |
| **Z.AI (GLM 5.2)** | 模型 API | — | — | —¹ |
¹ Z.AI 通过现有的工具工作。将 Claude Code、Cline 或 Zed 指向 GLM Coding Plan 端点。对于 VS Code Copilot，请安装 `glm-copilot` 扩展。
支持 MCP 的工具会自动注册 `skills` MCP 服务器。具有技能目录的工具会获得指向所有规范技能的符号链接。
---
## `omni-skills` CLI
| 命令 | 功能 |
|---------|------|
| `omni-skills mcp` | 通过 stdio 运行 MCP 服务器（每个工具启动时都会运行）。 |
| `omni-skills index` | 重新生成 `INDEX.md` 文件和托管的 `SHARED.md` 技能块。 |
| `omni-skills workflow [list\|run <name>]` | 列出可链接的技能工作流或运行一个。 |
| `omni-skills sync [tool\|all] [--dry-run]` | 连接指令、技能目录、MCP 配置、钩子和资产。 |
| `omni-skills check [--move] [--dry-run]` | 查找孤立的技能和悬空/外来符号链接。 |
| `omni-skills classify [path] [--depth=N] [--dry-run]` | 扫描指令文件，检测敏感内容，分类公共/私人。 |
| `omni-skills discover` | 扫描整个系统以查找 AI 工具、指令文件、技能目录和项目。 |
| `omni-skills setup` | 自动扫描系统，检测工具，建议清理，生成配置。 |
| `omni-skills doctor` | 健康检查：验证符号链接、配置、索引和技能数量。 |
| `omni-skills report [--enhance]` | 使用情况统计和启发式改进提示。 |
| `omni-skills init [--dry-run]` | 交互式设置：扫描、分类、路由、连接。 |
| `omni-skills security [scan]` | 检查/安装 NVIDIA SkillSpector。扫描技能以查找漏洞。 |
| `omni-skills create [name]` | 使用交互式向导创建新技能。 |
| `omni-skills create from <file>` | 将现有文件转换为技能。 |
| `omni-skills help` | 显示帮助。 |
### 工作流
将技能链接在一起形成可重复的序列。工作流是一组命名技能，按顺序执行 —— 类似于常见任务的剧本。
```bash
# 列出所有工作流
omni-skills workflow list
# 运行工作流
omni-skills workflow run release-prep
omni-skills workflow run advanced-feature-dev
```
#### 简单工作流（线性）
```yaml
---
name: release-prep
description: 发布前 lint、测试和提交
steps:
- lint-and-validate
- testing-patterns
- commit-suggest
---
```
#### 高级工作流（循环、条件、并行）
```yaml
---
name: advanced-feature-dev
description: 具有质量门的完整功能开发
goal: "功能已指定、实现、测试和提交"
steps:
- skill: refine-requests
goal: "需求清晰且有验收标准"
max_retries: 2
- loop:
goal: "规范已批准"
until: "用户说批准"
max_iterations: 3
steps:
- skill: speckit-specify
- skill: speckit-checklist
- condition:
check: "规范复杂（超过 5 个需求）"
then:
- skill: speckit-plan
else:
- skill: speckit-tasks
- skill: speckit-implement
goal: "所有任务都已实现"
- parallel:
goal: "所有质量检查通过"
branches:
- steps:
- skill: lint-and-validate
- steps:
- skill: testing-patterns
- steps:
- skill: speckit-analyze
- skill: speckit-git-commit
goal: "干净的提交，带有良好的消息"
---
```
**步骤类型：**
| 类型 | 语法 | 功能 |
|------|--------|--------------|
| **技能** | `skill: name` | 加载并执行一个技能 |
| **目标** | `goal: "..."` | 步骤的成功条件 |
| **重试** | `max_retries: 3` | 如果步骤失败，则重试 |
| **循环** | `loop: { until, max_iterations, steps }` | 重复直到条件满足 |
| **条件** | `condition: { check, then, else }` | 根据检查分支 |
| **并行** | `parallel: { branches: [...] }` | 并行运行分支 |
| **重试** | `max_retries: 3` | 如果步骤失败，则重试 |
**工作流功能：**
- **目标：** 每个步骤都有明确的“完成”条件
- **循环：** 重复精炼周期，直到您批准
- **条件：** 适应复杂性 —— 简单功能跳过重规划
- **并行：** 质量检查同时运行，而不是逐一运行
- **重试：** 自动重试失败的步骤，然后再放弃
工作流位于您的私人仓库下的 `workflows/` 目录中 —— 它们是私有的，不共享。
---
## 🔒 安全扫描（NVIDIA SkillSpector）
研究表明 **26.1% 的 AI 技能包含漏洞** 且 **5.2% 显示可能存在恶意意图** 。全能技能与 [NVIDIA SkillSpector](https://github.com/NVIDIA/skillspector) 集成，以扫描您的技能，然后再安装它们。
SkillSpector 检测 **64 个漏洞模式**，涵盖 **16 类别**：
- 提示注入、数据泄露、权限提升
- 供应链攻击、恶意软件、凭证收集
- 过度代理、工具滥用、系统泄露
### 快速入门
```bash
# 检查 SkillSpector 状态
omni-skills security
# 扫描您规范存储中的所有技能
omni-skills security scan
# 扫描时不使用 LLM（更快，仅静态分析）
omni-skills security scan --no-llm
# 扫描特定技能目录
omni-skills security scan ~/my-skills-private/clean-code
```
### 安装 SkillSpector
```bash
git clone https://github.com/NVIDIA/skillspector.git
cd skillspector
python3 -m venv .venv && source .venv/bin/activate
pip install -e .
```
或者使用 Docker：
```bash
docker run --rm -v "$PWD:/scan" ghcr.io/nvidia/skillspector scan /scan
```
---
## ✨ 创建新技能
与其通过代理创建技能然后移动它们，不如直接创建：
```bash
# 交互式向导
omni-skills create
# 带有名称和描述
omni-skills create refine-requests "完善票据验收标准"
# 将现有文件转换为技能
omni-skills create from ./my-instructions.md
# 然后索引和同步
omni-skills index
omni-skills sync all
```
这会在您的私人技能存储中创建一个具有适当 frontmatter 的 `SKILL.md` 文件。
---
## 如何存储您的技能
该工具是 **仅代码**。您的技能存放在一个单独的仓库（或两个）中，您可以控制它们。
### 推荐的结构
```
# 您的私人技能仓库（永远不会公开）
~/my-skills-private/
├── SHARED.md ← 生成的共享指令
├── INDEX.md ← 生成的技能索引
├── config.json ← 工具配置
│
├── clean-code/SKILL.md
├── systematic-debugging/SKILL.md
├── refine-requests/SKILL.md
├── codebase-memory/SKILL.md
├── mobile-ui-patterns/SKILL.md
├── dependency-updates/SKILL.md
├── build-optimizer/SKILL.md
└── ... （所有您的技能）
│
├── projects/ ← 每个项目的指令文件
│ ├── project-alpha/AGENTS.md
│ ├── project-beta/AGENTS.md
│ └── project-gamma/
│ ├── Core Rules.md
│ └── Core Rules Compact.md
│
├── workflows/ ← 可链接的技能序列
│ ├── release-prep/WORKFLOW.md
│ ├── feature-dev/WORKFLOW.md
│ └── debug-trace/WORKFLOW.md
│
└── large-projects/
└── project-gamma/
└── ensure_symlinks.sh
```
### 为什么是私有的？
您的技能是 **个人** 的 —— 它们包含：
- 您的编码风格和偏好
- 您项目的内部约定和架构
- 您的私有工作流和领域知识
- 您的私有项目结构
没有人需要查看您的 `refine-requests` 技能或您的 `review-feedback` 工作流。工具是公开的，因为它是通用基础设施。技能是私有的，因为它们是您的知识产权。
---
## 我如何使用这个（真实统计）
我的个人设置 —— 统一后：
| 指标 | 值 |
|--------|-------|
| **连接的 AI 工具** | 9（Claude、Codex、Kimi、Gemini、Cursor、Kilocode、OpenCode、Windsurf、Claude Desktop） |
| **规范存储中的技能** | 49（全部私有，全部我自己的） |
| **删除的过时模板文件** | 77 - 消除重复的 AGENTS.md/GEMINI.md 副本 |
| **救援孤立技能** | 15 — 从 `~/.kimi/skills/` 到规范存储 |
| **删除重复技能** | 15 — 从项目的市场克隆中删除 |
| **存档的通用市场技能** | 203 — 从活动项目中删除，不会丢失 |
| **每周健康检查** | 自动运行 `omni-skills doctor` 每天 9:17 AM |
| **规范存储的指令文件** | 5 — 特定项目规则，无需再漂移 |
| **核心项目规则** | 98KB 文件，单一来源，符号链接到 2 个其他仓库 |
| **新工具集成** | `omni-skills sync <tool>` — 一条命令 |
---
## 每周健康检查
定时 `cron` 作业每天早上运行 `omni-skills doctor`，以便在问题变得严重之前发现问题：
```bash
omni-skills doctor # 检查所有符号链接、配置、索引和技能数量
omni-skills check # 扫描孤立的技能
omni-skills report # 使用情况统计和改进提示
```
---
## 验证
在信任系统之前，请先验证它：
```bash
node verify.js
# === 技能生态系统验证 ===
# [config] ✓ 加载成功
# [技能路径] ✓ 2 个路径存在
# [技能扫描] ✓ 发现 49 个技能，无重复
# [技能文件] ✓ 所有文件有效
# [SHARED.md] ✓ 存在
# [指令] ✓ 6 个符号链接 + 1 个常规有效
# [技能目录] ✓ 4 个工具，每个工具 49 个技能，全部健康
# [MCP 配置] ✓ 7 个工具，全部都有技能服务器
# ✓ 所有检查通过（24 个检查通过）
```
---
## 测试
```bash
npm test
```
14 个测试，Node 内置运行器，无需额外依赖。涵盖：
- `sensitive.js` — 拒绝列表检测（公司名称、票证 ID、API 密钥、内部 URL）
- `fs-utils.js` — 符号链接管理，托管块插入/更新
- `skills.js` — 技能扫描，frontmatter 解析，隐藏目录过滤
每次推送后，CI 通过 GitHub Actions 运行。
---
## 许可证
MIT — 请参阅 [LICENSE](LICENSE)。
---
## 星标和贡献
如果此工具对您有帮助，请给它一个星标 ⭐
发现了错误？想添加新功能？有疑问？
- [打开一个问题](https://github.com/moatazhamada/ai-omni-skills/issues) — 错误报告、功能请求、问题
- [打开讨论](https://github.com/moatazhamada/ai-omni-skills/discussions) — 想法、展示和讲述、问答
- [打开拉取请求](https://github.com/moatazhamada/ai-omni-skills/pulls) — 欢迎贡献
---
**作者：** Moataz Mohamed · [GitHub](https://github.com/moatazhamada) · [npm](https://www.npmjs.com/package/ai-omni-skills)
*由一个尝试使用每种新 AI 工具，并对在 18 个项目中分散的技能感到厌烦的人构建。如果你也有一个 `.claude/`、`.kimi/`、`.codex/`、`.gemini/`、`.cursor/` 和 `.kilocode/` 目录位于同一台机器上，那么这就是为你准备的。*
连接信息
猜你喜欢
暂无推荐服务器