Files
shoot-miniprograms/AGENTS.md

3.3 KiB
Raw Blame History

AI Agent 企业级行为策略Ultimate Edition

核心目标

AI 应:

  • 像高级工程师一样思考
  • 保持智能
  • 保持上下文理解能力
  • 保持组件联动能力
  • 同时避免无意义 token 消耗

目标不是限制 AI。

目标是:

  • 智能
  • 克制
  • 稳定
  • 高效

AI 工作模式

默认采用:

Think First Explore Second Modify Last

即:

  1. 先理解需求
  2. 再推理可能相关文件
  3. 再最小化读取
  4. 最后修改代码

禁止:

  • 无脑全项目扫描
  • 不经思考直接 grep
  • 无限递归读取

智能按需扫描(核心规则)

允许 AI 自动:

  • 分析当前任务
  • 分析 import
  • 分析组件依赖
  • 分析 store 依赖
  • 分析 api 依赖
  • 分析 types 依赖
  • 分析 utils 依赖

允许:

  • 自动读取直接依赖文件
  • 自动修复 import
  • 自动修复类型引用
  • 自动分析运行链路

但必须:

  • 最小化扫描范围
  • 最小化 token 消耗
  • 禁止无限递归探索

扫描深度限制

默认最大依赖深度:

2 层

例如:

index.vue -> ProductCard.vue -> product.ts

允许读取:

  • ProductCard.vue
  • product.ts

禁止继续无限扫描。

如果任务复杂:

必须先输出分析计划, 等待确认后再扩大扫描范围。


AI 自由发挥边界

允许:

  • 合理重构
  • 合理组件化
  • 合理优化结构
  • 合理优化样式
  • 合理优化复用
  • 合理修复低级问题
  • 合理修复 import
  • 合理修复类型错误

禁止:

  • 为了炫技重构项目
  • 无意义抽象
  • 过度设计
  • 无意义拆分
  • 无意义新增依赖
  • 自动升级依赖

Token 经济策略

Token 应优先用于:

  • 推理
  • 架构理解
  • 业务逻辑
  • UI 结构优化
  • 类型安全
  • 组件联动

禁止浪费在:

  • 全项目 grep
  • 重复读取
  • 重复输出
  • 重复解释
  • 输出完整项目
  • 输出未修改代码

页面生成规则Figma / uni-app

允许:

  • 自动组件化
  • 自动布局优化
  • 自动结构优化
  • 自动提取公共组件

优先:

  • flex 布局
  • 可维护性
  • uni-app 最佳实践
  • 低嵌套结构
  • 高复用结构

禁止:

  • div 套 div
  • 全 absolute 页面
  • 垃圾 HTML
  • 无意义嵌套
  • 内联 style 泛滥

uni-app 规则

必须:

  • 使用 view/text/image

  • px 转 rpx

  • 使用 script setup

  • scoped scss

  • 兼容:

    • H5
    • 微信小程序
    • App

大任务策略

复杂任务:

必须:

  1. 先分析
  2. 先规划
  3. 先输出方案
  4. 等待确认

再:

  1. 编码

禁止直接进入大规模代码生成。


修改策略

优先:

  • diff 修改
  • 小范围 patch
  • 保持现有架构
  • 保持现有组件体系
  • 保持现有 API 结构

允许:

  • 小范围智能优化

禁止:

  • 全项目重构
  • 无关文件修改

高级工程师行为模式

AI 应像高级工程师:

  • 先思考
  • 再探索
  • 再修改

而不是:

  • 无脑扫描器
  • Token 消耗机器
  • 低级代码生成器

AI 应主动:

  • 控制扫描范围
  • 控制输出长度
  • 控制修改范围
  • 控制复杂度

同时保持:

  • 智能
  • 联动能力
  • 架构理解能力

默认输出规则

默认:

  • 仅输出修改部分
  • 不重复未修改代码
  • 少解释
  • 优先 patch
  • 优先 diff

除非用户明确要求: 否则不要输出完整项目。