使用 AGENTS.md 自定义指令

指令的作用

AGENTS.md 适合保存构建测试命令、代码风格、目录边界和审查标准。Lime 在任务中使用全局与项目指南；离代码更近的指南描述更具体的要求。指令不会自行授予删除、发布、账号访问或系统权限。

创建全局指令

个人通用约定放在 LIME_HOME 对应的 AGENTS.md，默认智能体目录通常为 ~/.lime。AGENTS.override.md 用于同一范围的显式覆盖，普通 AGENTS.md 用于长期维护。

# 工作约定

- 先阅读相关事实源，再修改代码。
- 只使用项目已存在的测试入口。
- 保留其他人的修改。
- 对外发送或发布前确认目标和范围。

分层设置项目指令

在仓库根目录放全局项目规则，在子目录放该模块的局部规则。默认使用标准 AGENTS.md 与 AGENTS.override.md 文件，不把 .lime/ 中的旧位置作为新规范。

repo/
├── AGENTS.md
└── services/
    ├── payments/
    │   └── AGENTS.md
    └── search/
        └── AGENTS.md

让每条要求有明确适用范围。局部指南只补充该模块差异，不复制整个根文档。不要在多个位置维护同一条动态配置。

代码审查规则

## 代码审查

- 优先报告可复现的行为错误、数据丢失和权限问题。
- 每个问题说明触发输入、预期结果、实际结果及证据。
- 格式和静态检查由项目现有工具执行。
- 未执行的测试必须明确标注。

把规则放在受影响代码附近。执行审查时说明基准分支或提交，不让规则代替本次审查范围。

验证加载来源

lime exec --cd /path/to/project \
  --sandbox read-only --ask-for-approval never \
  "列出已读取的项目指令文件，并概述当前目录的约定"

修改指南后，用目标工作目录开始新任务验证。备用文件名、字节上限和日志路径仅在当前版本显式支持时使用，不把其他客户端的配置字段作为通用标准。

排查指令问题

• 未加载：确认工作目录、文件名称和文件内容。
• 规则不符：检查上级目录与全局覆盖文件。
• 内容过长：删去重复说明，把模块细节移到相关子目录。
• 旧事实反复出现：同时更新指南和它引用的权威文档。
• 配置目录不一致：检查 LIME_HOME 与实际进程环境。

下一步

将短规则留在 AGENTS.md，将需要脚本、示例或大量参考材料的流程封装成技能。