mi4646 装备管理器（Equipment Manager）
把「盘点 → 查重 → 三档筛选 → 提问澄清 → 备份安装 → 验证」固化为通用方法论，管理从第三方仓库安装的 skill 与 agent。方法论一份，各仓库专属情报按仓库归档在 references/——加新仓库只需加一个档案文件，方法论不动。
使用时机
- 某仓库
git pull后有新增/变更的 skill 或 agent，需评估是否安装 - 从某仓库安装新 skill/agent
- 精简/删除某仓库已装的装备
- 盘点本地已装的 skill/agent 及其来源
支持的仓库
| 档案 | 仓库 | 内容 |
|---|---|---|
references/msitarzewski.md |
msitarzewski/agency-agents | agent 按 domain 分目录，install.sh 清单安装 |
references/wshobson.md |
wshobson/agents（Marketplace） | plugins 多域结构，符号链接惯例 |
references/mattpocock.md |
mattpocock/skills | 按 domain 分目录，link-skills.sh |
接入新仓库
当用户说「我新 clone 了 XX 仓库」「想接入 XX 仓库」、或提出一个新的 skill/agent 来源时：
- 确认来源：
git -C <仓库路径> remote -v - 摸清结构：目录结构、命名约定、安装机制（复制 vs 符号链接）
- 建档案：在
references/下新建档案文件（按作者或仓库名命名，仿照现有三个档案的格式：基本信息/目录结构/安装机制/坑位/已知实践） - 登记：在上表加一行
- 更新 description：把新仓库加入 frontmatter
description的「已接入」列表（保持触发精准）
通用内核不动——仓库差异全走档案，加仓库 = 建档案 + 表格一行 + description 补一个名字。
通用流程（七步）
① 盘点本地现状
先摸清本地已有什么，不凭记忆：
- 用户级：
ls ~/.claude/agents/、ls ~/.claude/skills/、ls ~/.claude/plugins/ - 项目级：
ls <repo>/.claude/agents/、<repo>/.claude/skills/ ls -la识别符号链接来源（->指向即溯源到对应仓库）- 区分「用户级」与「项目级」作用域
② 识别候选来源
- 确认仓库路径存在：
git -C <repo> remote -v - 识别增量：
git -C <repo> log --diff-filter=A --name-only --since="90 days"找近期新增的 skill/agent，对照references/<仓库>.md的「已知实践」区分哪些是新增、哪些早已装——只评估新增项，不重推旧清单 - 弄清目录结构、命名约定、安装机制（复制 vs 符号链接）
- 对照对应仓库档案
references/<仓库>.md
③ 查重
先识别本地已装，再推荐——不重复推荐已装的同源项。
- 符号链接安装的：
readlink <链接>识别已指向某仓库（已装），新候选对照跳过 - 复制安装的：readlink 查不到，对照
references/<仓库>.md档案与本地文件命名习惯判断来源（如engineering-*.md源自 msitarzewski） - 新候选逐个对照
~/.claude/与项目.claude/跳过重复
④ 基于真实需求三档筛选
判断依据是用户真实项目栈（扫描 /var/www 等实际项目判断方向），不是「以后可能用到」：
- 保留：与用户核心栈匹配（Python 后端 / LLM / API / DB / DevOps / 代码质量 / 文档 / git）
- 待定：边界情况，列出倾向交用户定夺
- 建议删：扫描确认无对应项目/方向（如 PHP/CMS、移动/小程序、区块链、嵌入式、网络、ITIL、合规/渗透等用户不碰的）
⑤ 提问澄清
拿不准的先问用户，一次只问一个问题，根据回答持续追问，直到 95% 理解真实需求再给方案。涉及删除前先复述理解让用户确认。
⑥ 军师出方案，主公定夺
给出推荐方案（含理由），用户三选一或修改后确认，不擅自执行删除/安装。
⑦ 备份安装验证
覆盖/删除前先备份：统一用
mkdir -p ~/.claude/backups/<日期>+cp，不用mv xxx.bak等临时改名方式选择安装方式（须用户拍板）——给出两种方式对比，让用户明确选择，不擅自替用户决定：
方式 优点 缺点 适合 符号链接 仓库更新自动传播，无需重装；省磁盘 依赖仓库路径存在，仓库移动/删除会断链 仓库长期稳定、想省维护 复制文件 完全独立，不依赖仓库路径，永不断链 仓库更新需手动重装；占磁盘 仓库可能变动、图省心 默认推荐符号链接（多仓库开发者、更新自动传播），但以用户选择为准。
按所选方式安装：
- 符号链接：
ln -s <源> <目标>（若仓库官方脚本有软链选项如install.sh --link，优先用官方参数） - 复制文件：
cp -r <源> <目标> - 具体源路径/官方机制见对应仓库档案
references/<仓库>.md
- 符号链接：
验证：确认文件存在且非空；符号链接则
readlink确认目标存在、目标目录有SKILL.md
克制原则
- 不为了装而装；本地已有同类型不推荐
- 符号链接 vs 复制：安装方式由用户选择——给出对比后让用户拍板，不默认替用户决定；链接省维护但依赖仓库路径存在、会断链，复制稳定但更新需手动重装
- 删除前必备份；判断靠真实需求，不靠猜测
- 拿不准就问，一次一问，追问到理解再动手