# IIT Manager Agent 开发阶段与任务清单

> **版本：** V2.9  
> **更新日期：** 2026-02-05  
> **关联文档：** [IIT Manager Agent V2.6 综合开发计划](./IIT%20Manager%20Agent%20V2.6%20综合开发计划.md)
> 
> **V2.9.1 更新**：
> - **新增 Phase 1.5**：隐私安全与自动化工具（P0 合规必需）
> - Phase 1 新增 AutoMapperService 任务
> - Phase 3 新增反馈循环任务
> - Phase 4 新增 ProfilerService 和 Cron Skill 任务
> - Phase 5 新增多意图处理任务

---

## 1. 开发阶段总览

```
Phase 1          Phase 1.5        Phase 2          Phase 3          Phase 4          Phase 5          Phase 6
┌──────────┐    ┌──────────┐    ┌──────────┐    ┌──────────┐    ┌──────────┐    ┌──────────┐    ┌──────────┐
│基础工具层│ ──▶│ 隐私安全 │ ──▶│ SOP 引擎 │ ──▶│ReAct 引擎│ ──▶│ 调度系统 │ ──▶│ 智能路由 │ ──▶│ 视觉能力 │
│          │    │  P0必需  │    │ + 记忆L2 │    │ + 记忆L1 │    │ + 记忆L3 │    │          │    │ (延后)   │
└──────────┘    └──────────┘    └──────────┘    └──────────┘    └──────────┘    └──────────┘    └──────────┘
     ▼               ▼               ▼               ▼               ▼               ▼               ▼
 ToolsService   Anonymizer      SopEngine       ReActEngine    Scheduler       IntentService   VisionService
 FieldMapping   AutoMapper      HotMemory       FlowMemory     WeeklyReports   MixedRouting    (Postponed)
 HardRule       PII Audit       SoftRule        AgentTrace     ReportService   StreamingFB
```

---

## 2. Phase 1: 基础工具层

### 2.1 目标

- 搭建可复用的工具框架
- 实现字段映射机制
- 建立硬规则引擎

### 2.2 任务清单

| 任务ID | 任务名称 | 优先级 | 状态 | 前置依赖 |
|--------|----------|--------|------|----------|
| P1-01 | 创建 `iit_skills` 表 | 高 | 待开始 | - |
| P1-02 | 创建 `iit_field_mapping` 表 | 高 | 待开始 | - |
| P1-03 | 实现 `ToolsService` | 高 | 待开始 | P1-01 |
| P1-04 | 实现 `read_clinical_data` 工具 | 高 | 待开始 | P1-03 |
| P1-05 | 实现 `search_protocol` 工具 | 高 | 待开始 | P1-03 |
| P1-06 | 实现 `HardRuleEngine` | 高 | 待开始 | - |
| P1-07 | 集成字段映射到 ToolsService | 中 | 待开始 | P1-02, P1-03 |
| P1-08 | **[V2.9.1]** 实现 `AutoMapperService` | 中 | 待开始 | P1-02 |
| P1-09 | **[V2.9.1]** 实现 REDCap Data Dictionary 解析器 | 中 | 待开始 | P1-08 |
| P1-10 | **[V2.9.1]** 实现 LLM 语义映射 Job | 中 | 待开始 | P1-08 |
| P1-11 | **[V2.9.1]** 实现管理后台映射确认 UI | 低 | 待开始 | P1-10 |
| P1-12 | 单元测试覆盖 | 中 | 待开始 | P1-01~P1-11 |

### 2.3 验收标准

- [ ] 工具可通过名称调用
- [ ] 字段映射正确生效（LLM 用 "年龄" → 实际调用 "dem_age"）
- [ ] 硬规则拦截生效
- [ ] **[V2.9.1]** AutoMapper 可解析 REDCap Data Dictionary
- [ ] **[V2.9.1]** LLM 可生成字段映射建议
- [ ] 测试覆盖率 > 80%

---

## 2.5 Phase 1.5: 隐私安全与自动化工具（P0 合规必需）

> **⚠️ 重要**：此阶段必须在 Phase 2 调用 LLM 之前完成！
> 临床数据包含患者隐私信息，未脱敏直接发送给 LLM 将违反数据保护法规。

### 2.5.1 目标

- 实现 PII 脱敏中间件
- 建立脱敏审计日志
- 确保合规性

### 2.5.2 任务清单

| 任务ID | 任务名称 | 优先级 | 状态 | 前置依赖 |
|--------|----------|--------|------|----------|
| P1.5-01 | 创建 `iit_pii_audit_log` 表 | **P0** | 待开始 | - |
| P1.5-02 | 实现 PII 识别正则库 | **P0** | 待开始 | - |
| P1.5-03 | 实现 `AnonymizerService.mask()` | **P0** | 待开始 | P1.5-01, P1.5-02 |
| P1.5-04 | 实现 `AnonymizerService.unmask()` | **P0** | 待开始 | P1.5-03 |
| P1.5-05 | 实现脱敏映射加密存储 | 高 | 待开始 | P1.5-03 |
| P1.5-06 | 集成到 ChatService 调用链 | **P0** | 待开始 | P1.5-04 |
| P1.5-07 | 单元测试：各类 PII 识别 | 高 | 待开始 | P1.5-02 |
| P1.5-08 | 端到端测试：脱敏还原完整流程 | 高 | 待开始 | P1.5-01~P1.5-06 |

### 2.5.3 验收标准

- [ ] 身份证号正确识别并脱敏（18位）
- [ ] 手机号正确识别并脱敏（11位）
- [ ] 中文姓名正确识别并脱敏（2-4字）
- [ ] 病历号正确识别并脱敏
- [ ] LLM 收到的 Payload 不包含任何 PII
- [ ] LLM 回复正确还原占位符
- [ ] 审计日志正确记录（加密存储）

### 2.5.4 PII 脱敏流程

```
用户输入: "张三（身份证420101199001011234）今天血压偏高"
    ↓ AnonymizerService.mask()
LLM 收到: "[PATIENT_1]（身份证[ID_CARD_1]）今天血压偏高"
    ↓ 同时写入 iit_pii_audit_log（加密存储映射表）
    ↓ LLM 处理
LLM 返回: "[PATIENT_1] 的血压需要关注..."
    ↓ AnonymizerService.unmask()
用户看到: "张三 的血压需要关注..."
```

---

## 3. Phase 2: SOP 引擎 + 热记忆

### 3.1 目标

- 实现状态机驱动的 SOP 执行
- 搭建热记忆层（L2）
- 支持人工确认机制

### 3.2 任务清单

| 任务ID | 任务名称 | 优先级 | 状态 | 前置依赖 |
|--------|----------|--------|------|----------|
| P2-01 | 创建 `iit_task_run` 表 | 高 | 待开始 | - |
| P2-02 | 创建 `iit_pending_actions` 表 | 高 | 待开始 | - |
| P2-03 | 创建 `iit_project_memory` 表 | 高 | 待开始 | - |
| P2-04 | 实现 `SopEngine` 核心状态机 | 高 | 待开始 | P2-01 |
| P2-05 | 实现 `SoftRuleEngine` | 高 | 待开始 | - |
| P2-06 | 集成 SoftRuleEngine 到 SOP | 高 | 待开始 | P2-04, P2-05 |
| P2-07 | 实现 SUSPENDED 状态机制 | 高 | 待开始 | P2-04 |
| P2-08 | 实现人工确认流程 | 高 | 待开始 | P2-02, P2-07 |
| P2-09 | 实现 `MemoryService` 热记忆 | 中 | 待开始 | P2-03 |
| P2-10 | 集成热记忆到 SOP 上下文 | 中 | 待开始 | P2-04, P2-09 |
| P2-11 | 端到端测试：质控 SOP | 中 | 待开始 | P2-01~P2-10 |

### 3.3 验收标准

- [ ] 质控任务可自动执行完整 SOP
- [ ] 写操作正确等待人工确认
- [ ] SUSPENDED 状态正确持久化
- [ ] 热记忆正确注入 SOP 上下文
- [ ] 手动恢复执行成功

---

## 4. Phase 3: ReAct 引擎 + 流水账

### 4.1 目标

- 实现 ReAct 模式的灵活查询
- 搭建流水账层（L1）
- 实现只读安全约束

### 4.2 任务清单

| 任务ID | 任务名称 | 优先级 | 状态 | 前置依赖 |
|--------|----------|--------|------|----------|
| P3-01 | 创建 `iit_conversation_history` 表 | 高 | 待开始 | - |
| P3-02 | 创建 `iit_agent_trace` 表 | 中 | 待开始 | - |
| P3-03 | 实现 `ReActEngine` 核心循环 | 高 | 待开始 | P1-03 |
| P3-04 | 实现只读工具白名单 | 高 | 待开始 | P3-03 |
| P3-05 | 实现 `MemoryService` 流水账 | 高 | 待开始 | P3-01 |
| P3-06 | 实现向量化存储（pgvector） | 中 | 待开始 | P3-05 |
| P3-07 | 实现相似度检索 | 中 | 待开始 | P3-06 |
| P3-08 | 实现 Trace 记录机制 | 中 | 待开始 | P3-02, P3-03 |
| P3-09 | 实现流式反馈机制 | 高 | 待开始 | P3-03 |
| P3-10 | 实现 "正在思考" 状态提示 | 中 | 待开始 | P3-09 |
| P3-11 | 集成流水账到 ReAct 上下文 | 中 | 待开始 | P3-03, P3-05 |
| P3-12 | **[V2.9]** 扩展对话表支持反馈字段 | 中 | 待开始 | P3-01 |
| P3-13 | **[V2.9]** 实现反馈收集接口 | 中 | 待开始 | P3-12 |
| P3-14 | 端到端测试：模糊查询 | 中 | 待开始 | P3-01~P3-13 |

### 4.3 验收标准

- [ ] ReAct 可正确推理并调用工具
- [ ] 只读约束生效（无法调用写入工具）
- [ ] 流水账正确存储和检索
- [ ] Trace 记录可供调试
- [ ] 流式反馈 < 2秒首字节
- [ ] "正在思考" 状态正确显示
- [ ] **[V2.9]** 反馈按钮可正确收集用户反馈

---

## 5. Phase 4: 调度系统 + 历史书

### 5.1 目标

- 实现定时任务调度
- 实现周报生成
- 搭建历史书层（L3）

### 5.2 任务清单

| 任务ID | 任务名称 | 优先级 | 状态 | 前置依赖 |
|--------|----------|--------|------|----------|
| P4-01 | 创建 `iit_weekly_reports` 表 | 高 | 待开始 | - |
| P4-02 | 实现 `SchedulerService`（pg-boss） | 高 | 待开始 | - |
| P4-03 | 实现 `ReportService` | 高 | 待开始 | P4-01 |
| P4-04 | 实现周报自动生成 | 高 | 待开始 | P4-02, P4-03 |
| P4-05 | 实现记忆卷叠机制 | 中 | 待开始 | P4-01, P3-05 |
| P4-06 | 实现历史书检索 | 中 | 待开始 | P4-01 |
| P4-07 | 集成历史书到上下文组装 | 中 | 待开始 | P4-06 |
| P4-08 | **[V2.9]** 实现 `ProfilerService` | 中 | 待开始 | P2-03 |
| P4-09 | **[V2.9]** 扩展 Skill 表支持 Cron 触发 | 中 | 待开始 | P1-01 |
| P4-10 | **[V2.9]** 实现 Cron Skill 调度 | 中 | 待开始 | P4-02, P4-09 |
| P4-11 | **[V2.9]** 实现访视提醒 Skill | 中 | 待开始 | P4-10 |
| P4-12 | **[V2.9]** 集成用户画像到通知个性化 | 低 | 待开始 | P4-08, P4-11 |
| P4-13 | 端到端测试：周报生成 | 中 | 待开始 | P4-01~P4-12 |

### 5.3 验收标准

- [ ] 周报每周一自动生成
- [ ] 记忆卷叠每日自动执行
- [ ] 历史书检索正确召回
- [ ] **[V2.9]** 用户画像正确存储在 project_memory
- [ ] **[V2.9]** Cron Skill 按时触发
- [ ] **[V2.9]** 访视提醒正确发送给目标用户

---

## 6. Phase 5: 智能路由

### 6.1 目标

- 实现意图识别服务
- 实现混合路由（正则 + LLM）
- 实现追问机制

### 6.2 任务清单

| 任务ID | 任务名称 | 优先级 | 状态 | 前置依赖 |
|--------|----------|--------|------|----------|
| P5-01 | 实现 `IntentService` | 高 | 待开始 | - |
| P5-02 | 实现正则快速通道 | 高 | 待开始 | P5-01 |
| P5-03 | 实现 LLM 意图识别 | 高 | 待开始 | P5-01 |
| P5-04 | 实现降级策略 | 中 | 待开始 | P5-01~P5-03 |
| P5-05 | 实现追问机制 | 中 | 待开始 | P5-01 |
| P5-06 | 扩展 `ChatService` 集成路由 | 高 | 待开始 | P5-01~P5-05 |
| P5-07 | **[V2.9]** 优化 ReAct Prompt 支持多意图 | 中 | 待开始 | P3-03 |
| P5-08 | 端到端测试：路由分发 | 中 | 待开始 | P5-01~P5-07 |

### 6.3 验收标准

- [ ] 简单指令 < 50ms 命中快速通道
- [ ] 复杂句子正确识别意图
- [ ] UNCLEAR 情况正确追问
- [ ] LLM 不可用时正确降级
- [ ] **[V2.9]** 多意图消息正确拆分并顺序执行

---

## 7. Phase 6: 视觉能力（延后）

> ⚠️ **注意**：根据风险评估，视觉能力延后到核心功能稳定后再开发。

### 7.1 目标

- 实现图片识别能力
- 支持知情同意书识别
- 支持 CRF 扫描件识别

### 7.2 任务清单

| 任务ID | 任务名称 | 优先级 | 状态 | 前置依赖 |
|--------|----------|--------|------|----------|
| P6-01 | 评估 GPT-4V / 通义千问-VL | 低 | 延后 | P1~P5 完成 |
| P6-02 | 实现 `VisionService` | 低 | 延后 | P6-01 |
| P6-03 | 集成到 ChatService | 低 | 延后 | P6-02 |
| P6-04 | 端到端测试 | 低 | 延后 | P6-03 |

### 7.3 延后原因

1. 核心功能优先级更高
2. 视觉能力成本较高
3. 需要更多真实场景验证

---

## 8. 里程碑与依赖关系

```mermaid
gantt
    title IIT Manager Agent 开发里程碑
    dateFormat  YYYY-MM-DD
    section Phase 1
    基础工具层           :p1, 2026-02-10, 14d
    section Phase 2
    SOP 引擎 + 热记忆    :p2, after p1, 21d
    section Phase 3
    ReAct 引擎 + 流水账  :p3, after p2, 14d
    section Phase 4
    调度系统 + 历史书    :p4, after p3, 14d
    section Phase 5
    智能路由             :p5, after p4, 7d
    section Phase 6
    视觉能力             :p6, after p5, 14d
```

---

## 9. 风险与对策

| 风险 | 影响 | 对策 | 已整合 |
|------|------|------|--------|
| ReAct 决策链过长 | 延迟 > 10秒 | 流式反馈 + "正在思考" 状态 | ✅ |
| 混合意图难分类 | 用户困惑 | UNCLEAR + 追问机制 | ✅ |
| ReAct 误调写入工具 | 数据风险 | 只读工具白名单 | ✅ |
| UI 无响应感 | 体验差 | 流式反馈 + 状态提示 | ✅ |
| SOP 中途被打断 | 任务丢失 | SUSPENDED 状态 + 恢复机制 | ✅ |
| 视觉能力分散精力 | 核心功能延迟 | 延后到 Phase 6 | ✅ |
| **[V2.9]** 用户多意图混乱 | 任务遗漏 | ReAct Prompt 多意图拆分 | ✅ |
| **[V2.9]** 回复不符用户偏好 | 体验差 | 反馈循环 + 用户画像 | ✅ |
| **[V2.9]** 主动提醒打扰用户 | 用户投诉 | 最佳通知时间 + 个性化 | ✅ |
| **[V2.9.1]** 患者隐私泄露给 LLM | **法律风险** | PII 脱敏中间件 + 审计日志 | ✅ |
| **[V2.9.1]** 字段映射配置繁琐 | 效率低 | AutoMapper LLM 语义匹配 | ✅ |

---

## 10. 性能指标

| 指标 | 目标值 | 测量方法 |
|------|--------|----------|
| 快速通道响应 | < 50ms | 正则匹配耗时 |
| LLM 意图识别 | < 1s | API 调用耗时 |
| SOP 单步执行 | < 2s | 包含工具调用 |
| ReAct 完整推理 | < 10s | 最多 5 轮循环 |
| 流式首字节 | < 2s | 第一个 token |
| 周报生成 | < 30s | 后台任务 |
| 向量检索 | < 500ms | Top-5 结果 |

---

**文档维护人**：AI Agent  
**最后更新**：2026-02-05