カスタムスキルで開発ワークフローを自動化する

はじめに

Claude Codeには「カスタムスキル」という拡張機能があります。スラッシュコマンド（/skill-name）として呼び出せる再利用可能なプロンプトテンプレートで、日常の開発作業を効率化できます。

本記事では、実際のプロダクト開発で構築・運用しているカスタムスキルを紹介します。

カスタムスキルの基本

Claude Codeのカスタムスキルは、.claude/skills/<skill-name>/SKILL.md にMarkdownで定義します。

.claude/
  skills/
    commit-push/
      SKILL.md
    review-pr/
      SKILL.md
    watch-deploy/
      SKILL.md

/commit-push のようにスラッシュコマンドとして呼び出せます。単なるエイリアスではなく、プロンプト内で分岐やツール連携を定義できるため、複雑なワークフローも自動化できます。

実際に使っているスキル

1. /commit-push — コミット＆プッシュの自動化

最も使用頻度の高いスキルです。変更内容を分析してコミットメッセージを自動生成、ステージングからプッシュまでを一気に実行します。

主な機能：

• git diff からコミットメッセージを自動生成
• プロジェクトのprefix規約（feat:, fix:, refactor: 等）に準拠
• lint/formatチェックを実行してからコミット
• リモートへのプッシュまで一貫実行

これだけで、毎回の「変更確認→メッセージ作成→add→commit→push」という流れが1コマンドで完結します。地味ですが、1日に何十回も行う操作なので、累積の効果は大きいです。

2. /watch-deploy — デプロイ監視

PRマージ後のデプロイ状況を監視するスキルです。

# /watch-deploy

## 処理
1. GitHub Actionsのワークフロー実行状況を確認
2. Heroku/Vercelのデプロイステータスを確認
3. 成功/失敗を報告
4. 失敗時はログから原因を特定

Claude Codeの /loop と組み合わせて /loop 1m /watch-deploy のように使うと、1分間隔で自動監視し、完了時に通知されます。デプロイ待ちの間に別の作業に集中できるので、特に並行開発時に重宝します。

3. /codex — OpenAI Codexによるセカンドオピニオン

Claude CodeからOpenAIのCodex MCPを呼び出し、別のAIの見解を得るスキルです。

使い所：

• 設計判断に迷ったときのセカンドオピニオン
• Claudeの回答に確信が持てないときのクロスチェック
• 異なるアプローチの提案を求めるとき

AIエージェントを併用することで、単一のAIのバイアスに引きずられるリスクを減らせます。MCPサーバー経由でシームレスに連携できるのがポイントです。

4. /tdd — テスト駆動開発

Issue番号を渡すと、Red→Green→Refactorのサイクルを自動で回すスキルです。

# /tdd

## Red Phase
- Issueの要件からテストケースを設計
- Jest/Playwrightでテストを作成
- テストが失敗することを確認

## Green Phase
- テストが通る最小限の実装

## Refactor Phase
- コードの整理
- テストが引き続き通ることを確認

このスキルの価値は、AIにTDDの規律を強制できることです。プロンプトなしだとAIは実装を先に書きがちですが、スキルで「まずテスト」を強制できます。

5. /review-pr — PRレビュー

PR番号を渡すと、変更内容を分析してレビューコメントを投稿するスキルです。

主な機能：

• PRのdiffを読み取り、コードの問題点を指摘
• セキュリティ・パフォーマンス・保守性の観点でレビュー
• GitHub API経由でコメントを直接投稿

チーム開発でレビュアーの確保が難しい場合や、マージ前のセルフチェックとして活用しています。

6. /check — CIステータス確認

PRのCIチェック状況を確認するシンプルなスキルです。

# /check

## 処理
1. 現在のPRのCIステータスを取得
2. 失敗しているジョブがあればログを確認
3. 修正が必要な場合は原因を報告

/watch-deploy がマージ後の監視なのに対し、/check はマージ前のCI確認用です。役割を明確に分けることで、それぞれのプロンプトをシンプルに保てます。

スキル設計のポイント

単一責任にする

1つのスキルに1つの責務。/commit-push はコミットとプッシュ、/check はCI確認、/watch-deploy はデプロイ監視。機能を詰め込みたくなりますが、分けたほうが結果的に使いやすくなります。

既存ツールと連携する

スキルの中で gh CLI、git、MCPサーバーなどの既存ツールを活用します。/codex がMCP経由でCodexを呼ぶように、スキルは既存のツールをつなぐ糊の役割を果たします。

よく使うものから作る

スキル化すべきは「毎日何十回も繰り返す操作」です。派手なスキルよりも、地味で頻度の高い作業を自動化するほうが効果的です。

生産性への効果

実際の開発プロジェクト（約2ヶ月間）で、これらのスキルを活用した結果、95件のPRを作成・マージしました。コミット・デプロイ監視・レビュー・CI確認といった周辺作業をスキルに任せることで、実装と設計に集中できる環境を作れます。

まとめ

カスタムスキルのポイントは「派手なものを作る」ことではなく、毎日の地味な繰り返しを消すことです。まずは自分が最も頻繁に行う操作を観察し、そこから1つスキル化してみてください。