- 文聿2026-03-2745697
请简化你的 AGENTS.md 只保留必要的规则,最新的模型已经很聪明了,不需要太多的束缚。
指令越少,反而可能更聪明。```
AGENTS.md
核心目标:交付高质量、安全、可维护的代码。
硬性约束:所有用户可见输出、文档、注释、Git Commit 一律使用简体中文。1. 工作原则
- 先分析后执行:先明确目标、约束、边界、风险、业务价值和验收标准,再开始编码。
- 方案有取舍:至少快速比较主方案与备选方案,优先简单、可维护、能解决根因的方案,避免补丁式修复和过度设计。
- 安全优先:禁止硬编码密钥;所有外部输入都必须校验、清洗并做好边界检查。
2. 编码要求
- 文件统一使用 UTF-8 无 BOM。
- 标识符使用清晰英文命名,禁止无意义命名。
- 关键逻辑、接口和非显而易见的决策必须写中文注释,重点说明“为什么”和业务背景。
- 设计遵循 KISS、YAGNI、SOLID、DRY,保持高内聚、低耦合。
3. 变更与验证
- 逻辑变更必须补充自动化测试;核心逻辑优先保证 80%+ 覆盖率。
- 每次修改都要执行受影响范围内的最小充分验证,如单测、集成测试、契约测试、端到端测试或静态检查。
- 纯文档或注释变更可不跑测试,但交付时必须说明原因。
- 交付时明确说明:做了什么、为什么这样做、如何验证、剩余风险、潜在技术债,并做简要复盘。
4. 检索与工具约束
- 本地检索优先使用
rg。 - 除纯本地或纯文档微调外,默认进行联网检索;优先查官方文档、标准规范和权威资料,并保留关键结论来源。
主楼 - 雾里2026-03-2717185
感谢分享
- 始皇与成都九男七日那些事儿2026-03-2713357
- daisy_mirai2026-03-2745698
感谢分享
- sine-linuxdo2026-03-2745699
- Brantfang2026-03-276334
我都是写一些技术栈和限制要求,其他遇到问题再添加。
- 文聿2026-03-2745697
不冲突,非必要的话 AGENTS.md 都可以不写。
- zamasu-linuxdo2026-03-279670
全局AGENTS.md,是全局的规范,在单独项目再建立一个项目的AGENTS.md作为项目的规范,这样搭配使用的
- jackFeng2026-03-2745700
agents.MD 不是要写项目的内容吗。
- pking2026-03-2745701
- 除纯本地或纯文档微调外,默认进行联网检索;优先查官方文档、标准规范和权威资料,并保留关键结论来源。 ```说话默认的代码没有注释,你们有这方面的处理吗 - fjiabinc2026-03-2745702
不写的话,不会用gemini,不会遵循前端规则. 拉一大坨div
- sine-linuxdo2026-03-2745699
- 文聿2026-03-2745697
这是全局的
- arygboy2026-03-2745703
有一些限制不写会有很多问题的,乱码,乱删文件,环境转义字符,执行卡死,不写注释,还有相同的方法不直接复用,非要单独写两个一样的 ^-^
- sine-linuxdo2026-03-2745699
哦哦哦,那楼主这个应该属于全局规范。
- EdwardYi2026-03-2739490
学习学习,现在superpowers一堆天才牛马干活,感觉我的AGENTS.md有点多余了,除了git规范
- 大帅哥2026-03-276194
感谢大佬。
- fx3182026-03-2716757
学习学习
- 文成宇2026-03-2716004
本地检索优先使用
rg。 这一条可以删除,因为codex系统提示词中已经有了```
When searching for text or files, prefer usingrgorrg --filesrespectively becausergis much faster than alternatives likegrep. (If thergcommand is not found, then use alternatives.)
```参考 codex/codex-rs/protocol/src/prompts/base_instructions/default.md at main · openai/codex · GitHub - 全球最菜2026-03-2715718
感觉和以前的提示词一样,开始多,后面少。
