技能共享管家 yinsanbian/AgentSkillHub

cd D:\AgentSkillHub
python skill-hub\scripts\gui.py

3. 首次启动会自动扫描所有已登记的 Agent 目录，扫描结果只存在内存里，不会写入磁盘。

命令行用法

扫描所有 Agent 目录，输出技能清单（dry-run，不写文件）
python skill-hub\scripts\skill_hub.py scan

把技能合并进共享库（dry-run）
python skill-hub\scripts\skill_hub.py merge

为指定 Agent 建立链接（dry-run）
python skill-hub\scripts\skill_hub.py link --agent claude-code

同步共享库与所有 Agent 目录（dry-run）
python skill-hub\scripts\skill_hub.py sync

加 --apply 才会真正写入文件系统。

安装为 Agent 技能（可选）

把管理器本身安装为技能，供 Agent 读取 .\install.ps1

安全设计

| 风险 | 处理方式 |
| 覆盖个人定制技能 | 只复制缺失技能，已存在的同名技能一律跳过 |
| 误删原始技能 | 只撤销本工具创建的链接，共享库副本与原始技能始终保留 |
| 同名技能版本冲突 | 标记为冲突并禁用执行，绝不猜测取舍 |
| 复制过程中源目录被修改 | 复制后校验文件指纹，不一致则中止 |
| 技能内含敏感文件 | 扫描时拒绝疑似密钥文件（.env、.pem、.pfx、.p12 等） |
| 技能内含符号链接 | 扫描时拒绝技能内部的符号链接 / 目录联接 |
| 技能体积过大 | 超过文件大小 / 数量上限的技能直接拒绝 |
| 未经确认就改动文件系统 | 暂存式编辑 + 变更预览 + 二次确认，三步缺一不可 |
| 上传或外发数据 | 全程离线，不发送任何网络请求 |

兼容性

- Windows 10 / 11：完整支持，目录联接（Junction）无需管理员权限。
- macOS / Linux：核心扫描与合并逻辑可用，链接功能依赖 os.symlink，需要相应权限。
- Python 3.10+：仅使用标准库，无第三方依赖。

常见问题

Q：为什么列表里有 34 个 Agent，但只有 13 个能自动扫描？

A：只有这 13 个有官方文档明确说明的本地技能目录路径。其余 21 个仅提供手动配置入口，列表中存在不代表该产品支持本地技能。你可以在设置里为它们手动指定真实的技能根目录。

Q：共享库默认放在 D:\AI-Skills\skills，可以改吗？

A：可以。在设置里修改共享库路径即可，改完后重新扫描。

Q：链接和复制有什么区别？

A：链接（Junction）不占额外磁盘空间，共享库里的技能一更新，所有链接方立刻同步；复制则是各 Agent 目录下各存一份独立副本。默认用链接，你也可以在设置里改成复制。

Q：撤销共享会删掉我的技能吗？

A：不会。撤销只移除本工具创建的链接，共享库副本和原始技能都保留。如果链接被人手动替换过，工具会拒绝撤销。

Q：支持 DeepSeek Harness 吗？

A：支持。内置条目会读取 .dsh/skills，并识别 DSH_HOME 环境变量。

测试

python -m pytest tests/ -v

18 项单元测试全部通过。

协议

MIT
cd D:\AgentSkillHub
py -3 .\skill-hub\scripts\gui.py

3. 首次使用建议先在左下角 设置与路径 中确认共享库位置（推荐 D:\AI-Skills\skills）。
4. 先用一个不含敏感信息的普通技能、只共享给一个 Agent 试跑一遍完整流程。

图形界面操作流程

左侧选择 Agent ↓ 中间搜索 / 筛选技能（可 Ctrl / Shift 多选） ↓ 右侧设置该技能的共享状态与接收 Agent ↓ 底部保存配置（仅保存策略，不改动文件） ↓ 预览操作：复制 / 建立链接 / 撤销链接 / 冲突 ↓ 最终确认执行（此时才真正修改文件系统）

快捷键：

| 快捷键 | 功能 |
| Ctrl+F | 搜索技能 |
| Ctrl+S | 保存共享策略 |
| Ctrl+R | 重新扫描 |
| Ctrl / Shift + 点击 | 多选技能 |

示例：把 Codex 的技能共享给 Claude Code 与 DeepSeek Harness

1. 左侧选择 Codex，中央选中目标技能。
2. 右侧勾选 加入共享库，接收方只勾选 Claude Code 与 DeepSeek Harness。
3. 点击底部 预览并执行，在弹窗中核对共享库路径、目标 Agent 与计划操作。
4. 确认无冲突后点击 确认执行，再按需要重启相关 Agent 以发现新技能。

命令行用法

CLI 适合脚本化与自动化场景，所有命令默认都是 dry-run（只预览），必须显式加 --apply 才会真正写入。

1. 扫描所有已登记 Agent 的技能目录，输出唯一技能 / 重复 / 冲突 / 错误 py -3 .\skill-hub\scripts\skill_hub.py scan --report D:\skill-scan.json

额外扫描某个项目内的技能目录 py -3 .\skill-hub\scripts\skill_hub.py scan --project D:\MyProject

2. 预览合并到共享库，确认后加 --apply py -3 .\skill-hub\scripts\skill_hub.py merge --out D:\AI-Skills\skills py -3 .\skill-hub\scripts\skill_hub.py merge --out D:\AI-Skills\skills --apply

3. 预览把共享库链接到指定 Agent，确认后加 --apply py -3 .\skill-hub\scripts\skill_hub.py link --out D:\AI-Skills\skills --agents codex claude cursor gemini py -3 .\skill-hub\scripts\skill_hub.py link --out D:\AI-Skills\skills --agents codex claude --apply

4. 合并 + 链接一步完成（同样需要 --apply） py -3 .\skill-hub\scripts\skill_hub.py sync --out D:\AI-Skills\skills --agents codex claude --apply

CLI 的 link 会把共享库中的全部技能链接给指定 Agent；若需要按技能分别选择接收方，请使用图形界面。

把管理器本身安装为 Agent 技能（可选）

安装后，Agent 可以在自己的技能列表中发现本管理器的使用说明。该步骤不是启动 GUI 的必要条件。

可选 Agent：codex, claude, cursor, gemini, opencode .\install.ps1 -Agents codex,claude # 预览 .\install.ps1 -Agents codex,claude -Apply # 真正建立 Junction

配置文件

共享策略、自定义 Agent 与链接管理记录保存在：

%LOCALAPPDATA%\AgentSkillHub\settings.json

（无 LOCALAPPDATA 环境变量时退回到用户主目录下的设置文件。）

- 升级版本不会主动重置该文件；升级前建议备份配置文件与共享库。
- 更改共享库目录时，如仍存在本工具管理的链接，界面会要求先撤销链接，避免产生失效引用。
- 已存在的同名文件夹不会被自动覆盖，冲突需由你手动处理。

安全边界与限制

请在使用前知悉，以下能力不在本工具范围内：

- 不内置 Notion 等云端 API 同步；云端技能需先自行导出。
- 不是实时双向同步服务：原始技能更新后需要再次处理，共享库中的已有副本不会被自动覆盖。
- 不是权限隔离系统：部分 Agent 会主动读取通用 .agents/skills，只勾选一个接收方不代表其他 Agent 一定看不到该技能。
- 不自动探测软件是否安装：左侧"有技能"仅表示发现了可读的技能目录。
- 21 个手动登记条目未核实官方写入路径，部分产品可能根本不支持本地 SKILL.md。
- 不提供打包好的 .exe，以 Python + Tkinter 和 .bat 方式分发。
- 执行日志只记录本次运行的最近一次结果，不是持久化审计历史。
- 即使技能内容通过了扫描规则，分享给其他 Agent 前仍应自行审查其指令、依赖、脚本与授权范围。

运行测试

py -3 -m unittest discover -s tests -v

共 18 项单元测试，覆盖注册表路径、扫描去重、密钥与链接拒绝、冲突阻断、暂存策略、定向共享与安全撤销、批量策略与预览统计。测试在 Windows 上同样要求全部通过。

设计参考

界面设计参考了以下公开设计原则（仅为设计借鉴，不代表相关方对本项目的认可或排名）：

- Microsoft Fluent 2 — Layout
- Microsoft — Navigation design basics
- Microsoft Fluent 2 — Navigation
- Nielsen Norman Group — Ten Usability Heuristics
- Nielsen Norman Group — Complex Applications

许可证

MIT License