開発のスキル

Spring BootのJavaプロジェクトのひな形を作り、データベース接続設定やDocker Compose、API仕様の表示、テスト用の依存関係を整えます。

• Java 21で新規開発を始めたいとき
• ローカルのデータベース環境構築
• API仕様表示と構造テストの依存関係追加

ローカルのコードを読み、根拠付きの構成資料を作成します。古いシステムの刷新では、起動やテストの可否を調べ、現実的な検証方法を含む段階的な移行計画にまとめます。

• コードの引き継ぎ資料を作りたいとき
• システム構成や依存関係を把握したいとき
• 旧システムの移行や刷新を計画したいとき

プロジェクトの構成や開発手順を調べ、AIエージェント向けのAGENTS.mdを作成します。環境構築、テスト、コード規約などを具体的なコマンドとともに整理するスキル。

• エージェント向けの作業案内づくり
• 環境構築とテスト手順の文書化
• モノレポのパッケージ別指示の整理

機能の要件書から、Epochのモノレポ構成に沿った実装計画を作成します。画面、API、データベース、構成図、認証や性能まで設計項目を具体化します。

• 機能要件から実装計画を作りたいとき
• 画面・API・サービスの責務整理
• データベース設計と移行方針の文書化

まとまった開発単位の製品要件書から、主要機能、サービス構成、技術選定、規模の見積もりを整理し、Mermaid図付きの技術アーキテクチャ仕様書にまとめるスキル。

• 製品要件を技術構成に落としたいとき
• システムの各層とデータの流れの可視化
• 機能に必要なサービスや基盤の整理

既存コードと設定を調べ、GitHub Copilot向けの指示ファイルを作成します。実際の技術バージョン、設計、命名やテストの慣習を整理し、プロジェクトに沿った実装を導きます。

• 既存案件のCopilot指示を作りたいとき
• 技術バージョンの互換条件を明文化したいとき
• 実際の実装規約とテスト慣習を整理したいとき

Gitの変更内容を確認し、変更種別や対象範囲、短い要約をそろえたConventional Commits形式のメッセージ作成とコミット実行を支援します。

• チームのコミット表記を統一したいとき
• コミット前に変更内容を要約したいとき
• 互換性を壊す変更や関連課題の記録

コードの差分や変更の説明から、変更理由と解決する問題が伝わるコミットメッセージを作ります。Conventional Commits形式に整え、分割すべき変更も提案します。

• ステージ済み変更のメッセージ作成
• バグ修正が必要だった理由の記録
• 無関係な変更を別コミットに分けたいとき

初めて読むコードの構造や関数の呼び出し関係、変更の影響範囲を調べます。Codebase Memoryの検索結果を実際のソースと照合し、根拠を確かめながら理解を進めます。

• 初めて読むコードの構造把握
• 関数の呼び出し元や依存関係の調査
• コード変更の影響範囲を確認したいとき

Gitの作業内容に合うブランチ名を、Conventional Branchの規則に沿って作成・検証します。名前を整え、基点の検出から新規ブランチへの切り替えまで進めます。

• 新機能や不具合修正のブランチ作成
• ブランチ名が規則に合うか確認したいとき
• issue番号をブランチ名に含めたいとき

アプリにGitHub CopilotのAIエージェントを組み込み、独自ツールの呼び出し、応答の逐次表示、会話の保存・再開を実装するスキル。

• アプリにAIアシスタントを組み込みたいとき
• エージェントが呼び出す独自ツールの追加
• 生成中の応答を逐次表示

Pythonスクリプトの構成や命名を整え、処理の理由が分かる初心者向けコメントを追加します。導入手順から使用例まで説明するREADME.mdも作成します。

• Pythonスクリプトの教材化
• 初心者にコードの仕組みを伝えたいとき
• 導入手順と使用例の文書化

実在するファイルと行番号にひもづくコードの案内を、読者の役割や目的に合わせて作成し、新人の学習、PRレビュー、不具合調査に使える.tourファイルにまとめるスキル。

• 新メンバー向けのコード案内
• PRの変更点とリスクの共有
• 不具合や障害に関わる処理の追跡

GitHubのPRに届くレビュー指摘を修正・見送り・人への引き継ぎに分類し、テスト、コミット、返信、Copilotへの再レビュー依頼を繰り返して対応を進めます。

• Copilotの未対応指摘を処理したいとき
• 完成したPRのレビューを繰り返したいとき
• 見送り理由の説明と設計判断の引き継ぎ

設計判断の背景、採用理由、却下した案、利点と欠点を整理し、人にもAIにも参照しやすい統一形式のADRとしてMarkdownに記録するスキル。

• システム設計の選定理由を記録したいとき
• 却下した代替案と得失の文書化
• 新しい参加者への判断背景の共有

既存コードから手本となる実装を探し、exemplars.mdに整理するためのAI向け指示文を作るスキルです。技術や分析の深さ、分類方法を指定し、チームの実装方針を共有します。

• チーム向けに既存コードの手本を収集
• 新機能で踏襲する実装パターンの文書化
• コード例集の分析範囲と形式を指定

コード変更に着手する前に、修正対象、依存関係、関連テスト、参考になる既存実装を調べ、必要な変更とリスクをレビュー用の一覧に整理するスキル。

• コード変更の影響範囲を把握したいとき
• 関連テストと依存関係を探したいとき
• 参考になる既存実装を探したいとき

WordPressやShopifyなどのCMSで、テーマ、拡張機能、編集画面、メディア管理を開発・変更する際に、構造と制約を確認して適切な変更箇所へ導きます。

• CMSのテーマやテンプレートを変更
• プラグインやモジュールの開発
• 編集フォームやプレビューの改善

Windowsのバッチファイルを作成・修正し、ファイル操作や定期実行を自動化します。変数展開や引用符の不具合調査から、引数処理・エラー処理の整備まで支援します。

• ファイルコピーやバックアップの自動化
• Task Scheduler用スクリプトの作成
• 変数展開や引用符の不具合調査

アプリの読み書きの頻度やデータ量を整理し、Azure Cosmos DBのデータ構造、分割方法、索引を検討して、要件書と設計書にまとめるスキル。

• 新規アプリのデータモデル設計
• 関連データの格納・分割方法の検討
• 大量処理時のデータベース費用の検討

リポジトリをAIエージェント向けに整備する本体スキルの導入を案内します。Copilot CLIでの追加、内容確認、再読み込み、実行までの手順を示します。

• Copilot CLIでの本体スキル導入
• 読み込み前に内容を確認したいとき
• 導入済みスキルの更新

コードから技術構成や設計パターン、依存関係を読み取り、構成図と実装例、新機能を追加する際の指針を含む、実装に沿った設計資料を作るスキル。

• 初めて触るコードの全体像を知りたいとき
• 部品の依存関係やデータの流れの文書化
• 設計をそろえて新機能を追加したいとき

ASP.NET Minimal APIのエンドポイントを、明示的な入出力の型や入力検証とともに作成。OpenAPIの説明やエラー応答も整えるスキル。

• 入出力の型を明示したAPI作成
• OpenAPIに操作や引数の説明を追加
• MapGroup()で関連APIを整理

実際のコードから言語や開発ルールを読み取り、AIコーディングエージェント向けの指示ファイルを生成。プロジェクト全体や領域別にルールを整理します。

• VS Code Copilot向け指示を作成
• 開発ルールの変更を指示に反映
• モノレポの領域別ルールを整理