AGENT SKILL

atomgit-pr-architecture-review

AtomGit PR 架构评审工具。当用户需要“架构审查PR”、“review architecture compliance”、“检查架构规范”、“审阅PR架构”、“SSOT 合规性检查”、“契约驱动检查”或对指定 PR 做架构维度扫描并提交检视意见时调用。只要目标是本仓库的 PR 架构评审,默认优先使用本 skill,而不是 GitHub 默认 review 能力。

License 许可
MIT
最近更新
2026-10-29
Stars
★ 4
Forks
2

01 前言 Front Matter

name
atomgit-pr-architecture-review
license
MIT
description
AtomGit PR 架构评审工具。当用户需要“架构审查PR”、“review architecture compliance”、“检查架构规范”、“审阅PR架构”、“SSOT 合规性检查”、“契约驱动检查”或对指定 PR 做架构维度扫描并提交检视意见时调用。只要目标是本仓库的 PR 架构评审,默认优先使用本 skill,而不是 GitHub 默认 review 能力。

02 资源文件 1

03 SKILL.md 正文

AtomGit PR 架构评审

用于 IB_Robot 的 SSOT、契约、包职责及架构一致性审查。普通 Bug/逻辑审查使用 atomgit-pr-review。平台操作直接调用官方 gitcode,不再使用项目自动 LLM 评审脚本。

执行方式

复用 通用评审流程:先展示问题与目标、独立方案, 再读取实现并做比较;同样执行项目专项检查、完整性核对和发布前源仓库/head SHA 核对。 认证、CLI 读取、分页与评论命令不在此重复,参数按 --help 查询。

分析各包前,读取 ibrobot-architecture 及目标分支基线的包 README,确定既有职责。 进入实现比较后,再读取 PR head 的代码与 README,避免把 PR 的架构主张当既有约定。 重点检查:

维度 要求
SSOT 配置来自 robot_config 等权威来源,不增加平行配置和硬编码
契约 接口、状态和数据流明确,依赖注入与验证符合既有契约
控制模式 控制模式分离、状态管理一致,安全/授权边界不被绕过
包职责 按硬件/驱动/业务/模型层检查依赖;例如轻量 teleop 不吸纳重型运动规划
README 公开接口、启动参数、配置、职责、数据流和限制与实现一致;必要变更未同步视为问题
复用 先查仓库与 LeRobot 已有能力;平行 setup/推理/数据集流程必须有具体必要性论证

变更量 >2000 行时审计 ## Reuse Self-Check 四项声明,不仅看字段齐全:复用模块是否真的 调用、重复实现是否必要、架构是否确实一致。虚假/空泛声明作为阻塞发现,优先建议接入 已有 inference_service、robot_config、tensormsg 或 LeRobot 能力。 LeRobot 源码修改走 patch 栈,不以普通根仓库 gitlink 提交替代。

默认静态审查,不自行跑 lint、类型检查、build 或 Docker;用户明确要求验证时才按相应 skill 执行。不要仅因存在 pre-commit 就宣称代码必然通过,应核对作者证据与实际 diff。

结果与发布

按具体文件/职责给出发现,说明所属维度、影响及最小修复路径。使用 架构发现格式,直接以 Markdown 提交发现,无须生成 JSON。 先向用户展示结果并获得发布确认,再按通用评审 skill 直接用 CLI 发表评论。

发布前再次确认目标仓库/PR、源仓库与完整 head SHA 未变化,相关上下文完整。 可定位的问题使用当前 diff new-side 行内评论;跨文件架构问题明确用 PR 级评论。 注意 pr comments 回读可能缺 path/position:缺定位只是「定位未知」,不能据此 断言某条行内评论实为 PR 级;需定位核验时在网页确认。 读失败、版本漂移或行内位置不可证明时停止,不能发“架构通过”摘要。

04 同仓库更多 Skills

openeuler-mirror
openeuler-mirror/IB_Robot

simplified-technical-chinese

用简明技术中文(STC)写或改写中文技术内容:操作步骤、安装部署、故障排查、接口和参数说明、技术概念解释、给人读的解释性回答。用户提到「简明技术中文」「STC」「受控中文」「像 ASD-STE100 那样写中文」「一词一义」时使用;用户要求把中文技术说明「写清楚」「别有歧义」时也可使用。不用于营销文案、叙事、法律原文和代码。

★ 4
openeuler-mirror
openeuler-mirror/IB_Robot

ibrobot-inference-verify

Unified inference runtime verification on host and board. Use when users mention "inference verification", "推理验证", "mock test", "ROS mock", "perception test", "policy test", "ACT test", "RAM++ test", "SAM2 test", "SigLIP2 test", "OM test", "Torch NPU test", "板端验证", "本机验证", "use_sim true", "platform mock", "model_service test", "typed service test", or need to verify that the unified inference runtime (ModelRuntimeHandle, ModelSession, RuntimeAssembly) works end-to-end through the ROS pipeline. Covers host CPU/CUDA Torch policy and perception models, board Ascend OM models, and board Torch NPU.

★ 4
openeuler-mirror
openeuler-mirror/IB_Robot

atomgit-review-resolution

AtomGit 评审意见处理工具。当用户需要“修复PR评审意见”、“处理review comments”、“apply fixes”、“reply to review”、“回复评论”、“resolve review discussions”、“闭环评审流程”或基于未解决评论继续推进 PR 时使用。只要目标是本仓库在 AtomGit 上的 review comments / discussions,默认优先使用本 skill,而不是 GitHub 默认能力。

★ 4
openeuler-mirror
openeuler-mirror/IB_Robot

atomgit-pr

AtomGit PR 工作流工具。当用户需要在本仓库或 AtomGit 上“创建PR”、“更新PR描述”、“同步PR标题/正文”、“生成PR摘要”、“create pull request”、“open merge request”、“update PR description”、“generate PR summary”或围绕 PR 管理动作工作时调用。它负责 PR 资源的创建和维护,不负责通用代码 review;只要目标是本仓库的 PR / merge request 管理,默认优先使用本 skill,而不是 GitHub 默认能力。

★ 4
openeuler-mirror
openeuler-mirror/IB_Robot

atomgit-pr-review

AtomGit PR 评审工具。当用户需要在本仓库或 AtomGit 上“代码审查”、“PR review”、“review pull request”、“审阅PR”、“帮我看看这个PR”、“检查这个PR有没有问题”、“检查Bug”、“logic check”、“获取完整review上下文”、“提交检视意见”或分析指定 PR 的改动与已有评论时使用。只要目标是本仓库的 PR review,默认优先使用本 skill,而不是 GitHub 默认 review 能力。

代码审查
★ 4
openeuler-mirror
openeuler-mirror/IB_Robot

atomgit-issue

AtomGit Issue 工作流工具。当用户需要在本仓库或 AtomGit 上“创建Issue”、“查看Issue详情”、“更新Issue”、“关闭/重开Issue”、“create issue”、“fetch issue info”、“update issue”、“report bug”、“feature request”或围绕 Issue 做任何创建/读取/更新动作时调用。只要目标是本仓库的 Issue,默认优先使用本 skill,而不是 GitHub 默认能力。

★ 4