Language policy: Chinese for human-facing files (README, docs/, human-fillable templates), English for AI-facing files (CLAUDE.md, AGENTS.md, AI templates). Commits / PRs / branches / tags stay English. - Translate docs/01-06 to Chinese - Translate README.md, PR / handoff / project README templates to Chinese - Drop README.en.md (redundant once language policy is explicit) - Rewrite CLAUDE.md and CLAUDE.md.template under the new policy - Add AGENTS.md (root) and templates/AGENTS.md.template for Codex - Add docs/07-codex.md covering Codex usage and AGENTS.md / CLAUDE.md sync rules Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
3.0 KiB
3.0 KiB
01 — Vibe coding(人机协作)
人和 AI 在团队里怎么分工。
前提
Claude / Codex 写大部分代码。人负责把方向:定义问题、做决策、判断 什么算"够好可以发"。我们不是在跟 AI 比谁打字快——是用 AI 把打字时间 省下来,多花点时间在思考上。
分工
AI 干的:
- 读代码、解释代码
- 拿到清晰 spec 后写第一版实现
- 机械重构(重命名、抽函数、改类型)
- 跑测试 / build / lint,按报错迭代
- 生成模板代码(配置、fixture、CRUD)
- 跨工作区搜索、汇总
人干的:
- 决定要做什么、为什么做
- 在 AI 动手前把 spec 写清楚
- 批准任何有外溢影响的改动(依赖、schema、infra、auth、密钥)
- 合并前读完每一行 diff
- AI 已经试错两次还在打转时,叫停
- 写 commit message 和 PR description(AI 起草,你定稿)
如果你觉得任务正在朝"AI 替我决策"漂移,先停下来自己写一段 spec。
提示词习惯
- 给框架,不给步骤。 告诉 AI 目标、约束、你已经否决了哪些方案。 除非步骤本身就是关键,否则别一步步指挥。
- 点名文件。 "修一下
eval-agent/runner.py里的 bug"比"修一下那个 bug"省一次搜索。 - 说清楚什么算完成。 "测试通过、新 flag 默认关"——可衡量。 "干净一点"——不行。
- 一轮一件事。 三个不相关的请求就开三条对话或三个 session。 上下文混在一起,输出也会混。
- 看到不对就 push back。 diff 写错了就直说哪里错。别接受你自己 不会写出来的代码。
什么时候叫停 AI、自己上
出现以下情况停手:
- 同一个方案试了两次,错误信息都没变。
- AI 在加任务里没要求的"防御性代码"。
- diff 已经长到你一次坐下来读不完。
- 你没法在不重新看 diff 的情况下跟同事讲清楚改了什么。
- 它马上要做不可逆的事(删数据、force push、动 auth)——必须明确 确认。
如果你叫停了自己上,把"为什么叫停"写进 PR description——下一个人 不至于重蹈覆辙。
验收 AI 产出
把 AI 的每一份 diff 当一个跑得快的实习生 PR 来 review:
- 能 build 吗?
- 测试过吗——新写的测试是不是真的覆盖了新代码?
- 改没改 spec 范围之外的文件?每个都看一遍。
- 加依赖了吗?看 lockfile diff。
- AI 加的注释一条条读。一半是噪音,删掉。
- 用户可见的功能要端到端跑一遍。类型检查通过 ≠ 功能正常。
反模式
- 上下文滚雪球。 长 session 会带进过期假设。新任务开新 session。
- 闭眼批准。 不读 diff 就说"看着没问题"是 bug 上线的标准姿势。 读 diff。
- 把 spec 也外包了。 "你看着办"不是提示词,是逃避。
- 顺手改无关代码。 AI 想"既然来了顺便重构一下"——拒绝。开新任务。