用途：为当前仓库创建或刷新两份高信号文档 REPO_CONTEXT.md 和 REVIEW_BRIEF.md，让后续智能体或对话无需重新探索仓库即可理解仓库概况、结构与下一步工作。触发场景包括新仓库、需要打包给后续对话，或生成有依据的简要说明。
主要能力：先收集证据再写作，覆盖仓库根信号（README、AGENTS.md、清单与锁文件、CI、容器与部署配置、infra 目录）、运行时入口、质量与测试信号、架构信号、运维信号及 Git 信息；按模板填充 REPO_CONTEXT.md（用途、真实架构、可发现的安装/运行/lint/类型检查/测试/构建/部署命令、重要文件、风险与未知项，并以文件路径为证据锚点）和 REVIEW_BRIEF.md（范围边界、相关文件、当前状态、缺口与风险、实施或评审计划、验证命令，以及可直接粘贴的后续工作提示）。用户未指定任务时，优先聚焦最有价值的缺失能力、最高风险的弱点或高杠杆清理机会。
使用方式：显式调用最可靠，例如 $repo-context-builder 分析本仓库并按内置模板生成两份文档；或刷新已有文档；或针对认证 bug 等具体任务生成任务范围的 REVIEW_BRIEF.md。可读取内置模板与参考文件，并可选用 scripts/repo_inventory.py 加速盘点，但需核对重要结论。默认在仓库根目录输出两份文件，已存在则原地更新。
适用场景：单应用、服务、库、基础设施仓库或 monorepo；monorepo 需区分根与各重要包，记录包级命令与跨包依赖。
限制：无法确认的内容须标注 Unknown 或 Not found in repo；不编造命令、环境、服务、密钥或部署目标；不输出无证据的“生产可用”结论；不在无这两份产物时编写代码。