Addy Osmani

新機能や不具合修正に先立って失敗するテストを書き、最小限の実装とコード整理を繰り返し、期待する動作と既存機能への影響を確かめるスキルです。

• テストを先に書いて実装したいとき
• 報告された不具合の再現と修正
• コード変更時に既存動作を確かめたいとき

動作を変えずに、深い条件分岐、長い関数、重複、分かりにくい名前を整理するスキルです。既存の規約とテストを確認し、読みやすさを基準に小さな変更を重ねます。

• 動く機能の読みやすさを改善したいとき
• レビューで指摘された複雑さの整理
• 深い条件分岐や長い関数の整理

使用中のフレームワークやライブラリのバージョンを確認し、公式資料に沿って実装します。設計判断の出典を示し、非推奨APIや確認できない点も明らかにするスキルです。

• 使用バージョンの公式資料で実装を確認
• 根拠のあるひな型コードの作成
• 非推奨APIを使うコードの点検

漠然としたアイデアを対話で掘り下げ、複数案の比較から実行に移せる構想へまとめます。対象者や成功条件、未検証の前提、最小限の範囲、やらないことまで整理するスキル。

• 漠然としたサービスや機能案を具体化したいとき
• 方向を決める前に別案を比較したいとき
• 計画に進む前に前提を検証したいとき

既存のデザイン体系に沿って、スマホから大画面まで使えるUIを実装します。部品構成や状態管理に加え、キーボード操作、読み込み中やエラー時の表示まで整えるスキル。

• 新しいページやUI部品を作りたいとき
• スマホとパソコンの表示を整えたいとき
• キーボードや読み上げ対応を改善したいとき

Webアプリの入力処理・認証・外部連携を点検し、脆弱性への対策を整理します。依存パッケージ、個人情報、LLM出力の扱いまで確認するスキルです。

• ログインとアクセス権限の点検
• ファイル投稿や外部API連携の確認
• 公開前の依存パッケージ監査

テスト失敗やビルドエラー、予期しない動作を、再現・原因の絞り込み・最小化の順で調べ、根本原因の修正と再発防止テストまで進めるスキルです。

• コード変更後のテスト失敗を調査
• ビルドエラーの原因を調べたいとき
• 動かなくなった機能の原因調査

開発の相談内容から適切なスキルと使う順番を選び、仕様作成から実装、テスト、公開までの進め方を整理します。前提の明示や作業範囲、検証の共通ルールも示すスキル。

• 開発開始時に使うスキルを選びたいとき
• 新機能の作業手順を整理したいとき
• 不具合修正やレビューの手順を選びたいとき

設計や実装の重要な判断を、作業経緯を共有しない別のレビュー役に検証させ、隠れた前提や失敗条件を洗い出して、修正や判断の見直しにつなげるスキルです。

• 設計案の前提を検証したいとき
• 不慣れなコードでの判断を確認
• 認証や機密性の高い処理の検証

本番の動作や障害の原因を追えるよう、ログ・指標・処理経路の記録とアラートを設計し、実際の出力や通知の検証まで進めるスキルです。

• 本番機能の監視情報を整えたいとき
• サービス間のログをつなぎたいとき
• アラートと対応手順の見直し

混在したコード変更を目的ごとのコミットに整理し、ブランチやPRの運用から、互換性に応じたバージョン番号と変更履歴の作成まで支援するスキルです。

• 混在した変更をコミットに分けたいとき
• レビュー用のブランチやPRの準備
• worktreeで並行作業を分けたいとき

曖昧な依頼を、一問ずつの対話で掘り下げます。エージェントの仮説も示しながら、対象者・目的・成功条件・制約・対象外を整理し、確認済みの意図にまとめます。

• 曖昧な依頼の目的を明確にしたいとき
• 対象者と成功条件の整理
• 両立しにくい希望の優先順位の確認

複数ファイルにまたがる機能追加や改修を、動作確認できる小さな単位に分けて進めるスキルです。実装、テスト、検証、コミットを繰り返し、段階ごとに動く状態を保ちます。

• 複数ファイルに及ぶ機能追加
• 計画の次のタスクを実装したいとき
• 機能フラグで未完成部分を隠して統合

コード変更時のテスト・型チェック・ビルドを自動化し、公開前の品質確認を整えます。GitHub Actionsの設定から段階的な公開、切り戻し手順まで扱うスキルです。

• 新規プロジェクトのCI導入
• テストと品質チェックの自動化
• 段階的な公開と切り戻しの設計

AIエージェントに渡すルールや仕様、関連コードを作業ごとに選び、長い会話の情報整理や次のセッションへの引き継ぎまで整えるスキルです。

• AI開発用のルールを整えたいとき
• 作業に必要なファイルの選定
• 長い会話の情報を整理したいとき

本番公開前の品質・セキュリティ・性能・操作性を点検し、監視と切り戻しの準備を整えます。公開後の確認や指標に基づく段階的な展開まで扱うスキルです。

• 初回の本番公開前の準備確認
• 大きな機能の段階的な公開計画
• 監視項目と公開後の確認手順の整理

実際のブラウザで画面表示や操作を確かめ、エラー・通信・表示速度を調べます。修正前後の画像比較やアクセシビリティの確認も行うスキルです。

• レイアウトやスタイルの不具合調査
• ブラウザエラーやAPI通信の調査
• 修正前後の画面を比較したいとき

画面表示やAPI、データベースの遅さを測定して原因を絞り、改善前後の数値で効果を確かめます。効果のない変更の差し戻しや、性能低下を防ぐ監視まで導くスキル。

• ページ表示や操作の遅さを調べたいとき
• APIの遅延やクエリの重複を減らしたいとき
• 変更後の性能低下を確かめたいとき

APIやモジュール間の入出力を定義し、命名、エラー形式、入力検証をそろえるスキルです。既存の利用側との互換性や、再試行による処理の重複も考慮して設計します。

• 新しいREST APIの設計
• 画面とサーバー間のデータ仕様の定義
• 互換性を保ってAPIを拡張したいとき

設計の判断理由や比較した案を記録し、README・API文書・変更履歴を整えます。後から参加する人やAIエージェントに、実装の背景を伝えるスキルです。

• 設計判断と不採用案の記録
• 公開APIの変更を文書化したいとき
• READMEの導入手順の整備

仕様や要件を、完了条件と検証方法のある小さな実装タスクに分けます。依存関係、作業順、確認の区切りを整理し、計画書とタスク一覧に残すスキルです。

• 大きな機能を実装タスクに分けたいとき
• 依存関係に沿った作業順の整理
• 完了条件と検証方法の明文化

マージ前のコード変更を、正しさ・読みやすさ・設計・セキュリティ・性能の5軸でレビューし、修正が必要な問題と任意の提案を整理するスキルです。

• マージ前のプルリクエスト確認
• AIが書いたコードを確認したいとき
• リファクタリングの効果を確認

曖昧なアイデアを、目的・作業範囲・完了条件が分かる仕様書にまとめます。複数機能の分割や依存関係も整理し、人の承認を挟みながら計画・タスク化・実装へ進めるスキルです。

• 実装前にアイデアを具体化したいとき
• 完了条件を含む要件書の作成
• 大きな要件を独立した機能に分割

古いAPIや機能の廃止判断から、代替への段階的な移行、利用状況の確認、削除までを整理するスキルです。本番データベースの列変更も、新旧のコードが共存できる手順で進めます。

• 旧APIから代替APIへ移行したいとき
• 不要な機能の終了計画
• 本番データベースの列名を段階的に変更