長時間の AI コーディングでも、変更範囲・検証上限・現在の進捗をセッションをまたいで保持します。
English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Español · Français · Deutsch · Português (Brasil)
## Dev Flow でできること Dev Flow は、Codex、DeepSeek、Claude Code、ZCode で長時間の AI コーディング作業を管理するためのツールです。 合意した要件、ファイル範囲、検証計画、進捗、結果をローカルに保存し、セッションが終わっても作業を続けられます。 - **変更範囲を明確にする：** 変更予定のファイルを記録し、実際の変更を計画と照合します。 - **検証を計画する：** 作業に必要な確認を選び、検証量に上限を設けます。 - **作業を再開する：** 元の作業ディレクトリに戻り、同じタスクの残りの作業を続けます。 - **結果を確認する：** 進捗、検証結果、対応が必要な問題を確認できます。 複数のセッションにまたがる作業や、ファイル範囲とテスト量を明確にしたいリポジトリ作業に向いています。 一度きりの質問、コードの説明、進捗保存が不要な小さな変更は、Codex、DeepSeek、Claude Code、ZCode を直接使う方が簡単です。 ## クイックスタート > Node.js `>=24` と利用する Host を先にインストールしてください。必要なバージョンと検証済み環境は[サポート表](docs/SUPPORT-MATRIX_en.md)を参照してください。 ### 1. Dev Flow をインストールする 以下の公開パッケージは、公開済みの Codex と DeepSeek の連携用です。Claude Code は[ソースからのインストール手順](docs/CLAUDE_en.md)を利用してください。従来の公開 CLI では、ソース版のみの Adapter はインストールされません。 ZCode も[ソースからのインストール手順](docs/ZCODE_en.md)を利用します。対象は Windows x64 と macOS arm64 で、macOS 上の ZCode の実機検証は今後行います。 ```sh npm install -g @imotong/dev-flow@latest dev-flow ``` 利用するインストーラーの選択肢から対応する Host を選びます。Codex は `/hooks` で Dev Flow hook を確認して信頼し、DeepSeek は選択した Profile を再起動します。Claude Code はプラグインを再読み込みするか新しい会話を開始し、権限の案内を確認してください。 ZCode では Settings → Plugins でプラグインをインストールして有効にし、新しい会話を開始して Hook を反映させます。ローカルの準備完了だけでは、ZCode がプラグインを読み込んだことは確認できません。 ### 2. 作業を開始する 対応するインストールを完了してから、Host の会話に次のいずれかを送信してください。 **Codex** ```text $dev-flow-codex:dev-flow ログイン失敗のレート制限を追加してください。認証関連のファイルだけを変更し、対象を絞った確認を最大 4 件実行してください。 ``` **DeepSeek Harness** ```text /dev-flow ログイン失敗のレート制限を追加してください。認証関連のファイルだけを変更し、対象を絞った確認を最大 4 件実行してください。 ``` **Claude Code** ```text /dev-flow-claude:dev-flow ログイン失敗のレート制限を追加してください。認証関連のファイルだけを変更し、対象を絞った確認を最大 4 件実行してください。 ``` **ZCode** 入力欄の `/` → Skills から `dev-flow` を選択し、タスクを説明してください。 ```text Dev Flow を使ってログイン失敗のレート制限を追加してください。認証関連のファイルだけを変更し、対象を絞った確認を最大 4 件実行してください。 ``` これらはターミナルではなく会話に送信します。目標、受け入れ条件、ファイル範囲、テスト上限を具体的に記載してください。 最初の応答では依頼を評価し、直接作業するか Dev Flow を使うかを尋ねます。Dev Flow を選ぶと、 既定では現在のディレクトリで現在の HEAD から新しいタスクブランチを作成します。新しいブランチと、 既存の未コミット変更をタスクに含めるかを確認します。依存関係、ローカル設定、ファイル、ステージ状態を 維持し、すべての対象ディレクトリにアクセスできる場合は同じセッションで続行します。 現在のブランチをそのまま使うか、専用の Git 作業ツリーを作成することも明示的に選べます。専用作業ツリーでは ローカルまたはリモートのソースと開始ブランチも指定します。Codex は宿主が対応していれば新しいディレクトリを 開き、DeepSeek と Claude Code は必要な再起動コマンドを案内します。 同じディレクトリで実行できる Task は一つです。手動や他のツールによる変更も確認対象となり、タスク中の ブランチ切り替えは進行を一時停止します。完了後もローカルのディレクトリとブランチを残します。次のタスクを 開始する際には、残っている未コミット変更の扱いを確認します。 実装前に、要件、設計、作業項目、変更予定のファイル、検証計画を確認して話し合います。計画全体への明確な承認後に開発を開始します。計画の修正やファイル範囲の拡大には再承認が必要です。Dev Flow やワークツリーの選択は計画の承認とは別です。 ### 3. 再開して進捗を確認する セッションを再起動したら、タスクの元の作業ディレクトリに戻り、続行を明示的に依頼してください。Dev Flow は保存済みの 進捗から再開します。元の作業ディレクトリが消失または置換された場合、復元するかタスクの放棄を明示するまで停止します。 DeepSeek Harness では、再開を依頼するメッセージにも `/dev-flow` を含めてください。 Claude では元の作業ディレクトリと会話を開き、`/dev-flow-claude:dev-flow` で保存済みタスクの再開を明示してください。 ZCode では元の作業ディレクトリを開き、Dev Flow Skill を選択して保存済みタスクの再開を依頼します。新しいディレクトリを準備した場合は、返されたワークスペースの開き方に従ってください。 以下はインストール済みのグローバル管理コマンドです。ソース版では、ガイドに記載された対応する入口を使ってください。 ```bash # インストール済みの連携を確認 dev-flow status --host all # ローカルのタスク画面を開く dev-flow webui start ``` 非対話形式のインストール、独自の DSH Profile、更新、修復、削除については [コマンドリファレンス](docs/COMMANDS_en.md)を参照してください。 ## デスクトップペット ペットには、設定済みの Adapter とインストール済みのデスクトップアプリが必要です。Adapter だけをインストールしても、デスクトップアプリは入りません。 デスクトップペットは複数のタスクを重ねた吹き出しで表示し、それぞれの WebUI を開けます。ブロック中のタスクを優先し、完了後は別の未完了タスクに自動で切り替わります。特定のタスクを固定することもできます。外観の変更、アニメーションの制御、サイズ変更、個別の起動と停止に対応しています。 ```bash dev-flow pet start dev-flow pet stop ``` デスクトップアプリの対象は macOS arm64 と Windows 10/11 x64 です。インストールと操作は [ペットガイド](docs/DESKTOP-PETS_en.md)、検証済みの利用範囲は[サポート一覧](docs/SUPPORT-MATRIX_en.md)を参照してください。 ## 利用上の制限 専用の作業ツリーはコードの変更を分離します。プロセス、ネットワーク、認証情報、外部サービスは現在の環境と共有されます。 タスクが完了しても、コードのコミット、プッシュ、作業ツリーの削除は自動では実行されません。これらには別途許可が必要です。 ## ドキュメント - **使い方：** [Codex](docs/CODEX_en.md) · [DeepSeek](docs/DEEPSEEK_en.md) · [Claude Code](docs/CLAUDE_en.md) · [ZCode](docs/ZCODE_en.md) · [コマンド](docs/COMMANDS_en.md) · [Control Center](docs/WEBUI_en.md) - **プロジェクト：** [製品定義](docs/PRODUCT_en.md) · [サポート一覧](docs/SUPPORT-MATRIX_en.md) · [セキュリティ](SECURITY.md) - **開発と貢献：** [ドキュメント一覧](MANIFEST_en.md) · [貢献ガイド](CONTRIBUTING.md) ## ライセンス [Apache License 2.0](LICENSE)