From 67bdacbf2e4f932b3bee127545f71c45563e000c Mon Sep 17 00:00:00 2001
From: lanrtop <lanrtop@gmail.com>
Date: Thu, 9 Jul 2026 16:12:47 +0900
Subject: [PATCH] =?UTF-8?q?feat(onboarding):=20AGENTS.md=20v1.5.0=E2=80=94?=
 =?UTF-8?q?=E2=80=94=E6=96=B0=E5=A2=9E=E9=9C=80=E6=B1=82=E5=AF=B9=E9=BD=90?=
 =?UTF-8?q?=E5=8D=8F=E8=AE=AE=EF=BC=88Bug=20Fix/Feature=20=E5=88=86?=
 =?UTF-8?q?=E7=B1=BB=20+=20S=20=E7=BA=A7=E8=BD=BB=E9=87=8F=E5=8D=A1=20+=20?=
 =?UTF-8?q?=E6=B1=87=E6=80=BB=E8=A1=A5=E5=BD=95=E9=99=90=E5=AE=9A=E8=AF=AD?=
 =?UTF-8?q?=EF=BC=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src-tauri/resources/onboarding/AGENTS.md.tmpl | 24 ++++++++++++++++++-
 1 file changed, 23 insertions(+), 1 deletion(-)

diff --git a/src-tauri/resources/onboarding/AGENTS.md.tmpl b/src-tauri/resources/onboarding/AGENTS.md.tmpl
index 54d6373..1b29911 100644
--- a/src-tauri/resources/onboarding/AGENTS.md.tmpl
+++ b/src-tauri/resources/onboarding/AGENTS.md.tmpl
@@ -18,7 +18,7 @@
 
 <!-- TODO: 列出 README / ARCHITECTURE.md / 其他关键文档及用途。 -->
 
-<!-- ONBOARDING_MANAGED_START version="1.4.0" -->
+<!-- ONBOARDING_MANAGED_START version="1.5.0" -->
 ## 核心开发约束
 
 ### 包管理
@@ -35,6 +35,28 @@
   另建 `test:install` 脚本显式安装浏览器（`playwright install --with-deps`），
   升级时有意识操作，避免 pnpm install 静默触发 ~200MB 的浏览器重下
 
+## 需求对齐协议
+
+开始写代码前，先判断改动类型：
+
+**Bug Fix**（当前行为与预期的意外偏差）
+→ 建任务卡，直接执行，无需等确认词。
+
+**Feature / 行为变更**（新增能力或主动改变已有行为）
+→ 必须先输出确认卡，等用户说「确认」再动手：
+
+- **S 级**（单文件、行为对外无变化，任务卡 complexity=S）：输出三行轻量卡
+  ```
+  改哪：<文件或模块>
+  改什么：<一句话>
+  验收：<agent_verify 路径>
+  ```
+- **M / L 级**：输出完整任务卡（含 `files` + `acceptance` + `complexity`），等确认
+
+**边界模糊时**：保守判断，按 Feature 处理，走完整确认卡。
+
+> ⚠️ Session 结束汇总补录 ≠ 确认卡替代——补录仅适用于漂移检测触发后用户主动选择补录的场景，不得作为「先做再补」的通道。
+
 ## Git 工作流
 
 见 `docs/ai-context/git-workflow.md`（分支策略 + Conventional Commits + Rules-Applied trailer + PR 规范）。