docs: update dev agent guide with accurate CLI usage and Windows launcher

2026-05-30 22:59:29 +08:00
parent fec4c09ee0
commit 547e55168c
2 changed files with 89 additions and 7 deletions
@@ -92,19 +92,51 @@ git clone → pip install → pytest →

 ## Dev Agent 使用指南

-### 方式 A: Claude Code Agent 模式
+### 前置：配置环境变量（一次性）
+
+每次启动 Agent 前需要设置 Gitea API Token：
+
+**Windows (双击启动):** 使用项目自带的 `scripts/start_dev_agent.bat`（见下方）
+
+**Bash/WSL/Git Bash:**
+```bash
+export GITEA_API_TOKEN="59117246ec418d5d87042de073b0d4197d8054bf"
+export GITEA_URL="http://localhost:3000"
+export GITEA_REPO="pzhang_zywl/document_analyzer"
+```
+
+### 方式 A: 单次任务模式
+
+直接在命令行带上 Prompt 执行一次性任务：

 ```bash
 cd /c/Users/peterz/projects/document_analyzer
-export GITEA_API_TOKEN="你的token"
-export GITEA_URL="http://localhost:3000"
-export GITEA_REPO="pzhang_zywl/document_analyzer"

-# 启动 Dev Agent
+claude -p --agent agents/DEV_AGENT.md \
+  "检查 Gitea 有没有新的 agent-task 或 ci-failure 工单，有就领取并修复。"
+```
+
+`-p` 表示非交互模式，执行完退出。适合手动触发或脚本调用。
+
+### 方式 B: 持续轮询模式（推荐）
+
+```bash
+cd /c/Users/peterz/projects/document_analyzer
+
+claude -p --agent agents/DEV_AGENT.md \
+  "用 loop 模式每 10 分钟检查一次 Gitea Issues，发现 agent-task 或 ci-failure 就处理。"
+```
+
+Agent 会持续运行，每隔 10 分钟检查一次，有工单就干活。
+
+### 方式 C: 交互模式
+
+```bash
+cd /c/Users/peterz/projects/document_analyzer
 claude --agent agents/DEV_AGENT.md
 ```

-对 Agent 说: "检查 Gitea 有没有新的待处理工单，有就处理。"
+进入交互会话后，对 Agent 说："检查 Gitea Issues 并处理。"

 ### 方式 B: Claude Code 内作为子 Agent

@@ -112,7 +144,7 @@ claude --agent agents/DEV_AGENT.md

 > 用 DEV_AGENT.md 检查 http://localhost:3000/pzhang_zywl/document_analyzer/issues 有没有待处理工单

-### 方式 C: 任何其他 Agent
+### 方式 D: 任何其他 Agent

 任何支持终端命令的 AI Agent 都可以通过 `agent_poller.py` 与 Gitea 交互:

@@ -0,0 +1,50 @@
+@echo off
+chcp 65001 >nul
+title Dev Agent - Gitea Issue Worker
+
+echo ============================================
+echo   Dev Agent 启动器
+echo ============================================
+echo.
+
+set GITEA_API_TOKEN=59117246ec418d5d87042de073b0d4197d8054bf
+set GITEA_URL=http://localhost:3000
+set GITEA_REPO=pzhang_zywl/document_analyzer
+
+cd /d C:\Users\peterz\projects\document_analyzer
+
+echo 模式选择:
+echo   [1] 单次任务 - 检查一次 Issue 并处理
+echo   [2] 持续轮询 - 每 10 分钟检查一次 (推荐)
+echo   [3] 交互模式 - 进入对话手动操作
+echo.
+set /p MODE="请输入 (1/2/3): "
+
+if "%MODE%"=="1" (
+    echo.
+    echo 正在执行单次检查...
+    claude -p --agent agents/DEV_AGENT.md "检查 Gitea 有没有新的 agent-task 或 ci-failure 标签的工单，有就领取并修复。"
+    pause
+    exit
+)
+
+if "%MODE%"=="2" (
+    echo.
+    echo 启动持续轮询模式 (每 10 分钟)...
+    echo 按 Ctrl+C 停止
+    claude -p --agent agents/DEV_AGENT.md "用 loop 模式每 10 分钟检查一次 Gitea Issues，发现 agent-task 或 ci-failure 标签就处理。处理完后在对应 Issue 下评论进度，push 代码触发 CI。"
+    pause
+    exit
+)
+
+if "%MODE%"=="3" (
+    echo.
+    echo 启动交互模式...
+    echo 进入后输入: 检查 Gitea Issues 并处理
+    claude --agent agents/DEV_AGENT.md
+    pause
+    exit
+)
+
+echo 无效选择。
+pause