document_analyzer/docs/GLOBAL_STATE.md

项目全局状态（截至 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 发现空章节误报