開発のスキル

エージェント向けスキルの新規作成や修正を支援し、呼び出し条件、作業手順、付属ファイルの配置を整理して、設定や参照先、補助スクリプトを検証します。

• 定型作業をスキルにまとめたいとき
• 既存のSKILL.mdを修正したいとき
• 付属資料やスクリプトを整理したいとき

対話型のコマンド操作が動いているtmuxの画面を確認し、文字やキーを送るスキル。セッションの一覧、出力履歴の取得、入力待ちの監視に使えます。

• 対話型プログラムの出力を確認したいとき
• 実行中のセッションへ文字やキーを送信
• 入力待ちや処理の完了を監視したいとき

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

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

REAの解析処理やキャッシュ設計を見直し、結果の正しさと根拠へのアクセスを保ちながら、処理時間・CPU・メモリ・エージェントのコンテキスト負荷を改善するスキル。

• 解析処理の遅さを調べたいとき
• キャッシュ設計の見直し
• CPU・メモリ負荷の削減

配布済みアプリやバイナリ、パッケージをREAで解析し、機能や版ごとの違いを調べます。逆コンパイルや実行時の観測を使い、根拠と不明点を分けて説明します。

• 配布済みアプリの機能を調べたいとき
• アプリのバージョン間の動作比較
• バイナリや同梱リソースの解析

REAの調査ツールを設計・変更する際に、担当範囲、入出力、CLIやMCPの取り決めを整理します。調査根拠の扱いと検証方法まで含めて設計案をまとめます。

• REAの新しい調査ツールの設計
• CLI・MCPの入出力を見直したいとき
• providerの責任とEvidenceの意味の整理

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

コミット直前に変更ファイルを整形し、既存の型チェックとテストを実行する仕組みを設定します。Huskyとlint-stagedの導入から設定・動作確認まで扱うスキルです。

• コミット前の自動チェックを導入
• 変更ファイルをPrettierで整形
• 既存の型チェックとテストを実行

指定したコミットやブランチなどを基準にコードの変更を確認し、開発規約への適合と仕様の実現を別々にレビューします。二つの観点の指摘を分けて報告するスキルです。

• ブランチやPRの変更レビュー
• 指定コミットやタグ以降の確認
• 文書化された開発規約との照合

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

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

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

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

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

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