Agent Skills › dartsim/dart › dart-mechanical-refactor

dart-mechanical-refactor

GitHub

执行DART项目的机械式重构工作流，在保持行为不变的前提下进行代码结构优化。通过自动化或脚本化方式修改代码，严格隔离功能变更与清理工作，并依次运行lint、build和测试以验证安全性，最终生成PR供审查。

.agents/skills/dart-mechanical-refactor/SKILL.md dartsim/dart

Trigger Scenarios

需要重构代码结构但需保持行为不变执行重复性的机械式代码调整

Install

npx skills add dartsim/dart --skill dart-mechanical-refactor -g -y

More Options

Non-standard path

npx skills add https://github.com/dartsim/dart/tree/main/.agents/skills/dart-mechanical-refactor -g -y

Use without installing

npx skills use dartsim/dart@dart-mechanical-refactor

指定 Agent (Claude Code)

npx skills add dartsim/dart --skill dart-mechanical-refactor -a claude-code -g -y

安装 repo 全部 skill

npx skills add dartsim/dart --all -g -y

预览 repo 内 skill

npx skills add dartsim/dart --list

SKILL.md

Frontmatter

{
    "name": "dart-mechanical-refactor",
    "description": "DART Mechanical Refactor: perform a behavior-preserving mechanical refactor"
}

dart-mechanical-refactor

Use this skill to run the DART dart-mechanical-refactor workflow. The editable workflow source lives in .claude/commands/; this generated skill is its entrypoint for Codex and Muse.

Invocation

Claude Code: /dart-mechanical-refactor <arguments>
Codex: $dart-mechanical-refactor <arguments>
Muse: /dart-mechanical-refactor <arguments>

Treat the text after the skill name, or the user's request when the skill is loaded on demand, as $ARGUMENTS. When the workflow references $1, $2, etc., map those to the positional values supplied by the user.

Command Body

Perform mechanical refactor: $ARGUMENTS

Required Reading

@AGENTS.md @CONTRIBUTING.md @docs/onboarding/code-style.md

Workflow

Define the exact transformation and scope before editing.
Create a topic branch from the target branch, for example git switch --no-track -c refactor/<topic> origin/main.
Prefer scriptable or automated edits when the transformation is repetitive.
Keep behavior unchanged; do not mix in feature work or cleanup outside scope.
If reorganizing files, update CMake, pixi tasks, generated indexes, and docs.
Run focused checks first, then broader checks according to risk:
- pixi run lint
- pixi run build
- pixi run test
- pixi run test-all when feasible
- pixi run -e gazebo test-gz when package, collision, constraint, or downstream Gazebo/gz-physics compatibility could be affected
Ask for explicit maintainer/user approval before pushing or opening a PR. After approval, open a PR with a clear scope statement and no behavior-change claim unless tested.

Output

Transformation summary
Files or areas changed
Verification run
Any residual risk

Version History

f630c91 Current 2026-10-18 20:25
新增对Muse客户端的支持；将单元测试命令从test-unit调整为更通用的test；增加针对Gazebo兼容性的专项测试步骤；完善分支命名规范说明。
deb9869 2026-09-08 21:45
AI 运行环境支持从 Claude Code/OpenCode 调整为仅 Claude Code 和 Codex。
bcd584e 2026-09-02 23:40
b9fbefc 2026-07-19 11:29

Metadata

Files: 0
Version: aa707ae
Hash: 605868d6
Indexed: 2026-07-19 11:29

dart-mechanical-refactor