Background

§5.9.B 要求涉及 API 调用的改动先查 gc-api-doc 参考仓（git@gitcode.com:gitcode-cli/gc-api-doc.git）确认端点/path/body。但当前 gc-api-doc 是外部独立仓，每次查证需临时 clone（约 120s，6.0M），门槛高，导致：

• AI 代理倾向跳过查证直接类比 GitHub CLI 或猜语义——这正是 release list bug 前次修复（#256）不彻底的根因：没查 direction 参数就修成 sort.Slice，只排了已返回数据
• 新环境/新会话每次重新 clone，重复劳动

刚合入主干的 PR #464 正是靠 §5.9.B 查 gc-api-doc 确认 direction 参数才修对。降低查证门槛能预防类似"修不彻底"。

Proposal

将 gc-api-doc 作为 git submodule 引入仓内 api-doc/ 目录：

• git submodule add git@gitcode.com:gitcode-cli/gc-api-doc.git api-doc
• 生成 .gitmodules + gitlink，git submodule update --init 即可本地获取，无需每次 clone
• 版本锁定：submodule 锁定特定 commit，确保团队查证一致

Acceptance Criteria

• api-doc/ submodule 引入，.gitmodules 配置正确，git submodule update --init 可用
• spec/governance/source-of-truth-matrix.md 补 gc-api-doc 行，注明 submodule 副本定位 + 时效约束（锁定 commit，需定期 sync）
• AGENTS.md §2.1 顶层目录表加 api-doc/ 行
• AGENTS.md §2.3 + §5.9.B 路径说明更新（优先用 api-doc/ submodule，仓不可达时 fallback 临时 clone）
• sync 约定：spec 说明定期 git submodule update --remote api-doc + 发版前确认最新
• 验证打包不误包含：goreleaser archives、Dockerfile、package.sh 均不含 api-doc/
• 单元测试不涉及（纯配置 + 文档改动）
• 本地门禁通过（build、pre-commit、regression-core）
• 文档同步 spec/governance + AGENTS

调研结论（已确认）

• gc-api-doc 仓 6.0M（含 .git 756K），submodule 增量可接受
• 打包配置天然排除 api-doc/：goreleaser archives 只打包 LICENSE/README/completions+二进制（.goreleaser.yaml:59-63），Dockerfile 只 COPY gc+completions，package.sh 打包二进制产物
• spec 无 submodule 规则（§9 需用户确认——已确认推进）
• source-of-truth-matrix.md 未列 gc-api-doc（治理空白，本次补）

时效风险与缓解

submodule 锁定特定 commit，但 gc-api-doc 是"权威真相源"——API 文档随 GitCode 平台更新。锁定旧 commit 可能查到过时端点。缓解：

• spec 约定定期 git submodule update --remote api-doc（如每月或发版前）
• 查证时若端点与实测行为不符，优先以远端平台实测为准（source-of-truth-matrix 优先级第 3）

Scope

scope/docs, scope/api, type/refactor, risk/low

Refs

承接 §5.9.B 横切编排资产；release list --limit bug 修复（PR #464）印证查证价值。