真相源矩阵

本文档定义 gitcode-cli 仓库中不同信息类型的真相源、适用边界和判定优先级。

职责

信息类型	真相源	可否直接判事实	说明
项目正式规则	`spec/`	是	项目规则唯一正式来源
命令行为	`docs/COMMANDS.md`	是	`gc` 命令行为唯一真相源
测试、门禁、评审规则	`spec/foundations/`、`spec/workflows/`	是	包括测试、状态机、门禁、评审边界
构建与打包规则	`spec/delivery/*`	是	当前本地构建与打包规则以此为准
AI 共享场景定义	`.ai/skills/*`	有条件地是	只对共享 skill 场景定义生效，不得覆盖 `spec/`
项目入口导航	`README.md`	否	入口文档，不是规则源
AI 客户端入口	`AGENTS.md`、`CLAUDE.md`	否	入口文档，不是规则源
外部项目 AI 使用说明	`docs/AI-GUIDE.md`	否	只服务外部项目通过 AI 使用 `gc`
外部通用 skill 分发	`.ai/distribution/gc-core/*`	否	只服务外部项目复用，不定义本仓库开发规则
项目阶段说明	`issues-plan/PROGRESS.md`	否	可能滞后，只能作阶段说明与背景参考
单个 issue / PR 的实时状态	GitCode 远端 issue、PR、label、comment	是	远端平台是实时事实源
是否已主干合入	merged PR + `origin/main`	是	不能只看 issue 状态、comment 或 release 文案
CI 运行状态与结果	GitHub Actions run（通过 `gh run view` 获取）	是	CI 结论是自动化事实；失败原因分析需人工/AI 判断
CI 工作流定义	`.github/workflows/ci.yml` + `spec/delivery/ci-workflows.md`	是	workflow 文件定义 CI 行为，spec 定义 CI 规范

当不同文档或信息源出现冲突时，按以下顺序理解：