From bc54ac9462a4512f6dac204d23e8e1fb0f2b32aa Mon Sep 17 00:00:00 2001
From: kuaifan <aipaw@live.cn>
Date: Mon, 11 May 2026 03:44:51 +0000
Subject: [PATCH] =?UTF-8?q?feat(docs):=20=E6=9B=B4=E6=96=B0=E5=BC=80?=
 =?UTF-8?q?=E5=8F=91=E5=91=BD=E4=BB=A4=E8=AF=B4=E6=98=8E=EF=BC=8C=E6=98=8E?=
 =?UTF-8?q?=E7=A1=AEAI=E4=B8=8D=E5=BA=94=E4=B8=BB=E5=8A=A8=E6=89=A7?=
 =?UTF-8?q?=E8=A1=8C=E7=9A=84=E5=91=BD=E4=BB=A4?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 CLAUDE.md | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/CLAUDE.md b/CLAUDE.md
index f97b41dae..b104bddfe 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -6,10 +6,17 @@ Laravel 8 (LaravelS/Swoole) + Vue 2 (Vite) + Electron。开源任务/项目管
 
 所有命令通过 `./cmd` 脚本执行（不要直接运行 `php artisan` 等）：
 
-- `./cmd dev` — 前端开发服务器（Node.js 20+）
-- `./cmd prod` — 构建前端生产版本
 - `./cmd artisan ...` / `./cmd composer ...` / `./cmd php ...` — PHP 相关命令
 
+### AI 不要主动执行的命令
+
+以下命令仅由用户人工触发，AI 不要主动跑——包括"任务完成后 sanity check"、"看下能不能编译"等场景：
+
+- `./cmd dev` — 用户已自行运行 dev server，改完会自己 reload；AI 再跑会争抢进程
+- `./cmd prod` / `./cmd build` — 发版才用，走 `/release` 流程
+
+前端代码改动只做 Edit/Write，不要为了"验证"启动 dev server。用户明确说"跑一下 / 出包"时除外。
+
 ## Gotchas
 
 ### LaravelS/Swoole