AI Engineering / Harness Knowledge Modules

这里是知识归属地图，不是默认课程顺序。 新学习者请从 13-week-map.md 开始。01–21 只表达 canonical ownership、检索位置与模块内部推荐阅读顺序。

模块之间存在大量螺旋 prerequisite：例如 W6 会先学习 Runtime core，再在 W7 学 Planning / DAG；W8 先建立 retry/idempotency/side-effect 语义，再在 W9 学 Durable Execution；HTTP/DB/Queue/Performance 也会在最终集成前分别进入 W9–W12。因此不要把下面的编号当作 01 → 02 → ... → 21 的课程拓扑。

Canonical ownership map

01 Foundations                  12 HTTP / Streaming
02 Model Layer                  13 Database / Durable Storage
03 Python Engineering           14 Cache / Redis / Queue
04 Context                      15 MCP
05 Retrieval / RAG              16 Workspace / Coding Agent
06 Tools                        17 Security / Sandbox
07 Planning / Orchestration     18 Observability / Testing / Eval
08 Async / Concurrency          19 Performance / Cost / Capacity
09 Execution Runtime            20 Linux / Docker / Deployment
10 State / Session / Memory     21 Shadow Harness Integration
11 Reliability / Human Control

I. Foundations & Contracts

01. Agent 与 Harness 基础

控制权、执行权、Workflow/Agent/Harness/Runtime 与 long-running mental model。

02. 模型层与结构化交互

Model call boundary、structured interaction、Provider Adapter、fallback、Fake Model 与 reproducibility。

03. Python 工程

只补实现 Harness 所需的 package、typing、Protocol/ABC、异常、test double、configuration 与 dependency boundary。

II. Information & Decision

04. Context Engineering

Context assembly、budget、selection、Tool result、compaction、long-horizon continuity 与 evaluation。

05. Retrieval 与 RAG

Ingestion、chunking、embedding、retrieval、rerank、grounding 与 evaluation。

06. Tool 工程

Tool contract、schema、registry、discovery、execution、error、retry eligibility、idempotency boundary 与 evaluation。

07. Planning 与 Orchestration

Decomposition、ReAct/Plan-and-Execute、StructuredPlan、validation/replanning、graph compilation 与 coordination。

III. Execution & Durability

08. Async 与 Concurrency

Event loop、TaskGroup、structured concurrency、cancellation、bounded queue、race 与执行模型选择。

09. Execution Runtime

Run/Node state machine、DAG scheduler、cancellation、checkpoint、replay、worker ownership 与 durable wait。

10. State、Session 与 Memory

Run/Session/Durable State、Checkpoint、Memory、RAG、crash recovery 与 state schema migration。

11. Reliability 与 Human Control

Timeout/deadline、retry/backoff/idempotency、limits、circuit/degradation、HITL/approval 与 guardrails。

IV. Harness Service Runtime

12. HTTP 与 Streaming

Run API、connection lifecycle、timeout、SSE/WebSocket、disconnect 与 streaming backpressure。

13. Database 与 Durable Storage

Run/Node/Tool/Checkpoint/Approval/Event persistence、transaction/outbox/reconciliation 与 side-effect consistency。

14. Cache、Redis 与 Queue

Cache、distributed coordination、Run dispatch、ack/redelivery、idempotent worker、DLQ 与 worker backpressure。

V. External Capabilities & Production Boundaries

15. MCP

Modern MCP core、Tools/Resources/Prompts、routing/cache、Authorization、MRTR/Extensions/Tasks、Gateway 与 Adapter。

16. Workspace 与 Coding Agent

Filesystem/Shell/Patch/Git/Test/Artifact/Sandbox/Skill/Browser 与 workspace recovery，作为综合 Harness case study。

17. Security 与 Sandbox

Threat model、prompt injection、capability、least privilege、isolation、credential、tenant、retention 与 audit。

18. Observability、Testing 与 Evaluation

Trace/metrics 解释发生了什么；deterministic testing 验证软件契约；Eval 衡量 Agent 决策质量。

19. Performance、Cost 与 Capacity

Latency/token/cost、routing/cache、queue/backpressure、admission、capacity 与 benchmark。

20. Docker、Linux 与 Deployment

API/Worker/Sandbox 的 process/signal、permission/network、image/volume、secret/health、graceful shutdown 与 reproducible deployment。

VI. Integration

21. Shadow Harness Integration

把 Model、Context、Tool、Planner、Scheduler、StateStore、Checkpoint、Queue/Worker、MCP、Workspace、Trace/Eval、API 与 Developer Console 接成完整系统。

VII. Language Migration

22. Java 开发者的 Python 快速迁移

从 Java 心智模型迁移到 Python，覆盖基础语法、工程结构、异步并发以及 Agent / Harness 开发常用能力。

如何使用本页

• 学习：回到 13-week map，按周给定深度读；
• 查概念：在本页定位 canonical module，再进入对应文章；
• 读源码：优先用 OpenAI Codex Source Map 对照官方 coding-agent Runtime；复杂产品组合再看 Grok Bot Source Map；
• 查完整能力边界：看 Harness Scope Map。