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:
+62
-6
@@ -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 处理流程
|
||||
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user