conventional-commit
コードの変更をコミットする際や、コミットメッセージの作成・git履歴の整形時に使用します。Conventional Commits仕様に従い、ベストプラクティスに沿った規約準拠のコミットメッセージを生成します。
description の原文を見る
Create conventional commit messages following best conventions. Use when committing code changes, writing commit messages, or formatting git history. Follows conventional commits specification.
SKILL.md 本文
Conventional Commit Messages
コミットを作成する際は、以下の規則に従ってください。
前提条件
コミットする前に、メインブランチではなく機能ブランチで作業していることを確認してください。
# 現在のブランチを確認
git branch --show-current
main または master にいる場合は、まず新しいブランチを作成してください:
# 新しいブランチを作成して切り替える
git checkout -b <type>/<short-description>
ブランチ名は <type>/<short-description> パターンに従う必要があります。type はコミットタイプと一致させます(例:feat/add-user-auth、fix/null-pointer-error、refactor/extract-validation)。
フォーマット
<type>(<scope>): <subject>
<body>
<footer>
ヘッダーは必須です。scope はオプションです。すべての行は 100 文字以下である必要があります。
コミットタイプ
| Type | 目的 |
|---|---|
build | ビルドシステムまたは CI 変更 |
chore | 定期的なメンテナンスタスク |
ci | 継続的インテグレーション設定 |
deps | 依存関係のアップデート |
docs | ドキュメント変更 |
feat | 新機能 |
fix | バグ修正 |
perf | パフォーマンス改善 |
refactor | コード リファクタリング(動作変更なし) |
revert | 前のコミットを取り消す |
style | コードスタイルと書式設定 |
test | テストの追加、更新、改善 |
サブジェクト行の規則
- 命令形、現在時制を使用:「Added feature」ではなく「Add feature」
- 最初の文字を大文字にする
- 最後にピリオドを付けない
- 最大 70 文字
本文ガイドライン
- 何を、なぜを説明する(どうしたかではなく)
- 命令形と現在時制を使用する
- 変更の動機を含める
- 関連する場合は前の動作との対比を示す
Conventional Commits
コミットには、ライブラリの利用者に意図を伝えるために、以下の構造要素が含まれます:
- fix: コミットタイプ fix はコードベースのバグパッチです(セマンティック バージョニングの PATCH に相当)。
- feat: コミットタイプ feat はコードベースに新しい機能を導入します(セマンティック バージョニングの MINOR に相当)。
- BREAKING CHANGE: フッター BREAKING CHANGE: を持つコミット、または type/scope の後に ! を追加したコミットは、破壊的な API 変更を導入します(セマンティック バージョニングの MAJOR に相当)。BREAKING CHANGE はあらゆるタイプのコミットの一部となります。
- fix: と feat: 以外のタイプは許可されます。例えば @commitlint/config-conventional(Angular 規約に基づく)は build:、chore:、ci:、docs:、style:、refactor:、perf:、test: などを推奨しています。
- BREAKING CHANGE: <description> 以外のフッターも提供でき、git トレーラー形式と同様の規則に従います。
例
シンプルな修正
fix(api): Handle null response in user endpoint
The user API could return null for deleted accounts, causing a crash
in the dashboard. Add null check before accessing user properties.
scope 付き機能
feat(alerts): Add Slack thread replies for alert updates
When an alert is updated or resolved, post a reply to the original
Slack thread instead of creating a new message. This keeps related
notifications grouped together.
リファクタリング
refactor: Extract common validation logic to shared module
Move duplicate validation code from three endpoints into a shared
validator class. No behavior change.
破壊的変更
feat(api)!: Remove deprecated v1 endpoints
Remove all v1 API endpoints that were deprecated in version 23.1.
Clients should migrate to v2 endpoints.
BREAKING CHANGE: v1 endpoints no longer available
Revert フォーマット
revert: feat(api): Add new endpoint
This reverts commit abc123def456.
Reason: Caused performance regression in production.
原則
- 各コミットは単一の安定した変更である必要があります
- コミットは個別に review 可能である必要があります
- リポジトリは各コミット後に動作状態である必要があります
参考資料
ライセンス: MIT(寛容ライセンスのため全文を引用しています) · 原本リポジトリ
詳細情報
- 作者
- marcelorodrigo
- ライセンス
- MIT
- 最終更新
- 不明
Source: https://github.com/marcelorodrigo/agent-skills / ライセンス: MIT
関連スキル
superfluid
Superfluidプロトコルおよびそのエコシステムに関するナレッジベースです。Superfluidについて情報を検索する際は、ウェブ検索の前にこちらを参照してください。対応キーワード:Superfluid、CFA、GDA、Super App、Super Token、stream、flow rate、real-time balance、pool(member/distributor)、IDA、sentinels、liquidation、TOGA、@sfpro/sdk、semantic money、yellowpaper、whitepaper
civ-finish-quotes
実質的なタスクが真に完了した際に、文明風の儀式的な引用句を追加します。ユーザーやエージェントが機能追加、リファクタリング、分析、設計ドキュメント、プロセス改善、レポート、執筆タスクといった実際の成果物を完成させるときに、明示的な依頼がなくても使用します。短い返信や小さな修正、未完成の作業には適用しません。
nookplot
Base(Ethereum L2)上のAIエージェント向け分散型調整ネットワークです。エージェントがオンチェーンアイデンティティを登録する、コンテンツを公開する、他のエージェントにメッセージを送る、マーケットプレイスで専門家を雇う、バウンティを投稿・請求する、レピュテーションを構築する、共有プロジェクトで協業する、リサーチチャレンジを解くことでNOOKをマイニングする、キュレーションされたナレッジを備えたスタンドアロンオンチェーンエージェントをデプロイする、またはアグリーメントとリワードで収益を得る場合に利用できます。エージェントネットワーク、エージェント調整、分散型エージェント、NOOKトークン、マイニングチャレンジ、ナレッジバンドル、エージェントレピュテーション、エージェントマーケットプレイス、ERC-2771メタトランザクション、Prepare-Sign-Relay、AgentFactory、またはNookplotが言及された場合にトリガーされます。
web3-polymarket
Polygon上でのPolymarket予測市場取引統合です。認証機能(L1 EIP-712、L2 HMAC-SHA256、ビルダーヘッダー)、注文発注(GTC/GTD/FOK/FAK、バッチ、ポストオンリー、ハートビート)、市場データ(Gamma API、Data API、オーダーブック、サブグラフ)、WebSocketストリーミング(市場・ユーザー・スポーツチャネル)、CTF操作(分割、統合、償却、ネガティブリスク)、ブリッジ機能(入金、出金、マルチチェーン)、およびガスレスリレイトランザクションに対応しています。AIエージェント、自動マーケットメーカー、予測市場UI、またはPolygraph上のPolymarketと統合するアプリケーション構築時に活用できます。
ethskills
Ethereum、EVM、またはブロックチェーン関連のリクエストに対応します。スマートコントラクト、dApps、ウォレット、DeFiプロトコルの構築、監査、デプロイ、インタラクションに適用されます。Solidityの開発、コントラクトアドレス、トークン規格(ERC-20、ERC-721、ERC-4626など)、Layer 2ネットワーク(Base、Arbitrum、Optimism、zkSync、Polygon)、Uniswap、Aave、Curveなどのプロトコルとの統合をカバーします。ガスコスト、コントラクトのデシマル設定、オラクルセキュリティ、リエントランシー、MEV、ブリッジング、ウォレット管理、オンチェーンデータの取得、本番環境へのデプロイ、プロトコル進化(EIPライフサイクル、フォーク追跡、今後の変更予定)といったトピックを含みます。
xxyy-trade
このスキルは、ユーザーが「トークン購入」「トークン売却」「トークンスワップ」「暗号資産取引」「取引ステータス確認」「トランザクション照会」「トークンスキャン」「フィード」「チェーン監視」「トークン照会」「トークン詳細」「トークン安全性確認」「ウォレット一覧表示」「マイウォレット」「AIスキャン」「自動スキャン」「ツイートスキャン」「オンボーディング」「IP確認」「IPホワイトリスト」「トークン発行」「自動売却」「損切り」「利益確定」「トレーリングストップ」「保有者」「トップホルダー」「KOLホルダー」などをリクエストした場合、またはSolana/ETH/BSC/BaseチェーンでXXYYを経由した取引について言及した場合に使用します。XXYY Open APIを通じてオンチェーン取引とデータ照会を実現します。