開発のスキル

GitHubのIssueやPRを確認・作成し、コメントやレビュー、CIの実行結果を扱います。失敗ログの調査や再実行、承認されたマージの状態確認にも対応します。

• IssueやPRを作成・更新したいとき
• PRのレビューやチェックを確認したいとき
• CIの失敗ログ調査と再実行

AIエージェントと外部ツールをつなぐMCPサーバーを、コマンドで一覧表示・設定・認証し、ツールの呼び出しや入出力の仕様確認まで行うスキル。

• MCPツールと引数の仕様確認
• MCPの接続設定と認証
• JSON引数でツールを呼びたいとき

バグやテスト失敗、予期しない動作の原因を、再現手順やログ、直近の変更から調べます。仮説の検証から修正後のテストまで、根拠に沿って進めるスキルです。

• 失敗するテストの原因を調べたいとき
• 本番の不具合を追跡したいとき
• ビルドや連携の失敗箇所の調査

互いに依存しない不具合やテスト失敗を別々のエージェントに割り当て、並行して調査・修正するスキル。担当範囲を明確にし、結果の確認と変更の統合まで案内します。

• 原因の異なるテスト失敗を調べたいとき
• 別々の機能の不具合を修正したいとき
• 複数エージェントの担当を整理したいとき

機能開発を別の作業領域で進めるために、既存の分離状態を確認し、環境標準の機能かgit worktreeで領域を用意。依存関係の準備と開始前のテストも行います。

• 機能開発を別の作業領域で始める
• 実装計画の開始前に環境を整える
• 作業領域が分離済みか確認する

superpowersの作業記録を読み、作業の重複や計画逸脱、時間・トークン消費などを調べます。ファイルの行番号を根拠に、経緯を報告書へまとめるスキルです。

• 作業の重複や計画逸脱を調べたいとき
• セッションの時間や消費量の確認
• スキルが使われたか確認したいとき

実装完了後に全テストを確認し、ローカルでのマージ、Pull Request作成、現状維持を選んで進めます。選択と作業環境に応じてブランチや作業領域を整理します。

• 完成した機能をローカルでマージする
• ブランチをpushしてPRを作る
• 完成した変更を後で統合したいとき

作成済みの実装計画を、同じセッションでタスクごとに実行します。テストの失敗と成功、進捗や判断を記録し、最後にブランチ全体をレビューするスキルです。

• 作成済みの開発計画を実装したいとき
• 実装用の別エージェントなしで進めたいとき
• 進捗記録から作業を再開したいとき

AIエージェント向けスキルの新規作成・改訂・公開前検証を、テストから進めるスキル。導入前後の振る舞いを比較し、指示の抜けや誤解を修正します。

• 再利用できるスキルを作りたいとき
• 誤解される指示を改訂したいとき
• 公開前にスキルを検証したいとき

実装計画をタスクごとに別のエージェントへ任せ、仕様への適合とコード品質を確認しながら進めるスキル。進捗をファイルに記録し、最後に変更全体もレビューします。

• 独立したタスクの実装計画を進めたいとき
• タスクごとに仕様への適合を確認したいとき
• 進捗記録から作業を再開したいとき

コードレビューの指摘を実際のコードや対応環境と照らし合わせ、妥当性を確認します。不明点の整理、根拠を示した返答、修正ごとのテストまで進めるスキルです。

• 曖昧なレビュー指摘を整理したいとき
• 提案された変更の互換性確認
• 追加機能が使われているか調べたいとき

仕様や要件を、変更するファイル・関数の定義・テスト・確認手順が分かる実装計画にまとめるスキル。コードを書く前に作業を分け、担当者へ引き継げる形に整えます。

• コードを書く前に機能実装を計画したいとき
• 要件をテスト可能なタスクに分けたいとき
• 別の担当者やエージェントに引き継ぎたいとき

機能の実装後やマージ前に、別のエージェントへコードレビューを依頼します。変更内容と要件、対象のコミットを渡し、指摘の重要度に応じて修正を進めるスキルです。

• 大きな機能を実装した後のレビュー
• マージ前に変更を確認したいとき
• 複雑な不具合修正への第三者確認

コーディングの作業ログを振り返り、ファイルの探しやすさ、自動チェック、指示文、ツール利用などを点検して、次回に向けた環境改善案を重要度順に整理するスキル。

• 時間がかかった開発作業の振り返り
• 繰り返すミスの自動チェックを探したいとき
• エージェント向け指示を整理したいとき

計画や設計を掘り下げる質問を重ね、内容を具体化しながら設計判断の記録と用語集も作ります。検討と文書化を同じ対話の中で進めたいときに使うスキルです。

• 質問に答えながら計画を詰めたいとき
• 対話で設計を掘り下げたいとき
• 検討中に設計判断を記録したいとき

課題や外部からのPRを分類し、報告内容の検証や不足情報の整理を進めます。対応状況を管理し、エージェントや人が着手するための作業説明を残すスキル。

• 管理者の確認が必要な課題の抽出
• 不具合報告や外部PRの検証
• エージェント向けの作業説明の作成

コード変更を確認する人に向けて、図や差分による要約、変更前後の動作証拠、取り消しやすさと影響範囲を短く整理したプルリクエスト本文を書くスキル。

• プルリクエスト本文を作成したいとき
• 構成変更をツリーや差分で説明したいとき
• 画面変更の前後を証拠で示したいとき

プロジェクトで使う業務用語や概念の境界を、具体例とコードの照合で明確にします。決まった定義を用語集に記録し、重要な設計判断の理由も必要に応じて残すスキルです。

• 曖昧な業務用語を整理したいとき
• GLOSSARY.mdの作成・更新
• 業務上の定義とコードの整合確認

仕様書と関連チケットの依存関係を読み取り、複数のエージェントで実装を進めます。テストとレビューを経て、成果を一つの統合ブランチにまとめるスキルです。

• 複数チケットの仕様を実装したいとき
• 独立した作業を並行実装したいとき
• 実装成果を統合ブランチにまとめたいとき

仕様書やチケットに書かれた作業をコードに反映します。型チェックとテストで確認し、コードレビューを経て現在のブランチへコミットするスキルです。

• 仕様書から機能を実装したいとき
• 指定チケットを実装したいとき
• 型チェックとテストで変更を確認したいとき

TypeScriptのパッケージ内部への直接参照や循環依存を検出し、公開ファイルだけを入口にする構成を、設定・検証・文書化まで整えるスキル。

• パッケージ内部への直接参照を防ぎたいとき
• 型チェックと一緒に境界を確認したいとき
• コピー用のパッケージ雛形を作りたいとき

コードの構造を調べ、理解やテストを難しくしている箇所の改善案を図入りHTMLレポートにまとめます。候補を選んだ後は、制約や設計判断を対話で掘り下げます。

• 変更が多い領域の設計を見直したいとき
• リファクタリング案を図で比較
• テストしやすいモジュール設計を検討

再現しにくい不具合や処理速度の悪化を、症状を判定するテストやスクリプトで調べます。原因候補の検証から修正、再発防止の確認まで進めるスキル。

• 再現しにくいエラーを調べたいとき
• 処理が遅くなった原因の調査
• 断続的な不具合を繰り返し検証

アイデアの整理、実装、不具合調査など、状況に合う関連スキルと使う順序を案内します。作業の規模や段階に応じて、次に進む手順を選ぶための相談役です。

• アイデアから実装までの手順選び
• 不具合調査の始め方を知りたいとき
• 複数回に分ける開発の進め方を相談