MCP HubMCP Hub
← スキル一覧に戻る

formatting-commit-messages

majiayu000
更新日 Yesterday
20 閲覧
58
9
58
GitHubで表示
ドキュメントgeneral

について

このスキルは、Conventional Commits規格に従ってGitコミットメッセージをフォーマットし、ステージングされた変更を分析して構造化されたメッセージを生成します。適切なタイプとスコープを自動的に決定し、破壊的変更を識別します。コードのコミット時、コミットメッセージの作成時、またはリリース対応で変更ログに適したコミットが必要な場合にご利用ください。

クイックインストール

Claude Code

推奨
プラグインコマンド推奨
/plugin add https://github.com/majiayu000/claude-skill-registry
Git クローン代替
git clone https://github.com/majiayu000/claude-skill-registry.git ~/.claude/skills/formatting-commit-messages

このコマンドをClaude Codeにコピー＆ペーストしてスキルをインストールします

ドキュメント

Commit Message Formatter (Conventional Commits)

When to use this skill

  • User asks to commit staged changes
  • User wants help writing a commit message
  • User mentions "conventional commits" or commit formatting
  • User asks for release-ready or changelog-friendly commits
  • User wants to ensure commits follow team standards

Workflow

  • Check for staged changes using git diff --cached
  • Analyze the nature of the changes (new feature, bug fix, refactor, etc.)
  • Determine appropriate type prefix
  • Identify scope from affected files/modules
  • Check for breaking changes
  • Generate formatted commit message
  • Present message for user approval
  • Execute commit if approved

Conventional Commits Format

<type>[optional scope][!]: <description>

[optional body]

[optional footer(s)]

Type Prefixes

TypeWhen to Use
featNew feature for the user
fixBug fix for the user
docsDocumentation only changes
styleFormatting, missing semicolons (no code change)
refactorCode change that neither fixes nor adds feature
perfPerformance improvement
testAdding or correcting tests
buildChanges to build system or dependencies
ciCI configuration changes
choreOther changes that don't modify src or tests
revertReverts a previous commit

Breaking Changes

  • Add ! after type/scope: feat(api)!: remove deprecated endpoints
  • OR add BREAKING CHANGE: footer in the body

Instructions

Step 1: Analyze Staged Changes

Run the following to get staged diffs:

git diff --cached --stat
git diff --cached

Step 2: Determine Commit Type

Analyze the changes to determine the appropriate type:

  • New files in src/ with new functionality → feat
  • Modified files fixing incorrect behavior → fix
  • Changes only to *.md, *.txt, or docs folder → docs
  • Only whitespace/formatting changes → style
  • Code restructuring without behavior change → refactor
  • Performance optimizations → perf
  • New or updated test files → test
  • Changes to package.json, webpack.config.*, tsconfig.* → build
  • Changes to .github/workflows/, CI configs → ci
  • Dependency updates, config tweaks → chore

Step 3: Identify Scope

Derive scope from the primary affected area:

  • src/components/Button.tsx → scope: button
  • src/api/users.ts → scope: api or users
  • lib/utils/ → scope: utils
  • Multiple unrelated areas → omit scope

Step 4: Detect Breaking Changes

Look for indicators of breaking changes:

  • Removed public functions or exports
  • Changed function signatures (parameters, return types)
  • Renamed public APIs
  • Changed default behavior
  • Removed configuration options

Step 5: Compose the Message

Subject line rules:

  • Use imperative mood: "add" not "added" or "adds"
  • No capital letter at start
  • No period at the end
  • Max 50 characters (hard limit: 72)

Body (if needed):

  • Wrap at 72 characters
  • Explain what and why, not how
  • Separate from subject with blank line

Footer (if needed):

  • BREAKING CHANGE: <description>
  • Fixes #123 or Closes #456
  • Reviewed-by: Name <email>

Step 6: Present and Commit

Present the formatted message to the user:

**Suggested commit message:**

feat(auth): add OAuth2 login support

Implement OAuth2 authentication flow with Google and GitHub providers.
Users can now sign in using their existing accounts.

Closes #142

If approved, execute:

git commit -m "<subject>" -m "<body>" -m "<footer>"

Or for simple commits:

git commit -m "<type>(<scope>): <description>"

Examples

Simple Feature

feat(cart): add quantity selector to cart items

Bug Fix with Issue Reference

fix(auth): prevent token refresh race condition

Multiple simultaneous requests could trigger parallel refresh attempts.
Added mutex lock to ensure single refresh execution.

Fixes #287

Breaking Change

feat(api)!: migrate to v2 response format

BREAKING CHANGE: API responses now use camelCase keys instead of snake_case.
All clients must update their parsing logic.

Documentation Update

docs(readme): add installation instructions for Windows

Refactor

refactor(utils): extract date formatting into separate module

Validation

Before committing, verify:

  • Type accurately reflects the change
  • Scope is specific but not overly narrow
  • Subject is in imperative mood
  • Subject is under 50 characters
  • Breaking changes are properly marked
  • Related issues are referenced

Error Handling

  • No staged changes: Run git status to confirm. Prompt user to stage files first.
  • Commit fails: Check git status for conflicts or hooks blocking commit.
  • Unsure about a command: Run git commit --help for options.

Resources

GitHub リポジトリ

majiayu000/claude-skill-registry
パス: skills/commit-message-formatter

関連スキル

algorithmic-art

メタ

This Claude Skill creates original algorithmic art using p5.js with seeded randomness and interactive parameters. It generates .md files for algorithmic philosophies, plus .html and .js files for interactive generative art implementations. Use it when developers need to create flow fields, particle systems, or other computational art while avoiding copyright issues.

スキルを見る

subagent-driven-development

開発

This skill executes implementation plans by dispatching a fresh subagent for each independent task, with code review between tasks. It enables fast iteration while maintaining quality gates through this review process. Use it when working on mostly independent tasks within the same session to ensure continuous progress with built-in quality checks.

スキルを見る

executing-plans

デザイン

Use the executing-plans skill when you have a complete implementation plan to execute in controlled batches with review checkpoints. It loads and critically reviews the plan, then executes tasks in small batches (default 3 tasks) while reporting progress between each batch for architect review. This ensures systematic implementation with built-in quality control checkpoints.

スキルを見る

cost-optimization

その他

This Claude Skill helps developers optimize cloud costs through resource rightsizing, tagging strategies, and spending analysis. It provides a framework for reducing cloud expenses and implementing cost governance across AWS, Azure, and GCP. Use it when you need to analyze infrastructure costs, right-size resources, or meet budget constraints.

スキルを見る