本页目录

规范 · 概览

协议接触面，2026-05-07 冻结于 v1.0。

状态

v1.0，2026-05-07 冻结，到 v2 之前不会再有破坏性变更。实现覆盖 v1 规范约 75%。

协议里的七件事

1. Atoms

知识的最小单元。28 种 kind 分布在 5 个层（Data / Behaviour / Composition / Style / Meta）。每个原子都要声明自己的 id、version、对应 kind 的 body 字段，以及一组出边。

14 个带类型的 verb：related、requires、enhances、 validates-with、contradicts、specializes、 conflicts、extends、derived-from、 compatible、supplies-to、see-also、 includes、relationships。每个 verb 都规定了允许的源 kind 和目标 kind，L3 跨原子检查器靠这些语义做推理。

3. Projection

每个原子会渲染成三种 Markdown 视图：summary（约 30 token，常驻 index）、core（约 150 token，命中相邻原子时加载）、full（约 380 token，直接命中时加载）。chunker 是 kind-aware 的——一条 rule 的 summary 就是它的 claim，一个 method 的 summary 就是它的 goal。

4. 组合契约

method、persona 或 scope 上的 contract 块声明了三件事：父原子加载时必须一起加载哪些原子、必须排除哪些原子、哪些是有条件强制加载的。contract 由运行时来解，agent 不参与——所以 agent 拿到的总是一个"构造完整"的集合。

5. Registry 契约

一个 Prime 以 tarball + manifest 的形式发布。任何实现下面这三条 HTTP 路由的服务都能当 registry：POST /publish、GET /pack/:scope、GET /pack/:scope/:version/tarball。prime publish 和 prime install 是这套契约的客户端，参考实现是 @skill-wiki/registry。

`_index.xml` 格式

始终常驻上下文的索引文件。每个 domain 一个 <cluster>，里面的每个 <atom> 项给出 id、kind、tokens（full 投影的 token 数）、q（质量分），以及若干 <edge> 子节点。

投影层级由 agent 自选

agent 通过 MCP 工具的 level 参数决定加载哪一种投影。检索驱动的轮次通常对选中的原子加载 core，聚焦的轮次加载 full。summary 永远不需要单独加载——它本来就在 index 里。

协议刻意不规定的事

Skill Wiki 是领域无关的，下面这些协议都不管：

你的领域用哪些 kind。从 28 种里挑，剩下的在你的 corpus 里就当不存在。
L1 阶段抽哪些 intent 字段。那是领域插件的活。
L5 阶段怎么校验生成结果。同样是领域插件的活。
怎么检索。参考实现走的是 6 轴排序，其它实现可以用别的。

关于这条边界的细节，详见领域插件。