Imported from JW546/Z-Link (
AGENTS.md). Install upstream withnpx skills add JW546/Z-Link. Copyright stays with the author.
AGENTS.md
本文件用于约束后续所有 Codex 开发任务。所有代码修改、功能设计、测试补充和文档更新都必须遵守以下规则。
项目定位
- 本项目是“智通无阻（Z-Link）——面向无人设备的自然语言意图驱动协同系统”。
- 本项目不是普通 Web App，也不是中心化远程调度平台。
- 前端只是演示和实验可视化，不是系统核心。
核心流程
系统核心流程必须围绕以下链路展开：
自然语言意图 -> DSL 任务契约 -> IDL/DDS 发布订阅 -> 多设备 Agent 自主协同 -> 冲突消解 -> 可解释路线决策
任何新增功能、重构或实验模块，都应说明自己在该链路中的位置，不能把系统退化成普通前端演示、静态脚本或集中式调度器。
决策与 Agent 约束
- Dijkstra 和 Greedy 只能作为 baseline，不能作为最终智能决策。
- Agent 不能写成固定 if-else 脚本。
- 如果没有真实强化学习训练，不要声称已经完成 RL / MARL 训练。
- 决策模块必须尽量体现可解释性、可评估性和可优化性。
系统能力要求
系统必须体现以下能力：
- DDS 发布订阅；
- 多设备建议；
- 消息冲突；
- 冲突消解；
- 动态重规划；
- 可解释决策；
- 策略评估；
- Agent 优化。
开发新功能时，应优先补齐或增强这些能力，而不是只增加静态页面、硬编码示例或一次性展示逻辑。
测试要求
每次改功能都必须补测试。测试应覆盖新增或修改的核心行为，尤其是：
- DSL 任务契约生成与解析；
- IDL/DDS 消息发布订阅；
- 多设备协同建议；
- 冲突检测与消解；
- 动态重规划；
- 路线决策解释；
- baseline 与智能策略的评估对比。
后续优先使用的 Skills
后续 Codex 开发任务应优先使用以下 skills：
- codebase-design；
- tdd；
- implement；
- diagnosing-bugs；
- browser/control-in-app-browser。
