在真实项目里用好 AI 编程助手

先给助手一份“项目说明书”

在仓库根目录维护一个说明文件（例如 AGENTS.md），写清楚：

• 项目结构和各目录职责
• 构建、测试、代码检查的命令
• 代码风格约定和禁止事项（比如不要改动生成代码）

助手每次开始工作时读取它，能减少大量重复解释。

任务要拆小

“把用户模块重构一下”这种需求，助手大概率会改出一大堆难以审查的代码。更好的做法是：

1. 先让它阅读代码并输出改造计划
2. 人工确认计划后，按步骤逐个实现
3. 每一步完成后运行测试并提交

让机器来把关

助手写的代码同样要过自动化检查：

go vet ./... && go test ./... && golangci-lint run

把这些命令写进说明文件，并要求助手在宣布完成之前自己运行一遍。

什么时候不适合交给助手

• 涉及线上数据写入、资金、权限的变更
• 需求本身还不清晰的探索性工作
• 对性能、安全要求极高的核心路径

这些场景可以让助手辅助分析，但决策和最终实现要由人负责。

小结

AI 编程助手是放大器：流程规范时放大效率，流程混乱时放大混乱。