docs/v1.0/guides/ai-development-prompts.md

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 技术栈规范
• 服务开发流程
• 个人提示词模板（需要本地创建）

---

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