AI

Claude Code 工作流:如何让 AI 写出可维护的代码

把需求拆成 Sprint,用 Prompt 驱动 AI 生成代码,再做代码评审与提交。

#Claude Code#AI#工作流
Claude Code 工作流:如何让 AI 写出可维护的代码

AI 编码工具的真正价值,不在于"一键生成",而在于用工程化方式把 AI 嵌进开发流程。

四段式 Prompt

每个 Sprint 的 Prompt 由四部分组成:

  1. 目标
  2. 为什么这么做
  3. 开发任务
  4. 验收标准

没有验收标准的 Prompt,AI 会自由发挥,结果通常不可控。

示例:抽离 Layout

提示词骨架:

// 伪代码:说明意图,而不是逐行命令
const task = {
  goal: "抽离共享 Layout",
  why: "所有页面共享 Header/Footer",
  done: ["Header.tsx", "Footer.tsx", "Container.tsx"],
  accept: ["npm run lint 无错误", "首页正常显示"],
};

常见坑

  • 不读文档就写:框架大版本(如 Next 16)有破坏性变更,必须先读官方文档。
  • 没有验收:AI 生成完不知对错,必须跑 lint / tsc / build
  • 一把梭:把所有需求塞进一个 Prompt,结果越改越乱,要拆 Sprint。

配图示例

工作流示意