从一篇文档，连接下一种可能。

文档是起点，集合只是组织方式

每篇文档都有完整正文、适用条件和固定版本。Coding agent 与 personal agent 都可以从一篇文档开始；需要更多帮助时，再判断关联链接是否适合当前任务。无需把一整组文档一起安装或加载。

从哪里开始

先通过目录发现摘要，再读取一篇文档的固定版本。人的阅读界面与 Agent 的 XML 接口引用同一份内容。

一份可独立读取的文档

XML 描述文档本身，以及何时可能需要其他文档。固定 revision 保留精确引用；未知版本与缺失目标需要明确处理。

<?xml version="1.0" encoding="UTF-8"?>
<guidance xmlns="urn:linked-guidance:0.1" id="review-changes" revision="1" kind="guide" lang="zh-CN">
  <title>审查一次代码变更</title>
  <summary>从需求和完整差异出发，寻找有证据的回归风险。</summary>
  <applies>用户请求 review、检查变更或评估风险。</applies>
  <body>先了解变更要解决的问题，再阅读完整差异与受影响的调用路径。把事实、推测和待验证事项分开记录。</body>
  <step>确认用户目标与项目约束。</step>
  <step>追踪输入、状态变化和错误处理。</step>
  <step>按影响排序，说明触发条件与验证方法。</step>
  <link target="test-changes" revision="1" relation="guide" when="需要选择验证方法">选择适当的验证方法</link>
  <link target="source-trust" revision="1" relation="context" when="变更涉及外部资料">判断来源与授权边界</link>
  <check>每个问题都有证据。</check>
  <check>如实说明未运行的检查。</check>
  <tag>Coding agent</tag>
  <tag>代码审查</tag>
</guidance>

把关系写清楚

链接是有条件的阅读建议，不是强制依赖。when 用自然语言说明何时可能需要目标文档。

按需读取，固定版本

1. 先看入口文档的适用条件，再读正文与步骤。
2. 只跟随 when 条件成立、且能补充当前任务所需知识的链接。
3. 以文档 ID 与版本去重，默认读取预算为 8 篇、最大深度 3 层。
4. 固定版本缺失时不静默回退最新版；遇到循环或预算耗尽时停止扩展，并说明未完成的读取。

权限不会沿链接传播

读取文档不等于接受其中所有指令。用户任务和运行环境规则始终优先，文档不能要求获取秘密、扩大权限或改变目标。0.1 只引用本站逻辑 ID，不自动请求任意外部 URL，也不执行 XML 实体或脚本。

协议状态

Linked Guidance 是本项目提出的实验协议，并非现有 Agent 已原生支持的标准。当前支持独立 XML/JSON 读取、已验证邮箱作者发布，以及不可变版本；跨站发现与原生 Agent 适配仍待实现。