ff-dev-toolkit 1.0.0を公開、互換性の対象と更新手順を案内

株式会社フィールフロウは2026年11月10日、Claude Codeなどで使えるオープンソースの開発支援プラグイン ff-dev-toolkit 1.0.0 を公開しました。1.0.0から、互換性の契約を破る変更がある場合はメジャーバージョンを上げます。

互換性を約束する対象

配布物に同梱する PUBLIC-SURFACE.md に、導入先が依存できる「契約」と実装詳細にあたる「内部」を記載しています。契約には次の要素が含まれます。 公開面の仕様

• スキルの起動名
• フックの登録された起動条件と入口
• 導入先に配置されるファイルやディレクトリのうち、契約として明記したパス
• FF_* 環境変数のうち、公開文書に記載され、配布物が読み取るもの
• FF_ で始まらない環境変数のうち、契約として明記したもの

契約の要素を削除・改名したり、その意味を変えたりする場合は、破壊的変更としてCHANGELOGに記録します。契約の要素を削除するときは、少なくとも1つ前のマイナー版のCHANGELOGで次のメジャー版での削除を予告し、予告した版では旧名を引き続き受け付けます。 v1.0.0の変更履歴

0.xから更新する場合

同日に公開した v1.1.0 では、1.0.0より前に契約から外れた旧設定名の受付を終了しました。0.xで設定を変更していた場合は、更新前にClaude Codeの設定、シェルの設定、CIの環境変数を確認してください。 v1.1.0のリリースノート

• 継続して処理を止める旧宣言は FF_DEV_TOOLKIT_SKIP=<鍵> に移行します。たとえば、更新通知を止める FF_DEV_TOOLKIT_SKIP_UPDATE_CHECK=1 は FF_DEV_TOOLKIT_SKIP=update-check に置き換えます。複数の鍵はカンマで区切ります。
• 1回だけ通す承認は、対象の FF_<鍵>_ACK=1 を使います。対応する変数名と鍵は、READMEの一覧を確認してください。 設定の一覧

自動更新や記録に関わる4つの処理（auto-update、codex-auto-update、effort-metrics、decision-tree）は、対応する旧設定名に空でない値が残っている間、停止を維持します。 v1.1.0の変更履歴

公開マーケットプレイスから ff-dev-toolkit の名前で導入済みの場合は、次のコマンドを順に実行し、Claude Codeを再起動してください。 更新手順

claude plugin marketplace update
claude plugin update ff-dev-toolkit@ff-dev-toolkit

改名前の dev-toolkit のまま使っている場合は、READMEの手順に沿って再インストールしてください。 インストール手順

関連リンク

• v1.0.0のリリースノート
• ff-dev-toolkitのGitHubリポジトリ
• 2026年7月のオープンソース公開のお知らせ