AiCodeCat Docs

主题

学习地图 ​

用一张地图把这套使用教程的学习路线串起来：先从零开始跑通，再按目标进入 Prompt、Skill 或工程质量路线。

核心摘要 ​

  • 如果你是新手，先走“零基础路线”，目标是完成一次从想法到可运行项目的闭环。
  • 如果你已经会编程，先走“开发者路线”，目标是把 AI 编程变成可复用、可验证、可维护的工程流程。
  • 如果你要带团队，先走“团队路线”，目标是统一上下文、产物模板、任务拆解、审查和门禁。

路线总览 ​

路线适合谁目标首选入口
零基础路线不会编程或刚开始跑通从想法到项目的最小闭环问题求解 / 状态转移闭环
开发者路线已会写代码建立 AI 结对编程工作流Vibe Coding 经验 / 状态转移闭环
Prompt 路线想提升提问质量把需求表达成可执行指令提示词库
Skill 路线想沉淀复用能力把高频任务做成可重复调用的技能Skills 技能大全
质量门禁路线担心 AI 乱写代码用测试、CI、schema、清单约束 AI 输出工程实践

路线一：零基础路线 ​

目标：完成一次“想法 -> 需求 -> 方案 -> 任务 -> AI 编码 -> 验证 -> Git 保存”的最小闭环。

  1. 问题求解 先学会把问题说清楚：目标、现状、差距、标准、约束、对象、路径。
  2. Vibe Coding 状态转移闭环 再把目标、约束、行动、证据和版本串成一轮可验证、可回滚的状态转移。
  3. 5 分钟接入 AiCodeCat 装好一个 AI 编程工具（Claude Code、Codex 等）并接上 AiCodeCat，让本地 Agent 能在终端里执行工程动作。
  4. 确认工具能回话 在工具里发一句话能收到回复再往下走；不回话先看 常见报错。
  5. 开发环境搭建 优先交给 Codex Agent 主动检查和配置 Git、Node.js、Python、编辑器、项目依赖与测试命令。
  6. Vibe Coding 经验 学会人机分工、门禁、复盘和用 AI 审 AI。
  7. 第一个项目 用本地待办清单走通需求、实现、运行、验收和 Git 保存。

完成标准：

  • [ ] 能清楚描述一个项目目标
  • [ ] 能让 AI 生成初版 PRD 或任务清单
  • [ ] 能在本地打开项目目录
  • [ ] 能用 AI CLI 执行一次修改
  • [ ] 能按验收清单验证功能和边界
  • [ ] 能用 Git 保存一次变更并记录提交号

路线二：开发者路线 ​

目标：把 AI 从“临时助手”变成稳定的工程协作者。

  1. Vibe Coding 状态转移闭环 先建立目标、约束、行动、证据和版本组成的总模型。
  2. Vibe Coding 经验 再建立人机分工和质量意识。
  3. 拼好码 优先复用成熟能力，把自研代码限制在连接、编排、适配和业务逻辑。
  4. 工程实践 在任务开始前写清楚目标、边界、禁止项、验收标准和门禁，并用底层程序逻辑检查项约束实现质量。

完成标准：

  • [ ] 每个任务都有明确验收标准
  • [ ] 每次 AI 输出都能被测试、脚本或清单验证
  • [ ] 不让 AI 无依据重构或造轮子
  • [ ] 能把一次失败整理成可复用经验

路线三：Prompt 路线 ​

目标：把自然语言需求写成可执行、可检查、可复用的指令。

  1. 提示词库入口
  2. 工程实践
  3. 语言层要素
  4. 问题求解

练习方式：

  • 把“我要做一个功能”改写成“目标、约束、输入、输出、验收标准”
  • 把“帮我优化”改写成“按哪些指标优化、不能改什么、如何验证”
  • 把“检查一下”改写成“按什么清单审查、输出什么格式、什么情况阻断”

路线四：Skill 路线 ​

目标：把高频工作沉淀成可重复使用的能力。

  1. Skills 技能大全
  2. auto-skill
  3. Claude 官方 Skills

完成标准：

  • [ ] 每个 Skill 都有清晰触发场景
  • [ ] 每个 Skill 都说明输入、流程、输出和验证方式
  • [ ] 复杂能力有 references、scripts 或 assets 支撑
  • [ ] Skill 不只是长提示词，而是可执行工作流

路线五：团队路线 ​

目标：让多个人和多个 AI Agent 使用同一套上下文和门禁。

优先阅读：

  1. AGENTS.md
  2. 工程实践

团队约束：

  • 任务开始前必须写清目标、边界、验收标准
  • 重要产出必须新开会话做 AI 审计
  • 任何目录、命令、配置、工作流变化都要同步文档
  • 任何自研偏离拼好码原则都要说明理由、风险和回滚路径

建议顺序 ​

如果你不知道从哪里开始，按这个顺序：

文本
问题求解
  -> Vibe Coding 状态转移闭环
  -> 接入 AiCodeCat（装好 AI 编程工具）
  -> 让 Agent 主动配置开发环境
  -> Vibe Coding 经验
  -> 第一个项目
  -> 拼好码
  -> 工程实践
  -> Skills 技能大全

下一步 ​

本文改编自开源项目 vibe-coding-cn（MIT 许可，© 2025 Nicolas Zullo, tukuaiai, 123olp），AiCodeCat 做了删减与本地化。许可全文见 开源许可。