refactor-method-complexity-reduce
指定したメソッド `${input:methodName}` の認知的複雑度を `${input:complexityThreshold}` 以下に下げるため、ヘルパーメソッドを抽出してリファクタリングします。
description の原文を見る
Refactor given method `${input:methodName}` to reduce its cognitive complexity to `${input:complexityThreshold}` or below, by extracting helper methods.
SKILL.md 本文
メソッドのリファクタリングによる認知的複雑性の削減
目的
メソッド ${input:methodName} をリファクタリングし、ロジックをフォーカスされたヘルパーメソッドに抽出することで、認知的複雑性を ${input:complexityThreshold} 以下に削減します。
手順
-
現在のメソッドを分析 して、認知的複雑性の原因を特定します:
- ネストされた条件分岐
- 複数の if-else チェーンまたは switch チェーン
- 重複するコードブロック
- 条件付きループの複数出現
- 複雑なブール式
-
抽出の機会を識別します:
- 別のメソッドに抽出できる検証ロジック
- 繰り返される型別処理またはケース別処理
- 複雑な変換や計算
- 複数回現れる共通パターン
-
フォーカスされたヘルパーメソッドを抽出します:
- 各ヘルパーは単一で明確な責任を持つ必要があります
- 検証は別の
Validate*メソッドに抽出します - 型別ロジックはハンドラーメソッドに抽出します
- 共通操作のユーティリティメソッドを作成します
- 適切なアクセスレベル (static, private, async) を使用します
-
メインメソッドを簡潔にします:
- ネスト深さを減らします
- 大規模な if-else チェーンを、小さなオーケストレーション呼び出しで置き換えます
- クリーンなディスパッチのために、必要に応じて switch ステートメントを使用します
- メインメソッドが高レベルなフローとして読めるようにします
-
機能を保持します:
- 入出力の動作は同じに保ちます
- すべての検証とエラー処理を保持します
- 例外の型とエラーメッセージを保持します
- すべてのパラメータがヘルパーに適切に渡されることを確認します
-
ベストプラクティス:
- インスタンス状態が不要な場合、ヘルパーメソッドを static にします
- null チェックとガード句を早期に使用します
- 不要なローカル変数の作成を避けます
- 複数の戻り値にタプルの使用を検討します
- 関連するヘルパーメソッドをグループ化します
実装アプローチ
- メインフローのリファクタリング前にヘルパーメソッドを抽出します
- 段階的にテストして、回帰がないことを確認します
- 抽出された責任を説明する意味のある名前を使用します
- 抽出されたメソッドを使用位置の近くに保ちます
- 繰り返されるコードパターンを汎用メソッドにすることを検討します
結果
リファクタリングされたメソッドは以下を満たす必要があります:
- 認知的複雑性が
${input:complexityThreshold}以下の目標値まで削減されている - より読みやすく、保守しやすい
- 関心の明確な分離がある
- より簡単にテストおよびデバッグできる
- 元の機能をすべて保持している
テストと検証
重要: リファクタリング完了後、以下を必ず実施してください:
- リファクタリングされたメソッドおよびその周辺機能に関連するすべての既存テストを実行します
- 必須: テスト結果が「failed=0」を明示的に確認します
- テストが成功したと仮定しないでください - 常に実際のテスト出力を確認します
- 合格/不合格の数を含む概要行を探します (例: 「passed=X failed=Y」)
- 概要で「failed=0」以外の数を示している場合、テストは失敗しています
- テスト出力がファイルにある場合、ファイル全体を読んで失敗数を見つけ、確認します
- テスト実行はテスト成功の検証と同じではありません
- ゼロ失敗を明示的に確認するまで進みません
- テストが失敗した場合 (failed > 0):
- 失敗したテスト数を明確に述べます
- 各失敗を分析して、どの機能が壊れたかを理解します
- 一般的な原因: null 処理、空コレクション チェック、条件ロジック エラー
- リファクタリングされたコード内の根本原因を特定します
- 元の動作を復元するようにリファクタリングされたコードを修正します
- テストを再実行し、出力で「failed=0」を確認します
- すべてのテストが成功するまで (failed=0) 繰り返します
- コンパイルを確認します - コンパイルエラーがないことを確認します
- 認知的複雑性をチェックします - メトリクスが
${input:complexityThreshold}以下の目標値にあることを確認します
確認チェックリスト
- コードはエラーなくコンパイルされる
- テスト結果が明示的に「failed=0」と表示される (出力を読んで検証)
- すべてのテスト失敗を分析および修正している (発生した場合)
- 認知的複雑性が
${input:complexityThreshold}以下の目標値にある - すべての元の機能が保持されている
- コードがプロジェクトの規則と標準に従っている
ライセンス: MIT(寛容ライセンスのため全文を引用しています) · 原本リポジトリ
詳細情報
- 作者
- github
- ライセンス
- MIT
- 最終更新
- 不明
Source: https://github.com/github/awesome-copilot / ライセンス: 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を通じてオンチェーン取引とデータ照会を実現します。