Agent Skills
返回列表
💻

机器人软件设计原则

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_3c6cb52e/robotics-software-principles-nmy3。

技能介绍

机器人代码的约束和普通软件不一样

写业务系统时，bug 的后果通常是一次报错或一次回滚。机器人软件的约束要更苛刻，这个技能把它归纳为七条：

  • 物理后果：出错不只是进程崩溃，而是机器撞墙
  • 实时截止：错过 1ms 级别的控制回路 deadline，可能直接引起震荡或损坏
  • 传感器不确定：输入永远带噪声、延迟，偶尔还是错的
  • 硬件碎片：同一个算法要适配 5 家厂商的 10 种夹爪
  • 虚实迁移：代码必须在仿真和真机上行为一致
  • 长时运行：机器人一次跑几小时甚至几天，内存泄漏和漂移会累积
  • 安全关键：有些失败在任何软件状态下都不能发生

它怎么工作

技能先给出这些约束的结构化清单，再针对每条约束展开设计取舍，而不是给一套放之四海皆准的模板。核心思路是把「为什么这么写」和「不这么写会怎样」绑定在一起讲，方便在代码评审时逐条对照：

  • 用约束驱动架构决策，而不是先选框架再补理由
  • 把实时性和不确定性当作一等公民，在接口和数据结构里显式表达
  • 对仿真与实机的差异保持怀疑，任何「仿真里没问题」都不算验证完成
  • 把安全关键路径单独隔离，不参与普通迭代的权衡

当前版本的 SKILL.md 已收录问题定义章节，原则清单按上述约束顺序组织，后续章节会随资料逐步补全。

适用边界

适合用在控制回路、感知融合、仿真迁移和长时任务这类工程讨论里，也可以直接当作团队的设计评审 checklist。

需要注意的地方：它解决的是设计原则和取舍依据，不提供具体算法实现，也不能替代硬件层面的调参和安全验证。涉及人身安全的功能，原则只是起点，实际落地仍需完整的测试与冗余设计。

使用场景

  • 团队在评审控制回路代码时，用这份原则逐条核对是否遗漏实时截止、传感器噪声与安全边界。
  • 规划仿真到真机迁移时，把 sim-to-real gap 与硬件多样性作为评审清单来检查方案。
  • 设计长时运行任务的内存管理策略时，对照长时运行约束排查泄漏与漂移风险。
  • 多厂商夹爪适配出现兼容问题时，回到硬件碎片约束讨论接口抽象与参数化方案。

适合人员

  • 机器人软件工程师：需要在模块设计阶段审视架构决策是否覆盖物理后果与实时约束。
  • 实时系统工程师：负责调优控制回路，想要一份可对照的实时截止与内存泄漏取舍依据。
  • 仿真迁移负责人：计划把算法从仿真推向真机，需要用 sim-to-real gap 清单组织评审。
  • 安全关键功能开发者：关注哪些失败绝不能发生，需要原则来隔离和保护安全路径。