dart-fix-issue
Use this skill in Codex to run the DART dart-fix-issue workflow. The editable
workflow source lives in .claude/commands/; this file is its generated adapter
in the shared .agents/skills/ catalog.
Invocation
- Claude Code:
/dart-fix-issue <arguments>
- Codex:
$dart-fix-issue <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
Fix GitHub issue: $ARGUMENTS
Required Reading
@AGENTS.md
@docs/onboarding/contributing.md
@docs/onboarding/changelog.md
@docs/ai/verification.md
Workflow
If the fix depends on 3D structure or behavior, route through
dart-verify-sim: text oracle plus assessed visual evidence, or a recorded
exception.
gh issue view $1 - Validate issue
- Classify whether the issue is a bug fix that applies to the active DART 6
LTS branch. For applicable bug fixes, start from the highest maintained
origin/release-6.* branch; otherwise start from origin/main.
- Fix with minimal changes + add regression test. For dual-PR bug fixes, fix
the active DART 6 LTS branch first, then cherry-pick or reapply to
main.
- For an intermediate commit or PR, preserve and update the active task folder.
In the completing change, follow
docs/dev_tasks/README.md: complete feasible
work, promote durable artifacts, and remove the folder before final validation
and commit. Preserve its approval requirement for retiring unfinished work.
pixi run lint, then the smallest relevant tests and the task-type gate
set from docs/ai/verification.md
- Before PR creation, invoke the
dart-changelog routine to decide whether
CHANGELOG.md needs an entry, then fill .github/PULL_REQUEST_TEMPLATE.md.
- After explicit maintainer/user approval,
git push -u origin HEAD && gh pr create --base <target-branch> --milestone "<milestone>"
CRITICAL: Dual-PR for Bug Fixes
PRs to BOTH the active DART 6 LTS branch AND main. See
docs/onboarding/contributing.md.
Output
- Issue number and classification (bug fix, dual-PR, or main-only)
- Fix summary and regression test added
- Gates run (lint, focused tests,
pixi run test-all)
- PR readiness for each target branch, noting any explicitly approved mutation
1---2name: dart-fix-issue3description: DART Fix Issue: resolve a GitHub issue with a fix and regression test4---56<!-- AUTO-GENERATED FILE - DO NOT EDIT MANUALLY -->7<!-- Source: .claude/commands/dart-fix-issue.md -->8<!-- Sync script: scripts/sync_ai_commands.py -->9<!-- Run `pixi run sync-ai-commands` to update -->1011# dart-fix-issue1213Use this skill in Codex to run the DART `dart-fix-issue` workflow. The editable14workflow source lives in `.claude/commands/`; this file is its generated adapter15in the shared `.agents/skills/` catalog.1617## Invocation1819- Claude Code: `/dart-fix-issue <arguments>`20- Codex: `$dart-fix-issue <arguments>`2122Treat the text after the skill name as `$ARGUMENTS`. When the workflow23references `$1`, `$2`, etc., map those to the positional values supplied by the24user.2526## Command Body2728Fix GitHub issue: $ARGUMENTS2930## Required Reading3132@AGENTS.md33@docs/onboarding/contributing.md34@docs/onboarding/changelog.md35@docs/ai/verification.md3637## Workflow3839If the fix depends on 3D structure or behavior, route through40`dart-verify-sim`: text oracle plus assessed visual evidence, or a recorded41exception.42431. `gh issue view $1` - Validate issue442. Classify whether the issue is a bug fix that applies to the active DART 645 LTS branch. For applicable bug fixes, start from the highest maintained46 `origin/release-6.*` branch; otherwise start from `origin/main`.473. Fix with minimal changes + add regression test. For dual-PR bug fixes, fix48 the active DART 6 LTS branch first, then cherry-pick or reapply to `main`.494. For an intermediate commit or PR, preserve and update the active task folder.50 In the completing change, follow `docs/dev_tasks/README.md`: complete feasible51 work, promote durable artifacts, and remove the folder before final validation52 and commit. Preserve its approval requirement for retiring unfinished work.535. `pixi run lint`, then the smallest relevant tests and the task-type gate54 set from `docs/ai/verification.md`556. Before PR creation, invoke the `dart-changelog` routine to decide whether56 `CHANGELOG.md` needs an entry, then fill `.github/PULL_REQUEST_TEMPLATE.md`.577. After explicit maintainer/user approval, `git push -u origin HEAD && gh pr create --base <target-branch> --milestone "<milestone>"`5859## CRITICAL: Dual-PR for Bug Fixes6061PRs to BOTH the active DART 6 LTS branch AND `main`. See62`docs/onboarding/contributing.md`.6364## Output6566- Issue number and classification (bug fix, dual-PR, or main-only)67- Fix summary and regression test added68- Gates run (lint, focused tests, `pixi run test-all`)69- PR readiness for each target branch, noting any explicitly approved mutation