Claude Code、楽しいですよね。
スキル、コマンド、サブエージェント、フック、ルール...色々あって最初は「何から手をつければいいの?」となりがちですが、ベストプラクティスに従えば意外とシンプルに構築できます。みなさんすでにやっているかもしれませんが、私が実践している方法を共有してみます。
私のワークフロー
Step 1: ベストプラクティスをスキル化する
まず最初にやることは、Claude自身にベストプラクティスを教え込むこと。Anthropicが公開しているベストプラクティス集を読み込ませて、「スキル・コマンド・ルールの作り方を熟知したアドバイザー」としてスキル化します(公式で用意してくれればいいのに...と思いつつ)。
claude-code-advisor/
├── skill.md # プロンプト
└── SOURCES.md # 参照すべきドキュメント一覧
参照ドキュメントには以下のような公式ガイドを含めています:
| ドキュメント | 内容 |
|---|---|
| Claude 4.x Prompting BP | プロンプト設計の指針 |
| Agentic Coding BP | Claude Code全体のベストプラクティス |
| Skills Best Practices | スキル作成の詳細ガイド |
| Long-running Agents | 長時間タスクの設計パターン |
Step 2: 日々の作業をパターン化する
よく使う作業の流れや覚えておいてほしい知見をStep 1のスキルに基づいて整えてもらいます。例えば:
-
/feature- 機能追加の標準ワークフロー -
/investigate- バグ調査・修正の手順 -
/done- 作業完了・コミット・プッシュ
「こういう作業をよくやるんだけど、コマンド化して」と伝えるだけで、ベストプラクティスに沿った形で整備してくれます。
Step 3: 定期的にセルフレビューさせる
作りっぱなしだと品質が劣化していくので、Step 1のアドバイザースキルを使って既存のスキルやコマンドをレビューしてもらいます。「簡潔さ」「構造」「最新のベストプラクティスに沿っているか」といった観点でセルフレビューさせることで、品質を維持できます。
Step 4: 知識を自己更新させる
ここが一番面白いところ。参照ドキュメント一覧(SOURCES.md)を持たせておくことで:
- 「ドキュメントが更新されてないか確認して」
- 「新しいベストプラクティスが出てないか検索して」
- 「自分のスキルをレビューして改善点を提案して」
といった指示で、Claude自身が自らを更新していきます。気が向いたときに投げるだけでOKです。
まとめ
Claude Codeのカスタマイズは、難しそうに見えて実はシンプル:
- ベストプラクティスを教える → 土台ができる
- 作業をパターン化する → 日々の効率が上がる
- 定期的にレビューさせる → 品質を維持できる
- 新しい知識を取り込ませる → 最新に追随できる
このサイクルを回すだけで、Claude Codeは日々育っていきます。
みなさんはどうやっていますか?もっといい方法があれば教えてください。