@@ -426,7 +426,8 @@ pr.fetch_diff → pr.gate_check → agent.review_diff → [post] pr.post_review
 ```
 workspace.guard_clean → pr.checkout_branch → pr.fetch_ci_failures → pr.group_failures
   → [not report_only] agent.debug_group (foreach failure_groups)
-  → [not report_only] review.patch_gate → [not report_only] ci.push → report.final_summary
+  → [not report_only] review.patch_gate → [not report_only] ci.push
+  → [not report_only] pr.harvest_debug_knowledge → report.final_summary
 ```
 
 **`pr-rebase`** — push 只针对 PR head 分支，force 仅 with-lease。
 
@@ -1,6 +1,6 @@
 # config.py —— 规范
 
-<!-- verified-against: 2026-08-25 -->
+<!-- verified-against: 2026-08-28 -->
 
 `LOC ~630 · 配置 · refactor-status: oversized`
 
@@ -13,7 +13,9 @@
 （reviewer 模型、远端 CI 轮次/预算、`github_token` 推送凭据）、agent 运行时、
 ensemble、MoA、评审深度与按 pass 路由、Strict 后端选择、profile、patch 触发器、
 metrics 与升级，提供带类型字段和安全默认值；外加 PR4d 知识运行时 cutover
-（`imx_knowledge_runtime`）与 manifest 展开回退（`expansion_env()`）。
+（`imx_knowledge_runtime`）、manifest 展开回退（`expansion_env()`），以及
+知识回流落盘目录 `knowledge_intake_dir`（`KNOWLEDGE_INTAKE_DIR`，默认空 = 关闭；
+消费方见 `doc/RFC-knowledge-intake.md`）。
 
 ## 公开契约
 带全部可调项的 `Settings`；`reviewer` / `intent`（回退到 `agent_model`）；
 
@@ -1,8 +1,8 @@
 # engine/steps/pr/ —— 规范
 
-<!-- verified-against: 2026-08-18 -->
+<!-- verified-against: 2026-08-28 -->
 
-`LOC ~1100（6 个文件） · step 库（PR） · refactor-status: ok`
+`LOC ~1200（6 个文件） · step 库（PR） · refactor-status: ok`
 
 ## 职责
 受守卫的推送、只读的 PR 抓取/门禁、PR rebase、PR debug、受门禁的评审发布。
@@ -15,13 +15,14 @@
 - `rebase.py` —— `pr.checkout_branch`、`pr.rebase_onto_base`、`pr.analyze_diff`、
   `agent.verify_module`。
 - `debug.py` —— `pr.fetch_ci_failures`（+ `_enrich_ci_logs`）、`pr.group_failures`、
-  `agent.debug_group`。
+  `agent.debug_group`、`pr.harvest_debug_knowledge`。
 - `publish.py` —— 对外写入（risk=push）：`ci.push`、`pr.post_review`。
 - `utils.py` —— 纯函数 `extract_signature`（及其正则）。
 
-## Steps（11 个）
+## Steps（12 个）
 `ci.push`（script/push）；`pr.fetch_diff`、`pr.gate_check`、`pr.checkout_branch`、
 `pr.analyze_diff`、`pr.fetch_ci_failures`、`pr.group_failures`（deterministic/read）；
+`pr.harvest_debug_knowledge`（deterministic/knowledge）；
 `pr.rebase_onto_base`、`agent.debug_group`（agent/write_workspace）；
 `agent.verify_module`（validation/read）；`pr.post_review`（script/push）。
 
@@ -46,6 +47,14 @@
 - `pr.fetch_ci_failures` 经 profile 选定的 CI provider 富化日志，否则记一条
   `capability_gap`（**E2**）；`pr.group_failures` 按**归一化后**的签名分组。
 - `pr.post_review` 是**双闸**的（**C5**）。
+- `pr.harvest_debug_knowledge` **只在真实推送后落盘**（push 输出存在且非 dry-run，
+  且至少一组修复同时有 root_cause 与 verification —— 与 debug memory 同一门槛），
+  写入 `settings.knowledge_intake_dir`（空 = 关闭，默认）。它是**刻意 fail-open**
+  的：目录未配、dry-run、无已验证修复、写失败（trace
+  `knowledge_intake_write_failed` 后吞掉）都返回 ok —— 关闭学习回路
+  **绝不能**让已落地的修复失败。它消费 executor 维护的 `state["outputs"]`，
+  该表在 resume 时由 checkpoint 恢复（见 `test_knowledge_harvest.py` 的
+  crash-then-resume 用例）。设计记录：`doc/RFC-knowledge-intake.md`。
 
 ## 边界 —— 不属于这里
 不含推送授权逻辑（那是 `push`）；不含 CI 日志抓取机制（那是 `ci/providers`）；
@@ -56,7 +65,8 @@
 `..agent_runtime`。
 
 ## 测试
-`test_pr_steps.py`、`test_push_and_steps.py`、`test_ci_and_repo_map.py`
+`test_pr_steps.py`、`test_push_and_steps.py`、`test_knowledge_harvest.py`、
+`test_ci_and_repo_map.py`
 （注意：`test_ci_and_repo_map` monkeypatch 的是 `pr.debug._gh`，
 即 `pr.fetch_ci_failures` 绑定 `gh` 的那个子模块）。
 
 
@@ -1,6 +1,6 @@
 # playbooks/*.yaml —— 规范
 
-<!-- verified-against: 2026-08-25 -->
+<!-- verified-against: 2026-08-28 -->
 
 `8 个文件 · 声明式编排数据 · refactor-status: ok`