Skip to content

PROJECT_OVERVIEW.md

Latest commit

 

History

History
282 lines (213 loc) · 8.65 KB

PROJECT_OVERVIEW.md

File metadata and controls

282 lines (213 loc) · 8.65 KB
Raw

多智能体项目管理模拟系统 - 项目总览

项目信息

项目名称：多智能体项目管理模拟系统
开发目的：模拟完整的软件项目管理流程
技术栈：Python 3.8+, OpenAI API, Markdown
版本：1.0.0
开发日期：2025年1月

核心价值

本系统通过多智能体协作模拟真实的软件项目管理过程，涵盖：

✅ 6个项目阶段：预启动 → 启动 → 计划 → 执行 → 控制 → 结束
✅ 3个关键角色：项目发起人、项目经理、项目组成员
✅ 完整的文档体系：从项目章程到最终总结报告
✅ 挣值分析（EVM）：跟踪项目成本和进度绩效
✅ 智能决策：基于LLM的智能体自主决策

系统特色

1. 真实的项目管理流程

严格按照PMBOK（项目管理知识体系）标准，模拟真实项目的：

  • 需求分析和项目章程制定
  • 三大约束（成本、范围、进度）确定
  • WBS分解和管理计划制定
  • 执行-控制循环
  • 挣值分析（EVM）
  • 最终验收和项目总结

2. 多智能体协作

三个智能体各司其职，通过共享数据库协作：

角色 职责 关键方法
项目发起人 提需求、做决策、验收 state_requirements(), review_product(), final_acceptance()
项目经理 计划、协调、分析 draft_charter(), create_wbs(), perform_evm_analysis()
项目组成员 开发代码、报告进展 develop_code(), report_progress()

3. 智能记忆系统

三层记忆架构确保智能体能够：

  • 短期记忆：保持对话上下文（最近10轮）
  • 工作记忆：存储当前任务的临时数据
  • 长期记忆：访问项目历史数据（通过共享数据库）

4. 完整的交付物

每次模拟生成：

  • 📄 8+ 项目管理文档（Markdown格式）
  • 💻 2-5 个代码文件（Python）
  • 📊 EVM分析报告（每个循环一份）
  • 📦 完整项目数据（JSON格式）

5. 灵活可扩展

  • 易于添加新的智能体角色
  • 可自定义项目阶段
  • 支持自定义文档模板
  • 配置化的Agent行为（通过提示词）

技术架构

┌─────────────────────────────────────────────┐
│         WorkflowEngine (工作流引擎)           │
│         控制6个项目阶段的执行                   │
└─────────┬───────────────────────┬───────────┘
          │                       │
┌─────────▼─────────┐   ┌────────▼─────────┐
│  Agents (智能体)    │   │  SharedDB (数据库) │
│  - SponsorAgent   │◄─►│  - 项目数据        │
│  - ManagerAgent   │   │  - 文档记录        │
│  - TeamMemberAgent│   │  - 讨论历史        │
└─────────┬─────────┘   └────────┬─────────┘
          │                       │
┌─────────▼─────────┐   ┌────────▼─────────┐
│  LLMClient        │   │  DocumentGenerator│
│  - API调用        │   │  - 文档生成        │
│  - 重试机制        │   │  - 代码保存        │
└───────────────────┘   └──────────────────┘

使用场景

1. 教育培训

  • 项目管理课程：学生了解项目管理流程
  • 软件工程课程：演示软件项目生命周期
  • 团队协作训练：理解不同角色的职责

2. 项目规划

  • 项目可行性分析：快速模拟项目流程
  • 资源估算：了解项目所需资源
  • 风险识别：发现潜在问题

3. 研究实验

  • 多智能体系统研究：研究智能体协作
  • 项目管理算法：测试不同的管理策略
  • 决策支持系统：辅助项目决策

关键数据

指标 数值
代码文件数 15+ Python文件
代码总行数 2000+ 行
支持的项目阶段 6个
智能体角色数 3个
文档模板数 8+ 种
可配置参数 20+ 项

实现亮点

1. 模块化设计

每个模块职责清晰，易于维护和扩展：

  • agents/ - 智能体模块
  • database/ - 数据存储模块
  • workflow/ - 工作流控制模块
  • utils/ - 工具模块

2. 容错机制

  • API调用失败时使用模拟响应
  • 数据解析失败时使用默认数据
  • 文件操作异常时记录错误继续执行

3. 可追溯性

  • 所有操作记录到数据库
  • 带时间戳的日志
  • 完整的讨论历史
  • 可导出为JSON格式

4. 标准化输出

  • Markdown格式文档，易于阅读
  • 统一的文档结构
  • 符合项目管理规范
  • 包含必要的签字栏

项目文件结构

ProjectManagement/
├── agents/                      # 智能体模块
│   ├── __init__.py
│   ├── base_agent.py           # Agent基类
│   ├── sponsor.py              # 项目发起人
│   ├── manager.py              # 项目经理
│   └── team_member.py          # 项目组成员
├── database/                    # 数据库模块
│   ├── __init__.py
│   └── shared_db.py            # 共享数据库
├── workflow/                    # 工作流模块
│   ├── __init__.py
│   └── engine.py               # 工作流引擎
├── utils/                       # 工具模块
│   ├── __init__.py
│   ├── llm_client.py           # LLM客户端
│   └── document_generator.py   # 文档生成器
├── simulation/                  # 模拟结果存储
│   └── {project_code}/
│       └── deliverables/       # 交付物
├── config.py                    # 配置文件
├── main.py                      # 主程序
├── test_simple.py              # 测试脚本
├── requirements.txt            # 依赖包
├── .gitignore                  # Git忽略文件
├── README.md                   # 项目说明
├── QUICKSTART.md               # 快速入门
├── USAGE.md                    # 使用指南
├── ARCHITECTURE.md             # 架构文档
├── PROJECT_OVERVIEW.md         # 本文件
└── example_ideas.txt           # 示例项目创意

依赖项

openai>=1.0.0          # OpenAI API客户端
requests>=2.28.0       # HTTP请求库
python-dateutil>=2.8.0 # 日期处理库

快速开始

# 1. 安装依赖
pip install -r requirements.txt

# 2. 运行测试
python test_simple.py

# 3. 运行模拟
python main.py

# 4. 查看结果
explorer simulation

详见 QUICKSTART.md

文档索引

文档 描述
README.md 项目详细说明
QUICKSTART.md 5分钟快速入门
USAGE.md 详细使用指南
ARCHITECTURE.md 系统架构文档
PROJECT_OVERVIEW.md 本文件
example_ideas.txt 示例项目创意

核心概念速查

项目阶段

  1. 预启动：需求陈述 → 项目章程
  2. 启动：启动会议 → 三大约束
  3. 计划：WBS → 管理计划
  4. 执行：开发代码 → 进展报告
  5. 控制：EVM分析 → 更新计划
  6. 结束：整理交付物 → 项目总结

三大约束

  • Cost（成本）：项目预算和成本管理
  • Scope（范围）：项目做什么、不做什么
  • Schedule（进度）：时间安排和里程碑

挣值分析指标

  • PV：计划值（Planned Value）
  • EV：挣值（Earned Value）
  • AC：实际成本（Actual Cost）
  • CPI：成本绩效指数（EV/AC）
  • SPI：进度绩效指数（EV/PV）

贡献指南

欢迎贡献！可以：

  • 🐛 报告Bug
  • 💡 提出新功能建议
  • 📝 改进文档
  • 🔧 提交代码
  • ⭐ 给项目加星

许可证

MIT License - 自由使用和修改

致谢

本项目灵感来源于：

  • PMBOK（项目管理知识体系）
  • 敏捷开发方法论
  • 多智能体系统研究

总结

这是一个完整、实用、可扩展的多智能体项目管理模拟系统，适用于：

✅ 项目管理教学和培训
✅ 软件工程课程演示
✅ 多智能体系统研究
✅ 项目规划和可行性分析

立即开始你的项目管理模拟之旅！ 🚀

python main.py --project-idea "你的项目需求描述"