AI 可以在几分钟内生成看起来完整的代码,也可以在几分钟内把错误扩散到整个项目。我的工作方式不是让 AI 代替开发者,而是让它成为一个高频、可质询、必须接受验收的协作者。
2.1 项目简报
每个项目先创建一页 task-brief.md:
# Task Brief
真实场景:
使用者/受众:
要完成的决策或动作:
截止时间:
已知事实与来源:
允许使用的文件:
数据敏感等级:公开 / 内部 / 机密 / 受限
明确不提供的材料:
最终交付物:
格式与长度:
验收标准:
必须由人确认的事项:
AI 可以做:
AI 不可以做:
人工审阅者:
失败时如何回滚或停止:
“体验好”“架构先进”“智能化程度高”不是验收标准。把标准写成可观察的动作,例如“用户能在 10 分钟内完成一次导入并看到错误报告”。
2.2 可复查的开发链
| 阶段 |
AI 可以协助 |
人必须确认 |
| 需求 |
整理用户、场景、限制和问题 |
问题是否真实,完成标准是否可观察 |
| 方案 |
提出架构、接口和最小实验 |
数据边界、依赖、失败模式和长期成本 |
| 原型 |
生成页面、接口、脚本和样例数据 |
是否解决核心任务,而不是只展示效果 |
| 实现 |
补全代码、解释改动、生成测试 |
关键逻辑、权限、异常处理和可维护性 |
| 校验 |
运行测试、静态检查、性能和安全检查 |
测试是否覆盖真实风险,结果能否复现 |
| 交付 |
整理文档、部署步骤、变更记录和回滚方案 |
用户能否使用,团队能否接手,问题能否追溯 |
每次只推进一个逻辑切片,不把需求、重构、格式化和依赖升级混在一起。保留一份无 AI 基线、一份真实可运行作品和一份错误/修订记录,才能区分速度与能力。
2.3 代码和发布门禁
这是任务简报和当前代码结构。先不要写代码。
提出两个最小实现方案,比较需求覆盖、改动范围、依赖、失败模式、测试难度、数据/权限风险和迁移成本。
明确缺失信息和推断。最后只推荐一个 1–2 小时可验证的切片。
发布前至少保存:版本号、变更摘要、迁移步骤、监控指标、回滚触发条件、负责人和用户通知。代码审查按严重性检查需求偏差、数据丢失、权限绕过、注入、竞态、异常处理、性能、可维护性和测试缺口。
每次试点或发布后填写AI 项目评分卡,同时保留无 AI 基线、AI 辅助版和延迟独立复测;没有这三份样本,就无法判断工具带来的是能力、代做还是返工。