# 项目全局状态（截至 2026-06-02）

## 参考章程
详见 `PROJECT_CHARTER.md`。章程中定义的长期目标与原则是当前决策的最高依据。

## 当前阶段目标
核心目标（对齐章程）：**IR 功能覆盖率 ≥ 70%，IR 一致性稳定**

**本轮迭代**：
- 修复表格格式统计功能（#34）
- 继续提升 IR 结构化覆盖率（#21，当前 36.1%，目标 70%）
- 当前分支：`test/issue-33` — `_extract_content_units` 仅统计功能章节表格行

## Pipeline 架构

```
input/*.docx → doc_parser → _parsed.json
                           ↓
              step1_semantic_index → semantic_index.json
                           ↓
              step2_ir_extraction → ir_fragments.json
                           ↓
              step2_5_branch_coverage → ir_autocomplete_fragments.json
                           ↓
              step3_merge_and_audit → ir_final.json + ir_audit_report.md
```

核心模块：
- `skills/doc_parser_skill/` — 文档解析（文本、表格、图片、冲突检测）
- `skills/ir_generation_skill/` — IR 生成（step1/2/2.5/3）
- `tests/acceptance/` — 验收测试（Layer A Schema / Layer B Coverage / Layer C QE Audit）
- `scripts/agent_poller.py` — Gitea Issue/PR 操作工具

## 已探索方向 & 结论
| 方向 | 状态 | 结论摘要 | 关联 Issue |
|------|------|----------|------------|
| table coverage 统计 | 已闭合 | 只统计功能章节的表格行，非功能章节排除 | #33, #21 |
| rule_signature None-safe | 已闭合 | conditions=None 防御 + 0 行表格覆盖率 | #21 |
| step1 空章节过滤 | 已闭合 | _has_section_content() 过滤空章节 | #29 |
| trigger.operator null 修复 | 已闭合 | step3 _normalize_rule 修复 trigger 缺失/null | #22 |
| 覆盖反馈重试 | 已闭合 | _quick_validate 增加 section/table 覆盖率检查 | #21 |
| 多 Agent 协作闭环 | 已闭合 | Dev+QE 通过 Gitea Issues 协同迭代 | #15 |

## 已知问题清单
- [P0] IR 结构化覆盖率不足（#21）：当前 36.1%，目标 70%
- [中等] 章节中表格格式统计功能下降（#34）：表格缺行反馈不够具体
- [轻微] `_measure_coverage` overall 维度输出 0 个维度（#36，test-code，QE 域）
- [轻微] 缺少完整 e2e 测试（#18，blocked）

## 当前打开 Issue（非纯测试）
| # | 标题 | 优先级 |
|---|------|--------|
| #34 | 章节中表格格式统计功能下降 + 表格缺行反馈 | 中 |
| #21 | [P0] IR 结构化覆盖率不足 (36.1% < 70%) | P0 |

## 下次启动推荐起点
1. 读取 `docs/PROJECT_CHARTER.md` 和 `docs/GLOBAL_STATE.md` 了解项目全局状态
2. 运行 `python scripts/agent_poller.py --action list` 获取最新 Issue 列表
3. 优先处理 P0 Issue（#21），其次 #34
4. 关注 IR 覆盖率提升和表格统计修复

## 最近变更日志
| 日期 | 变更 | 原因 |
|------|------|------|
| 2026-06-02 | 创建 PROJECT_CHARTER.md 和 GLOBAL_STATE.md | 对齐 Agent 认知，建立项目全局视图 |
| 2026-06-02 | DEV_AGENT.md 更新：自行验证关闭 Issue，强调功能验证非 dry-run | 明确 Dev-Agent 责任边界 |
| 2026-06-01 | test: _extract_content_units 仅统计功能章节表格行 - Closes #33 | 修复表格覆盖率误计 |
| 2026-05-31 | fix: table coverage only counts functional sections + specific missing row feedback - Closes #21 | 表格覆盖率只统计功能章节 |
| 2026-05-31 | fix: rule_signature conditions=None防御 + 0行表格覆盖率 + UT覆盖 - Closes #21 | 防御性修复 |
| 2026-05-31 | fix: step1 空章节过滤 + step3 rule_signature None-safe - Closes #21 | 空章节过滤修复 |
| 2026-05-30 | test: _has_section_content() 过滤空章节 - Closes #29 | QE 发现空章节误报 |