docs(deliverables): 参赛成果物补齐(README 五项 + 范式图/架构图 + coverage 报告)

按《参赛成果物提交规范·赛道一》§8:
- README:新增项目性质:新规声明、项目概述、整体功能说明、效果总结
  (431 测试/99.15% 覆盖/双语试运行/影响调查基线)、团队分工、规模与难度自评
- design.md:开发范式流程图(mermaid,6 步与 AI 日志步骤列一致)+ §2.1
  Agent 架构图(感知-规划-行动-记忆映射)
- _AI_USAGE_LOG.md:回填「待补充」→架构设计、「整体迭代」→反馈迭代
- tests/coverage/ 覆盖率 HTML 报告(99.15%)+ tests/test-execution-log.txt 执行日志
- docs/参赛成果物提交规范-赛道一.md → docs/submission-spec-track1.md(ASCII 化)
- pyproject: pytest norecursedirs 排除 test-execution-log.txt
全量 pytest 431 passed / 99.15%
This commit is contained in:
lhl
2026-08-26 14:24:02 +08:00
parent becd3e1f57
commit a1fefd43eb
66 changed files with 16833 additions and 8 deletions
+62 -6
View File
@@ -42,13 +42,30 @@
### 1.3 开发范式
本项目的开发遵循 5 个步骤,对应 AI 使用日志的"范式步骤"列:
本项目的开发遵循 6 个步骤,对应 AI 使用日志的"范式步骤"列(评审时按 范式图 ↔ AI 日志 逐步骤对照验证)
1. **需求理解** — 分析大赛规则,理解概要设计书生成需求
2. **架构设计** — AI 生成方案,人工审核设计
3. **Agent 实现** — AI 编码实现各 Agent 模块
4. **测试验证** — 单元测试与集成测试验证
5. **反馈迭代** — 基于测试结果反馈修正
```mermaid
flowchart LR
A[需求理解<br/>分析大赛规则] --> B[架构设计<br/>AI 生成方案 + 人工审核]
B --> C[Agent 实现<br/>AI 编码实现各模块]
C --> D[测试验证<br/>TDD 单元/集成测试]
D --> E[反馈迭代<br/>基于测试结果修正]
E -. 未达标 .-> C
E -. 文档沉淀 .-> F[文档规范<br/>设计文档/AI 日志同步]
F -. 新需求 .-> A
```
| 步骤 | 说明 |
|---|---|
| 需求理解 | 分析大赛规则,理解概要设计书生成需求 |
| 架构设计 | AI 生成方案,人工审核设计 |
| Agent 实现 | AI 编码实现各 Agent 模块(TDD RED→GREEN→REFACTOR |
| 测试验证 | 单元测试与集成测试验证(覆盖率红线 99%) |
| 反馈迭代 | 基于测试结果反馈修正 |
| 文档规范 | 设计文档、`_AI_USAGE_LOG.md`、参赛成果物同步更新 |
> AI 使用日志"范式步骤"列取值与上表一致;历史日志中出现的「整体迭代」归一为「反馈迭代」。
> 每次 AI 修改代码后自动追加日志(规则写入 `AGENTS.md`,由 AI 自动执行)。
---
@@ -88,6 +105,45 @@
└─────────────┘
```
#### Agent 架构图(感知-规划-行动-记忆,评审必检)
按评审要求的「感知-规划-行动-记忆」框架映射系统能力:
```mermaid
flowchart TB
subgraph 感知[感知 Perception]
P1[Parser Agent<br/>Excel/docx/Java 解析]
P2[RAG 检索<br/>规则文档切片/召回]
P3[Impact Agent<br/>既有系统影响调查]
end
subgraph 规划[规划 Planning]
PL1[章节 ↔ 模板映射<br/>template_mapper]
PL2[上下文装配<br/>build_contexts]
PL3[章节级数据定向<br/>CHAPTER_SHEET_TYPES]
end
subgraph 行动[行动 Action]
A1[Writer Agent<br/>LLM 分章生成]
A2[语言一致性强制<br/>language.py]
A3[Docx 注入<br/>docx_injector]
end
subgraph 记忆[记忆 Memory]
M1[StructuredSource<br/>结构化输入/Provenance]
M2[WriterState<br/>章间引用]
M3[ImpactReport<br/>影响调查书]
M4[会话存储<br/>sqlite/快照]
end
感知 --> 规划 --> 行动 --> 记忆
记忆 -. 上下文回读 .-> 规划
记忆 -. 状态回读 .-> 行动
```
| 框架 | 系统能力 |
|---|---|
| 感知 | Parser Agent 解析输入、RAG 规则检索、Impact Agent 既有系统影响调查 |
| 规划 | 章节↔模板映射、上下文装配、章节级数据定向注入 |
| 行动 | Writer Agent 分章生成 + 语言一致性强制 + docx 注入 |
| 记忆 | StructuredSource / WriterState / ImpactReport / 会话存储 |
### 2.2 处理流程
```