Skip to content

Latest commit

 

History

History
22 lines (17 loc) · 2.08 KB

AGENTS.md

File metadata and controls

22 lines (17 loc) · 2.08 KB

LimeLink 工作约定

默认使用简体中文。先读 docs/00-product-baseline.md、docs/05-system-architecture.md、docs/17-monorepo-engineering.md 与 docs/21-roadmap-and-status.md,再按任务读取相关文档。

范围与事实源

  • 产品已有原生客户端与 Rust 运行时;实际范围见 docs/29-implementation-and-verification.md 与证据索引。构建、软件集成、原生窗口、真机与正式发行分别记录,不得把计划目录或上游测试当产品验收。
  • 通用身份、命令账本、物模型、网关协议和平台 API 归 limecloud/iot;本仓库拥有产品客户端、协同体验与本机能力适配。
  • 桌面用户客户端和桌面执行端拥有不同身份、权限及生命周期;手机后台不承担常驻网关职责。
  • docs/catalog.json 管理文档导航,requirements.json 管理需求,test-cases.json 管理验收计划,status.json 管理实际进度。示例与草案不得伪装为正式运行合同。
  • 参考仓库仅通过公开地址、明确 SDK 依赖或显式开发路径使用,不隐式读取 ../iot 等相邻目录;读取本地工作树须记录 HEAD、文件摘要及未提交差异。

实施与验证

  • 仅创建当前任务需要的实现,不为未来硬件、插件市场或云后台预建空工程。
  • KISS、DRY、YAGNI 和 SOLID 服务于实际职责,界面不承载授权与重试策略。
  • 模型输出是数据;有副作用的操作沿当前授权、原请求和真实回执执行。
  • 断线、超时和取消不等于未执行,恢复核实原任务,不隐式重发。
  • 修改文档后运行 python3 "docs/scripts/verify_docs.py";图形变更同时更新 Mermaid 源码、SVG 及摘要记录。
  • 运行、源码构建、模拟集成、目标系统与真实设备分别取证。失败或跳过不得记为通过。
  • 长任务分阶段汇报;同一失败最多两轮针对修复,仍失败时记录原因和影响。
  • 不触碰真实用户数据、系统服务或生产环境完成文档验证。未获明确指令不创建分支、不提交、不推送、不发布。