refactor
Martin FowlerのカタログおよびClean Codeの原則に基づいたコードリファクタリングのベストプラクティス。既存コードのリファクタリング、コード構造の改善、複雑さの低減、コードスメルの除去、または保守性のコードレビューを行う際に使用します。メソッドの抽出、リネーム、条件式の分解、結合度の低減、可読性の向上などのタスクで機能します。
description の原文を見る
Code refactoring best practices based on Martin Fowler's catalog and Clean Code principles (formerly refactoring). This skill should be used when refactoring existing code, improving code structure, reducing complexity, eliminating code smells, or reviewing code for maintainability. Triggers on tasks involving extract method, rename, decompose conditional, reduce coupling, or improve readability.
SKILL.md 本文
Fowler/Martin コード リファクタリング ベストプラクティス
Martin Fowler のカタログと Clean Code の原則に基づいた包括的なコード リファクタリング ガイド。AI エージェントと LLM 向けに設計されており、自動リファクタリングとコード生成をガイドするために優先度付けされた 8 つのカテゴリーにわたる 43 のルールを含みます。
適用するべき場面
以下の場合にこのガイドラインを参照してください:
- 保守性を向上させるための既存コードのリファクタリング
- 長いメソッドや大規模なクラスの分解
- コンポーネント間の結合度の削減
- 複雑な条件分岐ロジックの簡潔化
- コード スメルとアンチパターンのコード レビュー
ルール カテゴリー優先度別
| 優先度 | カテゴリー | インパクト | プレフィックス |
|---|---|---|---|
| 1 | 構造と分解 | CRITICAL | struct- |
| 2 | 結合度と依存関係 | CRITICAL | couple- |
| 3 | ネーミングと明確性 | HIGH | name- |
| 4 | 条件分岐ロジック | HIGH | cond- |
| 5 | 抽象化とパターン | MEDIUM-HIGH | pattern- |
| 6 | データ構成 | MEDIUM | data- |
| 7 | エラーハンドリング | MEDIUM | error- |
| 8 | マイクロ リファクタリング | LOW | micro- |
クイック リファレンス
1. 構造と分解 (CRITICAL)
struct-extract-method- 長い関数の Extract Methodstruct-single-responsibility- 単一責任の原則の適用struct-extract-class- 大規模クラスからのクラス抽出struct-compose-method- 可読性のための Compose Methodstruct-function-length- 関数を 20 行以下に保つstruct-replace-method-with-object- メソッドを Method Object に置き換えるstruct-parameter-object- パラメーター オブジェクトの導入
2. 結合度と依存関係 (CRITICAL)
couple-dependency-injection- Dependency Injection の使用couple-hide-delegate- デリゲートの隠蔽で結合度を削減couple-remove-middle-man- 過度なら Middle Man を削除couple-feature-envy- Feature Envy をメソッド移動で修正couple-interface-segregation- インターフェース分離の原則の適用couple-preserve-whole-object- フィールドではなくオブジェクト全体を保持
3. ネーミングと明確性 (HIGH)
name-intention-revealing- 意図を示す名前の使用name-avoid-abbreviations- 省略形や頭字語を避けるname-consistent-vocabulary- 一貫した語彙の使用name-searchable-names- 検索可能な名前の使用name-avoid-encodings- 名前内の型エンコーディングを避ける
4. 条件分岐ロジック (HIGH)
cond-guard-clauses- ネストされた条件分岐をガード句に置き換えるcond-polymorphism- 条件分岐をポリモーフィズムに置き換えるcond-decompose- 複雑な条件分岐を分解するcond-consolidate- 重複する条件分岐フラグメントを統合cond-special-case- Special Case オブジェクトの導入cond-lookup-table- 条件分岐をルックアップ テーブルに置き換える
5. 抽象化とパターン (MEDIUM-HIGH)
pattern-strategy- アルゴリズム変種のための Strategy 抽出pattern-template-method- 共有スケルトンのための Template Methodpattern-factory- 複雑なオブジェクト生成のための Factorypattern-open-closed- Open-Closed の原則の適用pattern-composition-over-inheritance- 継承より合成を優先pattern-extract-superclass- 共通動作のためのスーパークラス抽出
6. データ構成 (MEDIUM)
data-encapsulate-collection- コレクションのカプセル化data-replace-primitive- プリミティブ型をオブジェクトで置き換えるdata-encapsulate-record- レコードをクラスでカプセル化data-split-variable- 複数の割り当てを持つ変数を分割data-replace-temp-with-query- 一時変数をクエリに置き換える
7. エラーハンドリング (MEDIUM)
error-exceptions-over-codes- エラー コードの代わりに例外を使用error-custom-exceptions- ドメイン固有の例外型の作成error-fail-fast- 前提条件で早期終了error-separate-concerns- エラー処理とビジネス ロジックの分離
8. マイクロ リファクタリング (LOW)
micro-remove-dead-code- デッドコードの削除micro-inline-variable- 自明な変数のインライン化micro-simplify-expressions- ブール式の簡潔化micro-rename-for-clarity- 明確性のための名前変更
使用方法
詳細な説明とコード例については、個別のリファレンス ファイルをお読みください:
セクション定義- カテゴリー構造とインパクト レベルルール テンプレート- 新しいルール追加用テンプレート- 個別ルール:
references/{prefix}-{slug}.md
完全なコンパイル ドキュメント
すべてのルールが展開された完全なガイドについては: AGENTS.md
ライセンス: MIT(寛容ライセンスのため全文を引用しています) · 原本リポジトリ
詳細情報
- 作者
- pproenca
- リポジトリ
- pproenca/dot-skills
- ライセンス
- MIT
- 最終更新
- 不明
Source: https://github.com/pproenca/dot-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を通じてオンチェーン取引とデータ照会を実現します。