185
205

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Claude Codeで開発を自動化するSkills 5選

185
Posted at

「Claude Codeを使い始めたけど、毎回同じような指示をプロンプトに書いている気がする…」と感じていませんか?

Claude Codeは素のままでも強力ですが、Skillsを使うことで繰り返しの作業を自動化し、開発のルーティンをまるごとコマンド一発に変えることができます。この記事では、開発の自動化に特に役立つSkills 5選を、具体的な使いどころとともに紹介します。

「毎回同じプロンプトを書くのが面倒」「チームの開発フローを統一したい」と感じているエンジニアに、特に読んでほしい内容です。


結論:Skillsは「賢いマクロ」ではなく「文脈を持った自動化」

一般的なマクロやシェルスクリプトは、決められた手順を機械的に繰り返すだけです。でも Claude Code の Skills は違います。プロジェクトのコンテキストを理解した上で、状況に応じた判断をしながら自動化を実行してくれます。

従来の自動化 Skills による自動化
手順が固定されている 状況を読んで柔軟に対応する
コードの中身を見ない コードベースを理解して動く
エラーが出たら止まる エラーの原因を判断して対処する
設定ファイルが必要 SKILL.md に自然言語で書くだけ

一度 Skill を作ってしまえば、チーム全員が同じ品質で同じフローを実行できます。これが Skills の本質的な価値だと私は感じています。


エンジニアなら読むべき本を30冊以上紹介しています。
正直、私の仕事のやり方をガラッと変えた神本やSQLのチューニングに悩んだ時にめちゃくちゃ役に立ったもあります👇
→記事を読む


開発の自動化に役立つ Skills 5選

1. pr-summary:プルリクエストの説明文を自動生成する

毎回 PR の説明を一から書くのが地味に時間がかかる、あの悩みを解決するSkill。

Claude Code の公式ドキュメントで紹介されているこの Skill は、GitHub CLI を使ってライブの PR データを取得し、変更内容・コメント・差分ファイルをもとに PR サマリーを自動で生成します。

# SKILL.md の例
---
name: pr-summary
description: プルリクエストの変更内容を要約する
context: fork
allowed-tools: Bash(gh *)
---

## Pull request context
- PR diff: !`gh pr diff`
- PR comments: !`gh pr view --comments`
- Changed files: !`gh pr diff --name-only`

## タスク
このプルリクエストを要約してください。変更の目的・影響範囲・レビュアーが注意すべき点を含めること。

使いどころ:

シーン 効果
毎日の PR 作成 説明文の作成時間をほぼゼロに
大規模リファクタリング 変更の全体像を自動で整理
新メンバーのオンボーディング PR の書き方を Skill が手本を示す

! 構文でシェルコマンドを事前実行し、その出力を Claude に渡せるのがこの Skill の肝です。Claude は「説明してくれ」と言われるのではなく、実際のコードの差分を見た上でサマリーを生成するので、精度が高くなります。


2. fix-issue:GitHub Issue 番号を渡すだけで修正まで自動実行

Issue を開いてコードを追って修正して PR を出す——この一連の流れをコマンド一発にするSkill。

---
name: fix-issue
description: GitHub Issue を修正する
disable-model-invocation: true
---

GitHub Issue $ARGUMENTS を修正してください。

1. Issue の内容を gh コマンドで取得する
2. 関連するコードを特定する
3. 修正を実装する
4. テストが通ることを確認する
5. 変更をコミットする

呼び出しは /fix-issue 1234 のように Issue 番号を渡すだけです。$ARGUMENTS プレースホルダーがその番号に置き換わります。

実際の自動化の流れ:

/fix-issue 1234
↓
Claude が Issue #1234 を gh コマンドで取得
↓
関連ファイルを特定・修正
↓
テストを実行して確認
↓
コミットまで完了

私はこの Skill を使い始めてから、軽微なバグ修正にかける時間が体感で半分以下になりました。特に「内容は理解できるけど修正が単純作業」な Issue との相性が抜群です。


3. deep-research:コードベースをフォークエージェントで深く調査する

「このバグの根本原因はどこだ」「この設計はなぜこうなっているのか」を自律的に調べてくれるSkill。

---
name: deep-research
description: トピックを徹底的に調査する
context: fork
agent: Explore
---

$ARGUMENTS について徹底的に調査してください:

1. 関連するすべてのファイルを特定する
2. 依存関係とデータフローを追う
3. 潜在的な問題点や改善余地を洗い出す
4. 調査結果をまとめたレポートを作成する

context: fork を指定することで、現在の会話履歴から独立した専用のサブエージェントとして動作します。長い調査が現在の会話を汚染しません。

使いどころ:

シーン 具体的な指示例
障害調査 /deep-research 決済処理でタイムアウトが発生する原因
設計理解 /deep-research 認証モジュールのアーキテクチャ
技術的負債の棚卸し /deep-research 非推奨APIの使用箇所

既存コードを引き継いだときや、大規模なリファクタリングの前調査として特に効果を発揮します。


4. commit:ステージング〜コミットを承認なしで自動実行

「git add して git commit して…」を毎回やるのが面倒な人向けの Skill。

---
name: commit
description: 現在の変更をステージングしてコミットする
disable-model-invocation: true
allowed-tools: Bash(git add *) Bash(git commit *) Bash(git status *)
---

現在の変更をステージングして、変更内容を説明するコミットメッセージを生成してコミットしてください。
Conventional Commits の形式(feat/fix/refactor/docs など)を使うこと。

allowed-tools に git コマンドを明示することで、このSkill が有効な間は git 操作を都度承認なしで実行できます。

コミットメッセージ自動生成の例:

# Claude が生成するコミットメッセージの例
feat(auth): JWTトークンの有効期限を設定可能にする

- 環境変数 JWT_EXPIRES_IN で有効期限を設定できるように変更
- デフォルト値を24hに設定
- テストケースを追加

変更内容を見て適切な prefix を選んでくれるので、チームのコミット規約を自然に守れます。


5. explain-code:コードの説明をビジュアル図解付きで自動生成

「このコード、何をやっているか説明して」を構造化されたドキュメントとして出力するSkill。

---
name: explain-code
description: コードをビジュアル図解と類推を使って説明する
---

指定されたコードを以下の形式で説明してください:

1. 一言で何をするコードか
2. 処理の流れを図解(Mermaid 記法)
3. 複雑な部分を日常的な例えで説明
4. 潜在的な改善点

自動化の観点では、以下のシーンで特に役立ちます:

シーン 効果
コードレビュー準備 PR に図解付きの説明を自動添付
新メンバーの技術共有 複雑なモジュールの解説資料を即生成
技術ドキュメント整備 コメントのないレガシーコードの文書化

このSkill は「コードが動くかどうか」ではなく「チームがコードを理解できるか」という観点の自動化です。ドキュメントのメンテナンスコストを大幅に下げられます。


5つの Skills 早見表

# Skill 名 自動化する作業 呼び出し例
1 pr-summary PR の説明文生成 /pr-summary
2 fix-issue Issue の調査〜修正〜コミット /fix-issue 1234
3 deep-research コードベースの深掘り調査 /deep-research 認証モジュールの構造
4 commit ステージング〜コミット /commit
5 explain-code コード解説ドキュメント生成 /explain-code

Skills をチームに導入するときのコツ

Skillsの自動化は個人で使っても便利ですが、チームで共有するときに本当の価値が出ます

プロジェクトルートの .claude/skills/ に置けばリポジトリで管理でき、チーム全員が同じ Skill を使えます。「このプロジェクトの PR はこのフォーマットで書く」「コミットメッセージはこの規約で」という暗黙のルールを、Skill というかたちで明文化・自動化できるのが最大のメリットです。

your-project/
├── .claude/
│   └── skills/
│       ├── pr-summary/
│       │   └── SKILL.md
│       ├── fix-issue/
│       │   └── SKILL.md
│       └── commit/
│           └── SKILL.md
├── src/
└── ...

まずは自分がよく繰り返している作業を1つ Skill にしてみてください。「あ、これも Skill にできる」という発見が連鎖していくはずです。


エンジニアなら読むべき本を30冊以上紹介しています。
正直、私の仕事のやり方をガラッと変えた神本やSQLのチューニングに悩んだ時にめちゃくちゃ役に立ったもあります👇
→記事を読む

185
205
2

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
185
205

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?