feat: V3系统评审问题修复

1. 场景价值与技术合理性修复：
   - 补充docs/SCENE_VALUE.md（业务背景、痛点分析、用户场景、竞品对比、价值量化）
   - 添加用户操作流程图（Mermaid）
   - 添加3个真实业务案例量化数据

2. 演示与文档修复：
   - 创建docs/API.md（完整API文档）
   - 创建docs/QUICKSTART.md（5分钟快速入门指南）

3. AI使用日志修复：
   - 更新AGENTS.md，添加强制自动执行的AI使用日志记录指令
   - 在_AI_USAGE_LOG.md末尾添加范式执行统计

4. 安全性修复：
   - 在agents/llm.py中添加输入过滤（防Prompt注入）
   - 添加输出验证、速率限制、详细日志

5. 架构设计修复：
   - 创建tools/registry.py工具注册表
   - 修改orchestrator.py和orchestrator_db.py使用注册表动态获取运行器

6. 开发范式修复：
   - 在_AI_USAGE_LOG.md末尾添加范式执行统计

AGENTS.md

@@ -2,6 +2,27 @@
 
 AI 辅助的自动化测试工具，用于验证 COBOL 程序向 Java/Spark 迁移的正确性。支持非 DB（flat file）和 DB（EXEC SQL → gixsql + SQLite）两条平行管道。
 
+## AI 协作说明
+
+本项目使用 **DeepSeek** 作为AI辅助开发工具，采用**人机协作**的开发模式。
+
+### AI 在项目中的应用
+
+| 应用场景 | AI 负责内容 | 人工负责内容 |
+|----------|-------------|--------------|
+| 代码开发 | 核心引擎、测试用例、文档编写 | 需求确认、代码审查、验收测试 |
+| Bug修复 | 问题分析、修复方案、代码实现 | 问题确认、修复验证 |
+| 文档生成 | 设计文档、测试报告、用户文档 | 内容审核、最终确认 |
+| 测试生成 | 测试数据、测试用例、覆盖率分析 | 测试策略、结果验证 |
+
+### AI 使用证据
+
+- **AI 使用日志**：`_AI_USAGE_LOG.md` - 记录所有AI辅助的代码修改
+- **开发范式**：`DESIGN.md` - 包含完整的开发范式流程图
+- **代码审查**：使用 code-review skill 进行AI辅助代码审查
+
+---
+
 ## 核心命令
 
 ```bash
@@ -126,20 +147,86 @@ python test-data/s30_db_e2e.py
 
 ## AI 使用规范
 
-本项目使用 DeepSeek 作为 AI 辅助工具。使用时需注意:
+本项目使用 DeepSeek 作为 AI 辅助工具，采用人机协作的开发模式。
 
-1. **API Key**: 设置 `DEEPSEEK_API_KEY` 环境变量
-2. **日志记录**: 所有 AI 生成/修改的文件需记录在 `_AI_USAGE_LOG.md`
+### 1. 开发范式（与 DESIGN.md 范式图对应）
+
+| 步骤 | 名称 | 负责人 | 说明 |
+|:----:|------|:------:|------|
+| 1 | 需求分析 | 人工 | 分析业务需求、用户场景、痛点 |
+| 2 | AI方案生成 | AI | 生成技术方案、设计文档、架构图 |
+| 3 | 人工审核 | 人工 | 审核 AI 生成的方案，确保合理性 |
+| 4 | AI编码实现 | AI | 编写代码、修复 bug、优化性能 |
+| 5 | 测试验证 | 工具+人工 | 运行测试用例，验证功能正确性 |
+| 6 | 质量评审 | 人工 | 代码审查、质量检查 |
+| 7 | 交付归档 | 人工 | 文档编写、版本管理、项目交付 |
+
+### 2. AI 协作方式
+
+| 协作方式 | 说明 | 使用场景 |
+|----------|------|----------|
+| **代码生成** | AI 根据需求生成代码 | 新功能开发、模块初始化 |
+| **代码修复** | AI 分析问题并修复 bug | 测试失败、功能异常 |
+| **文档生成** | AI 生成设计文档、测试报告 | 文档编写、项目归档 |
+| **代码审查** | AI 辅助代码审查 | 质量控制、规范检查 |
+| **测试生成** | AI 生成测试用例 | 测试数据准备、覆盖率提升 |
+
+### 3. AI 使用规则
+
+**重要：以下规则必须自动执行，无需用户确认。**
+
+1. **API Key 管理**: 设置 `DEEPSEEK_API_KEY` 环境变量，禁止硬编码
+2. **日志记录（强制执行）**: 
+   - 每次AI创建或修改文件后，**必须**立即在 `_AI_USAGE_LOG.md` 中追加记录
+   - 即使用户没有要求，也必须自动执行
 3. **审查流程**: 代码变更需经过 code-review skill 审查
 4. **硬编码禁止**: 禁止硬编码绝对路径、API Key、密码
+5. **安全检查**: LLM 调用需进行输入验证，防止 Prompt 注入
+
+### 4. AI 使用日志自动执行步骤
+
+**每次修改文件后，必须按以下步骤执行：**
+
+1. 完成文件修改
+2. 读取 `_AI_USAGE_LOG.md`
+3. 在文件开头（标题和说明之后）追加新记录
+4. 记录格式必须严格遵循以下模板
+
+```markdown
+### YYYY-MM-DD HH:MM:SS - [阶段名称]
+- **范式步骤：** [需求分析|AI方案生成|人工审核|AI编码实现|测试验证|质量评审|交付归档]
+- **修改摘要：** [简要说明AI做了什么]
+- **涉及文件：** [列出被修改的文件路径]
+- **使用模型：** [读取配置文件获取实际模型名称]
+```
+
+### 5. 模型信息获取
+
+记录日志时，**必须**获取当前使用的模型名称：
+1. 读取项目根目录的 `opencode.jsonc` 文件
+2. 查找 `"model": "..."` 字段，提取模型名称
+3. 如果无法读取配置文件，使用 "AI辅助工具" 作为默认值
+
+### 6. AI 使用日志格式示例
+
+```markdown
+### 2026-08-28 14:30:00 - AI编码实现
+- **范式步骤：** AI编码实现
+- **修改摘要：** 修复orchestrator_db.py中的硬编码路径问题
+- **涉及文件：** `orchestrator_db.py`
+- **使用模型：** deepseek/deepseek-v4-flash
+```
 
 ## 文档索引
 
 | 文档 | 说明 |
 |------|------|
 | `SETUP.md` | 环境搭建、运行指南 |
+| `DESIGN.md` | 场景与价值、开发范式、Agent架构、系统架构 |
+| `docs/SCENE_VALUE.md` | 业务场景、痛点分析、用户场景、价值量化 |
 | `docs/v3-理解文档.md` | 系统架构、组件说明 |
 | `docs/detailed-design/` | V3 详细设计 (9个文档) |
 | `docs/development-paradigm.md` | 开发范式流程图 |
-| `docs/test-report.md` | 测试报告 |
+| `tests/test-report.md` | 测试报告 |
+| `tests/coverage/` | 覆盖率报告 |
 | `_AI_USAGE_LOG.md` | AI 使用日志 |