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

[bug] Dev-Agent 启动时无法读取 PROJECT_CHARTER.md / GLOBAL_STATE.md — Glob 工具对项目目录返回空 #113

New Issue
Closed
opened 2026-06-08 12:38:40 +08:00 by pzhang_dev_agent_01 · 1 comment
pzhang_dev_agent_01 commented 2026-06-08 12:38:40 +08:00
Collaborator
Copy Link
Copy Source

问题

Dev-Agent 每次启动时按 DEV_AGENT.md 流程第 1 步应读取 docs/PROJECT_CHARTER.md 和 docs/GLOBAL_STATE.md。但 Glob 工具对项目目录 C:\Users\peterz\projects\document_analyzer 持续返回 "No files found"，导致 agent 跳过该步骤，无法获取项目状态。

根因

Glob 工具在 Windows 下对某些绝对路径返回空结果（用 /c/...、C:/...、C:\... 三种格式均复现失败），而 Bash ls 和 Read 工具对同一路径正常工作。

修复

更新 .claude/agents/dev-agent.md 启动流程第 1 步，显式使用绝对路径 + Read 工具：

1. 读取项目章程：`C:\Users\peterz\projects\document_analyzer\docs\PROJECT_CHARTER.md`
   读取全局状态：`C:\Users\peterz\projects\document_analyzer\docs\GLOBAL_STATE.md`

不再依赖 Glob 搜索。

验证

启动 Dev-Agent 后确认成功读取两个文件内容。

[pzhang_dev_agent_01]

## 问题 Dev-Agent 每次启动时按 DEV_AGENT.md 流程第 1 步应读取 `docs/PROJECT_CHARTER.md` 和 `docs/GLOBAL_STATE.md`。但 Glob 工具对项目目录 `C:\Users\peterz\projects\document_analyzer` 持续返回 "No files found"，导致 agent 跳过该步骤，无法获取项目状态。 ## 根因 Glob 工具在 Windows 下对某些绝对路径返回空结果（用 `/c/...`、`C:/...`、`C:\...` 三种格式均复现失败），而 Bash `ls` 和 Read 工具对同一路径正常工作。 ## 修复 更新 `.claude/agents/dev-agent.md` 启动流程第 1 步，显式使用绝对路径 + Read 工具： ``` 1. 读取项目章程：`C:\Users\peterz\projects\document_analyzer\docs\PROJECT_CHARTER.md` 读取全局状态：`C:\Users\peterz\projects\document_analyzer\docs\GLOBAL_STATE.md` ``` 不再依赖 Glob 搜索。 ## 验证 启动 Dev-Agent 后确认成功读取两个文件内容。 --- [pzhang_dev_agent_01]
pzhang_dev_agent_01 added the product-code label 2026-06-08 12:38:40 +08:00
pzhang_dev_agent_01 commented 2026-06-08 12:40:03 +08:00
Author
Collaborator
Copy Link
Copy Source

问题

Dev-Agent 启动时 Glob 工具对项目目录 C:\Users\peterz\projects\document_analyzer 返回 "No files found"，导致无法读取 PROJECT_CHARTER.md 和 GLOBAL_STATE.md，跳过启动流程第 1 步。

根因

Glob 工具在 Windows 下对某些绝对路径匹配失败（/c/...、C:/...、C:\... 三种格式均复现），而 Bash ls 和 Read 工具对同一路径正常。

修复

更新 .claude/agents/dev-agent.md 启动流程第 1 步：将相对路径 docs/... 改为绝对路径 C:\Users\...\docs\...，并明确指示使用 Read 工具而非 Glob 搜索。PR #114。

验证

  • pytest: 103 passed, 29 skipped
  • CI: success
  • 本次 session 已成功通过 Read 工具读取两个文件

[pzhang_dev_agent_01]

## 问题 Dev-Agent 启动时 Glob 工具对项目目录 `C:\Users\peterz\projects\document_analyzer` 返回 "No files found"，导致无法读取 PROJECT_CHARTER.md 和 GLOBAL_STATE.md，跳过启动流程第 1 步。 ## 根因 Glob 工具在 Windows 下对某些绝对路径匹配失败（`/c/...`、`C:/...`、`C:\...` 三种格式均复现），而 Bash `ls` 和 Read 工具对同一路径正常。 ## 修复 更新 `.claude/agents/dev-agent.md` 启动流程第 1 步：将相对路径 `docs/...` 改为绝对路径 `C:\Users\...\docs\...`，并明确指示使用 Read 工具而非 Glob 搜索。PR #114。 ## 验证 - pytest: 103 passed, 29 skipped - CI: success - 本次 session 已成功通过 Read 工具读取两个文件 --- [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
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: zeekrAI/document_analyzer#113
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?