菜单
跨系统借鉴设计 —— 当用户说"用 X 系统的成熟设计改 Y / 借鉴上游参考实现 / 把 Y 的 Z 机制搬过来 / 跨 agent 升级 / 上游设计 port 到本机"时触发。覆盖"先深度对位(现状摸底 × 上游 reference × 缺口矩阵)→ 提炼设计原则(每条标上游 file:line)→ 产出 1000+ 行 PLAN.md(分阶段 + schema 草稿 + 验收清单 + 协同点)"这个 class 的工作。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Diagnose and fix the dual-channel memory problem in Hermes Agent — when `memory.provider: holographic` (or any external provider) is configured but the agent keeps writing only to `memories/MEMORY.md`, bypassing it. Covers why agents default to the markdown file, the four root causes of routing failure, and three remediation options (SOUL.md rules / disable MEMORY.md / mirror via code). Triggers on 'memory 不生效', 'holographic 没在用', 'agent 都写到 MEMORY.md', '双 memory 系统', 'memory tool vs fact_store', 'on_memory_write', 'memory drift', 'Mirrors 不到', or any 'why is my agent ignoring the configured memory provider' question.
Use when the user works inside ~/Projects/Config/Guix-configs and mentions '改 dotfiles', 'blue home', 'guix system reconfigure', 'shepherd service', 'stow 死链', 'blue stow', 'AGENTS.md 翻新', 'fcitx', 'IME 没输入法', 'Electron 没输入法', 'wireplumber', '二轨 dotfiles', '恢复被删除的 dotfiles', or related. Ten sub-protocols — dotfiles deploy verification, worker delegation, multi-line edit safety, Guix service debugging, GNU Stow mutable config, restoring deleted dotfiles, ISO 移植, 需求澄清, 模块归属陷阱.
跨 agent KB 健康度维护。**触发信号**：每周/长会话后例行维护 / 卡片 >50 张 / 检索质量明显下降 / 用户触发 `/agenote-curate` / 发现重复卡片或矛盾结论 / 新增了对话抽取源。**当上述任一信号出现时立即调用本 skill** 做健康检查+去重+归档+权重重分配+reconcile 多源 memory。基础用法见 `agenote-base`；会话中单次经验记录见 `agenote-review`。
Maintain the personal Guix channel at ~/Projects/Config/jeans (Just Enough AI-geNerated Slops). Use when the user asks to "fix the CI build failure issue", "升级 X 包", "add a package", "check upstream updates", "跑 maak upgrade", "修复 auto-update 流水线的 issue
How to author a Hermes Agent skill the right way. Covers the two non-negotiable structural principles every skill must follow — **self-contained** (all runnable artifacts ship inside the skill directory so backup = usable) and **progressive disclosure** (SKILL.md is a thin router; details live under `references/`, `templates/`, `scripts/`) — the directory layout, file-type rules, decision trees for what goes in SKILL.md vs. a support file, **which of the 12 existing categories a new skill belongs to (never top-level `<skill-name>/`)**, and a checklist before declaring a skill done. Trigger when: writing a new skill, refactoring an existing skill's structure, wondering 'should this go in SKILL.md or references()' / 'which category directory should this skill live into', preparing a skill for backup/share, noticing a self-contained violation, or auditing existing skills. Also trigger when the user complains something is 'too verbose' or 'in the wrong place' — those are progressive-disclosure violations.
When the user says '校对文档 / 检查文档是否还有效 / sync doc with code / 扩写 README / 改写文档 / 把这个 PLAN/plan/任务书做成文档 / 文档并入主文档', or when a `refs/*.md` document may be drifting from the tool/CLI/源码 it describes, or when a PLAN file needs to become a user-facing reference doc. Covers three entry points — check, rewrite, plan-to-doc — backed by a `scripts/doc-check.py` checker that catches silent drift between a doc and its source-of-truth (CLI flags, MCP tool names, file paths). Trigger when the user names a doc path and asks whether it's still accurate, when adding a new CLI/MCP/API surface that old docs don't mention, or when a PLAN/任务书/thread needs to graduate into a stable reference.
| name | cross-system-borrow-design |
| description | 跨系统借鉴设计 —— 当用户说"用 X 系统的成熟设计改 Y / 借鉴上游参考实现 / 把 Y 的 Z 机制搬过来 / 跨 agent 升级 / 上游设计 port 到本机"时触发。覆盖"先深度对位(现状摸底 × 上游 reference × 缺口矩阵)→ 提炼设计原则(每条标上游 file:line)→ 产出 1000+ 行 PLAN.md(分阶段 + schema 草稿 + 验收清单 + 协同点)"这个 class 的工作。 |
| tags | ["design-borrow","cross-system","port","architecture-migration","plan-doc"] |
| metadata | {"hermes":{"tags":["design-borrow","cross-system","port","architecture-migration","plan-doc"],"related_skills":["codebase-scout","task-planner","architecture-advisor"]}} |
你负责把上游参考实现(可能是另一个 agent、另一个工具、另一个 fork)的 成熟设计,有结构、有取舍地借鉴到本机目标系统。这不是简单的"抄一抄", 而是经过对位分析、缺口识别、原则提炼、阶段拆解,产出一份 1000+ 行的 设计文档 + 可执行的分阶段实施计划。
grep 或 find 校验所有引用。| 场景 | 上游参考 | 本机目标 |
|---|---|---|
| 借鉴 agent 体系 | MiMoCode/actor/ | 本机 atelier 扩展 |
| 借鉴记忆体系 | MiMoCode/memory/ | 本机 agenote + kb |
| 借鉴 skill 注册 | MiMoCode skill/discovery.ts 远端 pull | 本机 ~/.config/agents/skills/ |
| 借鉴 review 流程 | opencode superpowers code-reviewer skill | 本机 code-reviewer skill |
| 借鉴 patch 工作流 | opencode patch.ts 工具 | 本机某个 patch 工具 |
通用判定:当用户说"X 系统的设计很好,把它搬过来 / 借鉴过来 / 升级本机的 Y", 而不是"重做 Y"或"看 X 怎么做的"时,触发本 skill。
用 codebase-scout 风格深度读,先上游后本机,两边都要"看代码"而不是
"看 README"。
*.ts 接口、关键算法(50-500 行/文件)。
至少读:入口 + schema + 主要实现 + 一个测试。看真实实现,
别只信 README 里的"5 大原则"。侦察产出:对本机每个子系统,给出一份"能力 × 现状 × 已知痛点" 的三栏表(每栏 1-2 行)。不是文件列表,是"能做什么 / 怎么做的 / 缺什么"。
画一张二维表:行 = 上游能力 × 列 = 本机能力 × 单元格 = 三态(✅/⚠/❌)。
每个 ❌ 项必须有具体出处:
packages/xxx/yyy.ts:行号-行号本机路径:行号-行号反模式:只说"上游有 X,本机缺 X"——必须说出 X 具体是什么、出处在哪、 本机的 workaround 是什么、缺它的具体损失是什么。
不是直接照搬实现,而是提炼原则——"为什么上游这样做"。
每条原则结构:
file:line(具体哪段代码体现了这个原则)原则数量控制在 5-9 条。多了记不住,少了对位不够。
骨架(每节标题固定,不要创新):
0. 现状摸底(日期标注)
1. 目标(Outcome) — 4-7 项
2. 设计原则(从上游提炼,5-9 条)
3. 架构图(目标态,ASCII art 即可)
4. 实施阶段(每阶段独立可交付,5-11 阶段)
5. 改动清单(具体文件路径,新增/改动/不动)
6. 风险与缓解
7. 上游参考实现索引(file:line 分类)
8. 落地步骤(PR 粒度,每 PR 可独立验收)
9. 暂不做(防 scope creep)
10. 审核检查清单
11. 变更日志
如果文档很大(如本机会话中的 PLAN.md 后续追加了 12-23 节),用 "# 第二部分" / "# 第三部分" 切分,每部分独立"现状摸底 / 实施阶段 / 改动清单"。
每阶段固定结构:
# 1. 提取所有 file:line 引用,逐个验证存在
grep -oE '/path/to/[A-Za-z0-9./_-]+:[0-9-]+' PLAN.md | sort -u | while read line; do
path="${line%:*}"
test -e "$path" || echo "MISSING: $line"
done
# 2. 验证行号范围真实存在(找最大行号)
file_lines=$(wc -l < "$path")
[[ $max_line -le $file_lines ]] || echo "BAD LINE: $line"
# 3. 反引号包裹的"整段路径"是文档语义,不是真的路径(grep 要去掉反引号内的)
反模式:
file.ts:42 —— 可能是 43 或 44一次完整的 cross-system-borrow-design 会话,产出 4 件东西:
dry_run=true,首次跑给用户审核checkpoint.ts 不会在 README 里讲清楚/skill codebase-scout 先扫双方现状(本 skill 的 Step 1)/skill task-planner 给本 skill 的 Step 4 套骨架
(本 skill 已给出固定 11 节骨架,直接套用)/skill architecture-advisor 在 Stage 3 原则提炼
之后做一次"原则是否合理"的二次审视~/Documents/Org/experiences/,本 skill 不主动写references/plan-md-skeleton.md —— 完整的 11 节骨架 + 字段约定,
copy-paste 即可起新文档references/capability-matrix-template.md —— 缺口矩阵的 markdown 模板references/file-line-validation.md —— grep 校验脚本片段