msp skill · version 0.2.4 · source-backed
Hermes MSP Skill 不是一个命令，是一组会生长的 procedures。
它把 gong 对 MSP 的 owner intent 落成可执行的 Hermes skill：先用最小 seed anchor 建立项目注意力，再用 seed folding 把过早展开的未来复杂度压回启发式。
核心逻辑：seed it till it grows
answer first · MSP second
01 · Owner intent
先保存人类高权威判断
`hello_agent.md` 存 owner seed；agent 的理解只能先作为草案，不能偷换成 owner truth。
02 · Attention routing
判断当前该细写还是该折叠
当前事实、路径、约束真实展开；早熟计划、未来架构、低证据高细节折叠为短 seed。
03 · Grow by feedback
让真实反馈决定什么 grow
MSP 不追求大而全计划；先保留可生长位点，再由任务、artifact、human feedback 推动 seed iteration。
当前稳定的两个 procedures
narrow implementation · growable root
A
Seed anchor generation
当用户要给 project / folder 做 MSP 初始化时，生成合适层级的 seed anchor。
- 完整 MSP project：默认 `hello_agent.md`
- 普通非独立 folder：默认 `seed.md`
- 不写成 README / roadmap / spec
点击看具体流程
触发“seed 一下这个项目”“给这个 repo 写 hello_agent.md”“这个子目录需要一个 seed”。
读取先读 skill 的 seed.md 和项目级 /Users/cms/msp4agent/hello_agent.md，再读目标目录证据。
判断目标是完整项目入口，还是项目内部普通目录；已有 owner seed 时不静默覆盖。
产物短 seed anchor：owner intent、当前边界、少量未来 seeds；不写成完整计划书。
B
Seed folding docs
当文档过早展开、锁死未来、污染 agent 注意力时，做局部折叠。
- 保留当前必须知道的信息
- 把未来复杂度压成短 seed
- 不是删除未来，也不是 full MSP rewrite
点击看具体流程
保留展开事实、路径、接口、约束、owner 高权威判断、当前执行必需信息。
折叠成 seed过早确定、注意力错位、低证据高细节、会锁死未来的内容。
避免不为了 folding 重排整篇；不重写 raw transcript / owner 原话；不把 seed 变 checklist。
为什么这样设计：让 skill 像种子，不像模板库
compact by default · expandable on demand
1 · 为什么不是一个“大而全 MSP 指南”？
因为 MSP 的危险不是信息太少，而是 agent 过早把模糊方向写成确定架构。主 SKILL.md 只保留高频稳定 procedures；复杂案例放进 references/，需要时再展开。
这样可以保持加载成本低，也避免每次回答都被一套宏大理论牵着走。
2 · 为什么区分 hello_agent.md / seed.md / seed 注释？
命名本身是在给 agent 分配注意力权重。hello_agent.md 表示项目级握手，需要 owner 战略注意力；seed.md 只是目录级局部锚点；<!-- seed: ... --> 是文件内的最轻提示。
如果所有东西都叫 hello_agent，agent 会误判层级，把普通目录当成独立项目。
3 · 为什么需要折叠语法和 casebook？
网页应该给人看“是什么、为什么”，但不要把首屏塞满。折叠块让普通读者先抓核心，agent / team member 可以点击查看流程、边界和反例。
同理，skill 更新也需要典型 case / 边界 case / 理想答案：它们是 router 的训练集，能把抽象原则落成稳定动作。
4 · 为什么 answer discipline 还只是 future procedure？
“MSP answer”很重要，但还需要更多真实问答样本来稳定：什么时候直接回答，什么时候 seed，什么时候折叠，什么时候不要把 coding request 偷换成 seed work。
在样本不足前，先承认它是 future procedure，避免把未稳定能力伪装成成熟流程。
需要什么 case 数据来继续更新 skill？
typical / boundary / ideal answer
最有价值的数据不是长理论，而是一组“输入 → 理想动作 → 为什么”的小样本。10–30 个就能显著稳定 skill 的 router。
case shape
典型 case
用户明确要求初始化项目、生成 seed、折叠文档、搬动 delivery surface。用于固化主流程。
边界 case
软链、已有 owner seed、项目级/目录级混淆、用户其实要 coding 不是 seed。用于防误伤。
理想答案
给出 agent 应该怎样短答、是否动手、改哪些文件、哪些不改，以及验收方式。
点击看推荐记录格式
case_id: seed-anchor-folder-vs-project-001
user_input: “给这个 folder 做 MSP 初始化”
context: 目标是项目根 / 普通子目录 / symlink / 已有 seed
ideal_action: 读 source chain → 判断层级 → 写 hello_agent.md 或 seed.md → patch 引用
ideal_answer: 1-3 句说明改了什么、核心判断、边界
pitfall: 不要全局替换 hello_agent；不要覆盖 owner seed
命名层级：不要把普通 folder 伪装成独立项目
hello_agent.md / seed.md / seed:
Project-level
`hello_agent.md` 是项目级 Seed Proposal：定义项目灵魂、核心问题、长期方向和全局约束。
Folder-level
`seed.md` 是普通目录/模块的局部上下文锚点：说明局部目标、边界和少量 seeds。
File-level
`seed:` 注释 是最轻量的局部启发：折叠非主线问题，留下未来可接回的启发式线索。
policy
越靠近项目根部，越需要 owner 的战略注意力；越靠近具体文件，越应该轻、短、自然、灵活。
Source chain：skill 的权威读取顺序
避免漂亮但漂移
1 · Skill seed
`/Users/cms/.hermes/skills/note-taking/msp/seed.md` 保存这个 skill/folder 的局部 owner intent。
2 · MSP origin
`/Users/cms/msp4agent/hello_agent.md` 是 MSP 概念源头，但 lifestory 不是普通模板。
3 · References
`references/` 保存边界、反例、seed folding 判断标准，避免主 SKILL.md 过重。
Guardrails：这个 skill 不做什么
anti-drift
应该做
- 保留 `msp` 作为可生长 skill set 母体
- 让每个稳定 procedure 有硬触发、流程、产物、验收
- 用最短必要 seed 保留未来可生长性
不要做
- 把 `msp` 缩成只会写 hello_agent 的单功能工具
- 把 seed 写成迷你 spec / checklist / hidden roadmap
- 覆盖 owner seed、raw trace 或人类原话