開発のスキル

定型的なコード変更を、パターンが合う場合にWASMで即時変換するスキルです。変数宣言の更新、型注釈やエラー処理の追加などに対応し、合わない変更はコーダーへ引き継ぎます。

• 定型的な変数宣言を更新したいとき
• 型注釈をまとめて追加したいとき
• Promiseチェーンを変換したいとき

GSDの計画とタスクに沿って、コードと計画ファイルを分けたコミット、構造化メッセージ、ブランチ状態の確認、節目のタグ付けを支援するスキルです。

• タスク単位で変更をコミットしたいとき
• 計画ファイルとコードを分けて記録したいとき
• ブランチ状態や差分を確認したいとき

ブランチやTODO、ドキュメント、テストカバレッジ、依存関係を点検し、技術的負債の状況をまとめて、保守作業の優先順位や改善案を整理します。

• 技術的負債を棚卸ししたいとき
• TODOやFIXMEを一括で探したいとき
• ドキュメントと依存関係を点検したいとき

調査結果をもとに、変更の重要度に応じた成功条件やリスク、テスト、細かな実装手順を含む計画書を作成するスキルです。

• 実装前に作業計画を作りたいとき
• 変更を検証可能なタスクに分けたいとき
• テストを先に計画したいとき

実装計画を完了条件や対象ファイル、依存関係を含む作業単位に分け、人の確認が必要な工程と並行実行の可否も整理します。

• 大規模な機能を作業単位に分けたいとき
• 変更対象ファイルを明確にしたいとき
• 人の確認が必要な箇所を洗い出すとき

技術的な重要判断を、背景・比較した選択肢・決定理由・想定される影響とともに記録し、連番付きのADRとして残すスキルです。

• 設計方針の選択理由を残したいとき
• 技術案を比較して判断したいとき
• 引き継ぎ用に決定の経緯を記録するとき

既存コードの調査前に依頼の目的や範囲を確認し、関連ファイルやデータの流れを追って、実装前の調査結果を文書にまとめます。

• 変更前に既存機能を調べたいとき
• 計画前に依存関係を把握したいとき
• 調査結果を文書に残したいとき

GSDの計画書やフェーズ成果物を点検し、構造の不備、参照切れ、未作成ファイル、要件の対応漏れをレポートするスキルです。

• 計画書の形式を実行前に確認したいとき
• フェーズ成果物の不足を調べたいとき
• 計画内の参照切れを洗い出したいとき

Git worktreeで作業場所とブランチを分け、機能開発の準備から状態確認、差分確認、同期、作業後の整理まで支援します。

• 機能開発を別の作業場所で進めたいとき
• 複数の作業を並行したいとき
• 基準ブランチとの差分を確認したいとき

不具合の再現から原因の仮説検証、修正、回帰確認までを順に進め、ログなどを根拠に原因を絞り込むデバッグ支援スキルです。

• テストで見つかった不具合を調べたいとき
• バグ報告の根本原因を特定したいとき
• 性能低下の原因を切り分けたいとき

実装前に入力や期待結果、端のケースを定めたテストを書き、そのテストを通すコードを段階的に実装・検証する開発手順を支援します。

• 実装前にテスト仕様を決めたいとき
• テスト作成を計画の最初に置きたいとき
• コード変更の動作を確認したいとき

要件が曖昧な段階で質問を重ね、複数の案とトレードオフを整理して、調査や実装に進むための要件をまとめるスキルです。

• 曖昧な機能要件を整理したいとき
• 設計案の利点とトレードオフを比べたいとき
• 関係者間で方針を決めたいとき

コンテキスト上限に近づいたとき、タスクの進捗や品質確認の結果を保存し、セッション再開後に続きから作業できるよう状態を復元します。

• コンテキスト圧縮後に開発を続けたいとき
• TDDの進行位置を引き継ぎたいとき
• タスクと品質確認の状態を復元したいとき

タスクの複雑さに応じて処理先を振り分け、簡単なコード変換を高速に行いながら、過去の振り分け履歴を学習して選択を調整するスキルです。

• 定型的なコード変換を素早く行いたいとき
• 複数ファイルの変更先を振り分けたいとき
• タスクに応じて処理経路を選びたいとき

変更規模に応じて確認の深さを調整し、根拠や行番号を添えてコード品質を評価するスキルです。指摘と判定を定型形式でまとめます。

• マージ前に変更をレビューしたいとき
• 差分に応じた確認範囲を決めたいとき
• 判定理由つきの報告書を作りたいとき

複数のAIエージェント間で合意形成や状態共有を行うため、Raft、ビザンチン耐性、Gossip、CRDTの方式を使い分けます。

• 複数エージェントの状態を同期したいとき
• 同時更新の競合を解消したいとき
• 信頼性に差がある参加者で合意形成したいとき

プルリクエスト作成後のCI結果やレビューコメントを追い、指摘への対応とスレッド解決を確認してマージ可能な状態か判断するスキルです。

• プルリクエストのCIを継続して確認したいとき
• レビューコメントへの対応を進めたいとき
• 未解決のレビュー スレッドを確認したいとき

`.maestro/knowledge.dot`に設計判断やアーキテクチャのパターンを記録し、整合性の確認、検索、コードとの同期、DOT形式での出力を行うスキルです。

• 設計判断を記録したいとき
• 知識グラフの矛盾を確認したいとき
• 既存パターンの使用箇所を探したいとき

計画を提示する前に、実現可能性・網羅性・依頼との整合性を3人の独立したレビュアーの視点で点検し、修正が必要な箇所を明確にします。

• 承認依頼の前に計画を点検したいとき
• 作業分割の抜けを確認したいとき
• 依頼との範囲ずれを見つけたいとき

プロジェクトの構成やソース、テスト、設定を調べ、既存コードの慣習を検索用インデックスと実行可能なルールにまとめます。

• 既存プロジェクトの慣習を把握したいとき
• コードやテストを検索用に索引化したいとき
• 開発ルールを明文化したいとき

承認済みの実装計画に沿って作業を進め、各手順の検証や段階ごとの確認、コード・セキュリティレビューまで管理するスキルです。

• 承認済みの計画どおりに実装したいとき
• 段階ごとに検証しながら変更を進めたいとき
• 実装後のコード・セキュリティレビューを管理したいとき

作業前に知識ベースからルールや注意点を確認し、完了後に得たパターンや判断を記録して、開発作業の知見を蓄積するスキルです。

• 着手前に関連ルールを確認したいとき
• 中断後に作業の文脈を取り戻したいとき
• 実装の知見を次の作業に残したいとき

コード変更を設計者の視点でレビューし、重複や先回りした実装、抽象化、テスト範囲を確認して、品質スコアと行番号付きの指摘をまとめます。

• 変更内容の重複を確認したいとき
• 不要な先回り実装を見つけたいとき
• 抽象化とカプセル化をレビューしたいとき

Python、TypeScript、JavaScript、Goのコードに対し、Lint・整形・型チェックを実行し、自動修正後に再確認する品質チェック手順を示します。

• PythonのLintと型チェックをしたいとき
• TypeScriptの整形と静的チェックをしたいとき
• Goの自動修正とチェックをしたいとき