AI_RULES.md 13 KB
93. AI 执行模式
本项目采用“任务分级 + 风险分级 + 自动选择执行模式”的 AI 开发机制。
AI 不得对所有任务使用相同的处理方式。
必须根据任务类型、影响范围和风险等级，选择对应执行模式。
94. 执行模式总览
本项目定义以下 7 种 AI 执行模式：
| 模式 | 名称 | 适用场景 | 是否直接修改 |
|---|---|---|---|
| MODE-1 | 快速修复 | 简单 Bug、明显错误 | 可以 |
| MODE-2 | 标准开发 | 普通新功能 | 可以 |
| MODE-3 | 深度开发 | 复杂业务、跨模块功能 | 先分析后修改 |
| MODE-4 | 安全模式 | 支付、权限、认证、安全 | 默认先确认 |
| MODE-5 | 数据模式 | 数据库、迁移、批量数据 | 高风险需确认 |
| MODE-6 | 重构模式 | 大规模重构、架构调整 | 先方案后执行 |
| MODE-7 | 发布模式 | 构建、部署、生产发布 | 默认需要确认 |
AI 必须自动判断使用哪一种模式。
95. MODE-1：快速修复模式
适用
以下问题可以使用快速修复：
- PHP 语法错误
- 明确的变量错误
- 明确的类型错误
- 明显的拼写错误
- 明确的前端 JS 错误
- 明确的 API 参数错误
- 已知函数调用错误
- 明确的空值错误
例如：
Undefined variable
Call to undefined method
Class not found
Syntax error
TypeError
执行流程
定位错误
↓
读取相关代码
↓
确认根因
↓
最小修改
↓
测试
↓
报告结果
不需要为了简单 Bug 输出长篇方案。
限制
快速修复模式不得：
- 修改数据库结构
- 修改支付
- 修改权限
- 修改认证
- 升级依赖
- 大规模重构
- 修改生产环境
如果发现涉及高风险内容：
自动切换到对应高风险模式。
96. MODE-2：标准开发模式
适用
普通功能开发：
- 新增 API
- 新增页面
- 新增 CRUD
- 新增业务 Service
- 新增 Vue 页面
- 新增 Uni-app 页面
- 新增后台管理功能
- 新增普通第三方接口
执行流程
需求分析
↓
搜索现有实现
↓
确定修改文件
↓
设计数据流
↓
后端开发
↓
前端开发
↓
接口联调
↓
测试
↓
代码审查
默认行为
如果风险较低：
AI 可以直接执行。
但必须：
- 遵守 AI_RULES.md
- 遵守 PROJECT_RULES.md
- 尽量最小化修改
- 测试相关功能
- 汇报修改结果
97. MODE-3：深度开发模式
适用
以下情况必须进入深度开发模式：
- 跨多个模块
- 涉及前后端
- 涉及多个数据库表
- 涉及 Redis
- 涉及队列
- 涉及 MQTT
- 涉及 WebSocket
- 涉及复杂业务状态
- 涉及订单
- 涉及库存
- 涉及用户权限
- 涉及多个第三方 API
执行流程
1. 项目扫描
↓
2. 业务链路分析
↓
3. 数据流分析
↓
4. 依赖分析
↓
5. 风险分析
↓
6. 制定实施方案
↓
7. 修改代码
↓
8. 测试
↓
9. 回归测试
↓
10. 输出变更报告
必须分析
至少说明：
入口
↓
Controller
↓
Service
↓
Model
↓
Database
↓
Redis / Queue
↓
第三方服务
↓
前端
如果某一层不存在：
按照实际项目结构处理。
98. MODE-4：安全模式
以下功能必须进入安全模式：
- 登录
- 注册
- Token
- Session
- 权限
- RBAC
- 支付
- 钱包
- 余额
- 退款
- 优惠券
- 文件上传
- 管理员
- API Key
- Webhook
- OAuth
- 第三方登录
- 加密
- 签名
- 敏感数据
安全模式原则
默认：
先分析，后修改。
必须检查：
身份认证
权限
输入验证
数据权限
SQL
XSS
CSRF
SSRF
文件安全
敏感信息
日志
接口重放
幂等
并发
支付相关
涉及支付时必须额外检查：
订单号
金额
签名
回调
订单状态
重复回调
退款
并发
幂等
禁止为了修复支付问题而降低安全等级。
安全模式确认点
如果修改可能导致：
- 用户权限变化
- 支付金额变化
- 账户余额变化
- 身份认证变化
- 敏感数据暴露
必须在修改前明确说明风险。
99. MODE-5：数据库模式
适用
以下操作进入数据库模式：
- 新增表
- 删除表
- 修改字段
- 修改索引
- 修改数据类型
- 数据迁移
- 批量更新
- 批量删除
- 数据清理
- 数据修复
数据库模式原则
先：
读取表结构
↓
检查数据量
↓
检查索引
↓
检查依赖
↓
设计迁移
↓
考虑回滚
高风险操作
以下操作默认禁止直接执行：
DROP DATABASE
DROP TABLE
TRUNCATE
DELETE FROM table
UPDATE table SET ...
尤其是生产环境。
必须：
- 明确目标。
- 明确影响范围。
- 确认备份。
- 尽可能使用条件限制。
- 先 SELECT 验证目标数据。
- 再执行修改。
批量数据修改
推荐：
SELECT
↓
确认数据数量
↓
备份
↓
分批处理
↓
验证
不要直接对百万级数据执行没有评估的 UPDATE。
100. MODE-6：重构模式
适用
- 大规模重构
- Controller 拆 Service
- Service 拆分
- 数据库重构
- API 重构
- 前端架构调整
- Vue 组件重构
- 目录结构重构
- Laravel / ThinkPHP 架构调整
- 技术栈升级
重构原则
核心原则：
行为优先于代码漂亮。
默认：
旧功能正常
↓
增加测试
↓
逐步重构
↓
保持兼容
↓
验证
↓
删除旧代码
禁止一次性大改
不要一次修改：
100+ 文件
而不建立阶段性验证。
推荐：
阶段 1
↓
测试
↓
阶段 2
↓
测试
↓
阶段 3
↓
测试
API 重构
优先：
旧 API
+
新 API
而不是：
直接删除旧 API
除非明确确认不再兼容。
101. MODE-7：发布模式
适用
- Git 发布
- 构建
- 生产部署
- 数据库迁移
- 服务重启
- Supervisor
- Docker
- Nginx
- PHP-FPM
- Webman Worker
- Queue
- Cron
- SSL
- DNS
发布流程
代码检查
↓
git status
↓
git diff
↓
测试
↓
构建
↓
确认环境
↓
备份
↓
部署
↓
数据库迁移
↓
清理缓存
↓
重启必要服务
↓
健康检查
↓
日志检查
生产发布
默认：
不允许 AI 自行进行不可逆的生产操作。
例如：
DROP
TRUNCATE
DELETE
force push
reset --hard
清空 Redis
删除生产文件
停止核心服务
除非用户明确授权。
102. 自动模式选择
AI 接收到任务后必须自动判断：
如果只是明显 Bug
→ MODE-1
如果是普通功能
→ MODE-2
如果跨多个模块
→ MODE-3
如果涉及安全 / 权限 / 支付
→ MODE-4
如果涉及数据库结构或批量数据
→ MODE-5
如果涉及大规模重构
→ MODE-6
如果涉及生产部署
→ MODE-7
如果一个任务同时符合多个模式：
选择风险最高的模式。
例如：
新增支付接口
同时属于：
MODE-2
MODE-4
最终使用：
MODE-4
103. 模式可以组合
复杂任务允许组合模式：
MODE-3 + MODE-4 + MODE-5
例如：
新增订单支付系统
需要：
深度开发
+
安全模式
+
数据库模式
104. 风险等级
所有任务分为：
L0：无风险
L1：低风险
L2：中风险
L3：高风险
L4：生产高风险
L0
例如：
修改注释
修改文档
格式化单个文件
AI 可以直接执行。
L1
例如：
简单 Bug
普通 UI
普通 API
AI 可以直接执行。
L2
例如：
新增业务
新增数据库字段
Redis
队列
第三方 API
AI 可以执行，但必须测试并报告影响。
L3
例如：
支付
权限
认证
余额
库存
数据库批量修改
大规模重构
必须先进行风险分析。
L4
例如：
生产数据库
生产支付
生产服务器
生产 Redis
生产部署
删除生产数据
必须明确确认后才能执行高风险操作。
105. AI 修改前的“变更计划”
当任务达到 L2 及以上时，AI 应先生成：
## Change Plan
### 目标
xxx
### 当前实现
xxx
### 问题
xxx
### 修改文件
1. xxx
2. xxx
3. xxx
### 数据库
无 / 新增字段 / 新增表 / 修改数据
### API
无 / 新增 / 修改
### 前端
无 / 修改页面 / 新增组件
### Redis
无 / 新增 Key / 修改缓存
### 风险
低 / 中 / 高
### 测试
xxx
### 回滚
xxx
106. AI 的“只读分析模式”
如果用户说：
帮我看看
分析一下
检查一下
为什么
排查
审计
有没有问题
默认进入：
READ-ONLY MODE
此模式下：
只分析，不修改代码。
除非用户明确要求修改。
107. AI 的“计划模式”
如果用户说：
设计一下
怎么实现
给我方案
架构怎么做
进入：
PLAN MODE
输出：
需求分析
↓
架构方案
↓
文件变更计划
↓
数据库方案
↓
API 方案
↓
前端方案
↓
测试方案
↓
部署方案
不直接修改代码。
108. AI 的“实现模式”
如果用户说：
帮我开发
实现
写代码
修复
修改
增加
删除
进入：
IMPLEMENT MODE
根据风险等级自动选择 MODE-1 ~ MODE-7。
109. AI 的“审查模式”
如果用户说：
帮我 Code Review
检查代码
安全审计
检查有没有问题
进入：
REVIEW MODE
只检查：
Bug
安全
性能
架构
代码质量
兼容性
默认不修改。
输出：
严重程度：
CRITICAL
HIGH
MEDIUM
LOW
INFO
注意：
审查等级不是代码质量评分。
不得使用：
9/10
A+
优秀
差
等无实际依据的评分。
110. AI 的“测试模式”
如果用户要求：
测试
验证
跑一下
检查是否正常
进入：
TEST MODE
优先执行：
语法检查
↓
单元测试
↓
集成测试
↓
API 测试
↓
前端构建
↓
关键业务测试
没有执行的测试：
必须明确标记：
NOT RUN
不能声称通过。
111. AI 的“部署模式”
用户要求：
部署
上线
发布
更新服务器
进入：
DEPLOY MODE
必须先检查：
当前分支
当前 Commit
工作区
构建状态
环境
数据库迁移
配置
备份
生产环境操作必须特别谨慎。
112. 用户没有明确要求时的默认行为
默认规则：
查看
→ 只读
分析
→ 只读
设计
→ Plan
开发
→ Implement
修 Bug
→ 根据风险自动选择
部署
→ Deploy
审查
→ Review
113. AI 的暂停条件
遇到以下情况必须暂停并询问：
需求冲突
例如：
用户要求保持兼容
但又要求删除旧 API
数据风险
例如：
需要删除大量数据
但没有明确条件
生产风险
例如：
需要修改生产数据库
但没有备份信息
安全风险
例如：
需要关闭权限验证
需要关闭 SSL 验证
需要暴露 API Key
不得为了完成需求而执行。
架构不确定
例如：
不知道项目使用 Laravel 还是 ThinkPHP
不知道数据库表结构
不知道接口规范
先读取项目，而不是猜。
114. AI 的自动降级原则
如果发现：
当前任务风险高于最初判断
必须自动切换到更高风险模式。
例如：
原任务：
修复一个 API Bug
发现：
涉及支付金额
自动切换：
MODE-4 安全模式
115. AI 的自动升级原则
如果发现：
简单修改
但实际涉及：
数据库
支付
权限
生产环境
必须自动升级模式。
不能继续按照普通 Bug 处理。
116. AI 的最终执行报告
任务完成后必须报告：
## Execution Report
执行模式：
MODE-X
风险等级：
L0 / L1 / L2 / L3 / L4
### 修改文件
- xxx
- xxx
### 修改内容
xxx
### 数据库
无修改
或者：
新增：
xxx
### API
无变化
或者：
新增：
xxx
### Redis
无变化
或者：
新增：
xxx
### 测试
执行：
xxx
结果：
PASS / FAIL / NOT RUN
### 部署
未部署
或者：
已部署到测试环境
### 风险
xxx
### 回滚
xxx
117. AI 执行优先级
当多个规则发生冲突时，优先级：
安全
>
用户明确要求
>
项目规范
>
现有业务兼容性
>
框架规范
>
通用最佳实践
>
AI 自己的偏好
AI 自己的“代码风格偏好”优先级最低。
118. 最终执行哲学
本项目不追求：
AI 写得最多
也不追求：
AI 改得最快
而追求：
正确
+
安全
+
可维护
+
可验证
+
可回滚
最终原则：
简单问题快速解决，复杂问题先分析，高风险问题先确认，生产问题可回滚。
AI 可以主动发现问题，但不能擅自扩大修改范围。
AI 可以提出更好的方案，但不能未经授权改变核心业务规则。
AI 可以自动修复低风险问题，但涉及数据、权限、支付和生产环境时必须提高执行等级。