
所有数据 2026-09-25 核实。文中涉及的治理工具已开源 lggyx/lggyx-agent-arch28 个测试通过2,163 行问题多 Agent 技能归属失控如果你同时使用多个 AI 编程 Agent大概会遇到这种情况~/.hermes/skills/ 62 个按分类目录组织 ~/.claude/skills/ 9 个平铺 ~/.config/opencode/skills/ 4 个另一套 ~/Downloads/某个技能/ 3 个不知道什么时候复制的这不是我编的示例是 lggyx-agent-arch README 里描述的真实状态。随之而来的是四个问题同一个技能装了多份改了一处另外几处还是旧的分不清哪些是自己写的、哪些是第三方装的想开源或分享时不敢动手换台设备就要重装一遍装完发现版本还不一样不知道某个技能从哪来原作者更新了无从跟进外部案例可以看 Stride 在 2026-09-15 发的事故记录一台 Mac 上413 个 SKILL.md约 60 个是自己写的分散在 4 个 Agent 下同一技能最多 4 份拷贝移动技能文件夹后产生106 个死路径表现为Agent 加载了技能但打不开技能指向的文件且不报错。根因Agent Skills 格式统一目录未统一按 Anthropic Agent Skills overview2026-09-25 核实原文name最多 64 字符只能小写字母、数字、连字符不能含 XML 标签和保留词description必填最多 1024 字符必须同时说明做什么和何时用三级渐进加载启动时只把 name description 放入 system prompt未触发前不占更多上下文四个主流 Agent 都读这个格式但目录各不相同据 Stride Note2026-09-25 核实Agent技能目录Claude Code~/.claude/skills/、项目内.claude/skills/OpenCode~/.config/opencode/skills/、~/.claude/skills/、~/.agents/skills/Hermes Agent~/.hermes/skills/skills.external_dirsPi仅--skill path显式传入于是只有两种选择拷贝→ 必然分叉。Stride 的同一技能 4 份拷贝就是终点。软链→ 路径一动就断且静默失败。现有工具的边界逐个查证2026-09-25后现有方案分三层层代表解决什么不解决什么记忆Mem0、neural-memory、MemorySync、MCP Memory Keeper同一个 Agent 跨会话记得你不碰技能配置CC Switch9 工具 / 50 provider 预设单设备多 Agent 配置不打架不做跨设备能力继承能力继承本文方案换设备/换 Agent技能原样带过去—相关但方向不同的工作hive 模式Munder Difflin单会话内多 Agent 共享技能目录skill 注册表AllenMuu/skill-manager等早期阶段未涉及 git 继承方案单一真源 零拷贝引用架构两个 git 仓库能力与上下文分离六部~/shared-brain能力层技能唯一真源。本机实测 12 个技能、54 commit。识海~/life-os上下文层项目进度/日程/身份/内容产出。一文一武六部管用什么干活识海管在干什么。零拷贝实现Hermes 通过skills.external_dirs指向外部库本机配置~/.hermes/config.yaml2026-09-25 实测external_dirs: - ~/shared-brain/skillsClaude Code OpenCode 组合一条软链即可OpenCode 的搜索路径原生包含~/.claude/skills/ln -s ~/shared-brain/skills ~/.claude/skills为什么不能用拷贝两个原因拷贝必然分叉多份同名技能无法判断哪份最新Hermes curator 会定时清理——据 Stride 记录其配置stale_after_days: 30、archive_after_days: 90、interval_hours: 168拷进~/.hermes/skills/的副本可能被自动删除。external_dirs 指向外部库可避免治理工具scan → classify → relocatelggyx/lggyx-agent-arch 把上述流程工具化Agent 执行、人做归属决策第一步scan.py只读424 行遍历所有已知 Agent 的技能位置采集frontmattername / description软链状态体积、内容指纹同时标出两类问题重名技能按 frontmatter name 分组区分「内容完全相同」真重复与「版本已分叉」需决定留哪份缺 SKILL.md不符合 agentskills.io 规范的目录python3 scripts/scan.py -o inventory.json第二步classify.py只读413 行启发式预分类个人原创 / 第三方 / 官方自带。只输出清单不改文件。python3 scripts/classify.py inventory.json -o review.json $EDITOR review.json # 给要处理的项加 confirmed: true第三步relocate.py371 行默认 dry-run把技能迁入真源仓库、原位置改为软链并生成回滚脚本。python3 scripts/relocate.py review.json --repo ~/skill-repo # dry-run python3 scripts/relocate.py review.json --repo ~/skill-repo --apply # 执行不加--apply绝不改动任何文件。执行后生成log/undo.sh。安全设计针对移动技能文件夹导致 106 个死路径这个真实事故工具做了三层防护relocate.py默认 dry-run执行后生成log/undo.sh回滚脚本README 硬约束「凡是涉及删除、移动、覆盖的操作一律先问我」实测$ python3 -m unittest discover tests Ran 28 tests in 0.022s OK2026-09-25clone 后实跑。代码 2,163 行scan 424 / classify 413 / relocate 371 / bootstrap 397测试 475 行同步 hook 83 行同步机制monitor cron多设备场景下同步不能靠人肉也不能每小时烧 token。用 monitor 模式每小时 cron → sync-check.sh只 git fetch不拉取 ├─ 无输出无新提交→ 静默结束Agent 不启动零 token └─ 检测到新提交 → 唤醒 Agent → git pull --ff-only → 汇报关键是脚本无变化时必须无输出否则 monitor 每次都会判定为有变化而启动 Agent。本机实测2026-09-24 创建至 25 日已自动拉到并汇报其他设备的提交。事故复盘我改正的三个错误写这篇文章时核对公开数据发现自己原稿有三处不实原稿实际原因11 个技能12 个漏数_office目录跨 4 个 Agent 运行时本机只装并验证了 Hermes 一个把设计支持当成已验证跑了一段时间54 commit、12 技能、cron 连续运行模糊表述无法验证宁可少写不可虚写。文章里的数字都应该经得起读者复现。小结Agent Skills 解决了格式没解决归属。三层边界记忆Mem0 们让 Agent 记得你配置CC Switch让多 Agent 配置不打架能力继承本文换设备换 Agent技能原样带过去实现门槛很低两个git init、一条external_dirs、一次技能盘点。治理工具已开源clone 下来把 PROMPT.md 里那段话发给你的 Agent它会带你扫一遍。参考来源内容来源Agent Skills 格式规范Anthropic Agent Skills overview四 Agent 目录表 / 413 文件事故 / curator 参数Stride Notestars 数据anthropics/skills 178,011★ / obra/superpowers 291,286★GitHub API 实测CC Switch 能力清单farion1231/cc-switchMem0 定位mem0ai/mem0neural-memorybswen 博客MemorySyncmemorysyncio/memorysync-cursor-starterMCP Memory Keepermkreyman/mcp-memory-keeperhive 模式Munder Difflin治理工具lggyx/lggyx-agent-arch