pi 文档基建升级：导航清单校验进入测试套件，发布指引沉淀为仓库技能

2026 年 9 月 9 日合入 pi 编码代理的两个 PR 都不碰代理运行时，而是冲着文档与发布流程去的：christianklotz 的 #9380 为文档站点的导航清单加上了测试套件内的校验层，davidbrai 的 #9370 则把交互测试与发布指引抽取成仓库技能。与之前几批一样，两者都停在主线上，要等 v0.85.1 之后的下一个 release 才会进入 npm。

#9380 把 packages/coding-agent/docs/docs.json 提升为文档站点带版本、可递归的导航清单。coding-agent 测试套件如今会校验导航结构、页面路径、重复 slug、Markdown 本地链接，以及从导航根出发的可达性——坏链接与够不着的页面会在上线前把检查打红。文档评测用例改为直接从每个 Markdown 文件中发现，与导航无关，评测语料不再依赖页面是否还挂在导航树上。

#9370 在 .pi/skills/ 下新增 interactive-testing.md 与 release.md 两个技能文件，AGENTS.md 也一并改动。release 技能把过去的口头约定落成文字：全包锁步版本（patch 对应修复与新增，minor 对应破坏性变更，不发 major）、发布前必须跑 /cl 变更日志审计、在仓库外的 tmux 会话里分别驱动 Node 与 Bun 两种发布产物做本地冒烟测试，以及发布链路本身——推送 tag 触发 GitHub Actions OIDC 的 npm 可信发布，R2 中的已验证标记支撑着 pi.dev/api/latest-version。interactive-testing 技能是它的搭档：一套受控的 tmux 工作流，用于 TUI 行为检查与发布冒烟测试，并明确写下「仅启动成功不算冒烟通过」。

文档类合并很少登上 release notes 的头条——完整的校验套件与两份技能全文，可在 GitHub 上的 #9380 与 #9370 页面查阅。