Stats
Actions
Tags
From git-commit-assistant
Generates ranked commit message suggestions for file groups from staged changes, in conventional or simple format. Analyzes diffs, validates, and lists files per commit.
How this command is triggered — by the user, by Claude, or both
Slash command
/git-commit-assistant:suggest-commitsatomic-commit/The summary Claude sees in its command listing — used to decide when to auto-load this command
# Operation: Suggest Commits Generate commit message suggestions for file groups. ## Parameters from $ARGUMENTS - `groups:string` - Comma-separated group IDs to process (default: all) - `format:conventional|simple` - Message format (default: conventional) - `include_body:true|false` - Include commit body (default: true) ## Workflow ### Step 1: Get File Groups If groups not provided, invoke file grouping: Parse grouping results to identify distinct commit groups. ### Step 2: Analyze Each Group For each file group: 1. Get file diffs 2. Analyze changes 3. Identify commit type 4. Dete...
Generate commit message suggestions for file groups.
groups:string - Comma-separated group IDs to process (default: all)format:conventional|simple - Message format (default: conventional)include_body:true|false - Include commit body (default: true)If groups not provided, invoke file grouping:
/atomic-commit group strategy:type
Parse grouping results to identify distinct commit groups.
For each file group:
Invoke Bash to get detailed diffs:
git diff --cached <files>
git diff <files>
For each group, create commit message following conventions:
Conventional format:
<type>(<scope>): <subject>
<body>
<footer>
Components:
Example:
feat(auth): implement OAuth 2.0 authentication
Add OAuth 2.0 authentication flow with support for:
- GitHub provider
- Google provider
- Token management
- Refresh token handling
Includes comprehensive test coverage.
Check each message for:
Apply commit message best practices:
Order commits by:
Create comprehensive suggestion report:
💬 COMMIT SUGGESTIONS
Commit 1 of 3: feat(auth) - 8 files
─────────────────────────────────────
feat(auth): implement OAuth 2.0 authentication
Add complete OAuth 2.0 authentication flow with
support for multiple providers (GitHub, Google).
Includes token management, refresh handling, and
comprehensive test coverage.
Files:
• src/auth/oauth.ts
• src/auth/tokens.ts
• src/auth/providers/github.ts
• src/auth/providers/google.ts
• src/config/oauth.config.ts
• src/types/auth.types.ts
• tests/auth/oauth.test.ts
• tests/auth/tokens.test.ts
Atomic: ✅ Yes
Ready: ✅ Can commit
─────────────────────────────────────
Commit 2 of 3: fix(api) - 3 files
─────────────────────────────────────
fix(api): handle null pointer in user endpoint
Fix null pointer exception when user profile is
incomplete. Add validation to check for required
fields before access.
Files:
• src/api/endpoints.ts
• src/api/validation.ts
• tests/api.test.ts
Atomic: ✅ Yes
Ready: ✅ Can commit
─────────────────────────────────────
Commit 3 of 3: docs - 2 files
─────────────────────────────────────
docs: add OAuth authentication guide
Add comprehensive documentation for OAuth 2.0
authentication setup and usage. Includes
configuration examples and provider setup.
Files:
• README.md
• docs/authentication.md
Atomic: ✅ Yes
Ready: ✅ Can commit
─────────────────────────────────────
Summary:
Total commits: 3
Total files: 13
All atomic: ✅ Yes
Ready to commit: ✅ Yes
Next steps:
1. Review suggestions above
2. Run: /atomic-commit sequence (to create plan)
3. Or manually stage and commit each group
Return structured suggestions:
suggestions:
- commit_id: 1
type: feat|fix|docs|etc
scope: module_name
subject: "Brief description"
body: "Detailed explanation"
footer: "Breaking changes, refs"
files: [list]
stats:
file_count: number
additions: number
deletions: number
atomic: true|false
ready: true|false
dependencies: [commit_ids]
summary:
total_commits: number
total_files: number
all_atomic: true|false
ready_to_commit: true|false
next_steps: [ordered actions]
feat: New features, capabilities, enhancementsfix: Bug fixes, error correctionsdocs: Documentation onlystyle: Formatting, whitespace, semicolonsrefactor: Code restructuring without behavior changetest: Test additions or modificationschore: Build, dependencies, toolingperf: Performance improvementsci: CI/CD configuration changesExample 1: All groups
/atomic-commit suggest
→ Suggests commits for all detected groups
Example 2: Specific groups
/atomic-commit suggest groups:"1,3"
→ Suggests commits only for groups 1 and 3
Example 3: Simple format
/atomic-commit suggest format:simple include_body:false
→ Simple messages without detailed bodies
This operation:
group-filescreate-sequenceinteractive-split workflowSuggestions are not final - user can review and modify before committing.
npx claudepluginhub dhofheinz/open-plugins --plugin git-commit-assistant/commitAnalyzes git diffs or staged changes to generate conventional commit messages explaining WHY changes were made. Auto-detects type/scope, supports staging, validation, and overrides.
/semantic-commitAnalyzes large git changes, groups into logical units with semantic messages, and creates atomic commits after approval. Supports --dry-run, --lang, --max-commits options.
/commitCreates clean, atomic git commits following project conventions. Supports ticket IDs, manual confirmation, and selective file commits.