Agent Skill Manager

English | 简体中文

一次开发，十一端同步 — 跨平台统一管理国内 AI Agent 产品的 Skill 安装与同步

安装 · 使用 · 二次开发 · 架构原理

痛点

每个国产 AI Agent 产品都有自己独立的 skill 目录，开发一个 skill 要手动复制到每个产品：

~/.openclaw/skills/my-skill/          ← AutoClaw
~/.config/agents/skills/my-skill/      ← Kimi
~/.workbuddy/skills/my-skill/          ← WorkBuddy
~/.trae/skills/my-skill/               ← Trae
~/.codebuddy/skills/my-skill/          ← CodeBuddy
~/.comate/skills/my-skill/             ← Comate
~/.qoderwork/skills/my-skill/          ← Qoder
... 每改一次都要重复一遍

agent-skill-manager 用「中央仓库 + 一键分发」解决这个问题：改一处，全同步。

支持的产品（11 个）

架构原理

核心设计：中央仓库 ~/.agents/skills/ 作为唯一权威源，通过 symlink（macOS）或 junction（Windows）自动分发到各产品。对不支持文件系统的 DuMate，打包为 .zip 手动上传；QwenWork/豆包工作 同样支持 junction 同步。

• Windows：使用 mklink /J 创建 junction，无需管理员权限
• macOS：使用 ln -s 创建 symlink
• 自动降级：链接创建失败时自动降级为复制模式
• 零依赖：仅使用 Python 标准库

安装

# 开发模式安装（推荐）
# 从 PyPI 安装（推荐）
pip install cn-skill-sync

# 开发模式安装
cd agent-skill-manager
pip install -e .

# 如果 pip 遇到 TLS 证书问题
python -m pip install -e . --no-build-isolation

安装后 askill 命令全局可用。

也可以通过 npx skills 生态安装：

# 安装 skill 定义到所有支持的 agent 产品
npx skills add yxdwind/agent-skill-manager

使用

# 查看所有产品的 skill 安装状态（含安全评测评分列）
askill status

# 一键同步所有 skill 到所有产品
askill sync

# 同步指定 skill
askill sync my-skill

# 列出中央仓库中的所有 skill（含安全评测评分）
askill list

# 安装 skill（本地路径或 GitHub URL）
askill install /path/to/skill-folder
askill install --sync /path/to/skill-folder          # 安装后自动同步到所有产品
askill install --audit /path/to/skill-folder         # 安装后自动运行安全评测
askill install --sync --audit <github-url>           # 同步 + 安全评测一起

# 支持多种 GitHub URL 格式（默认分支自动识别，无需手动指定 main/master）
askill install --sync https://github.com/user/repo                                # 仓库根目录的 SKILL.md
askill install --sync https://github.com/user/repo/tree/main/my-skill              # 指定分支的子目录
askill install --sync https://github.com/user/repo/blob/main/my-skill/SKILL.md     # 直达 SKILL.md 文件

# 从一个平台拉取 skill 到中央仓库，并同步到其他所有平台（adopt）
askill adopt autoclaw my-skill                       # 从 AutoClaw 采纳指定 skill
askill adopt kimi                                    # 从 Kimi 采纳全部 skill
# 安全评测（静态分析：提示注入 / 危险代码 / 敏感信息 / 二进制文件）
askill audit                                         # 评测中央仓库全部 skill
askill audit my-skill                                # 评测指定 skill

# 实时监听：skill 一改动自动同步到全部产品（v0.8.0 新增）
askill watch                                         # 常驻监听 ~/.agents/skills/
askill watch --interval 5                            # 自定义轮询间隔（秒）

# skill 升级：GitHub 来源自动追踪，一键检测/应用更新（v0.8.0 新增）
askill update --check                                # 只检查有哪些更新
askill update my-skill                               # 更新指定 skill 并同步
askill update                                        # 检查并更新全部 tracked skill

# 从所有产品移除 skill
askill remove my-skill

# 为 DuMate 打包 skill 为 .zip
askill pack my-skill

# 列出所有支持的产品
askill products

典型工作流

1. askill watch         ← 开启实时监听（推荐常驻）
2. 编辑 ~/.agents/skills/my-skill/SKILL.md   ← 保存即自动同步 + 安全复检
3. askill update --check ← 想升级时看看哪些 skill 有新版本

项目结构

agent-skill-manager/
├── pyproject.toml              # PEP 621 项目配置
├── setup.py                    # setuptools 兼容入口
├── docs/
│   ├── architecture.svg        # 架构图
│   ├── demo.svg                # 终端演示图
│   └── product-paths.md        # 各产品详细路径参考
├── src/                        # 包根（映射为 agent_skill_manager 包）
│   ├── __init__.py / __main__.py
│   ├── config/products.py      # 11 个产品定义
│   ├── controllers/cli.py      # CLI 命令（12 commands）
│   ├── models/                 # TypedDict 数据模型
│   ├── services/               # 业务逻辑（sync / audit / watch / sources）
│   └── utils/filesystem.py     # 跨平台文件操作
└── tests/                      # 94 个测试
    ├── test_products.py
    ├── test_utils.py
    ├── test_core.py
    ├── test_adopt.py
    ├── test_security.py
    ├── test_cli.py
    └── test_watch.py

实时监听与升级（v0.8.0）

askill watch — 改完即同步

askill watch 常驻监听中央仓库，每 3 秒（可调）做一次快照对比，零第三方依赖：

• 新增/修改 skill → 数秒内自动同步到全部产品，实时打印每个产品结果
• 删除 skill → 自动清理所有产品残留链接，杜绝死链
• 安全复检 → 每次同步后重跑 audit；安全评级从 safe 跌到 risky/dangerous 时高亮告警并列出主要问题

askill update — 来源追踪与一键升级

通过 GitHub URL 安装的 skill 会自动记录来源（仓库/路径/分支/commit）到 ~/.agents/skills/.askill-sources.json：

askill update --check      # 列出哪些 skill 远端有新版本
askill update              # 检查并应用全部更新（更新后自动同步 + 复检）
askill update my-skill     # 只更新指定 skill

安全评测（audit）

askill audit 对 skill 做零依赖静态分析，从 100 分起扣，按严重级别加权（每类封顶 40 分）：

评分与结论：A ≥ 90（safe）· B ≥ 80（safe）· C ≥ 70（caution）· D ≥ 60（risky）· F < 60（dangerous）

askill list 和 askill status 的输出中也会直接带上每个 skill 的评分（score/grade/结论）。安装时可直接附加 --audit 一步完成「安装 + 安全评测」：

askill install --sync --audit https://github.com/user/repo/tree/main/my-skill

二次开发

添加新产品

编辑 src/agent_skill_manager/products.py，在 PRODUCTS 列表中添加：

{
    "name": "新产品名称",
    "short": "short-name",
    "macos_path": HOME / ".newproduct" / "skills",
    "windows_path": HOME / ".newproduct" / "skills",
    "sync_method": "symlink",  # symlink | native | pack
    "note": "说明信息",
    "extra_dirs_macos": [],
    "extra_dirs_windows": [],
}

运行测试

pip install pytest
pytest tests/ -v

相关项目

• manage-my-skills — 跨平台 Skills 管理工具，支持 20+ 国际产品
• awesome-agent-skills — Agent Skills 终极指南
• skills CLI — npm 上的 agent skills 包管理器
• skill-creator — Skill 编写规范参考

贡献者

感谢以下贡献者参与本项目开发：

• @GLM-5.2 — AI 协作开发（智谱 GLM-5.2）

安全与隐私

• 安全政策（SECURITY.md） — 漏洞报告指引与安全建议
• 隐私政策（PRIVACY.md） — 数据本地处理说明

许可证

MIT