AI 编程

AI 编程的核心变化，是开发者不再只和补全工具协作，而是开始和 Coding Agent 协作。Agent 可以阅读项目、拆解任务、修改文件、执行命令、分析报错，并在多轮反馈中把一个需求推进到可验证状态。

本专栏围绕两类内容展开：

1. 主流 Coding Agent：Claude Code、Codex、Gemini CLI、OpenClaw。
2. Agent 工作流增强：gstack、Superpowers、OpenSpec、everything-claude-code、oh-my-claudecode。

每篇文章都会重点写安装方式、认证方式、命令大全、命令作用、典型工作流和安全注意事项。

从哪一篇开始

如果你还没有系统用过 Coding Agent，建议先读：

• Agent 工具概览：先理解工具版图和选择策略。
• Claude Code 深度指南：适合作为第一个主力 Agent。
• Codex 深度指南：适合 OpenAI 生态用户。
• Gemini CLI 深度指南：适合想体验开源 CLI 和 Google 生态的用户。

如果你已经能熟练使用一个 Agent，再读：

• gstack 深度指南：把 Agent 使用流程变成产品、计划、评审、QA、发布闭环。
• Superpowers 深度指南：用 Skill 机制沉淀可复用能力。
• OpenSpec 深度指南：用规格驱动复杂需求。

如果你正在深度定制 Claude Code，再读：

• everything-claude-code 深度指南
• oh-my-claudecode 深度指南

工具地图

类型	工具	主要解决什么问题
主力 Agent	Claude Code	终端内完成复杂编码、排错、重构、评审
主力 Agent	Codex CLI	OpenAI 生态下的本地 Coding Agent
主力 Agent	Gemini CLI	开源终端 Agent，大上下文、低门槛体验
自动化平台	OpenClaw	多 Agent、本地网关、任务自动化和插件能力
工作流	gstack	给 Agent 增加产品、工程、评审、QA、发布角色
技能系统	Superpowers	把高质量工作流程沉淀成可复用 Skill
规格驱动	OpenSpec	先写规格和变更，再让 Agent 实施
配置合集	everything-claude-code	agents、commands、skills、hooks 集合
配置合集	oh-my-claudecode	Claude Code 插件化增强和多 Agent 编排

官方地址总览

工具	官网 / 官方文档	官方仓库
Claude Code	https://code.claude.com/docs	-
Codex CLI	https://help.openai.com/en/articles/11096431-openai-codex-cli-getting-started	https://github.com/openai/codex
Gemini CLI	https://geminicli.com/	https://github.com/google-gemini/gemini-cli
OpenClaw	https://docs.openclaw.ai/	https://github.com/openclaw/openclaw
gstack	https://gstack.lol/	https://github.com/garrytan/gstack
Superpowers	https://claude.com/plugins/superpowers	https://github.com/obra/superpowers
OpenSpec	https://openspec.dev/	https://github.com/Fission-AI/OpenSpec
everything-claude-code	https://ecc.tools/	https://github.com/affaan-m/everything-claude-code
oh-my-claudecode	https://ohmyclaudecode.com/	https://github.com/Yeachan-Heo/oh-my-claudecode

学习路线

了解工具
  -> 安装一个主力 Agent
  -> 学会常用命令
  -> 用权限和测试建立安全边界
  -> 引入工作流增强
  -> 沉淀项目级规范

第一阶段：先跑起来

目标是能在一个真实项目里启动 Agent，让它解释项目结构、修改一个小问题，并运行构建或测试验证。

推荐阅读：

1. Agent 工具概览
2. Claude Code 深度指南
3. Codex 深度指南
4. Gemini CLI 深度指南

第二阶段：建立安全边界

目标是知道哪些命令可以让 Agent 执行，哪些必须人工确认。

重点习惯：

• 修改前先要计划。
• 修改后看 git diff。
• 构建、测试、格式化要让 Agent 自己跑。
• 删除文件、重置 Git、生产部署必须人工确认。

第三阶段：引入工程流程

目标是把 Agent 从“会写代码”变成“按流程交付”。

推荐阅读：

1. gstack 深度指南
2. Superpowers 深度指南
3. OpenSpec 深度指南

第四阶段：深度定制

目标是为自己的项目和团队准备统一的命令、技能、角色和 Hook。

推荐阅读：

1. everything-claude-code 深度指南
2. oh-my-claudecode 深度指南

安装前统一准备

大部分工具都需要下面这些基础环境：

环境	检查命令	说明
Node.js	node --version	很多 CLI 通过 npm 安装
npm	npm --version	安装全局命令
Git	git --version	让 Agent 理解 diff、分支和文件状态
终端	echo $SHELL	交互式 Agent 主要运行在终端里
项目构建命令	npm run build	用于验证 Agent 修改是否正确
项目测试命令	npm test	最好让 Agent 每次修改后执行

使用原则

不要把 Agent 当成万能外包

Agent 的输出速度很快，但它仍然需要上下文、约束和验证。你应该像带新人一样使用它：

1. 说清楚目标。
2. 给它项目约定。
3. 让它先计划。
4. 允许它小步修改。
5. 用测试和 review 验证。

不要让多个 Agent 同时改同一批文件

多个 Agent 并行适合“拆分写作、拆分模块、拆分测试”，但不适合同一文件抢写。否则很容易出现覆盖和冲突。

重要操作保留人工确认

尤其是：

• rm -rf
• git reset --hard
• git push --force
• 数据库删除或迁移
• 生产环境发布
• 修改密钥、Token、权限配置

总结

AI 编程工具真正有价值的地方，不是让你少写几行代码，而是让你把“理解、修改、验证、复盘”这些流程变得更快。

这个专栏会从工具安装开始，一直写到命令体系、工程流程和安全边界。建议你不要只看命令，而是把每个工具放进真实项目里试一次：让它读代码、改代码、跑测试，再看它哪里可靠、哪里需要你接管。