Agent Skills Shared — Design skill for Claude Code

agent-skills-shared · 跨 Agent 技能共享方案

一套技能 · 只装一次 · 所有 Agent 共用

在同一台 Windows 电脑上运行多个 AI Agent（Doubao、Claude Code、Codex、Cursor、Trae、WorkBuddy 等）时，每个 Agent 都有各自的技能目录，同一技能常常要重复安装、重复维护。本项目用 **NTFS 目录联接（Junction）** 让所有 Agent 的技能根目录指向同一个「统一技能库」——**技能只装一次，处处生效**。

功能总览

功能	说明	入口
统一共享技能库	NTFS Junction 指向单一共享库，一套技能处处可见	核心机制
专业终端控制台	交互式向导：真彩渐变标题、双线框、状态栏、16 色降级	双击桌面「统一技能库管理」
一键搭建	自动迁移已有技能、智能去重、建立联接	向导 [1] / setup.ps1
12 项预设 Agent 路径	Doubao / Claude Code / Codex / Cursor / Windsurf / OpenClaw / Trae / Copilot / WorkBuddy 等，自动探测本机状态	向导 [1] 步骤 2
技能自动分类管理	9 类关键词词典自动归类，含中文简介（_meta.json）	向导 [3]a / [3]d
一键安装技能	支持 GitHub 仓库链接与 skills.sh 链接，自动识别仓库类型	向导 [3]b / install-skill.ps1
扫描已装技能	随时检测各 Agent 中未进共享库的技能并迁移	向导 [5] / scan-agents.ps1
双重更新检测	技能版本更新检测 + 项目（工具）自身版本更新检测，均可一键升级	向导 [6]a / [6]b
桌面快捷方式	首次启动自动创建「统一技能库管理.lnk」	首次启动
全程中文	界面、文档、报错提示均为中文	—

为什么用 Junction？

Windows 的 NTFS **目录联接（Junction）** 是一个指向另一个目录的「指针」：

C:\Users\me\.claude\skills  ──(mklink /J)──▶  C:\Users\me\skills\shared
C:\Users\me\.codex\skills   ──(mklink /J)──▶  C:\Users\me\skills\shared
C:\Users\me\.cursor\skills  ──(mklink /J)──▶  C:\Users\me\skills\shared

• 对 Agent 而言，它「看到」的是自己的技能目录，行为无感知；
• 对使用者而言，新增 / 更新 / 删除技能只需在共享库做一次；
• 无需管理员权限（Junction 不像符号链接需要提权）；
• 不复制文件、不占双份磁盘，Agent 看到的技能与共享库实时一致。

图解：`diagrams/architecture.svg`（整体架构）、`diagrams/junction-mechanism.svg`（联接机制）。

快速上手（终端方式）

# 1. 下载并解压（任选）
#    a) 浏览器打开仓库 → 绿色 Code 按钮 → Download ZIP → 解压到任意目录
#    b) 或 git clone https://github.com/JacksenHu/agent-skills-shared.git
# 2. 打开 PowerShell，进入项目目录
cd <解压目录>
# 3. 启动管理控制台（全程选择即可，无需手写 JSON）
.\scripts\setup-wizard.ps1

图解：`diagrams/quickstart-flow.svg`（快速上手流程）。

首次启动会自动在桌面创建「统一技能库管理」快捷方式，之后双击即可打开控制台。

管理控制台主菜单

选项	功能
[1] 快速搭建	配置共享库与 Agent、自动迁移已有技能、建立联接
[2] 验证联接	检查所有 Agent 的技能可见性
[3] 技能管理	分类清单 / GitHub、skills.sh 仓库安装 / 移除 / 分类浏览