itaywol/adeptability

adeptability：跨框架 AI 技能可攜性

概要

跨框架的 AI 技能可攜性命令列工具。編寫一次代理技能，即可自動同步至 Claude Code、Cursor、Copilot、Codex、OpenCode 及超過 45 個 AI 程式設計代理。內建安全掃描器、內容雜湊漂移檢測。專為 AI 程式設計代理技能設計的套件管理器 / dotfiles。

平台支援

平台	支援狀態
Claude Code	✅ 受支援
Cursor	✅ 受支援
GitHub Copilot	✅ 受支援
Codex CLI	✅ 受支援
OpenCode	✅ 受支援
其他 45+ 代理	✅ 新增中

功能

• 編寫一次，到處執行：為所有 AI 程式設計代理定義單一技能。
• 安全同步：在同步至代理之前自動掃描任何安全性問題。
• 漂移檢測：偵測內容雜湊的變更並提醒。
• 套件管理器：像使用 npm 或 dotfiles 一樣管理技能。
• 最小配置：僅需一個 SKILL.md 檔案即可運作。

安裝

npm install -g adeptability

快速入門

# 初始化一個 Adeptability 專案
adeptability init my-skill

# 建立一個技能
adeptability create my-skill

# 將技能同步至所有已配置的代理
adeptability sync my-skill

使用方式

初始化新專案

adeptability init my-project
cd my-project

建立技能

adeptability create my-skill

這將會建立一個 skills/my-skill/SKILL.md 檔案。

同步技能

# 同步所有技能
adeptability sync

# 同步特定技能
adeptability sync my-skill

# 同步至特定代理
adeptability sync my-skill --agent claude-code

掃描技能是否存在安全性問題

adeptability scan my-skill

檢測漂移

adeptability drift my-skill

技能格式

每個技能都定義在 SKILL.md 檔案中。範例技能內容：

---
name: my-custom-skill
description: 為代理提供自訂行為的範例技能。
version: 1.0.0
---

# my-custom-skill

這是一個範例技能，指示代理如何執行某些自訂操作。

## 指令

當使用者要求時，代理應...

在專案中使用技能

在項目的根目錄建立一個 .adeptability.json 檔案：

{
  "agents": {
    "claude-code": {
      "enabled": true
    },
    "cursor": {
      "enabled": true
    },
    "copilot": {
      "enabled": true
    }
  },
  "skills": [
    {
      "name": "my-skill",
      "path": "./skills/my-skill/SKILL.md"
    }
  ]
}

貢獻

歡迎提交拉取請求。對於重大變更，請先開啟 issue 討論您想變更的內容。

授權

MIT