開発のスキル

コードの読み解きに必要な手間を、質問と答えの間にある層や隠れた状態から見直し、不要なラッパーや変更範囲を減らして追いやすい構造に整えるスキルです。

• 処理の流れが追いにくいコードのレビュー
• 不要なラッパーを整理したいとき
• モジュール内の共有状態を減らしたいとき

プロジェクトの検証スキルと機能マップを、ソースコードの確認とアプリの実操作で定期点検し、根拠のある説明やテスト用仕組みの修正をまとめます。

• 機能マップの抜けや重複を点検したいとき
• 検証手順と現行機能のずれを確認したいとき
• 説明のずれとアプリの不具合を切り分けたいとき

変更差分の外にある影響先や見落としやすい破損リスクを調べ、実際のコードを動かして安全性の根拠を確かめます。

• 変更の影響範囲を出す前に調べたいとき
• 小さな差分の安全性に不安があるとき
• 検索では見えない下流への影響を確認したいとき

条件分岐や状態管理に散らばったルールを、ドメインに合うデータ構造へまとめ、無効な状態や重複した判定を減らす設計を支援します。

• 増え続ける条件分岐を整理したいとき
• 状態やライフサイクルを明確に表したいとき
• 複数ファイルのデータ前提をまとめたいとき

デバッグ時に症状が現れた場所だけを塞がず、最初に誤った状態を生んだ箇所をたどって修正し、同じ原因がある場所も確認します。

• 症状から不具合の根本原因を追いたいとき
• ガードがバグを隠していないか調べたいとき
• 再起動後に起きる不具合を調査したいとき

コードベースの構成や処理の流れを調べ、機能の仕組み、コードの置き場所、担当パッケージや適切な層を把握するための説明をまとめます。

• 初めて触る機能の仕組みを知りたいとき
• 変更前に処理の流れを把握したいとき
• コードの置き場所や担当層を判断したいとき

リポジトリで繰り返すエージェントのミスを分類し、設計・型・Lint・テストの順に再発を防ぐ仕組みを整えるスキルです。

• 繰り返すエージェントのミスを防ぎたいとき
• 過去の失敗をLintやテストに反映したいとき
• リポジトリのルールと検査方法を整理したいとき

TypeScriptのコードを読む・編集するとき、型で不正な状態を防ぎ、外部データの検証や網羅性の確認まで一貫した実践ルールに沿って進めます。

• TypeScriptコードをレビューしたいとき
• 型で不正な状態を防ぎたいとき
• 外部データの検証方法を整えたいとき

計画済みの書き換えや移行で、途中の互換性維持より目標の構成への到達を優先し、区切りごとに確認する進め方を示します。

• 段階的なシステム移行を計画したいとき
• 目標アーキテクチャへ書き換えたいとき
• 一時的な互換対応の範囲を決めたいとき

静的型付け言語で、値の意味や入力元に合った型を設計し、無効な状態や未処理の分岐を型と検査で見つけやすくします。

• IDなど同じ基本型の値を区別したいとき
• JSONや設定値を型付きデータに変換したいとき
• 選択肢の分岐漏れを確認したいとき

ベンチマークの速度差を報告する前に、ボトルネック、条件、誤り、再現性、実際に処理が行われたかを証拠に基づいて点検します。

• 変更前後の性能差を報告したいとき
• 性能低下の測定結果を点検したいとき
• ライブラリや設定を測定値で比較するとき

クラッシュや再試行を前提に、処理を何度実行しても現在の状態から差分だけを反映し、同じ完了状態へ収束する設計を支援します。

• 繰り返し実行できるコマンドを設計したいとき
• 途中停止後の再実行を安全にしたいとき
• 一時ファイルや記録の残り方を点検したいとき

手作業では追いにくい編集、分析、確認を、再実行できるスクリプトや生成器に置き換え、レビュー時に確かめられる成果物として残します。

• 一括編集を再実行可能にしたいとき
• 移行結果を確認する仕組みを作りたいとき
• 定型ファイルを一貫して生成したいとき

既存設計に新しい要件を加える際、後付けの継ぎ足しを避け、最初から要件があった前提で全体を見直し、関連する型や文書、例まで変更を反映します。

• 既存設計に新要件を加えたいとき
• 継ぎ足しになった設計を見直したいとき
• 関連する型やドキュメントも更新したいとき

リファクタリングや差分の見直しで、不要な抽象化や重複した判断を減らし、問題を解く最小限の変更に絞るスキルです。

• 変更差分を最小限に整理したいとき
• 新しい抽象化が必要か見直したいとき
• 重複した判断を一元化したいとき

測定した性能値や評価結果について、何が数値を制限しているか、想定外の処理を測っていないかを証拠で確かめ、根拠とともに報告するスキルです。

• 性能改善を報告する前の検証
• 遅延や処理量の測定原因を調べたいとき
• 評価結果の差を複数試行で確かめたいとき

実装前にデータ構造や型、作業の順序を整理し、共有状態や並行処理のリスクも考えながら、後続のコードを単純に保つ設計指針を示します。

• 実装前にデータ構造を決めたいとき
• 型やデータモデルを整理したいとき
• 準備作業と機能開発の順を決めたいとき

Grok BotをWebhookで起動するページやダッシュボードを作り、送信キーをサーバー側で扱ってTailscale経由で共有する手順を案内します。

• ボタンでボットを起動する画面を作りたいとき
• Webhookにフォーム内容を送りたいとき
• 送信キーをブラウザーに置かず管理したいとき

並行作業で同じファイルや状態を書き換える競合を避けるため、共有先を分け、必要な場合だけ構造的に書き込み順を制御するスキルです。

• 並行作業の書き込み先を設計したいとき
• 共有状態の競合原因を洗い出したいとき
• 共有更新にロックが必要か判断したいとき

同じ依頼に複数の案を並行して作り、基準に沿って比較したうえで、最良案に他案の優れた部分を統合し、成果物を検証します。

• 複数の設計案を比較したいとき
• 大きな成果物の方向性を決めたいとき
• 複数の草案から長所を組み合わせたいとき

複数の編集や移行を小さな単位に分け、各変更を確認してから次へ進みます。コミットやPRも検証の順に並べ、レビューしやすくまとめるスキルです。

• 一括編集を一件ずつ検証したいとき
• 移行作業を安全な順序で進めたいとき
• レビューしやすいコミットを積みたいとき

対象のコードや差分にあるコメントを別の視点で点検し、不要なコメントの削除や制約のコード化を進めるスキルです。

• 差分中のコメントを見直したいとき
• 不要な説明コメントを整理したいとき
• コメントに書かれた制約をテストで守りたいとき

繰り返し起きる修正や指示を、文章の追加で済ませず、Lintや実行時チェック、スクリプトなどの仕組みに置き換える考え方を案内します。

• 繰り返すレビュー指摘を仕組みにしたいとき
• 同じ修正を防ぐチェックを考えたいとき
• 文章で伝える注意点を整理したいとき

入力や外部APIなど境界で検証とエラー処理を行い、内部の業務ロジックを型に沿った純粋な関数として整理する設計を支援します。

• 入力検証やエラー処理の置き場所を決めたいとき
• 業務ロジックをフレームワークから分離したいとき
• 外部データを型付きデータに変換したいとき