关键模块怎么用 AI 写的

平台里适合「AI 写 + 人审」的拆法：模块内模仿，模块外禁止。

AI CODING · 场景四 · 模块派活

不要「优化一下后端」。要写成：只改哪些文件、参考哪个邻居、验收怎么点、碰不碰鉴权。

练习 A / B / C 选一产出 给 AI 的 Prompt + 记录

派活 →

本节要点

• 什么适合交 AI、什么必须人审
• 一张受控平台小改 Prompt
• 练习 A/B/C + 记录模板

适合给 AI练习Review

适合交给 AI

备选做法 · 须人工审核

鉴权与租户、计费删除级联、Prompt/工具安全、模型密钥与降级、跨模块「顺手重构」。

推荐做法 · 可交 AI

CRUD/列表文案、只读 API、测试草稿、运维/README 清单——模块内模仿已有风格。

选型说明： 平台里 AI 擅长「照邻居抄」；安全与跨模块边界一漂，事故面是整仓。人审不是不信任模型，是把自己留在责任链上。

类型	例子	人审重点
CRUD / 列表 / 文案	管理页多一列已有字段	字段是否已在 API
只读 API	按已有风格加 GET	权限是否过宽
测试草稿	补断言骨架	是否测真行为
文档 / 清单	运维检查、README	命令是否可执行

模块地图（对照你的仓填空）

模块	路径（自填）	AI 默认	原因
控制台页面		可小改	UI + 已有 API
业务 API		可小改（只读优先）	契约清晰时
鉴权中间件		禁止擅自改	安全
Agent 运行时核心		人审	行为难测
部署脚本		人审	环境影响面大

给 AI 的 Prompt 模板

给 AI · Prompt · 平台小改动先复述范围与风险；确认前不要给 diff

【范围】只改：<目录或文件列表>
【参考】@architecture-platform.md @<同模块已有文件>
【目标】<一句话业务结果>
【不要】改鉴权、改全局数据库配置、重构邻居模块、改无关 CI
【风险】密钥/权限/多租户？（无则写「无」）
【验收】<点击路径或 curl>
【请你】先复述范围与风险，我确认后再给 diff。

练习题（选一做完即算跟练）

A. 只读展示
管理列表多显示一个后端已有字段。
验收：页面可见；网络无 500；diff ⊆ 允许文件。

B. 文档型（无仓也能做）
根据现有部署/README，写「试跑失败」排障 5 步。
验收：每步有命令或明确点击路径；不编造监控产品。

C. 测试型
给一个纯函数补 3 条测试。
验收：红→绿；业务行为不变。

练习记录模板

给 AI · 练习记录做完存进工作记录；复盘一句即可

练习：A / B / C
Prompt 原文：（粘贴）
允许文件：
实际 diff 文件：
验收：通过 / 失败（现象）
复盘一句：

反面教材

不合格示例 · 弱指令

「把平台后端优化一下」；「按业界最佳实践重构运行时」；整仓 @ +「修试跑」。

推荐做法

上面那张卡：文件列表 + 禁止项 + 验收路径写死。

Review 清单（合并前）

• [ ] diff ⊆ 允许列表
• [ ] 无密钥、无 .env
• [ ] 鉴权未被临时关掉
• [ ] 验收已人工走过
• [ ] PR/记录贴了Prompt 摘要

下一页：部署与运维。