AI 工程开发指令标准化模板

核心底层逻辑

整套模板遵循统一标准化工作流，固定五步闭环流程，可彻底规避 AI 自由发挥、改动失控、需求理解偏差、无效修改等问题，所有场景均可直接复制复用：

只读分析 → 输出方案计划 → 执行修改 → 校验验证 → 任务总结

一、项目读取模板（新项目/陌生项目初始化必用）

适用场景

初次接入新项目、接手开源项目、复盘现有工程架构、梳理项目基线信息。

复用指令

请先阅读当前项目，不要修改任何代码。帮我总结：1. 项目是做什么的2. 技术栈是什么3. 目录结构如何组织4. 启动、构建、测试命令是什么5. 新增一个页面应该从哪里开始6. 当前项目有哪些明显维护风险

二、新需求开发模板

适用场景

新增功能、迭代需求、页面/接口新增开发等场景，先定方案再落地，避免盲目改动。

复用指令

我有个新需求：XXX。请先阅读相关代码，不要修改。输出：1. 涉及文件2. 你需要进一步确认的信息3. 新需求的开发方案

三、Bug 排查模板（故障定位&根源分析）

适用场景

页面报错、接口异常、逻辑 bug、渲染错乱、功能失效等各类问题排查。

复用指令

我遇到了一个 bug：XXX。请先阅读相关代码，不要修改。输出：1. 可能原因2. 涉及文件3. 你需要进一步确认的信息4. 修复计划

四、代码修改执行模板（方案落地开发）

适用场景

新增功能、bug 修复、局部逻辑重构，严格约束改动边界，避免过度修改。

复用指令

请按刚才确认的计划修改代码。要求：1. 修改范围只限于 XXX2. 不要引入新依赖3. 不要重构无关代码4. 完成后运行相关测试5. 最后总结修改内容和风险

五、代码评审 Review 模板（自查/代码审核）

适用场景

开发完成自检、PR 代码审核、排查功能漏洞、优化代码健壮性。

复用指令

请 review 当前 git diff。重点关注：1. 是否破坏现有功能2. 是否有边界情况遗漏3. 是否有错误处理缺失4. 是否有类型问题5. 是否有安全风险6. 是否需要补测试只输出问题，不要修改代码。

六、任务收尾总结模板（任务闭环&留存记录）

适用场景

功能开发完成、bug 修复结束，用于任务闭环、工程记录留存，方便后续追溯、接续迭代开发。

复用指令

请总结这个任务。包括：1. 目标是什么2. 最终改了什么3. 已验证什么4. 还有什么风险5. 后续继续做应该从哪里开始

核心使用要点

无需死记模板细节，牢记五步核心工作流，即可灵活适配各类开发场景、自定义指令：

1. 只读分析：先读项目/代码，禁止盲目修改
2. 方案输出：输出完整开发/修复方案，确认细节
3. 精准执行：限定改动范围，落地代码修改
4. 校验评审：测试验证、代码评审，排查隐患
5. 闭环总结：留存任务记录，明确后续迭代方向