Coding with AI
基于 AI 的项目开发经历总结，沉淀可复用的开发规范，让 AI 陪你直到项目成功！
🎯 项目背景
这是一个 AI 辅助开发实战教程 项目，目标是：
- 总结经验：沉淀在实际项目中与 AI 协作开发的最佳实践
- 规范沉淀：提炼出一套可复用的开发规范，可直接复制到新项目
- 示例展示：通过完整示例展示 AI 协作开发的全过程
- 知识共享：让更多开发者掌握 AI 时代的高效开发方法
🧠 核心方法论：计划先行，分块验证，增量交付
AI 辅助开发和传统开发最大的不同在于：AI 可以帮你快速写代码，但你需要给 AI 清晰的方向。
工作流步骤
| 步骤 | 动作 | 责任人 | 核心产出 |
|---|---|---|---|
| 1 | 需求分析 | 你 | 清晰的功能描述 |
| 2 | 架构设计 | 你 | 技术选型和架构方案 |
| 3 | 编写计划 | 你 + AI | 分块的实现计划 |
| 4 | 逐块实现 | AI | 可运行的代码 |
| 5 | 逐块验证 | 你 + AI | 验证通过的功能 |
| 6 | 增量提交 | AI | 可追溯的提交记录 |
| 7 | 整体验收 | 你 | 完整可用的产品 |
三级验证体系
| 验证层级 | 时机 | 验证内容 |
|---|---|---|
| 单元验证 | 每个 Chunk 完成后 | 模块单独测试通过 |
| 集成验证 | 多个 Chunk 完成后 | 模块间能正常交互 |
| E2E 验证 | 整个功能完成后 | 完整流程能跑通 |
⚠️ 顺序：编码 → 验证 → 提交，不是 编码 → 提交 → 验证。
提交类型规范
| 类型 | 适用场景 |
|---|---|
config | 依赖安装、配置文件 |
feat | 新增功能 |
docs | 文档更新 |
fix | Bug 修复 |
refactor | 重构代码 |
🤝 AI 协作原则：你是决策者，AI 是执行者
| 分工 | 你负责 | AI 负责 |
|---|---|---|
| 决策 | 需求分析、架构设计、技术选型、方案拍板 | 提供选项、解释权衡、生成代码 |
| 方向 | 告诉 AI「做什么」和「为什么」 | 帮你实现「怎么做」 |
| 验证 | 验证功能是否符合预期 | 帮你写测试、定位问题 |
高效协作五步法
- 先思考，再让 AI 干活 → 指令越具体，结果越准确
- 分而治之，一次做一件事 → 一块一块验证，不容易错
- 充分利用工具，不依赖记忆 → API 问题查最新文档，不凭记忆猜
- 设计文档先写，代码后写 → 你想清楚了，AI 才能做对
- 计划跟踪进度 → 清楚知道做到哪，中断后能快速恢复
常见陷阱和避免方法
| 陷阱 | 避免方法 |
|---|---|
| AI 说能做就信了 | 每个 Chunk 写完必须验证 |
| 追求完美设计一开始 | 先做简单能跑的，再逐步完善 |
| 不停让 AI 重写，越来越乱 | 一两遍不对，停下来自己分析问题 |
| 忽略安全问题 | 安全设计从一开始就要考虑 |
📁 项目结构示例
project_root/
├── .claude/
│ ├── rules/ # 开发规范和规则（可直接复制到新项目使用）
│ │ ├── plan.md # 计划文档规范
│ │ ├── git.md # Git 提交规范
│ │ ├── python-agent.md # Python Agent 开发规范
│ │ ├── frontend.md # 前端开发规范
│ │ └── xinchuang.md # 信创系统兼容性规范
│ └── plans/ # 本项目的实现计划，按状态分类
│ ├── *.md # 进行中/待开始
│ ├── completed/ # ✅ 已完成
│ └── archived/ # 🗘️ 已废弃/取消
│
├── docs/ # 项目文档，给 AI 写文档
│ ├── 01_Design/ # 设计文档：PRD，技术方案
│ ├── 02_Dev/ # 开发文档：API接口，环境配置，运维部署
│ └── 03_Other/ # 其他文档
│
├── src/ # 项目核心目录
│ └── ... # 代码
│
├── CLAUDE.md # 本项目 Claude Code 指令
└── README.md # 项目介绍💡 核心观点
AI 是强大的生产力工具，但清晰的规划和严格的验证是成功的保障。
AI 是生产力放大器，你越会用，效率越高。
📖 快速开始
如果你是：
- 初学者：先阅读左侧导航的文档了解经验总结
- 开发者：直接复制
.claude/rules/到你的项目使用 - 实践者：查看
examples/看完整示例的实现过程