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

dart-mechanical-refactor

GitHub

用于执行DART项目的机械重构工作流。该技能保持行为不变，通过定义范围、自动化编辑和严格验证（Lint/Build/Test）来优化代码结构，最终生成变更摘要并请求审批以提交PR。

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

触发场景

用户需要重构DART代码库但不改变现有功能行为时用户希望清理或重组代码结构以提升可维护性时

安装

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

更多选项

非标准路径

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

不安装直接使用

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 in Codex to run the DART dart-mechanical-refactor workflow. The editable workflow source lives in .claude/commands/; this file is its generated adapter in the shared .agents/skills/ catalog.

Invocation

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

Treat the text after the skill name 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 branch from the target branch, usually 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-unit
- pixi run test-all when feasible
- pixi run -e cuda test-all when feasible on Linux CUDA hosts
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.