開発のスキル

対話と既存コードの調査を通じて曖昧な開発目標を具体化し、背景・準備・作業・検証を整理した、コピーして使えるralph-loop向けコマンドを作るスキル。

• 曖昧な機能案を作業に分解したいとき
• 既存コードに沿った実装計画の作成
• ビルド確認と完了条件の整理

複数のGitHub issueを並行して調査・修正するスキル。課題ごとに作業環境を分け、Mastra Codeの進捗監視から変更レビュー、PR作成、CI修正まで管理します。

• 複数のGitHub issueを並行修正したいとき
• 貢献履歴から対応する課題を探したいとき
• 課題ごとの進捗と障害を把握したいとき

プルリクエストのコードを不具合・保守性・記述ルールの順に確認し、統合前に直すべき問題と改善案、良い実装を、ファイル名や行番号を添えて整理するスキル。

• 統合前に直すべき不具合を探したいとき
• TypeScriptの型と非同期処理の確認
• 命名・インポート・デバッグ記述の点検

コード作成・修正・レビューを担うエージェントの指示文を設計します。ファイル操作の可否に応じた動作や必要なツール、検証方法、完了条件を具体化します。

• バグ修正用エージェントの設計
• PRレビュー担当の設計
• 接続なしのコード生成役の作成

Tailwind CSS v4の書き方に沿って、スタイルの実装・レビュー・整理を支援します。CSSでの設定方法やv3からの構文・表示の違いを確認できます。

• Tailwind CSS v3構文の移行
• CSSでの色・余白設定
• クラスと挙動変更のレビュー

GitHubのPRレビューやIssueコメントを、対象箇所・修正内容・根拠が伝わる文章に整え、投稿権限と承認条件を確認して公開するスキル。

• 対応箇所が明確なPRレビューの作成
• Issueの原因と修正を伝えたいとき
• 投稿承認と自己レビューの扱いを確認

Reactの実装・レビュー・リファクタリングで、データ取得や配信コード量、再描画を優先度順に見直し、部品構成・テスト・型の安全性も確認するスキル。

• React部品とデータ取得処理の実装
• 読み込み・描画性能のコードレビュー
• 大きな部品や広すぎる引数の整理

変更の目的や履歴を踏まえてプルリクエストの設計・テスト・安全性を確認し、検証結果と判定をGitHubおよびFactoryの作業カードに記録するスキル。

• Factoryで割り当てられたPRのレビュー
• バグ修正が根本原因を解消したか確認
• ボットや人のレビュー指摘の検証

ローカルやGitHubのコードをRepomix CLIでまとめ、全体構成や認証処理の所在、ファイル数などを調べて、初めて読むプロジェクトの理解を助けるスキル。

• 初めて読むプロジェクトの構成把握
• 認証処理やAPIの所在を調べたいとき
• ファイル数や推定トークン数の確認

ローカルやGitHubのコードをAIが読みやすい単一ファイルにまとめ、構成の把握や関連処理の検索、推定トークン数の確認から分析用の資料作りまで進めるスキル。

• AI分析用にコードを一つにまとめたいとき
• プロジェクトのディレクトリ構成の確認
• 認証処理やデータベースモデルの探索

コード変更の目的や設計判断、採用しなかった案の理由をコミット本文に残します。Conventional Commitsの件名に沿い、差分だけでは分からない背景を整理します。

• 機能追加の目的を記録したいとき
• 設計判断と見送った案の理由を保存
• 実装の制約や発見を引き継ぎたいとき

GitHubのリポジトリページにRepomixボタンを追加するブラウザ拡張の開発・保守を支援します。複数ブラウザへの対応や翻訳の更新、ビルドと検証を扱います。

• GitHubのRepomixボタン拡張を保守
• Chrome・Firefox・Edge対応の確認
• 翻訳の更新や対応言語の追加

Crushに標準搭載するスキルの追加・編集を支援します。SKILL.mdの配置、ビルド時の組み込み、検出テストまで、実装に必要な手順と仕組みを案内します。

• Crush標準スキルを追加したいとき
• 既存の標準スキルを編集したいとき
• スキルの検出と優先順位の確認

APIの応答や設定ファイルなどのJSONから、必要な項目や条件に合うデータを取り出し、構造を組み替えます。Crush内蔵のjqを使う変換式の作成や修正を支援します。

• API応答から必要な項目を抽出
• 条件に合うJSON配列の絞り込み
• 設定データの組み替えやJSON作成

Crushのシェルに組み込みコマンドを追加・修正するための実装を支援します。コマンドの振り分け、入出力の接続、終了状態や中断処理の扱いを案内します。

• Crushに独自コマンドを追加したいとき
• 既存の組み込みコマンドの修正
• パイプとリダイレクトへの対応

Crushのツール実行前に動くフックの作成・設定・不具合調査を支援します。呼び出しの拒否や自動承認、入力の書き換え、補足情報の追加を目的に合わせて案内します。

• 破壊的なシェルコマンドの拒否
• 読み取り専用ツールの自動承認
• 編集時の注意事項を追加したいとき

Crushの設定ファイルを作成・調整し、使うAIモデルや外部ツールとの接続、実行権限を整えます。設定の優先順位を踏まえ、表示やスキルの読み込み方も変更できます。

• AIの提供元とモデルの設定
• MCPや言語サーバーの接続
• 実行権限とフックの設定

繰り返し学んだ作業上の決まりを、Claudeの自動メモリから継続的に適用する指示へ整理。適用範囲に合うルールファイルへの移行と、元の記録の整理を支援します。

• 繰り返す修正をルール化したいとき
• パッケージ管理の決まりを記録
• API規約を対象パスに適用

繰り返し使う作業手順やデバッグで得た解決策を、SKILL.mdと説明文書、必要に応じた実例にまとめ、別のプロジェクトでも再利用できる形にするスキル。

• デバッグの解決策を再利用したいとき
• 定型手順を別のプロジェクトへ持ち出したいとき
• 保存済みの知見を手順書にしたいとき

文章で書いたアプリの仕様や要件から、動作するプロジェクトのひな形を作ります。機能の実装に加え、テスト、設定ファイル、導入手順までまとめて生成します。

• 要件書から開発のひな形を作りたいとき
• FastAPIとSQLiteでのタスクAPI作成
• Next.jsでのレシピ共有サイト作成

サブスクリプション型Webサービスの開発に向け、Next.jsを使った認証・データベース・課金・ダッシュボードを備えるひな形を生成します。

• サブスクリプション型Webサービスの立ち上げ
• 認証と課金をまとめて設定したいとき
• ダッシュボードと料金ページの作成

プルリクエストの差分から変更の影響範囲、安全性、テスト、互換性、性能を点検します。問題を重要度別に整理し、修正案を添えたレビューレポートを作成します。

• 共有ライブラリやAPIのマージ前確認
• 大規模PRのレビュー整理
• 認証・決済コードの変更確認

自然文の要件からSQLを作り、遅いクエリの分析、テーブル構造の文書化、変更と巻き戻しの手順作成、ORMとの連携まで日常のデータベース開発を支援するスキル。

• 集計や検索のSQLを書きたいとき
• 遅いクエリや大量の問い合わせの調査
• 構造変更と巻き戻しを計画したいとき

既存APIのOpenAPI仕様から、AIエージェントが使うMCPサーバーのひな形を作ります。PythonとTypeScriptに対応し、ツール定義の検証や互換性の確認も支援します。

• 既存REST APIをエージェントにつなぎたいとき
• MCPサーバーのひな形を作りたいとき
• 結合テスト前にツール定義を検証したいとき