# BMAD Research Framework

🧪 **通用科研智能体框架** - 适用于任意学科领域的AI辅助研究系统

[![NPM Version](https://img.shields.io/npm/v/bmad-research-framework)](https://www.npmjs.com/package/bmad-research-framework)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Node Version](https://img.shields.io/node/v/bmad-research-framework)](https://nodejs.org/)

## ✨ 核心特性

- 🤖 **智能配置**: 自动分析项目需求，生成最优专业团队配置
- 📚 **知识驱动**: 基于深度文献调研的结构化知识库
- 👥 **同行评议**: 内置多层级专业评议机制  
- 🔄 **动态协作**: 支持多专业智能体并行协作
- 🌐 **通用性**: 适用于任意学科领域的科研项目
- 📄 **标准化**: 符合学术规范的申请报告和研究报告生成

## 🚀 快速开始

### 安装

```bash
# 前提：已安装BMAD-METHOD核心框架
npm install bmad-research-framework
```

### 使用

在Claude Code或任何支持BMAD的环境中：

```markdown
我想开始一个关于"机器学习在医学影像分析中的应用"的研究项目。

@research-strategy-planner
```

系统将自动：
1. 📊 分析项目需求
2. 🤖 配置专业智能体团队
3. 📚 进行深度文献调研
4. 📄 撰写标准化申请报告
5. 🔬 协调专业团队执行研究
6. 📋 生成高质量研究报告

## 🎯 支持的研究类型

- ✅ 国家自然科学基金申请
- ✅ 多学科交叉研究项目  
- ✅ 工程技术攻关项目
- ✅ 社会科学研究项目
- ✅ 基础理论研究项目
- ✅ 应用开发研究项目

## 🧠 智能体架构

### 核心智能体
- `research-strategy-planner` - 研究策略规划师
- `project-auto-configurator` - 项目自动配置器
- `literature-research-expert` - 文献调研专家
- `grant-application-writer` - 申请报告撰写师

### 模板智能体 (可配置)
- `research-specialist-template` - 专业研究专家
- `peer-reviewer-template` - 同行评议专家
- `research-lead-template` - 研究团队组长

## 📋 典型工作流程

1. **规划配置阶段** (2-4周)
   - 项目战略规划
   - 自动团队配置
   - 用户确认配置

2. **研究准备阶段** (4-8周)  
   - 深度文献调研
   - 知识库构建
   - 申请报告撰写

3. **执行阶段** (主要研究周期)
   - 专业团队并行工作
   - 实时协调管理

4. **报告阶段** (2-4周)
   - 结果分析解释
   - 标准化报告撰写

## 🔧 程序化使用

```javascript
const researchFramework = require('bmad-research-framework');

// 获取框架信息
console.log('可用智能体:', researchFramework.agents);
console.log('框架路径:', researchFramework.frameworkPath);

// 获取特定智能体路径
const plannerPath = researchFramework.getAgentPath('research-strategy-planner');
```

## 📦 包内容

```
bmad-research-framework/
├── agents/           # 13个专业智能体定义
├── templates/        # 3个核心模板系统
├── workflows/        # 完整工作流程定义
├── tasks/           # 专业任务定义
├── checklists/      # 质量检查清单
├── data/            # 知识库和参考资料
└── agent-teams/     # 团队配置文件
```

## 🔗 依赖要求

- **Node.js**: >= 20.10.0
- **BMAD-METHOD**: ^4.0.0 (对等依赖)

## 📖 详细文档

- [安装指南](./INSTALL.md) - 详细安装和配置说明
- [使用示例](./bmad-research-framework/README.md) - 具体使用案例
- [智能体列表](./bmad-research-framework/agents/) - 所有可用智能体说明

## 🤝 基于开源项目

本框架基于 [BMAD-METHOD](https://github.com/bmadcode/BMAD-METHOD) 构建，遵循MIT开源协议。

## 📄 许可证

[MIT License](./LICENSE)

---

**让AI成为您科研工作的智能伙伴** 🚀