项目规则与初始化

把项目约定写成可随仓库维护的规则，让 ACECode 在理解和修改代码时遵循相同的边界。

本页内容

项目规则文件

ACECode 默认识别 AGENT.md、AGENTS.md 和 CLAUDE.md。同一目录按配置中的文件名顺序选用第一个匹配文件，默认顺序如上；不会把同目录三个文件无条件全部合并。

加载先读取用户数据目录中的全局规则，再按项目目录层级从外到内收集。是否读取、文件名顺序及内容长度都受配置控制，CLAUDE.md 还受独立读取开关控制。

规则适合记录目录职责、构建测试命令、编码风格、禁止修改的区域和交付标准。不要把临时任务状态、长日志和密钥放进去，冗长规则也会占用模型上下文。

在正确的项目中提交 /init，让 ACECode 分析仓库并生成或改进 AGENT.md。它会调用模型，可能需要阅读文件和写入确认；生成后仍应检查其中的目录与命令是否真实可用。

在 ACECode 输入框中提交

/init

已有团队维护的 AGENTS.md 时，先明确希望更新哪个文件，避免无意引入优先级更高但内容重复的 AGENT.md。桌面/Web 选择命令只把文本填入输入框，提交后才执行。

CF-04

图片占位初始化后的项目规则检查此处补充实际界面截图

展示提交 /init 的位置以及生成规则的文件预览，标出构建命令、测试命令和禁止修改范围。

AGENT.md 内容示例

项目使用 Python，业务代码放在 src/，测试放在 tests/。
修改前先阅读相关模块与测试；不要修改 generated/ 下的生成文件。
保持现有公开接口，新增行为需要相应测试。
完成后运行项目 README 中记录的验证命令，并报告未执行的检查。

把示例中的语言、路径和验证命令替换成自己的项目约定。稳定的个人偏好放在个性化或记忆中，可复用的操作流程整理为技能；本项目特有的约束留在项目规则里。