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

[product] Generic Agent 启动时自动加载项目上下文和 Gitea 配置 #117

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

问题

当前只有 Dev-Agent 和 QE-Agent 通过各自的 agent 定义文件在启动时加载项目上下文。但如果用 Claude Code 直接启动一个 generic agent（不指定 --agent 参数），它不会自动：

  1. 读取 docs/PROJECT_CHARTER.md 和 docs/GLOBAL_STATE.md 了解项目
  2. 读取 ~/.gitea/config.yaml 获取 Gitea 连接信息

导致每次都需要手动告知项目背景和配置。

期望

通过 CLAUDE.md（项目根目录，Claude Code 自动加载）实现：任何在该项目目录下启动的 Claude Code session（无论是否指定 --agent）都能自动：

  1. 加载项目上下文：读取 docs/PROJECT_CHARTER.md 和 docs/GLOBAL_STATE.md，了解项目目标、架构、当前状态
  2. 加载 Gitea 配置：读取 ~/.gitea/config.yaml，使用人类用户（pzhangzywl）的身份和 token 工作，所有 Gitea 操作通过 python scripts/agent_poller.py 执行

范围

  • 修改 CLAUDE.md 或相关启动机制
  • 确保对 generic agent（非特定 --agent 启动的 session）也生效
  • 不影响现有 Dev-Agent / QE-Agent 的行为
## 问题 当前只有 Dev-Agent 和 QE-Agent 通过各自的 agent 定义文件在启动时加载项目上下文。但如果用 Claude Code 直接启动一个 generic agent（不指定 --agent 参数），它不会自动： 1. 读取 `docs/PROJECT_CHARTER.md` 和 `docs/GLOBAL_STATE.md` 了解项目 2. 读取 `~/.gitea/config.yaml` 获取 Gitea 连接信息 导致每次都需要手动告知项目背景和配置。 ## 期望 通过 CLAUDE.md（项目根目录，Claude Code 自动加载）实现：任何在该项目目录下启动的 Claude Code session（无论是否指定 --agent）都能自动： 1. **加载项目上下文**：读取 `docs/PROJECT_CHARTER.md` 和 `docs/GLOBAL_STATE.md`，了解项目目标、架构、当前状态 2. **加载 Gitea 配置**：读取 `~/.gitea/config.yaml`，使用人类用户（pzhangzywl）的身份和 token 工作，所有 Gitea 操作通过 `python scripts/agent_poller.py` 执行 ## 范围 - 修改 `CLAUDE.md` 或相关启动机制 - 确保对 generic agent（非特定 --agent 启动的 session）也生效 - 不影响现有 Dev-Agent / QE-Agent 的行为
pzhang_zywl added the product-code label 2026-06-08 14:12:54 +08:00
pzhang_dev_agent_01 commented 2026-06-08 14:16:25 +08:00
Collaborator
Copy Link
Copy Source

问题

Generic session（无 --agent 参数）不会自动加载项目上下文和 Gitea 配置，导致每次需手动告知项目背景。

根因

CLAUDE.md 原本是 Dev-Agent 专用文件（开头声明"你是 Dev-Agent"），generic session 加载后与身份不匹配，且未涵盖 Gitea 配置引导。

修复

重构 CLAUDE.md 为通用入口（PR #118）：

  • 项目概述和文档路径（PROJECT_CHARTER.md、GLOBAL_STATE.md）
  • Gitea 配置说明（~/.gitea/config.yaml、GITEA_USER、agent_poller.py）
  • Agent 模式引用（dev-agent.md / qe-agent.md）
  • Generic session 默认使用人类用户身份（pzhangzywl）

Dev-Agent/QE-Agent 行为不受影响（各自的 agent 定义文件保持不变）。

验证

  • pytest: 103 passed, 29 skipped
  • CI: success
  • 本次 session 成功通过 CLAUDE.md 加载项目上下文

[pzhang_dev_agent_01]

## 问题 Generic session（无 --agent 参数）不会自动加载项目上下文和 Gitea 配置，导致每次需手动告知项目背景。 ## 根因 CLAUDE.md 原本是 Dev-Agent 专用文件（开头声明"你是 Dev-Agent"），generic session 加载后与身份不匹配，且未涵盖 Gitea 配置引导。 ## 修复 重构 CLAUDE.md 为通用入口（PR #118）： - 项目概述和文档路径（PROJECT_CHARTER.md、GLOBAL_STATE.md） - Gitea 配置说明（~/.gitea/config.yaml、GITEA_USER、agent_poller.py） - Agent 模式引用（dev-agent.md / qe-agent.md） - Generic session 默认使用人类用户身份（pzhangzywl） Dev-Agent/QE-Agent 行为不受影响（各自的 agent 定义文件保持不变）。 ## 验证 - pytest: 103 passed, 29 skipped - CI: success - 本次 session 成功通过 CLAUDE.md 加载项目上下文 --- [pzhang_dev_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 product-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#117
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?