基于官方 SWE-agent/mini-swe-agent 整理的本地学习仓库：保留可运行源码，并附分阶段笔记。原项目说明见 README.upstream.md。
官方文档：mini-swe-agent.com · 极简教程：minimal-agent.com
| 路径 | 内容 |
|---|---|
src/minisweagent/ |
Agent / Model / Environment / Run 源码 |
learning/ |
分阶段学习笔记（Phase 0–6） |
LEARNING.md |
学习路径总览与阅读顺序 |
docs/ |
上游项目文档（MkDocs） |
tests/ |
上游测试 |
README.upstream.md |
上游项目原 README |
用尽量少的脚手架让 LM 靠 bash 读代码、改文件、跑测试、修 bug：
Agent（控制流） × Model（调 LM + 解析 action） × Environment（执行） × Run（入口拼装）
从 LEARNING.md 进入；各阶段：
| 阶段 | 文档 | 主题 |
|---|---|---|
| 0 | learning/PHASE0-CONTROL-FLOW.md |
心智模型与 DefaultAgent 控制流 |
| 1 | learning/PHASE1-HELLO-WORLD.md |
Hello World：拼装 Agent / Model / Env |
| 2 | learning/PHASE2-MODEL.md |
Model：tool-call / 文本解析 / observation |
| 3 | learning/PHASE3-PROMPT-CONFIG.md |
Prompt / YAML：策略藏在配置里 |
| 4 | learning/PHASE4-EXTEND.md |
扩展：InteractiveAgent、换 Environment |
| 5 | learning/PHASE5-COMPARE.md |
对照完整 SWE-agent（可选） |
| 6 | learning/PHASE6-CAPSTONE.md |
毕业项目：自己写一个 <300 行 mini-agent |
- 按 Phase 顺序读；每阶段先看「先读这些文件」，再跟端到端链路。
- 勾掉验收清单再进下一阶段。
- 上游用法与安装仍以
README.upstream.md和官方文档为准；learning/是个人笔记，不进 MkDocs 导航。