From febf4ba019b9dd4e93b4df1a47f749b187639b00 Mon Sep 17 00:00:00 2001
From: Peter Zhang <18501667167@qq.com>
Date: Sun, 31 May 2026 17:14:01 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20QE-Agent=20=E9=BB=98=E8=AE=A4=E5=90=AF?=
 =?UTF-8?q?=E5=8A=A8=E5=8D=B3=E8=BD=AE=E8=AF=A2=EF=BC=8C=E8=87=AA=E5=8A=A8?=
 =?UTF-8?q?=20/loop=2010m?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 agents/QE_AGENT.md        | 13 +++++++++++++
 scripts/start_qe_agent.sh |  5 +++--
 2 files changed, 16 insertions(+), 2 deletions(-)

diff --git a/agents/QE_AGENT.md b/agents/QE_AGENT.md
index 1cc7d6b..4cad82e 100644
--- a/agents/QE_AGENT.md
+++ b/agents/QE_AGENT.md
@@ -7,6 +7,19 @@ description: QE Agent — 自动化验收测试开发与质量门禁。轮询 Gi
 
 你是 QE（质量工程）代理，专注于 **main branch 的发布质量**。你的工作是：根据 Gitea 上的 `test-dev` issue 开发新的验收测试，确保测试通过 CI，并推进到 main branch。
 
+## 启动行为
+
+**每次新 session 启动时，立即执行**：
+
+1. 设好环境变量（见下方"环境要求"）
+2. 用 `/loop 10m` 开启 10 分钟间隔的自动轮询
+3. 轮询内容：`agent_poller.py --action list --labels test-dev` 和 `--labels acceptance-failure`
+4. 有 issue → 走完整闭环处理（Step 2-8）
+5. 无 issue → 简短报告 "main healthy"，等待下次轮询
+6. 同时保持对话开放，随时响应用户指令
+
+这样 QE-Agent 真正做到 **"默认轮询 + 随时互动"**。
+
 ## 环境要求
 
 开始工作前，确认以下环境变量已设置：
diff --git a/scripts/start_qe_agent.sh b/scripts/start_qe_agent.sh
index ca5554e..c8bfab7 100644
--- a/scripts/start_qe_agent.sh
+++ b/scripts/start_qe_agent.sh
@@ -37,8 +37,9 @@ case "$MODE" in
     ;;
   3)
     echo ""
-    echo "启动交互模式..."
-    echo "进入后输入: 检查 Gitea test-dev Issues 并处理"
+    echo "启动交互模式 (默认 10 分钟轮询)..."
+    echo "按 Ctrl+C 停止"
+    echo ""
     echo "可用命令速查:"
     echo "  agent_poller.py --action list --labels test-dev"
     echo "  agent_poller.py --action list --labels acceptance-failure"