開発のスキル

データやAPI、設定、依存関係の移行を、互換性と既存データを保ちながら進めます。切り戻し手順や新旧両方の動作確認を含め、段階的な変更を支援します。

• 既存データを保って移行したいとき
• 新旧バージョンが併存する更新
• 移行前の切り戻し手順の準備

コードの振る舞いを保ちながら、処理の切り出しや重複の統合、担当箇所の移動を進めるスキル。構造を変える前後で同じ検証を行い、動作の一致を確かめます。

• 動作を保って処理を切り出したいとき
• 重複した処理の統合
• モジュール間で処理の担当を移したいとき

コードの所在調査、1〜2ファイルの修正、差分レビューを専用の補助エージェントに振り分けます。結果を短い構造化形式で受け取り、主エージェントの文脈消費を抑えます。

• 定義や呼び出し元を探したいとき
• 1〜2ファイルの限定的な修正
• 差分の不具合レビュー

不具合や小さな動作変更の原因をたどり、責任のある最小範囲を修正します。周辺の動作や既存の変更を保ちながら、関連するテストで再発防止を確認するスキルです。

• 周辺の動作を保って不具合を直したいとき
• 小さな動作変更を加えたいとき
• 特定の不具合の再発防止テスト追加

初めて触るコードや通常の検索で見つからない処理について、関連ファイルの場所を読み取り専用で調べます。確認済みの行範囲と短い理由を添えて報告します。

• 初めて触るコードの入口探し
• 複数ファイルにまたがる処理の調査
• 直接検索で見つからなかったとき

Cavemanの観測レポートを基に、利用者が選んだ対象の最小限のコード変更を検討します。承認後に変更前後を同じ入力で比較し、品質と資源使用量を確認します。

• Cavemanの観測レポートの確認
• 変更前後のトークン数やバイト数の比較
• 最適化後も品質を保てるか確認したいとき

コード内のLLMを使う処理を仕事の単位で洗い出し、承認後に用途別ラベルを付けます。Caveman Cloudで費用を処理ごとに分けて確認するためのスキルです。

• LLM費用を仕事別に把握したいとき
• APIや定期処理のLLM利用棚卸し
• 評価処理の費用を分けたいとき

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

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

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

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

プロジェクトの品質基準を数値とチェック方法付きで文書化し、テストの省略や警告の抑制、基準値の引き下げを差分から点検して、エージェント開発の品質を保つスキル。

• エージェント開発の品質基準を決めたいとき
• カバレッジや性能の目標値を選びたいとき
• テスト省略や警告の抑制を見つけたいとき

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Paperclipの失敗・停止・遅延や誤ったブロックを調べ、原因の再現から修正、再発防止テスト、実際の利用手順の検証、チェックが通るPRの作成まで進めます。

• Paperclipの実行失敗を直したいとき
• 停止や誤ったブロックの原因調査
• タスク実行の遅延を改善したいとき

native Paperclip Runnerに新しい実行ツールやプロバイダーを接続するため、要件整理と通信仕様の調査から実装、パッケージ化、実環境での一連の動作検証まで進めます。

• Runnerに新しい接続先を追加
• 実行ツールの通信仕様と機能を調査
• 接続機能のキャンセルと復旧を検証