zeekrAI/document_analyzer
1
0
Fork 1
Code Issues 2 Pull Requests Actions Packages Projects Releases Wiki Activity

[test-code] Generic Agent 启动代码同步 + 禁止直接改代码 #122

New Issue
Closed
opened 2026-06-08 14:48:05 +08:00 by pzhang_zywl · 1 comment
pzhang_zywl commented 2026-06-08 14:48:05 +08:00
Owner
Copy Link
Copy Source

问题

Generic Agent（通过 Claude Code 直接在本项目目录启动的 session，不指定 --agent）目前缺少两个关键行为：

  1. 不会自动同步最新代码：Dev-Agent 和 QE-Agent 持续向 Gitea main 分支提交代码，generic agent 本地工作目录可能落后，导致基于旧代码做出判断或操作
  2. 没有代码修改规范：generic agent 可能直接编辑文件而不走 Issue-PR-Merge 闭环，造成"沉默的修改"——没有记录、没有 review、无法追溯

期望

1. 代码同步机制

在 CLAUDE.md 中实现 session 启动时的代码同步行为：

  • 启动时：自动执行 git pull origin main，确保本地是最新代码
  • 定期检查：通过 /loop 30m 或其他机制，定期 git fetch origin 并对比 HEAD..origin/main，如有新提交则提醒用户或自动 pull
  • 有冲突时：暂停并报告，不自动解决

2. 代码修改规范（对齐 Dev-Agent）

Generic Agent 也不直接改代码，任何对 git 管理内容的修改必须走完整闭环：

开 Issue → 创建分支 → 修改代码 + UT → pytest → commit → push → 创建 PR → CI 通过 → merge → 验证 → 关闭 Issue

具体规则（与 DEV_AGENT.md 对齐）：

  • 任何修改先开 Issue（product-code 标签），描述问题和方案
  • 从 Issue 创建分支 dev/issue-N-<slug>
  • 修改代码 + 同步更新 UT
  • python -m pytest -v 全量通过后才能 commit
  • Push 后通过 agent_poller.py --action create-pr 创建 PR
  • CI 通过后 merge
  • 关闭 Issue 前自行验证修复效果
  • 禁止绕过此流程直接编辑文件

范围

  • 更新 CLAUDE.md，添加上述两个行为规则
  • 不影响 Dev-Agent / QE-Agent 各自的 agent 定义文件
  • Generic Agent 使用人类用户身份（pzhangzywl）通过 agent_poller.py 操作 Gitea
## 问题 Generic Agent（通过 Claude Code 直接在本项目目录启动的 session，不指定 --agent）目前缺少两个关键行为： 1. **不会自动同步最新代码**：Dev-Agent 和 QE-Agent 持续向 Gitea main 分支提交代码，generic agent 本地工作目录可能落后，导致基于旧代码做出判断或操作 2. **没有代码修改规范**：generic agent 可能直接编辑文件而不走 Issue-PR-Merge 闭环，造成"沉默的修改"——没有记录、没有 review、无法追溯 ## 期望 ### 1. 代码同步机制 在 CLAUDE.md 中实现 session 启动时的代码同步行为： - **启动时**：自动执行 `git pull origin main`，确保本地是最新代码 - **定期检查**：通过 `/loop 30m` 或其他机制，定期 `git fetch origin` 并对比 `HEAD..origin/main`，如有新提交则提醒用户或自动 pull - **有冲突时**：暂停并报告，不自动解决 ### 2. 代码修改规范（对齐 Dev-Agent） Generic Agent 也**不直接改代码**，任何对 git 管理内容的修改必须走完整闭环： ``` 开 Issue → 创建分支 → 修改代码 + UT → pytest → commit → push → 创建 PR → CI 通过 → merge → 验证 → 关闭 Issue ``` 具体规则（与 DEV_AGENT.md 对齐）： - 任何修改先开 Issue（`product-code` 标签），描述问题和方案 - 从 Issue 创建分支 `dev/issue-N-<slug>` - 修改代码 + 同步更新 UT - `python -m pytest -v` 全量通过后才能 commit - Push 后通过 `agent_poller.py --action create-pr` 创建 PR - CI 通过后 merge - 关闭 Issue 前自行验证修复效果 - 禁止绕过此流程直接编辑文件 ## 范围 - 更新 `CLAUDE.md`，添加上述两个行为规则 - 不影响 Dev-Agent / QE-Agent 各自的 agent 定义文件 - Generic Agent 使用人类用户身份（pzhangzywl）通过 agent_poller.py 操作 Gitea
pzhang_zywl added the test-code label 2026-06-08 14:48:05 +08:00
pzhang_qe_agent_01 commented 2026-06-08 14:55:14 +08:00
Collaborator
Copy Link
Copy Source

QE-Agent 已领取，正在更新 CLAUDE.md。

[pzhang_qe_agent_01]

QE-Agent 已领取，正在更新 CLAUDE.md。 --- [pzhang_qe_agent_01]
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
blocked
被其他 issue 阻塞，暂不处理
 product-code
产品功能相关
 test-code
QE-Agent 测试代码相关
No Label test-code
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
dzhou_dev_agent_01 dzhou_qe_agent_01 hshen_dev_agent_01 hshen_qe_agent_01 phong_dev_agent_01 phong_qe_agent_01 pzhang_dev_agent_01 pzhang_qe_agent_01 pzhang_zywl vlu_dev_agent_01 vlu_qe_agent_01
No Assignees
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: zeekrAI/document_analyzer#122
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?