開発のスキル

ロジックを書く前に、型・データ構造・共有状態を整理し、不要コードの削除からテスト基盤、機能実装へ進む順序と、早すぎる共通化を避ける判断を導くスキル。

• 実装前に型とデータ構造を決めたいとき
• 並行処理の共有状態を見直したいとき
• 基盤整備と機能実装の順序を決めたいとき

機能追加やリファクタリングの前に、不要なコードや重複した検証、内容のない参照を整理。実際の利用と仕様に沿って、単純な土台から変更を進めるための指針です。

• 機能追加前に不要なコードを整理する
• リファクタリングや書き直しの順序を決める
• 想像上の例外に備えた検証を見直す

リポジトリでエージェントが繰り返すミスを履歴から分類し、設計・型・静的チェック・テストの順に防止策を検討して、過去の実例で有効性を確かめるスキル。

• レビューで繰り返すミスを防ぎたいとき
• 重複した定義を一元化したいとき
• 型や自動チェックで規約を守らせたいとき

不具合を再現し、症状から原因をたどって最初に誤った処理を修正するデバッグ指針です。正当な状態への対処と、不正な状態を隠すだけの回避策を区別します。

• 不具合の根本原因を調べたいとき
• 追加チェックの妥当性を見直したいとき
• 再起動後の不具合調査

複数のエージェントや処理が同じファイルや状態を書き換える設計を見直し、保存先の分離を優先して、共有が必要な場合だけ排他制御を検討するスキル。

• 複数エージェントの更新競合を防ぎたいとき
• 独立した処理の状態保存先の分離
• 共有状態へのロック導入を見直したいとき

新しい要件を既存の設計へ組み込む際に、最初からその要件があった前提で構成を見直し、型・文書・使用例・設計理由まで段階的に変更を反映するスキル。

• 既存設計に新要件を組み込みたいとき
• 継ぎ足す前に構成を見直したいとき
• 型・文書・使用例の一括見直し

入力検証やエラー処理を、設定ファイルや外部APIとの接点に集める設計指針です。内部での重複チェックを減らし、業務ロジックをフレームワークから切り離します。

• 設定ファイルの検証を整理したいとき
• 業務ロジックを切り離したいとき
• 内部の重複チェックの見直し

リファクタリングや修正の際に、同じ判断の重複と変更量を見直します。判断の根拠を一か所にまとめ、不要な層や定型コードを増やさず、問題を解く最小限の変更を選びます。

• コード修正の差分を小さくしたいとき
• 複数箇所に重複する判断を整理したいとき
• 抽象化を追加する必要性の見直し

コード変更が差分の外で何を壊しうるかを調べ、安全性を支える重要な前提を実際のコード実行で検証し、確認できたリスクと未証明の点を整理するスキル。

• 小さなコード変更の影響を調べたいとき
• 設計前に既存コードの前提を確かめたいとき
• マージ前に安全性の根拠を検証したいとき

コードを読むときにたどる層の数と、覚えておく必要がある状態を点検します。不要な中継処理や広すぎる変更範囲を見直し、値の出所と変化を追いやすくします。

• 処理を追いにくいコードのレビュー
• 呼び出し元が1つのラッパーの見直し
• 変更可能な状態の範囲を狭めたいとき

静的型付け言語で、不正な状態やIDの取り違え、処理漏れを型で防ぎ、外部入力の解析と正式なスキーマに基づく型定義を設計・レビューするスキル。

• 関数の引数や戻り値を見直したいとき
• ユーザーIDと注文IDの混同防止
• 外部入力を型付きデータにしたいとき

pstackで役割ごとに使うAIモデルと推論の強さを設定します。利用可能なモデルを調べて設定ファイルへ反映し、セッション開始時に動くフックの有効・無効も切り替えます。

• 役割別にAIモデルを割り当てたいとき
• 利用可能なモデルに設定を合わせたいとき
• 既定値と役割別の推論の強さの調整

状態や業務ルールをデータ構造で表し、条件分岐や重複した前提を整理するスキル。状態遷移や型付きモデルなどを使い、不正な状態を作りにくいコード設計を支援します。

• 増え続ける条件分岐の整理
• 状態遷移やライフサイクルの設計
• ファイル間で重複するルールの集約

AIエージェントの開発作業を、簡潔な説明、必要に応じた設計比較、単純なコード、実物での検証という方針で進め、判断の根拠も記録するスキル。

• エージェントの開発方針をそろえたいとき
• 実装前に設計案を比較したいとき
• 実際の動作で修正を確かめたいとき

mainとの差分を確認し、AIが追加した不要なコメントや過剰な例外処理、型問題を避けるanyなどを、周囲の書き方に合わせて最小限の変更で整理するスキル。

• AIによる実装後のコード整理
• 不要なコメントや防御的処理の見直し
• 型問題を避けるanyを確認したいとき

編集・移行・分析・検証などの複雑な作業を、再実行できるスクリプトや生成ツールに落とし込み、担当者やレビュー担当が結果を確かめられるファイルとして残す方針を適用します。

• コード変更や移行を自動化したいとき
• 似た構成のファイルを生成したいとき
• 分析や検証を再現可能にしたいとき

クラッシュや再起動で途中まで実行された処理も、現在の状態から必要な差分だけを反映し、何度やり直しても同じ完了状態に収束するよう設計するスキル。

• 安全に再実行できるコマンドの設計
• クラッシュ後の復旧手順の見直し
• 残ったロックや一時ファイルの処理

指定ファイルや差分のコメントを専用エージェントが点検し、不要な記述の削除と根本原因の修正を進めます。コメントで示す制約を型やテストで守る方法も提案します。

• 変更差分のコメントを点検したいとき
• 注意書きが必要な回避策の見直し
• コメントの制約を自動検査にしたいとき

同じ課題を複数のAIエージェントに並行して依頼し、評価基準で比較した案を土台に、ほかの案の優れた部分を組み合わせ、成果物の検証まで進めるスキル。

• 複数の設計案を比較したいとき
• 同じ課題の実装方法を探りたいとき
• 候補案の良い部分を統合したいとき

現在の会話を判断・ツール利用・別の視点から並行レビューし、繰り返し使える教訓を抽出。承認を経て既存スキルの具体的な改善へつなげるスキルです。

• 完了した作業の教訓を振り返りたいとき
• 繰り返す失敗をスキル改善に生かす
• スキル修正と仕組みの改善を仕分ける

コードを調べて機能の仕組みや実行時の流れ、ファイル・パッケージの役割を説明し、変更前の理解や、新しい処理をどこに置くべきかの検討に役立てます。

• コードを変更する前に理解したいとき
• 初めて担当する領域の構造把握
• ファイルやサービスをまたぐ処理の追跡

同じ前提に基づく修正が二度以上、同じ検証で失敗したときに使う指針です。共通の前提を一文にし、次の修正を始める前に観測や再実行できる確認で検証します。

• 修正が繰り返し失敗したとき
• 原因の前提を再検証したいとき
• 失敗の分布を調べたいとき

公開済みのPRを継続的に見守り、CIの失敗やマージ競合、対応が明確なレビュー指摘を修正するスキル。修正後も状態を確認し、マージ可能な状態へ進めます。

• 公開後のPR対応を継続して任せたいとき
• CI失敗の修正と再確認
• 対応が明確なレビュー指摘の修正

実装前に型・関数の入出力・モジュール構成を描き、複数モデルによる異なる設計案を比較して、選んだ設計に沿う実装と必要な見直しまで進めるスキル。

• 複雑な機能を実装前に設計したいとき
• モジュール構成の代替案比較
• 実装と設計判断の整合性確認