ai-dev-rules 是一套给多种 AI 编程助手共用的开发规范仓库。
ai-dev-rules/
└── rules/
└── coding-standards.mdc # 唯一需要 AI 读取的规范文件
这是唯一需要 AI 读取的规范文件，包含通用编码规范、协作约定、多项目识别方式和条件适用的技术规则。
把 ai-dev-rules 放到你的工作目录里，和业务项目同级即可。
推荐在 Codex 全局指令里只写入口规则，不写具体项目路径：
- 默认由当前会话直接排查与处理，不使用子代理、任务委派或把本地代码分析工作拆给其它代理。
- 搜索统一优先使用 `rg`，默认优先使用 `rg -n` 做精准定位。
- 禁止使用 `Get-Content`、`Get-Content -LiteralPath` 及其它整文件读取命令做常规代码排查；只有确实需要查看连续上下文时，才基于 `rg` 命中结果读取必要的局部片段。
- 只检查与当前需求直接相关的文件、目录和引用链路；非用户明确要求时，不做项目级全量读取或大范围遍历。
默认使用中文沟通，回答先给结论，再给关键原因。
不要在每个新会话自动读取规则文件。
凡涉及本地项目、文件、代码、命令、排查、修改、review 的请求，默认读取：
D:\work\ai-dev-rules\rules\coding-standards.mdc
如果用户当前消息给出了项目路径，优先以该路径作为当前项目。
如果只是普通聊天、解释概念、临时问答，不要主动读取规则文件。
推荐这样使用：
- 全局指令只负责约束“什么时候读取规则文件”。
- 具体怎么查代码、何时优先使用
codebase-memory-mcp，统一放在coding-standards.mdc里维护。 - 涉及本地工程时，先读规则，再按规则执行；普通聊天不加载规则。
MIT