commit

Commit (Scoped)

Creates a commit from only task-related files. This is the global alias for /safe-commit.

Usage

/commit "<message>" [file1 file2 ...]
/safe-commit "<message>" [file1 file2 ...]

Examples

/commit "fix(auth): tighten role checks" backend/src/api/auth.ts backend/tests/integration/auth.test.ts
/safe-commit "chore(ai): update skill routing docs" .claude/CLAUDE.md .claude/skills/run-tests/SKILL.md

Required Behavior

1. Scope commit to task files only:
   • If file args are provided, use only those files.
   • If no file args are provided, derive scope from this conversation's work and exclude unrelated diffs.
2. Stage only scoped files:

   git add <scoped-files...>
   git diff --cached --name-only
   

3. Run /run-quality-gate before final commit.
4. Add GitHub issue references if the work relates to an issue:
   • Include (#<number>) at the end of the commit subject line.
   • If the commit fully resolves the issue, add a closing keyword in the commit body on its own line: Closes #<number>, Fixes #<number>, or Resolves #<number>.
   • For partial progress, use Part of #<number> in the body or just (#<number>) in the subject.
5. Commit with the provided message:

   git commit -m "<message>"
   

Hard Rules

• Never use git add -A or git add . in this skill.
• If no scoped changes are staged, abort (no empty commit here).
• If validation fails, abort and report exact failures.
• For full-worktree commits or checkpoint commits, use /safe-commit-all.