ff-dev-toolkit 1.0 実践ガイド
- 公開
- 読了時間
- 6分で読めます


Claude Codeにff-dev-toolkitを導入し、小さな変更をIssueに起こしてPRで閉じるまでの手順を解説します。受け入れ条件の書き方、マージ後に残す記録、フックに止められたときの読み方を一つの例でたどります。
READMEにテストの実行手順を1行足すとします。変更は小さくても、何をもって完了とするかは先に決められます。たとえば「初めてリポジトリを開く開発者が、READMEを見て、どのディレクトリからテストを実行するか分かる」です。この条件をIssueに書いておけば、PRでも同じ基準で変更を確認できます。
この記事では、Claude Code用の開発支援プラグイン ff-dev-toolkit 1.x を入れ、このREADME修正を題材に、Issueの作成からPRのマージ後までをたどります。2026年11月11日に公開版 v1.2.0 で、導入・更新コマンド、各スキルの起動、フックの応答を確認しました。以下のREADME修正は手順を説明するための例です。
Claude Codeに導入する
Claude Codeを使えるターミナルで、公開マーケットプレイスを登録してからプラグインを入れます。
claude plugin marketplace add feel-flow/ff-dev-toolkit
claude plugin install ff-dev-toolkit@ff-dev-toolkit
すでにこのマーケットプレイスから導入済みなら、登録済みマーケットプレイスの情報を取り直し、プラグイン本体を更新します。
claude plugin marketplace update
claude plugin update ff-dev-toolkit@ff-dev-toolkit
インストール・更新後はClaude Codeを終了し、作業対象のリポジトリで起動して新しい会話を始めます。既存の会話を再開すると、更新前のプラグインを読み込んだ状態に戻ることがあります。ターミナルで claude plugin list を実行すると、登録ID、バージョン、有効状態を確認できます。検証環境では ff-dev-toolkit@ff-dev-toolkit が Version: 1.2.0、enabled と表示されました。
以下では、GitHubのIssueとPRを使うリポジトリを想定します。認証済みの gh CLI と jq を用意してください。create-issue が参照する最小の文書は docs/ 配下の MASTER.md、PROJECT.md、ARCHITECTURE.md です。まだ文書の土台がなければ、Claude Codeで /ff-dev-toolkit:init-docs を使って初期化し、プロジェクトに合わせて内容を整えます。テスト・レビュー・マージの手順は、対象リポジトリで合意したルールに従います。
マージ後にACEへ記録するところまで試すなら、/ff-dev-toolkit:ace-setup でPlaybookを用意します。ACEの検査には、Node.jsと tsx などのTypeScript実行環境も必要です。
Issueを作って、同じ受け入れ条件でPRを確認する
スキルの起動名は、Claude Codeの会話欄に入力します。たとえば最初の依頼は「/ff-dev-toolkit:create-issue 初めてリポジトリを開く開発者向けに、READMEへテストの実行ディレクトリとコマンドを追記したい」です。
1. Issueに完了条件を置く
/ff-dev-toolkit:create-issue は、依頼の目的や範囲、受け入れ条件を整理してGitHub Issueの作成を支援します。例では「READMEに実行ディレクトリとコマンドが書かれ、そのディレクトリでコマンドが通る」を条件にします。先に条件が決まれば、レビューで確認することが具体的になります。
2. 実装し、コミット前に変更を確認する
リポジトリの手順に沿ってIssueに対応する作業ブランチを作り、READMEを修正します。書いた手順を実際にたどってテストを実行し、その結果を記録します。
変更を git add でステージし、コミットの前に /ff-dev-toolkit:pre-commit-check を呼びます。プロジェクトのルールと差分を照らし合わせ、該当する検査や未確認の項目を確認します。今回なら、記載したコマンドが実際の構成に合っているか、README以外に不要な変更が混ざっていないかを見ます。
3. PRを作り、マージ直前にIssueと突き合わせる
コミットをpushし、変更の概要とテスト結果を添えてPRを作ります。PR本文には、どのIssueを照合するかを Closes #123 または Refs #123 の形で書きます。
Closes #123は、マージ前にすべての受け入れ条件を確認でき、GitHubの既定ブランチへのマージと連動してIssueを閉じる場合に使います。Refs #123は、既定ブランチ以外にマージする場合や、本番での動作確認などマージ後に確かめる条件がある場合に使います。マージ後に何を確認すればIssueを閉じられるかもPR本文に書きます。
リポジトリで定めたレビューと検証を済ませたら、/ff-dev-toolkit:close-issue にPR番号を渡します。このスキルは、Issueの受け入れ条件を照合し、確認できた条件にチェックを付け、完了報告とマージ直前の確認を進めます。
マージ操作はリポジトリ所定の手順で行います。Refs #123 でIssueを開いておく場合は、close-issue が検査したマージコミットの件名と本文をそのまま使います。マージ後はGitHubでIssueの状態を確認し、すべての受け入れ条件を満たした時点で、開いているIssueを手動で閉じます。
4. マージ後にブランチを片付け、次に使える知見を残す
/ff-dev-toolkit:merge-cleanupにマージ済みのPR番号を渡します。ベースブランチへの復帰や、作業ブランチ・worktreeの片付けを安全条件に沿って進めます。/ff-dev-toolkit:ace-curateに同じPR番号を渡します。次の変更にも使えるプロジェクトの知見があれば、根拠とともにACE Playbookへ残します。たとえば、テストを動かすディレクトリを誤りやすい構成なら、どこから実行するかを再利用できる形で記録します。/ff-dev-toolkit:retrospectiveで作業の進め方を振り返ります。手順の確認を後回しにしてやり直した、などの観測を台帳に残し、繰り返す問題を改善候補にします。
フックに止められたら、末尾の3行を読む
Claude CodeがBashツールで rg README を実行しようとした例です。検索パスがないと、端末につながっていない標準入力を待つことがあるため、ff-dev-toolkitのガードが実行前に止めます。v1.2.0のフックにこの呼び出しを入力して、停止文の末尾を確認しました。
止めた層: ガード
止めた規則: rg-stdin(tests/lib/rg-stdin-scan.sh)— 検索パスの無い rg が標準入力を待ち続ける形を検出した
次の一手: rg に検索パスを明示する(rg README .)か標準入力を閉じる(rg README </dev/null)。意図した形ならコマンドの先頭へ FF_RG_STDIN_ACK=1 を付けて再実行する
「止めた層」でどこで止まったか、「止めた規則」で何を検出したか、「次の一手」で直し方を確認します。作業ディレクトリを検索したいなら、表示された rg README . で検索先を明示できます。
フックの動作を変更する設定には、効く範囲が異なる2種類があります。
- セッションを通して止める。
FF_DEV_TOOLKIT_SKIP=<鍵>をClaude Codeの環境設定などに置きます。たとえばFF_DEV_TOOLKIT_SKIP=update-checkは、その設定を読み込んだセッションの更新通知を止めます。複数の鍵はカンマ区切りです。 - 対象の呼び出しを1回だけ通す。意図した操作だと確認できた場合に、停止文が示す
FF_<鍵>_ACK=1を案内された位置に指定します。rg-stdinの例ではFF_RG_STDIN_ACK=1を対象コマンドの先頭に置きます。ACKの変数名・置き場所と、SKIPで指定できる鍵はREADMEの一覧で確認できます。
関連記事
参考資料
この記事は、次の一次情報に基づいています。数値や記述の詳細は各資料をご確認ください。
参考資料 5 件を表示参考資料を閉じる
- ff-dev-toolkit v1.2.0 README株式会社フィールフロウgithub.com確認
- ff-dev-toolkit v1.2.0 変更履歴株式会社フィールフロウgithub.com確認
- ff-dev-toolkit v1.2.0 公開面の仕様株式会社フィールフロウgithub.com確認
- Claude Code プラグインのインストールと管理Anthropiccode.claude.com確認
- プルリクエストをIssueにリンクするGitHubdocs.github.com確認
この記事を引用する
岡崎 太「ff-dev-toolkit 1.0 実践ガイド」株式会社フィールフロウ、2026年11月11日、https://feelflow.net/blog/2026-11-ff-dev-toolkit-tutorial/

この記事を書いた人
岡崎 太
CTO / AIアーキテクト







