From 72523ec97d581df1dc674ad6daac1f0c39af0920 Mon Sep 17 00:00:00 2001
From: Emrys <219520811+Emryswu@users.noreply.github.com>
Date: Mon, 19 Oct 2026 20:01:25 +0800
Subject: [PATCH] =?UTF-8?q?docs(agents):=20=E7=BA=A6=E5=AE=9A=20PR=20?=
 =?UTF-8?q?=E6=88=AA=E5=9B=BE=E5=88=86=E6=94=AF=20pr-assets/*=20=E7=9A=84?=
 =?UTF-8?q?=E7=94=A8=E6=B3=95=EF=BC=8C=E5=B9=B6=E7=A6=81=E6=AD=A2=E5=88=A0?=
 =?UTF-8?q?=E9=99=A4?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

已合并 PR 的描述仍引用这些分支上的图片，误删会让截图永久失效。
---
 AGENTS.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/AGENTS.md b/AGENTS.md
index 1e29949..9fd7dd1 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -51,6 +51,8 @@ CI（`ci.yml`）对每个指向 main 的 PR 跑以下全部检查。
 - commit 和 PR 只署作者本人。不加 `Co-Authored-By`、会话链接（`claude.ai/code/session…`）、`Generated with ...` 之类的署名行。CI 的「提交信息署名检查」会拦下带这些字样的提交。
 - PR 描述用中文。
 - 改完必须先在本地跑通所改部分的 lint 和测试（见上方命令），全部通过再提交。
+- PR 描述里的截图放在单独的孤儿分支 `pr-assets/<PR 主题>`（只含图片），用 `raw.githubusercontent.com/.../pr-assets/<主题>/...` 引用，不提交进功能分支。
+- **不要删除任何 `pr-assets/*` 分支**，PR 合并后也不删：已合并 PR 的描述仍引用这些图，删了截图就永久挂掉。清理分支时只删功能分支（`feat/*`、`fix/*`、`chore/*`、`docs/*`、`tmp/*` 等）。
 
 ## 修 bug 与 review