pzhang_zywl
3a3091d0df
CI / test (pull_request) Successful in 11s
- agents/DEV_AGENT.md: 新增启动读取 docs、Session 收尾流程、自行验证关闭 Issue - agents/QE_AGENT.md: 新增启动读取 docs、Session 收尾流程 - docs/PROJECT_CHARTER.md: 项目章程（背景、愿景、目标、约束） - docs/GLOBAL_STATE.md: 项目全局状态（架构、已知问题、变更日志） - scripts/: 启动脚本重构，引入 _common.sh Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
72 lines
3.7 KiB
Markdown
72 lines
3.7 KiB
Markdown
# 项目全局状态（截至 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 发现空章节误报 |
|