AI 辅助开发工作流

五段闭环

阶段	关键动作	退出条件
侦察	读规则、查状态、定位相关代码和测试	能解释现状和影响范围
计划	拆成可独立验证的小步骤，识别风险和依赖	每一步都有明确产出
实现	先做最小变化，保持现有行为和代码风格	目标功能能运行
验证	构建、测试、真实界面、链接、安全和回归	证据覆盖成功与失败路径
收尾	更新文档、风险、变更记录和版本	下一位维护者能接手

小步迭代原则

• 一次只解决一个明确问题。
• 修改前先确认已有测试和工作树状态。
• 优先扩展现有结构，不无故引入新框架。
• 每完成一个闭环就运行对应检查，不把所有验证留到最后。
• 大改动先建立可回退版本，再做批量迁移。
• 发现需求变化时，先更新规格，再继续写代码。

对话工程

对 AI 的有效指令不是“语气更强”，而是让任务具备可观察状态。

先读取：项目规则、相关模块和现有测试。
目标：实现……
允许修改：……
不得修改：……
保持行为：……
验收：运行……；页面应……；失败时应……
完成后报告：改动文件、验证结果、剩余风险。

当结果偏离时，补充缺失事实，不要连续重复同一句要求。出现多次失败，应让工具暂停生成，重新调查根因。

处理幻觉与死循环

现象	可能原因	处理方式
引用了不存在的文件或接口	没有先读工程	要求列出实际路径和搜索证据
反复修改同一处仍失败	根因判断错误	回退到最后可用状态，缩小复现
生成大量无关代码	范围不清或任务过大	重写为一个最小可验证步骤
测试“通过”但没有运行证据	只做了文本推断	要求执行命令并报告退出码
修好一个页面却破坏其他页面	缺少回归范围	增加关键路径和多尺寸检查

版本控制习惯

提交前确认差异只包含本任务；不要覆盖用户已有改动；不要提交密钥、缓存、构建产物和本机配置。提交信息应说明为什么变更，而不是笼统写“更新代码”。

完成后的交接

至少说明：结果、改动位置、如何验证、是否上线、已知风险和下一步。如果只完成了方案或本地代码，不要使用“已发布”“已上线”等词。