核心 GUIDE
Repository Context（仓库上下文）
Repository Context 是 AI Coding Agent 为了让修改真正适配现有系统而需要的 Code、Convention、Test、Dependency Boundary 与 Local History，而不是一堆孤立 Source File。
核心心智模型
把 Repository 看成带 Contract 的 Execution Environment，而不是文件集合。Relevant Context 应是约束这次 Change 的最小 File、Interface、Test 与 Convention 集合。
为什么重要
Coding Model 很容易生成语法正确的 Patch，却违反 Architecture、重复已有 Helper、忽略 Migration Rule 或扩大 Task Scope。好的 Repository Context 会让 Agent 拥有足够 Evidence 做局部 Reasoning，同时避免把整个 Codebase 一次性塞进 Prompt。
01
编辑前先发现 Change Boundary
从 Requested Behavior 出发，定位 Entry Point、相关 Test 与最近的 Contract，再沿 Import/Call Path 扩展到足够理解 Dependency 为止。同时读取 Repository Instruction、Build Command 与附近已有 Pattern。编辑后用 Diff 与 Targeted Test 反向检查最初 Boundary 是否过窄，只有发现 Evidence 时才继续扩 Context。
02
示例：新 API Client 重复已有 Retry Layer
Agent 只看到一个 Service File，就自行给 HTTP Call 增加 Retry Loop。Repository 另一处已经在 Shared Client 统一处理 Retry 与 Idempotency，最终 Production 出现 Double Retry。若编辑前查看 Shared Client、邻近 Test 与 Dependency Convention，就能识别正确 Boundary。
常见失败模式
- 不决定哪些 Evidence 真正约束 Task，就一次加载整个 Repository。
- 只改第一个 Search 命中的文件，忽略 Caller、Test 与 Shared Abstraction。
- 用 README 级 Context 代替可执行的 Repository Evidence。
工程启发
- 修改前先映射 Entry Point、Contract、Test 与 Dependency。
- 只有 Evidence 表明 Boundary 更大时才扩 Context。
- 用最终 Diff 与 Regression Test 判断 Repository Context 是否足够。
关键结论
- 01Repository Context 是与 Task 相关的 System Contract Evidence。
- 02更多 File 不自动等于更好 Context。
- 03正确 Patch 必须适配 Repository 的 Architecture 与 Verification Path。
阅读记录
这里只记录你真实做过的动作，不代表掌握、熟练或认证。
用于这些学习路径
这个 Concept 会在多个 canonical 学习路径中复用。
来自 Knowledge Graph 的相关知识点
这些关系直接来自 canonical graph，不维护第二套 Guide 分类体系。