rosclaw-embodied · diff
git:20260821.4520a54 to git:20260906.508b15c
36 added, 14 removed. Audit A to A.
---
name: rosclaw-embodied
- description: ROSClaw 具身任务纪律——权威资产、证据验收、安全分层的精简操作手册（何时用：任何涉及机器人/仿真/动作的任务）
+ description: ROSClaw 具身任务纪律——通用物理原语编排、任务沙箱编码、证据验收、安全分层（何时用：任何涉及机器人/仿真/动作的任务）
---
# ROSClaw 具身任务纪律
- ## 权威资产
+ Pi 是唯一大脑：理解用户目标、调查环境、组合通用原语、没有现成
+ 能力时在任务沙箱写代码、运行观察修错、判断是否完成用户目标。
- - 机器人模型只认 e-URDF-Zoo 权威资产（`e-urdf-zoo/<robot>/robot.mjcf.xml`）；
- 测试 fixture（tests/fixtures/）与简化模型绝不出现在交付证据里。
- - 不确定资产来源时先调查：`rosclaw robot list` / 读取 sandbox/loader
- 源码确认解析顺序，不从 / 全盘搜索同名文件。
+ ## 通用物理原语（SIM 自动执行，不弹批准）
+ - `trajectory_generate_planar_path`：任意路径点 waypoints
+ `[{x,y,z,contact?}]`（contact=false=抬笔移动段）——文字/任意
+ 图形都由你表达为点列；shape=star5|circle 只是便捷参数，
+ **没有默认形状**。返回 plan_id 句柄。
+ - `ur5e_simulate_cartesian_trajectory(plan_id)` → trace_id
+ （真实 MuJoCo 动力学 rollout + 跟踪指标）。
+ - `simulation_verify_tracking(trace_id, max_tracking_error_m)` →
+ 诚实 PASS/FAIL + 误差数值。
+ - `simulation_render_trace(trace_id, format=gif)` /
+ `simulation_render_scene(trace_id, camera=...)` → 交付物。
+ - 观测：`ur5e.get_end_effector_pose` 等 OBSERVE 面。
+ - 可信上下文每轮带 workspace_window（安全半径/z 窗口）——
+ 摆 waypoints 不要越界（规划器硬校验，越界即拒）。
+
+ ## 任务沙箱编码
+
+ - 活跃任务的 `scratch/` 区可写可运行（write/edit/bash cwd 限定在
+ session 工作区与任务 scratch 内）——写几十行 Python 把字母/
+ 图形转成点列是正常能力，不需要内核替你认识任何形状。
+ - scratch 是草稿——交付物登记走 outputs/（register_artifact）。
+
## 证据与验收
- 交付物必须登记（rosclaw_artifact_register）——口头提到不算。
- - 验收条件在任务创建时冻结；task_finish 不接受新规则。
- - 机器人行为任务的完成必须有受信管道的独立验证证据；
- 手写脚本的输出不算行为证据。
- - 用户否定结果后任务重开 revision——不得沿用旧 receipt 宣称成功。
+ - 仿真证据标 simulated——动力学自洽不证明真机效果。
+ - 用户否定结果后修正或重开 revision——不得拿旧结果冒充。
## 安全分层
- - 纯计算/封闭本地仿真：自动执行。
- - 真机动作：必须走 rosclaw_execute/request_action 的 admission 链
+ - SIM：物理原语工具 + 任务沙箱代码自动执行。
+ - 真机动作：必须走 rosclaw_request_action 的 admission 链
（rosclawd + permit + operator），任何其他路径都不是执行权威。
- - 仿真失败先读结构化诊断，按真实 Schema 修正参数；同一调用同一
- 参数不机械重试。
+ - 改产品核心源码不是任务能力——走开发流程（克隆仓库+PR）。
+ - 同一调用同一参数失败后不机械重试；先读结构化诊断。
+
+ ## 权威资产
+
+ - 机器人模型只认 e-URDF-Zoo 权威资产；测试 fixture 绝不出现在
+ 交付证据里。不确定资产来源时先调查，不从 / 全盘搜索。