この記事は「コーディングエージェント勉強会 #4」の内容を一部解説しています。 実際の画面操作・デモ映像を含む動画はYoutubeチャンネルよりオンデマンドで視聴できます👀
この記事でわかること
-
Claude Codeでワークフローを毎回ゼロから作ってしまう根本的な原因
-
コンテキストエンジニアリング（CE）の定義と、チーム開発で重要な理由
-
Claude Code Workflow Kitsの概要と3つのスキルの使い方
-
/bootstrap-documents でプロジェクト基盤を自動生成する方法
-
/create-workflow で独自ワークフローを作成する方法
-
「80点を一気に作って運用で磨く」という品質管理の考え方
よくある悩み：「Claude Codeで自動化したいのに、毎回ワークフローをゼロから作っている」
Claude Codeを使い始めると、多くのチームがこんな壁にぶつかります。
「チームのメンバーによって、ワークフローの品質がバラバラになってしまう」
この原因は、ワークフローの設計が属人化しているからです。コンテキストエンジニアリングの概念を理解していても、実際に書き起こすには時間がかかり、チームで統一するのはさらに難しい。
本記事では、こうした課題を解決する Claude Code Workflow Kits の考え方と使い方を解説します。
課題の根本：ワークフロー手作業組み立ての3つのボトルネック
① 作業時間が長い
1つの精度の高いワークフローを組むのに、最低でも数時間〜半日かかることが多いです。どのサブエージェントを使うか、それぞれにどんなスキルを持たせるか、どう組み合わせるか——これらすべてを設計するだけでも大変な作業です。
② 品質のばらつき
チームで開発をしていると、同じ目的のワークフローを作っても、作った人によって構造もフォーマットも異なります。後からメンテナンスしようとすると複雑に絡み合って誰も全体像を把握できない状態になってしまいます。
③ 再現性がない
AさんのワークフローがBさんに引き継がれた時、構造が違いすぎて使えない——あるいは似たようなワークフローをそれぞれが作ってしまって無駄が発生する。こういったことが頻繁に起きます。
解決策：コンテキストエンジニアリングを「共通スキル」にする
コンテキストエンジニアリング（CE）とは何か
コンテキストエンジニアリング（CE）とは、「どの情報を、どこに、どのような形で配置すれば、エージェントが最大限の性能を発揮できるか」を体系的に設計する手法です。
エージェントとコンテキストの関係を意識的に設計するこのアプローチがないと、Claude Codeでは以下の問題が起きます。
-
同じ指示を毎回繰り返すことになる
-
作業が長引くにつれて精度が落ちてくる
-
サブエージェントを使っても、守るべきルールや方向性がばらばらになる
-
プロジェクト固有の文脈が考慮されず、意図と違うことをやり始める
CEを実践するためには、CLAUDE.md・スキルファイル・ドキュメント・中間成果物など、それぞれの置き場所に何をどう書くべきかを体系的に理解する必要があります。
「設計のルールブック」としてスキル化する
CEの概念をスキルとして定義することで、誰がワークフローを作っても同じ原則に従った品質が保たれます。
Claude Code Workflow Kitsとは
Claude Code Workflow Kitsは、Claude Codeのプラグインとして提供されるワークフロー開発キットです。 ワークフロー作成にかかる時間・品質のばらつき・再現性のなさという3つのボトルネックを解消するために開発されました。
コアとなるのは以下の3つのスキルです。
スキル① /context-engineering（コンテキストエンジニアリングスキル）
CEの概念をすべてまとめたチーム全員が共通で使う設計のルールブックです。他のワークフローはすべてこのスキルを参照しながら動作します。これにより、どんなワークフローを作成しても、CE原則から外れることを防ぎます。
スキル② /bootstrap-documents（ブートストラップドキュメントスキル）
対話形式で、プロジェクトの基礎ドキュメント一式を自動生成するスキルです。
生成されるドキュメントは以下のとおりです。
-
CLAUDE.md（プロジェクトの共通基盤）
-
README.md
-
コンテキストエンジニアリングを維持するための各種ファイル
既存のファイルがある場合は自動で検出し、「どう修正するか」を確認しながら作業してくれます。新規プロジェクトでも既存プロジェクトの整備にも使えます。
スキル③ /create-workflow（クリエイトワークフロースキル）
対話形式で、自分だけのワークフローを自動生成するメタワークフローです。
使い方はシンプルです。スキルを呼び出す際に「目的・想定ステップ・サブエージェントのイメージ」をプロンプトとして入力するだけ。エージェントが足りない情報を質問してくれて、最終的にサブエージェントとスキルファイルを一式生成してくれます。
💡 ポイント: プロンプトに何も書かずにスキルを呼び出すことも技術的には可能ですが、品質が出にくいため、ある程度具体的な記述を推奨します。
3つの重要ポイント
ポイント1：プラグインのインストール方法
Claude Codeのスラッシュコマンドから /plugins → Marketplace を開き、該当のプラグインを選択してインストールします。プラグインの内容は基本的にマークダウンやJSONなどの自然言語で書かれており、インストール後は特定のフォルダに保存されます。
プラグインによってはMCPサーバーが含まれる場合があります。セキュリティ面には十分注意してください。
ポイント2：disable_modification パラメーターの活用
スキルを作成する際に disable_modification を true にすると、エージェントがそのスキルを「ユーザーの明示的な呼び出しのみで使う」ように設定できます。
-
false（デフォルト）：エージェントが自分で判断してスキルを使い始める
-
true：ワークフロー作成スキルが勝手に自動発火しなくなる（推奨）
ポイント3：ワークフローの「育て方」
ワークフローは一発で完璧に動くことはほぼありません。サブエージェント同士の責任境界が曖昧になったり、想定しなかったエッジケースが出てきたりと、必ず問題が発生します。
今回のアプローチでは**「運用しながら育てて磨く」プロセス**を前提としています。
-
まず「80点のワークフロー」を一気に作成する
-
実際に運用しながら問題箇所を特定する
-
/context-engineering スキルを使ってエージェントに修正させる
手作業で修正すると、修正を繰り返すうちにCE原則が守られなくなり品質が下がります。スキル経由で修正することで、一貫してCE原則を守り続けられます。
活用イメージ：どんなワークフローが作れるか
/create-workflow スキルを使うと、以下のようなワークフローも自動生成できます。
-
コードレビューのワークフロー
-
リリース手順のワークフロー
-
READMEをHTMLに変換するワークフロー
-
要件定義 → 設計 → 実装 → E2Eテスト・レビューの完全自動化フロー
特にソフトウェア開発では、これらのワークフローを組み合わせることで「0から100まで完全自動化」の環境を構築することも可能です。
よくある質問（FAQ）
Q1. Claude Code Workflow KitsはSpec-kitやCC-SDDと何が違いますか？
Spec-kitはスペックコーディングという用途が決まったワークフローですが、Claude Code Workflow Kitsは「自分のプロジェクトに合わせた任意のワークフローを作るためのメタワークフロー」です。 用途が決まっていないぶん、柔軟性が高いのが特徴です。
Q2. Claude Code Workflow Kitsで作ったワークフローはどうやって改善しますか？
/context-engineering スキルをエージェントに渡して修正させます。 手作業での修正はCE原則が崩れる原因になるため推奨しません。問題箇所を特定してスキルに渡すことで、CE原則に従った修正が自動で行われます。
Q3. スキルにコンテキストを組み込む考え方を教えてください。
「うまくいった文脈設計を、再利用可能な思考フレーム・手順・テンプレートに落とす」という考え方が基本です。 以前はそのような「考え方」をコード化するにはプログラミング言語が必要でしたが、今はエージェントを使えばマインドセットや概念を直接スキル化できます。これが現在のコーディングエージェントの強みのひとつです。
まとめ
Claude Codeでワークフローをチームに展開するための考え方を整理します。
この仕組みが整えば、「個人の経験や勘に頼らず、チーム全員が同じ品質で再現できる生産ライン」 が現実になります。
動画でもっと詳しく学ぶ
本記事の元となった勉強会では、実際の画面操作を交えながら /bootstrap-documents と /create-workflow のデモを行っています。
オンデマンド配信では以下が視聴できます。
-
実際のプロジェクトへの /bootstrap-documents 適用デモ
-
READMEをHTMLに変換するワークフローの作成デモ
-
コンテキストエンジニアリングスキルを活用したワークフロー改善の流れ
次回勉強会の開催については、connpassやXなどの公式アカウントで告知します。ぜひフォローをお願いします！
アポロでは現在メンバーを積極的に募集しております。興味のある方はぜひご応募お待ちしております！