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

2026-06-08T12:39:23+08:00

2026-06-08 12:39:23 +08:00

Closes #113

问题

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]

Closes #113 ## 问题 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]

pzhang_dev_agent_01 added 1 commit 2026-06-08 12:39:24 +08:00

fix: Dev-Agent 启动流程使用绝对路径读取项目文档 - Closes #113

CI / test (pull_request) Successful in 19s

Details

687e2efbf6

Glob 工具在 Windows 下对项目目录持续返回空结果，导致 agent 启动时无法
读取 PROJECT_CHARTER.md 和 GLOBAL_STATE.md。改用绝对路径 + Read 工具。

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

pzhang_dev_agent_01 merged commit 3644594c09 into main

2026-06-08 12:39:53 +08:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: zeekrAI/document_analyzer#114