2. Linux.do
  3. 请简化你的 AGENTS.md 只保留必要的规则，硬性规则越少，AI 可能更聪明

请简化你的 AGENTS.md 只保留必要的规则，硬性规则越少，AI 可能更聪明

文聿 2026-03-27 16:42 1

请简化你的 AGENTS.md 只保留必要的规则，最新的模型已经很聪明了，不需要太多的束缚。

指令越少，反而可能更聪明。


# AGENTS.md



> **核心目标**：交付高质量、安全、可维护的代码。  

> **硬性约束**：所有用户可见输出、文档、注释、Git Commit 一律使用**简体中文**。



## 1. 工作原则

- **先分析后执行**：先明确目标、约束、边界、风险、业务价值和验收标准，再开始编码。

- **方案有取舍**：至少快速比较主方案与备选方案，优先简单、可维护、能解决根因的方案，避免补丁式修复和过度设计。

- **安全优先**：禁止硬编码密钥；所有外部输入都必须校验、清洗并做好边界检查。



## 2. 编码要求

- 文件统一使用 **UTF-8 无 BOM**。

- 标识符使用清晰英文命名，禁止无意义命名。

- 关键逻辑、接口和非显而易见的决策必须写**中文注释**，重点说明“为什么”和业务背景。

- 设计遵循 **KISS、YAGNI、SOLID、DRY**，保持高内聚、低耦合。



## 3. 变更与验证

- 逻辑变更必须补充自动化测试；核心逻辑优先保证 **80%+ 覆盖率**。

- 每次修改都要执行受影响范围内的最小充分验证，如单测、集成测试、契约测试、端到端测试或静态检查。

- 纯文档或注释变更可不跑测试，但交付时必须说明原因。

- 交付时明确说明：做了什么、为什么这样做、如何验证、剩余风险、潜在技术债，并做简要复盘。



## 4. 检索与工具约束

- 本地检索优先使用 `rg`。

- 除纯本地或纯文档微调外，默认进行联网检索；优先查官方文档、标准规范和权威资料，并保留关键结论来源。
最新回复 (19)
  • 雾里 03-27 16:43
    1楼

    感谢分享

  • 始皇与成都九男七日那些事儿 03-27 16:44
    2楼



    学习

  • daisy mirai 03-27 16:45
    3楼

    感谢分享

  • sine 03-27 16:46
    4楼

    这个和superpowers冲突吗？


    bro

  • Brantfang 03-27 16:46
    5楼

    我都是写一些技术栈和限制要求，其他遇到问题再添加。

  • 文聿 楼主 03-27 16:47
    6楼

    不冲突，非必要的话 AGENTS.md 都可以不写。

  • zamasu 03-27 16:49
    7楼

    全局AGENTS.md，是全局的规范，在单独项目再建立一个项目的AGENTS.md作为项目的规范，这样搭配使用的

  • jackFeng 03-27 16:49
    8楼

    agents.MD 不是要写项目的内容吗。

  • pking 03-27 16:50
    9楼 

    - 除纯本地或纯文档微调外，默认进行联网检索；优先查官方文档、标准规范和权威资料，并保留关键结论来源。


    说话默认的代码没有注释，你们有这方面的处理吗

  • fjiabinc 03-27 16:51
    10楼

    不写的话,不会用gemini,不会遵循前端规则. 拉一大坨div

  • sine 03-27 16:54
    11楼

    我现在没有这个文件，我在考虑要不要用/init命令生成。。。


    但是它生成的跟你这个不一样，属于项目的。


    你这个应该是属于.codex的吧？

  • 文聿 楼主 03-27 16:54
    12楼

    这是全局的

  • arygboy 03-27 16:54
    13楼

    有一些限制不写会有很多问题的，乱码，乱删文件，环境转义字符，执行卡死，不写注释，还有相同的方法不直接复用，非要单独写两个一样的 ^-^

  • sine 03-27 16:54
    14楼

    哦哦哦，那楼主这个应该属于全局规范。

  • EdwardYi 03-27 16:56
    15楼

    学习学习，现在superpowers一堆天才牛马干活，感觉我的AGENTS.md有点多余了，除了git规范

  • 大帅哥 03-27 16:57
    16楼

    感谢大佬。

  • fx318 03-27 16:58
    17楼

    学习学习

  • 文成宇 03-27 17:02
    18楼

    本地检索优先使用 rg。 这一条可以删除，因为codex系统提示词中已经有了


    When searching for text or files, prefer using `rg` or `rg --files` respectively because `rg` is much faster than alternatives like `grep`. (If the `rg` command is not found, then use alternatives.)

    参考 codex/codex-rs/protocol/src/prompts/base_instructions/default.md at main · openai/codex · GitHub

  • 全球最菜 03-27 17:08
    19楼

    感觉和以前的提示词一样，开始多，后面少。

* 帖子来源Linux.do
附近帖子
返回
飞读
随机推荐