# ai-coding-guide
**Repository Path**: sdatafarmer/ai-coding-guide
## Basic Information
- **Project Name**: ai-coding-guide
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-09
- **Last Updated**: 2026-06-09
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# AI 编程工具实战指南
**简体中文** | [English](./README.en.md)
> **10 款主流 AI 编程工具的中文最佳实践** — 不讲概念，只讲怎么用好。从提示词技巧到工作流设计，从单工具精通到多工具协作，帮你把 AI 编程效率拉满。
[](https://github.com/jnMetaCode/ai-coding-guide)
[](./LICENSE)
[](https://book.aibuzhiyu.com/)
[](https://makeapullrequest.com)
> 📖 **[在线阅读：AI 编程实战三卷书 →](https://book.aibuzhiyu.com/)** ｜ 把仓库内容按读者画像重组：卷一·入门 / 卷二·工作流 / 卷三·架构 / 别册·速查手册
10 款工具
全覆盖教程 |
66 个技巧
Claude Code 深度 |
7 套方法论
提示词/调试/测试 |
可复制模板
即装即用配置 |
---
## 🚀 快速开始
**先看一眼 [📋 速查表](cheatsheet.md)** — 10 款工具一页横向对比：类型、上下文、配置文件、常用命令。知道自己选哪个、怎么配、怎么用。
**按画像走推荐路径：**
| 你是... | 推荐顺序 |
|---------|---------|
| 纯新手，还没用过 AI 编程 | [速查表](cheatsheet.md) → [Trae](trae/)（免费入门）→ [提示词工程](common/prompting.md) |
| 前端 / 日常编码为主 | [Cursor](cursor/) → [提示词工程](common/prompting.md) → [实战场景](workflows/scenarios.md) |
| 后端 / 重构 / 大项目 | [Claude Code](claude-code/) → [需求拆解](common/task-decomposition.md) → [实战场景](workflows/scenarios.md) |
| 从 Copilot 迁来 | [Copilot](copilot/) → [Claude Code](claude-code/)（对比差异）→ [多工具选型](workflows/tool-selection.md) |
| 已订阅 ChatGPT Plus/Pro | [Codex CLI](codex/) → [Claude Code](claude-code/) 对比 → [多工具选型](workflows/tool-selection.md) |
| 控成本 / 独立开发者 | [速查表](cheatsheet.md) → [Gemini CLI](gemini-cli/) 或 [Aider](aider/) + 本地模型 |
| 团队协作 / 高质量交付 | [Kiro](kiro/) → [代码审查](common/code-review.md) → [测试策略](common/testing.md) |
**已经在用了？** 直接看：[速查表](cheatsheet.md) · [进阶技巧](#-9-款工具教程) · [实战工作流](#-实战工作流) · [生态项目](#-相关项目)
---
## 🔧 10 款工具教程
| 工具 | 类型 | 亮点 |
|------|------|------|
| [**Claude Code**](claude-code/) | CLI Agent | 66 个技巧，Agent + Skill + Hook 完整工作流 |
| [**Codex CLI**](codex/) | CLI Agent | OpenAI 官方开源（Rust），Sandbox + AGENTS.md，ChatGPT 订阅可用 |
| [**Cursor**](cursor/) | IDE | .cursorrules 配置，Composer Agent 模式 |
| [**GitHub Copilot**](copilot/) | IDE 插件 | 行内补全 + Agent 模式 + 自定义指令 |
| [**OpenClaw**](openclaw/) | AI Agent 框架 | 338k Stars，多平台连接 + Skills + Cron 自动化 |
| [Windsurf](windsurf/) | IDE | Cascade Agent，自动上下文 |
| [Gemini CLI](gemini-cli/) | CLI | Google 出品，大代码库分析 |
| [Kiro](kiro/) | IDE | AWS 出品，Spec 驱动开发 |
| [Aider](aider/) | CLI | Git 原生，支持几乎所有 LLM |
| [Trae](trae/) | IDE | 字节出品，免费 Claude/GPT，国内直连 |
> 每个工具都有：**核心概念 → 快速上手 → 提示词技巧 → 进阶用法 → 配置模板**
---
## 📚 通用方法论
不管用哪个工具，这些方法都能让你写出更好的提示词、设计更高效的工作流：
| 主题 | 解决什么问题 |
|------|-------------|
| [提示词工程](common/prompting.md) | AI 编程场景下的提示词技巧，不是通用 prompt engineering |
| [需求拆解](common/task-decomposition.md) | 把大任务拆成 AI 能一次做好的小任务 |
| [代码审查](common/code-review.md) | 让 AI 审查代码的最佳实践 |
| [调试方法论](common/debugging.md) | 用 AI 高效调试的系统方法 |
| [上下文管理](common/context-management.md) | 控制 AI 的上下文窗口，避免"变笨" |
| [测试策略](common/testing.md) | 用 AI 写测试的方法和注意事项 |
| [安全注意事项](common/security.md) | AI 编程中的安全风险和防护 |
---
## 🔗 实战工作流
真实项目怎么跑完整流程，以及不同工具怎么各展所长。
| 工作流 | 说明 |
|--------|------|
| [实战场景脚本](workflows/scenarios.md) | 重构 / 协作开发 / 补测试——3 个端到端对话脚本，复制改就能用 |
| [⚠️ 陷阱合集](pitfalls/) | Claude Code / Cursor / Copilot 各 8 个真实踩坑，症状 / 根因 / 出坑 / 预防 四段式 |
| [Claude Code + Cursor 协作](workflows/claude-code-cursor.md) | Claude Code 做架构设计和复杂重构，Cursor 做日常编码 |
| [Claude Code + Copilot 协作](workflows/claude-code-copilot.md) | Claude Code 做 Agent 任务，Copilot 做行内补全 |
| [多工具选型指南](workflows/tool-selection.md) | 什么场景用什么工具，一张表说清楚 |
---
## 🌐 相关项目
> 以下项目均由「AI不止语」品牌持续维护，构成从 AI 编程到 AI 视频创作的完整链路：
```
AI 编程线：
读书 → 学工具 → 注入方法论 → 加载专家 → 多角色编排 → 安全防护
(book) (guide) (superpowers) (agents) (orchestrator) (shellward)
AI 视频线：
方法论 + 案例 + Skill
(ai-shortfilm-prompts)
```
| 项目 | 定位 | 一句话 | 教程 |
|------|------|-------|------|
| [**ai-coding-trilogy**](https://github.com/jnMetaCode/ai-coding-trilogy)  | 📚 三卷书 | 把本仓内容按读者画像重组：入门/工作流/架构（PDF + 在线版） | [产品页](https://github.com/jnMetaCode/ai-coding-trilogy) |
| **本项目**（ai-coding-guide） | 📖 实战教程 | 66 个 Claude Code 技巧 + 10 款工具最佳实践 + 配置模板 | — |
| [superpowers-zh](https://github.com/jnMetaCode/superpowers-zh)  | 🧠 工作方法论 | 20 个 skills 教 AI 怎么干活（TDD / 调试 / 代码审查等） | [安装与使用](ecosystem.md#1-superpowers-zh--给-ai-注入工作方法论) |
| [agency-agents-zh](https://github.com/jnMetaCode/agency-agents-zh)  | 🎭 专家角色库 | 211 个**即插即用** AI 专家，含 46 中国原创（小红书 / 抖音 / 飞书 / 钉钉） | [安装与使用](ecosystem.md#2-agency-agents-zh--211-个-ai-专家角色) |
| [agency-orchestrator](https://github.com/jnMetaCode/agency-orchestrator) | 🚀 编排引擎 | 一句话 → 211 专家协作，**几分钟出方案**（9 家 LLM / 6 免费） | [安装与使用](ecosystem.md#3-agency-orchestrator--多角色-yaml-编排) |
| [shellward](https://github.com/jnMetaCode/shellward) | 🛡️ 安全中间件 | 8 层防御 + DLP 数据流 + 注入检测，**零依赖**（含 MCP Server） | [安装与使用](ecosystem.md#4-shellward--ai-agent-安全防护) |
| 🆕 [ai-shortfilm-prompts](https://github.com/jnMetaCode/ai-shortfilm-prompts) | 🎬 视频提示词 | Mx-Shell《丧尸清道夫》5 段式方法论 + Skill，覆盖 Seedance / 小云雀 / Sora / 可灵 / 即梦 | — |
👉 **[完整安装教程和组合使用指南 →](ecosystem.md)**
---
## 交流 · Community
微信公众号 **「AI不止语」**（微信搜索 `AI_BuZhiYu`）— 技术问答 · 项目更新 · 实战文章
| 渠道 | 加入方式 |
|------|---------|
| QQ 2群 | [点击加入](https://qm.qq.com/q/EeNQA9xCxy)（群号 1071280067） |
| 微信群 | 关注公众号后回复「群」获取入群方式 |
---
## 商业合作 · 内训咨询
仓库主体（教程 / 模板 / 脚本）永久 **Apache-2.0 免费开源**，欢迎个人无障碍使用。
但以下场景**建议先沟通**：
| 场景 | 适合谁 |
|------|-------|
| **企业内训**（10 人以上 / 系列课）| 团队 lead / HR / 技术总监 |
| **付费课程 / 训练营**整合本仓内容 | 教育机构 / 自媒体培训方 |
| **AI 编程团队咨询**（选型 / 工作流设计 / CI 改造） | 技术 leadership |
| **纸书 / 电子书出版**（基于 [`book/`](./book/) 内容）| 出版社 / 编辑 |
| **演讲 / 闭门分享**（线下活动 / 公司年会 / 行业大会）| 大会主办方 / 企业 |
| **白标 / 内部知识库**（把内容嵌入企业内部 Wiki）| 大型团队 |
**联系方式**：
- 微信公众号 **「AI不止语」**（搜索 `AI_BuZhiYu`）后台留言「合作」
- GitHub Issue（标题加 `[BUSINESS]` 前缀）：[提交咨询](https://github.com/jnMetaCode/ai-coding-guide/issues/new?title=%5BBUSINESS%5D+)
> 关于 license：仓库主体 Apache-2.0 永远不变；`book/` 目录下的书用 [CC BY-NC-SA 4.0](./book/LICENSE.zh-CN.md)（个人免费 / 商业使用需授权）。
>
> 如果你只是个人学习、研究、写博客、做 demo——尽情使用，不用打招呼，注明来源就好。
---
## 贡献
欢迎参与！详见 [CONTRIBUTING.md](./CONTRIBUTING.md)。
简单来说：补技巧、修过时内容、分享协作经验，提 Issue 或 PR 都可以。
---
## 📚 延伸学习
本项目讲"怎么用好 9 款工具"，要继续深入推荐看 **[延伸学习资源](resources.md)**——精选了 **20+ 个高质量 GitHub 仓库 / 博客 / 播客**，按主题分类（Prompt 工程 / MCP 生态 / Claude Code 进阶 / Agent 工程 / 中文优秀资源 / 官方博客）。
## 🆕 更新日志
查看 **[CHANGELOG](CHANGELOG.md)** 了解项目重要更新。最近一次重大更新：**2026-04** 新增速查表、31 个深度陷阱合集、端到端实战脚本、画像推荐路径、20+ 外部学习资源。
---
## 致谢
本指南参考了以下优秀的开源项目：
- [claude-code-best-practice](https://github.com/shanraisshan/claude-code-best-practice) — Claude Code 最佳实践
- [awesome-cursorrules](https://github.com/PatrickJS/awesome-cursorrules) — Cursor 规则集合
- [awesome-copilot](https://github.com/github/awesome-copilot) — GitHub Copilot 官方资源
- [gemini-cli-tips](https://github.com/addyosmani/gemini-cli-tips) — Gemini CLI 技巧
- [Everything Claude Code](https://github.com/anthropics/everything-claude-code) — 本能评分、AgentShield、多语言规则
- [BMAD-METHOD](https://github.com/bmadcode/BMAD-METHOD) — 完整 SDLC、Agent 角色、多平台
---
**让 AI 编程工具真正为你所用**
[Star 本项目](https://github.com/jnMetaCode/ai-coding-guide) · [提交 Issue](https://github.com/jnMetaCode/ai-coding-guide/issues) · [贡献内容](https://github.com/jnMetaCode/ai-coding-guide/pulls)