背景

当前三只鹦鹉（MemoParrot、ScheduleParrotV2、AmazingParrot）存在以下问题：

• ~70% 代码重复：ReAct 循环、缓存、统计等逻辑高度重复
• 架构不统一：ScheduleParrotV2 使用 Native Tool Calling，其他使用 ReAct
• 扩展困难：新增能力需要修改多处代码

目标

创建 UniversalParrot 统一基类，三只鹦鹉仅在 Prompt 和 工具链 上有差异。

架构决策

基于 Agent 设计模式调研报告，确认以下决策：

详细设计文档

UniversalParrot 统一架构设计文档 已完成 ✅

设计文档包含：

• 组件架构图
• 工具集注册表设计
• 快速通道策略
• 数据结构定义
• 5 个实现阶段详解
• 关键代码实现片段
• 风险缓解措施

实现计划

Phase 1: UniversalParrot 基类

• 创建 ai/agent/universal_parrot.go
• 统一 ReAct 循环引擎
• 实现快速通道（Native Tool Calling）
• 能力声明式工具管理
• 统一 SessionStats 收集

Phase 2: PromptRegistry 扩展

• 扩展 ai/agent/prompt_registry.go
• 迁移 MemoParrot prompt
• 迁移 ScheduleParrotV2 prompt
• 迁移 AmazingParrot prompt

Phase 3: 三鹦鹉重构

• 重构 MemoParrot 基于 UniversalParrot
• 重构 ScheduleParrotV2 基于 UniversalParrot
• 重构 AmazingParrot 基于 UniversalParrot

Phase 4: 调用方更新

• 更新 ChatRouter
• 更新 GeekParrot（如需）
• 更新所有测试文件

Phase 5: 清理

• 删除重复代码
• 更新文档
• 性能验证

参考文档

• Agent 设计模式调研报告 2026
• UniversalParrot 统一架构设计文档 ⭐ 新增
• Anthropic: How we built our multi-agent research system
• Google: Towards a Science of Scaling Agent Systems

验收标准

• 三只鹦鹉功能与重构前完全一致
• 代码重复率 < 10%
• 所有测试通过
• 性能无明显下降
• 文档更新完成

Co-Authored-By: Claude Opus 4.6