feat: agent_poller 所有评论/PR 自动附加 [DEV_AGENT_ID] 签名
CI / test (pull_request) Successful in 7s

- agent_poller.py 读取 DEV_AGENT_ID 环境变量(默认 da-01)
- comment/close-issue/create-pr 自动附加 [da-XXXX-XXXX] 签名
- start_dev_agent.sh 启动时设为 da-MMDD-HHmm,token 改为从环境变量读取
- DEV_AGENT.md 文档说明签名机制
- test_step2 修复 trigger=None 边缘情况

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
2026-05-31 19:27:25 +08:00
parent 98546ba4b6
commit f2f85b984f
4 changed files with 44 additions and 19 deletions
+26 -9
View File
@@ -45,6 +45,9 @@ description: AI 开发专家,负责 document_analyzer 项目的功能开发、
- `GITEA_URL``http://localhost:3000`
- `GITEA_REPO``pzhang_zywl/document_analyzer`
- `GITEA_API_TOKEN` — Gitea 个人访问令牌
- `DEV_AGENT_ID` — 代理标识(默认 `da-01`,启动脚本自动设为 `da-MMDD-HHmm`
**代理签名:** 所有 Issue 评论和 PR 正文末尾自动附加 `[da-MMDD-HHmm]` 签名,用于区分 Dev-Agent 和 QE-Agent 的活动。未来多个 Dev-Agent 同时运行时,通过不同的 `DEV_AGENT_ID` 区分。
首次启动前,请阅读 `GITEA_CICD_SETUP.md` 了解 CI/CD 系统。
@@ -131,17 +134,27 @@ PR 创建后 CI 自动触发。用 agent_poller 监控状态:
python scripts/agent_poller.py --action pr-status --pr <PR_NUM>
```
### 6. Merge & 关闭
### 6. Merge & 验证
CI 通过后,执行 merge 并关闭 Issue
CI 通过后 merge PR,但**不立即关闭 Issue**——等待 QE 验证
```bash
# Merge PR(会自动检查 CI 状态)
# Merge PR
python scripts/agent_poller.py --action merge-pr --pr <PR_NUM>
# 如果 Issue 未被自动关闭,手动关闭
# 评论通知 QE 验证(不关闭 Issue)
python scripts/agent_poller.py --action comment --issue N \
--body "PR #<NUM> merged。请 QE 重新运行 e2e 测试验证。"
```
**重要:** Merge 后保持 Issue open,等 QE 在评论中确认修复有效后再关闭。如果 QE 反馈问题仍存在,重新分析根因(见 [[feedback-issue-close-gate]])。
### 7. 关闭 IssueQE 验证通过后)
```bash
# 确认 QE 评论已验证通过后,关闭 Issue
python scripts/agent_poller.py --action close-issue --issue N \
--body "PR #<NUM> merged. 变更已合入 main."
--body "QE 验证通过。变更已合入 main"
```
**一键查看完整生命周期:**
@@ -149,7 +162,7 @@ python scripts/agent_poller.py --action close-issue --issue N \
python scripts/agent_poller.py --action lifecycle --issue N
```
### 7. CI 失败处理
### 8. CI 失败处理
CI 失败时 Gitea 自动创建 `ci-failure` Issue
1. `agent_poller.py --action get --issue <NEW_NUM>` 分析失败原因
@@ -168,7 +181,9 @@ QE-Agent 开 Issue (qe-feedback)
┌─ 失败 → 自动开 Issue → push 修复 → 回到 CI
└─ 成功 → merge-pr → close-issue → QE-Agent 验证 → 新反馈
└─ 成功 → merge-pr → comment 通知 QE → QE 验证
↓ ↓
QE 确认通过 → close-issue QE 反馈仍失败 → 重新分析根因 → 回到开发
```
## 提交规范
@@ -206,5 +221,7 @@ QE-Agent 开 Issue (qe-feedback)
- [ ] **评论**`agent_poller.py --action comment` 在 Issue 下记录 PR 链接
- [ ] **CI**`agent_poller.py --action pr-status` 确认 CI 通过
- [ ] **合并**`agent_poller.py --action merge-pr` 合并 PR
- [ ] **关闭**确认 Issue 已自动关闭,否则 `--action close-issue`
- [ ] **验证**`agent_poller.py --action lifecycle` 确认全流程完成
- [ ] **通知**`agent_poller.py --action comment` 通知 QE 验证(不关闭 Issue
- [ ] **验证**检查 Issue 评论,确认 QE 验证通过
- [ ] **关闭**QE 确认后 `--action close-issue`
- [ ] **复盘**`agent_poller.py --action lifecycle` 确认全流程完成