# AI工具上下文模板 🤖

## 📖 模板使用指南

这个文档提供标准化的AI工具提示词模板，确保AI能够高效理解项目上下文并提供精准帮助。

## 🚀 快速开始模板

### 新会话启动模板
```
你好！我是Agent Development Center (ADC)项目的开发者。请先阅读以下文档以了解项目全貌：

1. 项目概览：/docs/ai_setup/01_project_overview.md
2. 当前状态：/docs/ai_setup/02_current_status.md  
3. 接下来任务：/docs/ai_setup/03_next_tasks.md

请确认你已理解项目的：
- 8层架构设计和技术架构
- 当前开发状态和进度（40%完成度）
- 优先级最高的待办任务

然后我们可以开始协作。我今天希望专注于：[具体任务描述]
```

## 🎯 场景化提示模板

### 1. ADC组件开发
```
我需要开发ADC组件，请先了解我们的技术栈：

**项目背景**:
- 项目：Agent Development Center (ADC) - AI Agent开发框架
- 技术栈：Python + 8层架构设计
- 当前重点：智能上下文层实现

**相关文档**:
- 架构设计：/docs/ARCHITECTURE_DESIGN.md
- 智能上下文层：/docs/architecture/09_intelligent_context_layer.md
- 核心建议：/docs/architecture/13_core_architecture_recommendations.md

**今天任务**: [具体开发任务]

**需要帮助**: 
- [ ] 架构设计建议
- [ ] 代码实现指导  
- [ ] 最佳实践参考
- [ ] 其他：_____

请基于我们的8层架构设计提供建议。
```

### 2. ADC架构优化
```
我需要优化ADC架构设计：

**项目背景**:
- 当前8层架构设计已完成
- 智能上下文层已合并上下文工程、RAG系统、知识管理
- 架构文档：/docs/architecture/README.md

**当前挑战**: [具体问题描述]

**期望结果**:
- [ ] 架构性能优化
- [ ] 功能完整性提升
- [ ] 开发效率改善
- [ ] 其他：_____

请基于我们现有的8层架构提供优化建议。
```

### 3. 文档编写
```
我需要编写或完善项目文档：

**文档项目**: ADC架构设计文档
**当前状态**: 查看 /docs/ai_setup/02_current_status.md 的文档部分
**目标章节**: [具体章节]

**写作要求**:
- 实战导向，包含可执行的代码示例
- 面向AI Agent开发场景优化
- 保持与现有文档风格一致

**参考资料**:
- 现有文档：/docs/architecture/
- 技术架构：/docs/ai_setup/01_project_overview.md

请帮助我创建高质量的技术文档。
```

### 4. 问题调试
```
我遇到了技术问题需要调试：

**问题描述**: [详细描述问题]
**相关组件**: [涉及的模块/文件]
**错误信息**: [完整错误日志]

**环境信息**:
- 系统：macOS/Linux/Windows
- 工具链：[具体版本信息]
- 项目路径：/Users/wangbo/workspace/vip_developer

**项目上下文**:
- 这是VIP Developer项目的一部分
- 具体组件：[Ethernet VIP/AI团队/构建系统等]

**尝试过的解决方案**: [已尝试的方法]

请基于我们的项目架构提供调试建议。
```

### 5. 代码审查
```
请帮我审查代码，确保符合项目标准：

**代码类型**: [C++/SystemVerilog/Python/JSON配置]
**所属模块**: [具体模块名称]

**项目编码规范**:
- 不在代码中使用中文
- 遵循VIP框架的TLM连接规则
- 符合SystemC/UVM最佳实践

**审查重点**:
- [ ] 代码质量和规范
- [ ] 架构一致性
- [ ] 性能考虑
- [ ] 文档完整性
- [ ] 其他：_____

[贴入代码]

请提供具体的改进建议。
```

## 🛠️ 专业领域模板

### AI智能体协作
```
**角色设定**: 我现在作为VIP Developer项目的[项目管理专家/系统架构专家/等]，需要与其他专家协作。

**协作场景**: [具体协作任务]

**我的专业领域**:
- [根据选择的专家角色填写专业能力]
- 参考：/VIP_AI_Developer/VIP_AI_Developer_Team_Config.json

**协作目标**: [具体目标]

**需要输出**:
- [ ] 技术方案
- [ ] 实现计划  
- [ ] 代码示例
- [ ] 文档模板
- [ ] 其他：_____

请以专业专家的身份为我提供建议。
```

### 架构设计
```
**设计任务**: [具体架构设计需求]

**项目约束**:
- 必须符合VIP框架的TLM连接规则
- 支持多协议扩展(当前Ethernet，计划PCIe/USB等)
- 保持与现有C++框架的兼容性

**技术要求**:
- 性能：[具体性能指标]
- 可扩展性：[扩展需求]
- 可维护性：[维护要求]

**参考架构**: 查看 /Docs/ai_setup/01_project_overview.md 的技术架构部分

请提供详细的架构设计方案。
```

## 📋 输出格式模板

### 技术方案输出格式
```
## 方案概述
[简要说明]

## 技术架构
[架构图或描述]

## 实现步骤
1. [步骤1]
2. [步骤2]
...

## 代码示例
```cpp
// 示例代码
```

## 测试策略
[测试方法]

## 风险评估
[潜在风险和缓解措施]

## 时间估算
[开发时间预估]
```

### 代码审查输出格式
```
## 整体评价
⭐⭐⭐⭐☆ (评分和总体评价)

## 优点
- [好的地方]

## 需要改进的地方
### 🔴 高优先级
- [严重问题]

### 🟡 中优先级  
- [一般问题]

### 🟢 低优先级
- [改进建议]

## 修改建议
```cpp
// 具体修改代码
```

## 符合性检查
- [ ] 编码规范
- [ ] 架构一致性
- [ ] 性能要求
- [ ] 文档完整性
```

## 🔧 自定义模板

### 模板变量
在使用模板时，可以替换以下变量：

| 变量 | 描述 | 示例 |
|------|------|------|
| `[具体任务描述]` | 当前要完成的具体任务 | "实现Ethernet MAC层TX路径" |
| `[优先级]` | 任务优先级级别 | "🔴 高" / "🟡 中" / "🟢 低" |
| `[截止日期]` | 任务完成截止时间 | "2024年1月31日" |
| `[负责专家]` | 主要负责的专家角色 | "接口时序专家" |
| `[相关文件]` | 涉及的项目文件路径 | "/VIPs/ethernet/mac/" |

### 创建新模板
根据项目需要，可以基于以下结构创建新的专用模板：

```
## 模板名称：[模板用途]

**适用场景**: [什么时候使用]

**模板内容**:
```
[模板提示词内容]
```

**使用说明**: [如何使用此模板]

**预期输出**: [期望得到什么样的回复]
```

## 📞 模板优化建议

### 使用技巧
1. **具体化描述**: 避免模糊的描述，提供具体的技术细节
2. **上下文完整**: 确保AI了解项目背景和当前状态  
3. **明确期望**: 清楚说明期望的输出格式和内容
4. **迭代改进**: 根据AI回复质量不断优化模板

### 常见问题解决
- **回复过于通用**: 增加更多项目特定的上下文信息
- **技术深度不够**: 提供更详细的技术背景和约束条件
- **格式不标准**: 明确指定输出格式要求

### 模板维护
- **定期更新**: 随着项目进展更新模板内容
- **收集反馈**: 记录哪些模板效果好，哪些需要改进
- **版本控制**: 保持模板版本历史，方便回溯

---

**模板版本**: v1.0  
**最后更新**: 2024-01-16  
**维护者**: VIP Developer Team

> 💡 **提示**: 这些模板是起点，请根据具体情况调整和个性化使用。 