Skip to content

kaelinda/aicoding-guide-book

Repository files navigation

AI Coding Guide Book 📚

面向初级 iOS 开发者的 AI 编程实践指南
从环境搭建到多 Agent 协作,系统掌握 AI 辅助开发的核心方法


🎯 这是什么

AI Coding Guide Book 是一份围绕 AI 辅助编程 的系统化教程,重点面向:

  • 有基础 Swift / Xcode 使用经验的 iOS 开发者
  • 想把 AI 真正用进日常开发流程的独立开发者
  • 对 Claude Code、Cursor、Codex、MCP、Agent 协作感兴趣的学习者

这不是一份单纯的工具说明书,而是一套从 入门体验、核心概念、实战方法,到高阶工作流 的完整学习路径。


👥 适合谁读

这份指南尤其适合下面几类读者:

  • 想开始尝试 AI 编程,但不知道从哪里入手
  • 会写 iOS App,但还不会高效和 AI 协作
  • 已经在用 Cursor / Claude Code / Codex,但流程不稳定
  • 希望建立更清晰的 Prompt、验收、修复和自动化工作流
  • 想把 AI 工具从“偶尔试试”变成“每天都能用”

🚀 你将学到什么

通过这份指南,你将逐步掌握:

  • 如何搭建完整的 AI 编程环境
  • 如何选择适合自己的 AI 编程工具
  • 如何把需求清楚地交给 AI
  • 如何评估、修正和验收 AI 生成的代码
  • 如何把 AI 工具用到真实 iOS 开发场景中
  • 如何进一步构建多 Agent 协作和自动化工作流

📚 内容结构

本书按学习路径分为五个阶段:入门 → 基础篇 → 实战篇 → 进阶篇 → 大师篇

01 基础篇

帮助你完成环境搭建、工具安装,并做出第一个 AI 辅助开发项目。

包含内容:

  • 环境搭建
  • 工具安装
  • 第一个项目

入口:

02 实战篇

聚焦真实开发场景,学习如何把 AI 工具真正用进项目。

包含内容:

  • Claude Code 实战(13个子章节)
  • Cursor 实战
  • Codex 实战
  • 失败案例与修复
  • iOS 专项场景

入口:

03 进阶篇

理解 AI 编程背后的关键概念,掌握更稳定、更高质量的协作方式。

包含内容:

  • Agent 概念
  • MCP 协议
  • Prompt 技巧
  • Rules 与 Skill
  • Cursor 进阶功能
  • Claude Code 新功能
  • Claude Code 环境配置

入口:

04 大师篇

面向更复杂的协作与自动化场景,进一步拓展 AI 编程工作流。

包含内容:

  • 多 Agent 协作
  • OpenClaw 远程 Coding
  • 高级工作流

入口:


🧭 推荐阅读路径

新手入门

按顺序阅读以下内容:

  1. 环境搭建
  2. 工具安装
  3. 第一个项目
  4. Prompt 技巧
  5. Claude Code / Cursor / Codex 实战

已有开发经验

如果你已经有一定 iOS 或 AI 工具使用经验,建议从这里开始:

  1. 进阶篇
  2. 实战篇
  3. 大师篇

🚀 快速导航

模块 说明 入口
入门 快速开始 开始
基础篇 环境、工具、练习项目 开始学习
实战篇 工具实战与开发场景 查看实战
进阶篇 核心概念、Prompt、Rules 继续深入
大师篇 多 Agent、远程协作、工作流 进阶提升
参考资料 FAQ、术语表、最佳实践 查看参考
iOS 专题 iOS 开发专项内容 查看专题
示例模板 AGENTS、Prompt 模板 查看 examples

🛠 仓库结构

aicoding-guide-book/
├── README.md             ← GitHub 仓库首页
├── AGENTS.md             ← AI 助手指南
├── .gitbook.yaml         ← GitBook Git Sync 配置(root: ./docs)
└── docs/                 ← GitBook 内容根
    ├── README.md         ← 书的首页
    ├── SUMMARY.md        ← GitBook 目录
    ├── 00-quick-start.md
    ├── cheat-sheet.md
    ├── 基础篇/            ← 环境搭建、工具安装、练习项目
    ├── 进阶篇/            ← Agent、MCP、Prompt、Rules、环境配置
    ├── 实战篇/            ← Claude Code/Cursor/Codex 实战、iOS 专项
    ├── 大师篇/            ← 多 Agent、OpenClaw、高级工作流
    ├── ios-*.md          ← iOS 专题(调试、发布、面试、工具)
    ├── FAQ.md / glossary.md / learning-path.md / best-practices.md
    └── examples/
        ├── prompts/      ← Prompt 模板
        ├── AGENTS-examples.md
        └── swift-templates.md

✨ 这份指南的特点

1. 面向真实开发,而不是空谈概念

本项目强调“能落地”。每一部分都尽量围绕真实开发问题展开,而不是只介绍工具功能。

2. 面向初级 iOS 开发者

你不需要先成为 AI 专家。只要你已经会一些 Swift / Xcode,就可以逐步把 AI 引入自己的开发流程。

3. 强调“生成之后的判断力”

AI 能生成很多代码,但真正重要的是:

  • 你是否能判断它对不对
  • 你是否知道哪里要修改
  • 你是否能建立自己的验收标准

4. 关注长期可持续的工作流

除了“怎么生成代码”,这份指南也会覆盖:

  • Prompt 组织方式
  • 代码验收方法
  • 安全边界设置
  • 多工具协作
  • 自动化工作流

📦 仓库内还包含什么

除了主线教程,这个仓库还包含这些内容:


📝 阅读建议

为了获得更好的学习效果,建议你采用下面的方式:

不要只读,要跟着做

每学完一章,至少自己动手完成一个小练习。

不要只让 AI 生成,要学会验收

重点不是“让 AI 写得更快”,而是“写完后你知道怎么判断”。

不要一口吃完

你不需要一次性读完整本。更好的方式是:

  • 先上手
  • 再解决当前最需要的问题
  • 最后回头补概念和体系

🤝 贡献方式

欢迎一起完善这个项目。

你可以通过这些方式参与:

  • 发现错误 → 提 Issue
  • 补充案例 → 提 PR
  • 推荐资源 → 提 Issue 或 Discussion
  • 提出新章节建议 → 提 Feature Request

相关文档:


📜 License

本项目采用 MIT License


🙏 致谢

感谢以下项目和资源带来的启发:


⭐ 开始阅读

从这里开始最合适:

如果这个项目对你有帮助,欢迎 Star ⭐

About

No description, website, or topics provided.

Resources

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages