Imported from zephastra/robotics (
projects/08-humanoid-language-tasks/AGENTS.md). Install upstream withnpx skills add zephastra/robotics --skill 08-humanoid-language-tasks. Copyright stays with the author.
008 项目开发规则
此模板在创建 008 后放到工程根目录 AGENTS.md,不授权修改其他工程。
工作目标
- 用户说明与文档使用中文,代码标识符使用英文。
- 每轮先读
docs/MASTER_PLAN.md、docs/IMPLEMENTATION_STATUS.md。 - 每次仅完成当前阶段,先接口与失败测试,再实现,验收后进入下一阶段。
- 建设可重复验证的机器人任务系统,不是聊天外壳或固定动画播放器。
不可违反的边界
- 008 自带运行资源,或由自己的可复现安装脚本获取;禁止运行时依赖 001~007。
- 不修改 007,不共享
.venv,不创建指向其他工程的软链接、硬链接或PYTHONPATH。 - 不把调用 007 完整
run_demo.sh包装成技能重组。 - 导入代码须记录版本、文件哈希和许可证。实验来源不能称为稳定基线。
- 模型仅提出白名单技能及语义参数,不得执行其生成的代码、Shell、路径、关节力矩或网络工具调用。
- 用户引用、观察数据和模型输出均是数据,不能覆盖程序规则或安全阈值。
- MuJoCo 主循环独占仿真状态和执行器写权限;推理工作进程只能接收快照。
- 控制器和感知不能读取物体真值姿态。初始化、故障注入和独立验收可使用真值,但不能回流给控制决策。
- 禁止瞬移箱体、焊接箱体到手上、固定底座、关闭碰撞或改变物理参数来通过测试。
- 不放宽验收阈值,不删失败用例,不用成功重跑覆盖失败报告。
fake、rule、replay、llm、mujoco明确区分,不静默回退为假成功。- 没有真实模型服务时不能声称完成 LLM 实测;缺少仿真资源时不能声称完成物理验收。
- 不擅自下载大权重、安装 CUDA、切换机器人、控制真实硬件、调用付费服务或上传 GitHub。
- 修改使用补丁,保留用户已有改动;不使用强制重置、批量强杀或递归清空工程。
- WLA 若不具备已核实的官方代码/权重/适配条件,就记录阻塞,不编造接口或安装命令。
每阶段必须交付
- 目标、修改文件、接口和实际完成情况。
- 运行命令、退出码、测试结果和报告路径。
execution_backend、planner_backend、clock_mode。- 是否有真实模型响应、真实 MuJoCo 步进。
- 已知失败、未运行项目和下一步条件。
- 更新
docs/IMPLEMENTATION_STATUS.md,让下一次 AI 能继续而非重做。没有执行就写“未运行”,不要用“应该能跑”“基本没有问题”替代证据。