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

[product] 统一 Agent 定义文件，删除 agents/ 遗留目录 #128

New Issue
Closed
opened 2026-06-08 22:21:47 +08:00 by pzhang_zywl · 2 comments
pzhang_zywl commented 2026-06-08 22:21:47 +08:00
Owner
Copy Link
Copy Source

背景

项目当前存在两套 Agent 定义文件，引用不一致：

路径 行数 引用方
.claude/agents/dev-agent.md 155 行（精简版） start_dev_agent.sh
.claude/agents/qe-agent.md 348 行 start_dev_agent.sh / start_qe_agent.sh
agents/DEV_AGENT.md 470 行（详细版，含禁止模式、研究型修复流程、质量级批处理策略、关闭规范示例） start_dev_agent.bat、GITEA_CICD_SETUP.md、PROJECT_CHARTER.md
agents/QE_AGENT.md 347 行 PROJECT_CHARTER.md、docs/QE_AGENT_WORKFLOW.html

目标：只保留一套，即 .claude/agents/{dev,qe}-agent.md。

要做的事

  1. 替换 .claude/agents/dev-agent.md → 用 agents/DEV_AGENT.md 的内容覆盖（470 行详细版），注意 frontmatter 用 kebab-case name
  2. 替换 .claude/agents/qe-agent.md → 用 agents/QE_AGENT.md 的内容覆盖（347 行版），同上
  3. 删除以下文件：
    • agents/DEV_AGENT.md
    • agents/QE_AGENT.md
    • agents/AGENT.md
    • scripts/start_dev_agent.bat（功能已被 start_dev_agent.sh + _common.sh 替代，且缺少 worktree 隔离）
    • GITEA_CICD_SETUP.md（内容已过时，引用旧路径）
  4. 更新 docs/PROJECT_CHARTER.md 第 39 行：
    • 旧：agents/DEV_AGENT.md、agents/QE_AGENT.md
    • 新：.claude/agents/dev-agent.md、.claude/agents/qe-agent.md
  5. 更新 docs/QE_AGENT_WORKFLOW.html（如有 agents/QE_AGENT.md 引用，改为 .claude/agents/qe-agent.md）

根因

项目从早期 agents/ 目录迁移到 Claude Code 标准 .claude/agents/ 时，只更新了 .sh 脚本，.bat 脚本和文档未同步，导致两套文件并存、内容开始分化。

[pzhangzywl]

## 背景 项目当前存在两套 Agent 定义文件，引用不一致： | 路径 | 行数 | 引用方 | |------|------|--------| | `.claude/agents/dev-agent.md` | 155 行（精简版） | `start_dev_agent.sh` | | `.claude/agents/qe-agent.md` | 348 行 | `start_dev_agent.sh` / `start_qe_agent.sh` | | `agents/DEV_AGENT.md` | 470 行（详细版，含禁止模式、研究型修复流程、质量级批处理策略、关闭规范示例） | `start_dev_agent.bat`、`GITEA_CICD_SETUP.md`、`PROJECT_CHARTER.md` | | `agents/QE_AGENT.md` | 347 行 | `PROJECT_CHARTER.md`、`docs/QE_AGENT_WORKFLOW.html` | 目标：**只保留一套，即 `.claude/agents/{dev,qe}-agent.md`**。 ## 要做的事 1. **替换 `.claude/agents/dev-agent.md`** → 用 `agents/DEV_AGENT.md` 的内容覆盖（470 行详细版），注意 frontmatter 用 kebab-case name 2. **替换 `.claude/agents/qe-agent.md`** → 用 `agents/QE_AGENT.md` 的内容覆盖（347 行版），同上 3. **删除以下文件**： - `agents/DEV_AGENT.md` - `agents/QE_AGENT.md` - `agents/AGENT.md` - `scripts/start_dev_agent.bat`（功能已被 `start_dev_agent.sh` + `_common.sh` 替代，且缺少 worktree 隔离） - `GITEA_CICD_SETUP.md`（内容已过时，引用旧路径） 4. **更新 `docs/PROJECT_CHARTER.md`** 第 39 行： - 旧：`agents/DEV_AGENT.md`、`agents/QE_AGENT.md` - 新：`.claude/agents/dev-agent.md`、`.claude/agents/qe-agent.md` 5. **更新 `docs/QE_AGENT_WORKFLOW.html`**（如有 `agents/QE_AGENT.md` 引用，改为 `.claude/agents/qe-agent.md`） ## 根因 项目从早期 `agents/` 目录迁移到 Claude Code 标准 `.claude/agents/` 时，只更新了 `.sh` 脚本，`.bat` 脚本和文档未同步，导致两套文件并存、内容开始分化。 --- [pzhangzywl]
pzhang_zywl added the product-code label 2026-06-08 22:21:47 +08:00
pzhang_dev_agent_01 commented 2026-06-08 22:40:44 +08:00
Collaborator
Copy Link
Copy Source

PR 已创建: #129

变更:

  • .claude/agents/dev-agent.md: 155 行精简版 → 470 行详细版（含禁止模式、研究型修复流程、质量级批处理策略、关闭规范、session 收尾）
  • .claude/agents/qe-agent.md: frontmatter name 统一为 kebab-case，内容同步最新
  • 删除遗留文件 5 个: agents/{DEV,QE}_AGENT.md, agents/AGENT.md, scripts/start_dev_agent.bat, GITEA_CICD_SETUP.md
  • 更新路径引用 2 处: PROJECT_CHARTER.md, QE_AGENT_WORKFLOW.html

等待 CI 通过后 merge。

[pzhang_dev_agent_01]

PR 已创建: https://git.zywl.me/zeekrAI/document_analyzer/pulls/129 变更: - .claude/agents/dev-agent.md: 155 行精简版 → 470 行详细版（含禁止模式、研究型修复流程、质量级批处理策略、关闭规范、session 收尾） - .claude/agents/qe-agent.md: frontmatter name 统一为 kebab-case，内容同步最新 - 删除遗留文件 5 个: agents/{DEV,QE}_AGENT.md, agents/AGENT.md, scripts/start_dev_agent.bat, GITEA_CICD_SETUP.md - 更新路径引用 2 处: PROJECT_CHARTER.md, QE_AGENT_WORKFLOW.html 等待 CI 通过后 merge。 --- [pzhang_dev_agent_01]
pzhang_dev_agent_01 commented 2026-06-08 22:42:09 +08:00
Collaborator
Copy Link
Copy Source

问题

项目存在两套 Agent 定义文件：.claude/agents/（155 行精简版）和 agents/（470 行详细版），引用路径不一致，内容已分化。

根因

项目从早期 agents/ 目录迁移到 Claude Code 标准 .claude/agents/ 时，只更新了 .sh 脚本，.bat 脚本和文档未同步，导致两套文件并存。

修复

  • 用 agents/DEV_AGENT.md 470 行详细版覆盖 .claude/agents/dev-agent.md，frontmatter name 使用 kebab-case
  • 用 agents/QE_AGENT.md 覆盖 .claude/agents/qe-agent.md，同上
  • 删除 5 个遗留文件：agents/{DEV,QE}_AGENT.md、agents/AGENT.md、scripts/start_dev_agent.bat、GITEA_CICD_SETUP.md
  • 更新 PROJECT_CHARTER.md 和 QE_AGENT_WORKFLOW.html 中的路径引用

验证

  • pytest: 103 passed, 29 skipped — 纯文档变更，无代码回归
  • PR #129 CI: success (20s)
  • 确认 .claude/agents/ 为唯一 Agent 定义目录，所有引用路径一致

[pzhang_dev_agent_01]

## 问题 项目存在两套 Agent 定义文件：.claude/agents/（155 行精简版）和 agents/（470 行详细版），引用路径不一致，内容已分化。 ## 根因 项目从早期 agents/ 目录迁移到 Claude Code 标准 .claude/agents/ 时，只更新了 .sh 脚本，.bat 脚本和文档未同步，导致两套文件并存。 ## 修复 - 用 agents/DEV_AGENT.md 470 行详细版覆盖 .claude/agents/dev-agent.md，frontmatter name 使用 kebab-case - 用 agents/QE_AGENT.md 覆盖 .claude/agents/qe-agent.md，同上 - 删除 5 个遗留文件：agents/{DEV,QE}_AGENT.md、agents/AGENT.md、scripts/start_dev_agent.bat、GITEA_CICD_SETUP.md - 更新 PROJECT_CHARTER.md 和 QE_AGENT_WORKFLOW.html 中的路径引用 ## 验证 - pytest: 103 passed, 29 skipped — 纯文档变更，无代码回归 - PR #129 CI: success (20s) - 确认 .claude/agents/ 为唯一 Agent 定义目录，所有引用路径一致 --- [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#128
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?