Files
document_analyzer/CLAUDE.md
pzhang_zywl 1ae09452d2
CI / test (pull_request) Successful in 25s
test: 添加 Agent session 上下文压缩规则 — Closes #115
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-06-08 14:19:21 +08:00

1.9 KiB
Raw Permalink Blame History

document_analyzer — PRD-to-IR Pipeline

基于 AI 的车机 PRD 文档解析与结构化 IR 生成 pipeline。通过 Dev-Agent 与 QE-Agent 协同迭代,探索 AI Agent 多智能体协作的软件工程闭环。

项目文档(session 启动时读取)

使用 Read 工具加载以下文件(绝对路径,不要用 Glob):

  • C:\Users\peterz\projects\document_analyzer\docs\PROJECT_CHARTER.md — 项目愿景、目标、架构、约束
  • C:\Users\peterz\projects\document_analyzer\docs\GLOBAL_STATE.md — 当前阶段目标、已知问题、最近变更

Gitea 配置

  • 配置文件:~/.gitea/config.yaml,按 GITEA_USER 环境变量选择 profile
  • 默认使用人类用户身份(generic session):export GITEA_USER=pzhangzywl
  • Agent 身份通过各自环境变量设置(Dev: pzhang_dev_agent_01QE: pzhang_qe_agent_01
  • 所有 Gitea API 操作必须通过 python scripts/agent_poller.py,禁止直接 curl 或硬编码 token

上下文管理

Context window 有限。当 session 持续较长时间时:

  1. 根据对话轮次和消息长度估计 context 使用量
  2. 使用量达 ~80% 时主动使用 /compact 压缩对话
  3. 压缩时保留:当前 Issue 上下文、GLOBAL_STATE.mdPROJECT_CHARTER.md、Agent 角色定义
  4. 压缩后从摘要恢复上下文,继续当前任务

核心规则

  1. 代码改动走完整流程:Issue → 分支 → 开发/UT → pytest → PR → CI → merge → 自行验证 → 关闭 Issue
  2. 关闭 Issue 必须包含 4 要素:问题 / 根因 / 修复 / 验证

Agent 模式

  • Dev-Agent: 启动时自动加载 .claude/agents/dev-agent.md(功能开发、重构、UT、接口集成测试)
  • QE-Agent: 启动时自动加载 .claude/agents/qe-agent.md(验收测试、质量门禁)
  • Generic session: 仅加载本文件,使用人类用户身份工作