# AI 辅助开发提示词指南

> **目标读者**：使用 AI 工具（Kiro、Cursor、Claude 等）进行开发的团队成员  
> **最后更新**：2026-01-31

---

## 快速开始

### 服务开发标准提示词

#### 场景 1：首次开发
```
基于 {service_name}.md 文档，使用 jointo-tech-stack 规范实现/迭代功能
```

#### 场景 2：迭代开发
```
使用 jointo-tech-stack 技能，基于 {service_name}.md 文档执行功能开发：
1. 检查文档与现有代码的差异
2. 识别需要新增/修改的功能点
3. 按照技术栈规范实现代码
4. 更新文档版本记录
```

---

## 团队约定

### 1. 提示词结构

所有开发提示词应包含：
- ✅ 明确的文档引用（`基于 xxx.md 文档`）
- ✅ 技术栈规范（`使用 jointo-tech-stack 规范`）
- ✅ 执行目标（`实现/迭代功能`）

### 2. 文档优先原则

- 先更新文档，再执行开发
- 文档版本号必须递增
- 变更记录必须完整

### 3. 代码审查清单

AI 生成的代码必须符合：
- [ ] 日志规范（中文 + %-formatting）
- [ ] 异步编程（async/await）
- [ ] 类型提示（完整的类型注解）
- [ ] 错误处理（exc_info=True）
- [ ] 数据库规范（无物理外键）

---

## 个人定制

如果你想定制自己的提示词模板，可以：

1. 复制 `.kiro/prompts/service-development.md` 到你的本地
2. 根据个人习惯调整
3. 使用 `#File .kiro/prompts/service-development.md` 快速引用

**注意**：`.kiro/` 目录下的文件是个人配置，不会提交到 Git。

---

## 常见场景

### Bug 修复
```
基于 {service_name}.md，使用 jointo-tech-stack 修复：{bug_description}
```

### 新增功能
```
基于 {service_name}.md v{version}，使用 jointo-tech-stack 实现：{feature_description}
```

### 重构代码
```
使用 jointo-tech-stack 技能，基于 {service_name}.md 文档执行功能开发：
1. 检查文档与现有代码的差异
2. 识别需要新增/修改的功能点
3. 按照技术栈规范实现代码
4. 更新文档版本记录

本次重构：{refactor_description}
```

---

## 参考资源

- [Jointo 技术栈规范](../architecture/tech-stack.md)
- [服务开发流程](../requirements/backend/README.md)
- [个人提示词模板](.kiro/prompts/service-development.md)（需要本地创建）

---

**维护者**：Jointo 开发团队  
**最后更新**：2026-01-31