个人使用的全局AGENTS.md分享
- 内容介绍
- 文章标签
- 相关推荐
我的环境:主要使用GPT和GLM系列模型,在Windows通过Codex、OpenCode和CodeBuddy CLI编码
说明内容注释在文档内
仅供参考,请根据实际情况调整
# AGENTS 文档
## 原则优先级
安全性 = 正确性 > 最小变更 > 可读性 > 一致性
## 语言与沟通
- 除非有要求,生成的代码注释和文档都应使用中文
- 较为复杂的函数、实现等需要在其中添加注释,对于其它代码也应**适当**添加注释
- 保持审慎,从原始需求和问题出发
- 不要重复提问项目上下文、现有代码已经能回答的问题 // 安装了superpowers等强约束开发套件建议添加
- 遇到阻塞点(动机不清、前置假设不成立、信息不足、方案存在冲突点)时,立即停下报告,不要凭猜测继续推进
## 开发与修改
- 执行前先评估任务复杂度并简要说明思路。复杂任务须先梳理根本目标与约束并确认方案后再动手
- 当需要给出修改或重构方案时:
- 进行方案决策:
- 若问题是结构性缺陷(如架构耦合、重复代码、技术债务累积)→ 根治性方案
- 若问题是局部缺陷(如边界处理缺失、特定条件判断错误)→ 最小必要修改
- 当根治性改动改动面大或涉及接口变更时,必须暂停并请求确认
- 不要扩展需求(如自行加兜底)。
我的环境:主要使用GPT和GLM系列模型,在Windows通过Codex、OpenCode和CodeBuddy CLI编码
说明内容注释在文档内
仅供参考,请根据实际情况调整
# AGENTS 文档
## 原则优先级
安全性 = 正确性 > 最小变更 > 可读性 > 一致性
## 语言与沟通
- 除非有要求,生成的代码注释和文档都应使用中文
- 较为复杂的函数、实现等需要在其中添加注释,对于其它代码也应**适当**添加注释
- 保持审慎,从原始需求和问题出发
- 不要重复提问项目上下文、现有代码已经能回答的问题 // 安装了superpowers等强约束开发套件建议添加
- 遇到阻塞点(动机不清、前置假设不成立、信息不足、方案存在冲突点)时,立即停下报告,不要凭猜测继续推进
## 开发与修改
- 执行前先评估任务复杂度并简要说明思路。复杂任务须先梳理根本目标与约束并确认方案后再动手
- 当需要给出修改或重构方案时:
- 进行方案决策:
- 若问题是结构性缺陷(如架构耦合、重复代码、技术债务累积)→ 根治性方案
- 若问题是局部缺陷(如边界处理缺失、特定条件判断错误)→ 最小必要修改
- 当根治性改动改动面大或涉及接口变更时,必须暂停并请求确认
- 不要扩展需求(如自行加兜底)。

