# 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_01`，QE: `pzhang_qe_agent_01`）
- **所有 Gitea API 操作必须通过 `python scripts/agent_poller.py`**，禁止直接 curl 或硬编码 token

## 核心规则

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**: 仅加载本文件，使用人类用户身份工作