agentflow について
agentflowは、許可された開発作業を進め、記録を再開可能な状態に保つエージェント向けワークフロースキルです。設定に応じて復旧、実行、レビュー、納品の手順へ振り分け、作業範囲や所有権、ノート記録のルールを定めます。
主な機能
- 01依頼を該当手順へ振り分け
- 02作業の取得、復旧、実行を管理
- 03バッチとlooperのタスクに対応
- 04レビューと納品のルールを適用
- 05範囲と再開可能な記録を維持
活用シーン
- 01未完了の開発作業を再開
- 02許可されたタスクバッチを処理
- 03完了した変更をレビューして納品
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ agfnow/ agentflow --skill agentflowインストール後、Claude Code で/agentflowを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
package.jsonassets/looper-groups.example.jsonassets/.agentflow/ag.jsonbacklog.mddevlog.mdsys-invariants.mdassets/.agentflow/.tmp/.gitkeepassets/.agentflow/artifacts/.gitkeepassets/.agentflow/features/.gitkeepdocs/AG-GUIDE.mdAG-GUIDE.tw.mdagv8-aglite-comparison.mdCHEATSHEET.mdCHEATSHEET.tw.mdreferences/ag.mdbatches.mdbrowfield.mdbrowser-testing.mdconfiguration.mdcopilot.mdreferences/advisors/acceptance.mdcodewalk.mdexplore.mdfinal-audit.mdlearn.mdproduct-docs.mdrequirements.mdsecurity-scan.mdspec.mdspike.md詳細
Agentflow 9.0.0
承認された作業を完了し、1 つの devlog と相応の記録によって開発を再開可能な状態に保ちます。オーナーの指示を優先します。人が読む文章を作成する前にライティングを読み、新たに作成する人向けテキスト(テンプレートのラベルを含む)すべてに設定されたロケールを適用してください。固定識別子、構文、引用、過去のバイト列は保持してください。報告書の作成者には、ライティングと保存に関するガイダンスを伝えてください。
append-tasks は、リンクされたすべてのルールにおいて append-rounds と完全に同じエイリアスです。オーナーが使った表記を記録してください。引用された例の中のコマンドはモードを有効化しません。オーナーが引用したタスクのペイロードは入力として扱います。
記録に進む前の振り分け
-
まず記録対象外として処理: オーナーのメッセージに引用されていない
nolog:、noop:、off:、skip:が含まれている場合は、ノートブックにアクセスしたりワークフローの記録を作成したりせずに、チャットで回答または実行します。これは現在だけでなく、後の要約でも同様です。承認されたプロダクト/設定の編集は引き続き可能ですが、自動保守は延期します。記録対象外の追記コマンドはステージングも実行もせず、マーカーを付けずに再送するよう依頼します。その際、ノートブックにはアクセスしません。以降のマーカーのないメッセージは通常どおり記録します。 -
分離された looper タスク: 一般的な検出/セットアップ/保守より先に、looper に従って、コーディネーターから提供された継承設定と明示的な記録の上書きを適用します。承認された
aglite-*ワークツリーから機能の振り分けを推測してはいけません。 -
設定/振り分け: セッションの物理ディレクトリ、Git ルート/ブランチ/ワークツリー(または既存の非 Git フォルダー)を確認してから、設定を読みます。静的ルールはコンテキストに保持している間は一度だけ読み、記録対象となるオーナーからのメッセージごと、および設定に依存する処理の実行前に、最新の設定を再確認します。検証済みの設定に基づいて
<ag-dir>とノートブックを一度だけ解決し、設定済みの名前をデフォルト名に置き換えてはいけません。起動時のチェックアウト、Trash の場所、または一貫しない識別情報が欠けている場合は、タスク作業を中止します。読み取り専用の確認、または機能契約で定められた範囲内の遷移/最終クリーンアップのみ可能です。サブプロセスの cwd によってセッションの場所が変わることはありません。 -
ルートの確認よりライフサイクルを優先:
new-feature、merge-feature、drop-feature、管理対象の.wts/パスまたは機能ブランチについては、一般的なノートブック/セットアップ/claim/復旧より先に機能を読みます。ライフサイクルコマンドではメイン/ルートのノートブック、アーカイブ、claim、記録、締め処理を使用しません。ルートの状態によって処理を妨げることはできません。追記メッセージにライフサイクル作業が含まれている場合、その追記はステージングも実行もせず、別のライフサイクルコマンドとして送信し、残りの追記作業を再送するよう依頼します。その際、ノートブック/保留中の記録にはアクセスしません。 -
新規セットアップまたは待機中: 選択中のノートブック、確立済みのノートブック/アーカイブ履歴、過去の引退処理がなく、設定済みの ag-dir もない(またはその設定のみがある)ことを確認した既存フォルダーでは、待機する前にセットアップに従います。非 Git セットアップでは、保存済みまたは以前に明示された Git の選択が必要です。それ以外の場合、直接のタスク/質問を伴わない単純な起動では、設定、選択された最新の Ask/Questions、Current/Next のみを確認します。ノートブックが見つからない場合は、まずルート/設定済みディレクトリの履歴を確認する必要があります。リンクされた未完了の作業/ゲート/納品、保留中のバッチ、進行中の操作、または曖昧さがある場合は、通常の復旧が必要です。すべての作業が存在しないことを確認できた場合に限り、claim、セットアップ、記録の更新、遡及的な記録を行わずに次の依頼を尋ねることができます。無関係なコマンドや読み取りは省略してください。日付条件に基づくリリーススケジュールの確認は限定的に許可されますが、期限が来た移行には通常の担当者による復旧が必要です。
-
担当作業: claim、復旧、記録、タスク作業の前にセッションを読み、完全な復旧/実行の前に claim を行います。無関係な編集は保持してください。影響を受ける作業の前に、共有/ローカルのプロジェクトルールと不変条件に従います。権威あるルールを利用できない場合、それに依存する書き込み/承認は延期します。単独の
godevは未完了の作業を再開します。起動時にプロジェクトのタスクを作り出してはいけません。
該当する手順のみ読み込む
-
バッチ:コマンドの追加、保留中のバッチを対象とする修正、または保留中のラウンドの復旧に適用します。キュー、クレーム、キャプチャ、統合、配信はホストが管理します。バッチに到達した場合は、例外の範囲内で、境界を定めたネイティブ実装ワーカーを優先します。
-
作業:実際のプロジェクト作業、タスクモード(
browfield、fast-lane、grill-me、skip-review、アドバイザー/3ways)、または依頼された差分に適用します。計画:該当する設計・トラッカーの基準、依頼された契約または重要な改訂が加えられた契約、ゲートに適用します。通常のQ&Aでは、実行や設計の契約を読み込みません。計画のみでは、実装権限は追加されません。 -
レビュー:計画経路の選択、結果レビュー、ワーカーのディスパッチの前に適用します。別個の結果レビューが設定されている場合、有効なタスク免除が適用されない限り、変更されたコード、運用プロンプト、製品成果物、実装可能な契約に適用されます。通常のQ&Aはホストがレビューします。Copilot ホスト上、または選択した Copilot 経路/プロファイルの場合にのみ、Copilot を読み込みます。Codex の
spawn_agentはすべて、完全で範囲を限定したコンテキストとともにfork_turns: "none"を明示的に使用します。 -
配信:STATUS/返信の作成、クローズアウト、アーカイブ、Git 配信、またはノートブック名の明示的な変更の前に適用します。
inline-reply: offの場合、実質的な回答、提案、例、質問はすべて、既存の記録上の場所に保存します。チャットには、作業状況、必須の通知/阻害要因/引き継ぎ、および正確にローカライズされた受領通知のみを記載します。チャット/ターミナルを宛先として明示的に指定する依頼がある場合に限り、指定された回答をそこに記載できます。保存済みの回答をツール経由で繰り返してはなりません。 -
セットアップ:実際の作業における、初回作成または AGENTS の導入が許可されている場合に適用します。保守:設定の移行/移動、または承認済みのインストールの置き換えに適用します。Agentflow8/統合に関する認識済みのトリガーでは、最初にレガシー移行を読み込みます。いずれも、公開や無関係な編集の権限は付与しません。
-
Looper:
prepare-tasks、run-tasks、handle-tasks、実行、または復旧の前に適用します。準備では Current にリンクされたキュー/計画ファイルを保存して停止します。run はそれを実行し、handle はその両方を行います。この機能に限り、範囲を限定した Node コーディネーター/agfランチャーが許可されます。通常のタスク設定、分離、ネイティブのライブホスト/メールボックス要件、オーナー限定の境界を維持します。CLI への置き換えは不可で、クリーンアップ/プッシュ/リリースの権限も付与されません。 -
Windows:Windows または移植性を明示的に扱う作業に適用します。専門アドバイザー、ブラウンフィールド、ブラウザー、製品ドキュメントに関する参照資料は、作業/レビューで定められたトリガーに従って読み込みます。すべての参照資料を日常的に読み込んではなりません。
saving-mode: onの場合は、作成前に保存モードを読み込みます。off の場合は通常の動作を維持します。saving-mode が欠落している場合は、設定の移行に従います。
範囲は、受け入れられた入力/修正に沿ったものにしてください。提案やレビュアーの推奨によって権限が追加されることはありません。結果が不明な場合は、再試行する前に外部操作の識別情報を確認してください。指示があれば、指定された作業/子孫プロセスを停止します。譲る前に、タスク所有のワーカー/変更プロセスを完了させ、セッションルールに従って、検証済みの自身のクローズ済みラウンドのクレームのみを解放します。サポートされていないバックグラウンド継続を約束してはなりません。
可能な場合は、独立した読み取り/検索/ツール呼び出しを、並行数と出力を制限してまとめて実行します。失敗を含め、すべての結果を確認します。依存関係、承認、適応的な追加対応は順次処理します。変更を並列化するのは、互いに独立しており安全な場合に限ります。ツールの制限を守り、承認と必須チェックを維持します。