用途:为 IsaacLab Arena 仓库创建符合贡献者规范的提交(commit)与拉取请求(PR)。
主要能力与用法: 提交前先运行 pre-commit-check 技能(或在宿主机执行 pre-commit run --all-files,容器内未安装),直到工作区干净;不要绕过钩子失败提交。暂存具体文件而非 git add -A,避免误提交点文件、凭据或大型未跟踪产物。提交需按 CONTRIBUTING.md 要求签署 DCO:git commit -s -m "<subject>"。主题行用祈使语气、约 50 字符、不加句号;正文与主题间空一行、每行 72 字符换行,说明 what 与 why。不得包含 Co-Authored-By、Generated with Claude Code 等 AI 署名行,DCO 签署是唯一必需的 trailer。多段落消息使用 heredoc 保持引号整洁。
分支命名格式为 <username>/<type>/<short-description>,type 可为 feature、fix、docs、refactor、chore、ci,描述用 kebab-case;不要省略用户名。
PR:首次推送用 git push -u origin <branch-name>,再以 gh pr create --base main 向 main 分支发起,标题遵循提交主题规则(祈使语气、约 70 字符内、无句尾句号),写描述前先读 .github/pull_request_template.md 并遵循其指引。
评审迭代:处理评论时新增提交,不要 --amend 后强制推送,以便评审者看到每轮变更;仅当某次提交是未合并且无人评审的自有笔误修正时,才可用 --amend。完成前用 gh pr view --json title,baseRefName 确认 baseRefName 为 main 且标题无句尾句号、为祈使语气。
限制:DCO 签署政策当前尚未由 CI 强制执行;具体模板细节以仓库内文件为准。