用途:当有人初次接触该仓库、需要可靠地完成一次安装配置、基线检查与术语梳理时使用。在用户还不清楚这个仓库是什么、如何安装、当前检出中哪些命令应当可用时,应先于 worktree 技能使用。
首要目标:立即区分两件事——在本仓库中开发 mainline 代码库,以及使用 mainline 去管理另一个目标仓库;不要让用户把两者混为一谈。
先读资料:在做出任何判断前,先阅读 README.md、docs/install.md、docs/FLOWS.md、SPEC.md、PLAN.md、AGENTS.md、CONTRIBUTING.md。
贡献者基线:在仓库根目录运行 make build、go test ./...、./bin/mq --help、./bin/mq repo show --repo . --json、./bin/mq repo root --repo . --json、./bin/mq status --repo . --json。解读:make build 应成功;go test ./... 应成功,测试辅助程序会为临时仓库有意中和全局 Git 签名配置;mq repo root --repo . --json 是判断当前检出是否为规范受保护根检出的唯一依据;在全新源码克隆中,mq status --repo . --json 可能失败,直到本机已将该仓库显式初始化为受管理的队列目标。
规范根说明:main 上的仓库根检出是规范受保护根检出,主题工作树才是功能开发发生的地方;若当前检出不是规范根,贡献者应明确说明;若 mq repo root --repo . --json 返回 trustworthy: false,应解释建议操作,而不是假装检出正常。
输出预期:入门结束时总结——用户是在开发 mainline 还是在其他仓库上使用它;当前检出是否为规范且可信;本地构建/测试基线是否成功;当前检出中哪些命令预期可用;贡献者与操作者各自的下一步。