Skip to main content
ClaudeWave
ES, Spanish
Slash Command215 estrellas del repoactualizado 4mo ago

gz-test

The gz-test command executes the gz-sim test suite from its build directory, optionally filtering tests by regex pattern. Use it to validate gz-sim functionality during development or after code changes, with summary reporting of pass/fail/skip counts and optional drill-down into failing tests via gtest binaries.

Instalar en Claude Code
Copiar
mkdir -p ~/.claude/commands && curl -fsSL https://raw.githubusercontent.com/harunkurtdev/ros2-claude-code-template/HEAD/.claude/commands/gz-test.md -o ~/.claude/commands/gz-test.md
Después abre una sesión nueva de Claude Code; el slash command carga automáticamente.

gz-test.md

Run the gz-sim test suite from `/home/rdadmin/gz-sim`.

1. Make sure `build/` exists. If not, tell the user to run `/gz-build` first.
2. If `$ARGUMENTS` is empty:
   `ctest --test-dir build --output-on-failure -j"$(nproc)"`
   else:
   `ctest --test-dir build -R "$ARGUMENTS" --output-on-failure`
3. After the run, report a one-line summary like
   `"148 passed, 0 failed, 2 skipped (12m13s)"`.
4. On failures, list the first 3 failing test names and offer to drop into
   the gtest binary directly (see the `gz-test` skill).
5. Never claim "tests pass" without showing the count and `ctest`'s
   exit code. If anything was skipped or filtered out, mention it.
behaviortree_node_creationSkill

Scaffold a Behavior Tree leaf node — plain BehaviorTree.CPP (SyncActionNode / StatefulActionNode / ConditionNode) or a BehaviorTree.ROS2 wrapper (RosActionNode / RosServiceNode / RosTopicPubNode / RosTopicSubNode) — with ports, factory/plugin registration, and XML v4 usage. Trigger when the user asks to write a behavior-tree node (not Nav 2-specific).

behaviortree-reviewerSubagent

Use proactively before opening a PR that adds or changes BehaviorTree.CPP nodes or BehaviorTree.ROS2 wrappers (RosActionNode/RosServiceNode/RosTopicPub/SubNode, TreeExecutionServer). Reviews a diff against BT.CPP v4 conventions — node base-class choice, non-blocking ticks, ports/blackboard typing, factory/plugin registration, XML v4, and the ROS 2 wrapper contract. Returns a punch list with file:line anchors, not a rewrite.

buildSlash Command

Build the colcon workspace (optionally a single package) and report the outcome.

clean-arch-architectSubagent

Use when a design decision touches Clean Architecture boundaries in a ROS 2 project — which layer a new behaviour belongs to, whether a port belongs in domain or application, whether a new node should be lifecycle-managed, whether to compose nodes or split packages. Returns an architectural recommendation with trade-offs, not implementation.

commandsSkill

Author a new skill under .claude/skills/<name>/SKILL.md with valid frontmatter, following the template conventions, and index it in CLAUDE.md + README.md.

ecs-architectSubagent

Use when a design decision touches the gz-sim ECS — where new state should live, which system phase should write it, how to avoid coupling, whether to add a component vs. a member variable, whether a new system should be split or merged with an existing one. Returns an architectural recommendation with trade-offs, not implementation.

extending_claude_configSkill

Author a new asset for this .claude/ template — a rule, skill, slash command, or sub-agent — following the project's conventions and wiring it into the CLAUDE.md / README.md indexes. Trigger when the user wants to add or extend a command, skill, agent, or rule (make the template itself extensible).

gz-buildSkill

Configure and build gz-sim from source using either CMake/Ninja directly or a colcon workspace. Trigger when the user asks to build, recompile, configure, or set up the gz-sim binary tree.