diff --git a/docs/design/17-toolchain-handler-enforcement.md b/docs/design/17-toolchain-handler-enforcement.md
index 7e96478..e6b4261 100644
--- a/docs/design/17-toolchain-handler-enforcement.md
+++ b/docs/design/17-toolchain-handler-enforcement.md
@@ -376,7 +376,7 @@ def verify_completion(self, task_id: str, db_path: Path) -> VerifyResult:
 verify 失败时的处理逻辑（现有逻辑保留）：
 
 1. 标 task 为 `failed`
-2. 通过 Mail API 通知庞统（`_notify_via_mail_api`）
+2. 通过 on_failure 三分路处理（PR comment / Gitea Issue / toolchain task）
 3. 通知内容包含：事件类型、事件详情、失败原因、Gitea 链接、行动指引
 
 ### 5.3 action_report comment 格式
@@ -423,7 +423,7 @@ Agent 可能写了 action_report 但没真做。缓解机制：
 | @mention → 被@者 | mention | toolchain | 按 guidance | 按 mention 模板的 response_guidance + report |
 | PR 合并 → PR 作者 | review_merged | toolchain | 0 步 | 纯通知，走 Gitea PR comment（verify 始终通过） |
 
-**D17-2: 除 PR 合并通知外，所有 toolchain 场景走 ToolchainHandler**
+**D17-2: 所有 toolchain 场景走 ToolchainHandler**
 
 ### 6.2 各场景 steps 详细定义
 
@@ -814,7 +814,7 @@ ticker 需要扫描 `_toolchain` 虚拟项目。当前 ticker 通过 `TaskTypeRe
 | 文件 | 改动类型 | 说明 |
 |------|---------|------|
 | `src/daemon/toolchain_handler.py` | 修改 | ToolchainContextSection 加 steps 渲染 + action_hint；ToolchainApiSection 改为 action_report 指引；ToolchainConstraintsSection 加 Red Flags；verify_completion 改用 action_report |
-| `src/api/toolchain_routes.py` | 修改 | 新增 `_toolchain_db_path()` + `_send_toolchain_task()`；各 handler 改为调用 `_send_toolchain_task`；PR merged 保持 `_send_mail` |
+| `src/api/toolchain_routes.py` | 修改 | 新增 `_toolchain_db_path()` + `_send_toolchain_task()`；所有 handler（含 PR merged）改为调用 `_send_toolchain_task` |
 | `src/daemon/spawner.py` | 修改 | handler 路径 PromptContext 构造时提取 `action_type`、`action_steps` 字段 |
 | `src/daemon/prompt_composer.py` | 修改 | PromptContext 新增 `action_type`、`action_steps` 字段 |
 | `src/blackboard/db.py` | 修改 | comments 表 CHECK 约束处理（去掉 CHECK 或加 action_report） |