适用于本仓库及其子目录;子目录有更具体的 AGENTS.md 时,同时遵循其适用规则。始终使用简体中文沟通。
- 本仓库是 LimeIoT 开源核心,工程边界见
docs/21-Monorepo与开发规范.md;按需阅读相关模块文档,不无目标地通读仓库。 contracts/是正式机器合同来源。修改合同须检查受影响消费者;docs/examples/中的设计示例不自动视为正式合同。- 官网与文档中心由独立的
iotweb仓库维护;不将相邻私有仓库作为本仓库构建或测试前提。 - 实际命令以当前
package.json和模块配置为准,验证方法按任务范围选择。
- 优先检查完成任务所必需的文件,明确改动位置后直接执行;只对影响正确性、兼容性或安全性的疑点继续调查。
- 同一任务内复用已经读取的信息,禁止无信息增量的重复读取。仅在文件已变化、关键上下文缺失或必须核对具体细节时,定向重读相关片段。
- 已有证据确认的结论不反复分析;出现新证据、需求变化或验证失败时再重新评估。
- 非关键问题记录原因和影响后继续,不无限循环修复。影响核心功能、数据完整性或安全的问题必须明确列为阻塞。
- 每完成一个独立模块,立即执行与改动相称的验证。纯文档修改检查内容、路径和格式,无需运行无关应用测试。
- 针对同一测试失败,首次失败后最多进行两轮针对性修复并复验。仍失败则记录失败项、已尝试方案、原因或未确认点及影响,继续不依赖该问题的任务;未解决的关键失败不得标记为通过或完成。
- 严守任务范围,不顺手重构无关代码,不引入当前需求之外的抽象、依赖或功能。
- 优先批量读取和组织必要修改;独立命令可并行执行。存在依赖关系或可能写入同一文件、共享状态的操作必须顺序执行。
- 每完成一个有实质产出的阶段,简要汇报修改内容、验证结果和剩余问题;小任务可合并到最终交付说明。
- 预计超过 20 分钟的任务,开始时主动拆分为可独立验证的阶段,说明拆分原因、依赖和验证点;执行中发现超出预估时及时补充拆分。
效率来自减少无效工作,不能通过省略必要验证、削弱断言或隐藏失败来提速。
- 遵循 KISS、YAGNI、DRY、SOLID:优先直接实现和组合,保持职责清晰,仅在真实重复和复用需求出现时抽象。
- 先读后改,保持现有代码风格和注释语言;测试优先覆盖业务行为、失败与恢复,避免逐行复刻实现。
- 保留用户和其他会话的未提交改动,避免覆盖无关内容。
- 未经用户明确要求,不计划或执行创建分支、提交、推送、发布等操作。
- 删除文件或目录、批量修改、破坏性 Git 操作、系统配置或权限变更、数据库结构或批量数据变更、发送敏感数据或调用生产 API、全局包安装卸载或核心依赖升级,必须先获得用户明确确认。
- 搜索优先使用
rg;Shell 命令中的文件路径使用双引号包裹。
- 先完成直接相关的检查,通过后仅在存在新变更、失败或未解决疑点时扩大验证范围。
- 依据实际执行结果报告通过、失败和未执行项;环境缺失导致无法验证时,说明缺失条件和影响。
- 构建通过、模拟测试通过和实机验收分别陈述,不将局部验证扩展为整体产品完成声明。
- 交付说明包含改动目的、验证结果及遗留问题;代码变更简要说明所采用的设计原则及其具体作用。