動的ワークフローモード は何をしますか？
このスキルは、コーディングエージェントが静的なコマンドフローのみに従うのではなく、タスクローカルなハーネスを生成または適応できる場合に使用します。目標は、動的ワークフローモードを規律あるシステムにすることです: 1回限りの作業用の一時的なハーネス、繰り返し作業用の共有スキル抽出、チーム向けの監視可能なコントロールペーンチェックポイント。
アクティベートするタイミング
- ユーザーが動的ワークフロー、カスタムハーネス、タスクごとのハーネス、適応型ワークフロー、またはClaude Codeの動的ワークフローモードに言及した場合。
- タスクにカスタムループ、評価器、クローラー、フィクスチャジェネレーター、ウォッチャー、またはローカルダッシュボードが必要な場合。
- 複数のエージェントが同じ繰り返し可能なプロセスを必要としているが、そのプロセスがまだ共有スキルとしてキャプチャされていない場合。
- ワークフローに耐久性のあるハンドオフ成果物、評価エビデンス、またはマージ前のオペレーター承認が必要な場合。
コア契約
動的ワークフローモードは、ハーネスが同じステップを手動で実行するよりも安価で安全な場合にのみ、タスクローカルなハーネスを生成する必要があります。ハーネスには以下が必要です:
- 目的: ハーネスが担当する成果と、明示的に担当しない成果。
- 入力: ファイル、URL、プロンプト、データソース、認証情報ポリシー、ユーザー提供の制約。
- 出力: コミット、レポート、スクリーンショット、ステータスファイル、またはコントロールペーンスナップショット。
- 評価: 「実行された」だけでなく、タスクに紐づく少なくとも1つの合格/不合格チェック。
- ハンドオフ: 何が起こったか、何がブロックされているか、どのように再開するかを次のオペレーターに伝える短い成果物。
動的ハーネス決定木
- 1回限りのタスク: インラインに保つ。ハーネスを発明しない。
- 入力が変わる繰り返しタスク: タスクローカルなハーネスを作成し、一時的またはプロジェクトローカルな作業領域に保管する。
- チームメイトやリポジトリ間で繰り返されるタスク: パターンを共有スキルに抽出する。
- 外部状態、キューイング、承認が必要なタスク: 自動化を追加する前に、コントロールペーンの可視性を追加する。
- 安全リスクのあるタスク: 自律実行の前に評価ゲートと人間によるマージゲートを追加する。
タスクローカルハーネステンプレート
コードを書く前に次の構造を使用します:
# 動的ワークフローハーネス
目的:
- 出荷するもの:
- 出荷しないもの:
入力:
- リポジトリまたはワークスペース:
- 外部システム:
- 認証情報ポリシー:
ループ:
1. 現在の状態を発見する。
2. 最小限の有用な成果物を生成または更新する。
3. 評価チェックを実行する。
4. ステータスとハンドオフを記録する。
5. ゲート不合格、所有権不明、または安全でない外部アクションで停止する。
評価:
- コマンド:
- 期待される合格シグナル:
- 不合格時の所有者:
ハンドオフ:
- ステータス:
- エビデンス:
- 次のアクション:
共有スキル抽出
以下のうち少なくとも2つが真である場合にのみ、タスクローカルハーネスを共有スキルに昇格させます:
- 同じワークフローが複数のセッション、リポジトリ、チーム、または起動で出現する。
- ワークフローに特定の言語、ツール、または安全性のシーケンスが必要である。
- オペレーターがゲートをスキップしたりコンテキストを失ったりすることで失敗が繰り返される。
- ワークフローに安定した入出力契約がある。
- ワークフローがコントロールペーン、ステータスボード、またはチームハンドオフの恩恵を受ける。
抽出する際は、まずskills/<name>/SKILL.mdにスキルを記述します。レガシースラッシュエントリサーフェスがまだ必要な場合にのみ、コマンドシムを追加します。
コントロールペーンチェックポイント
動的ワークフローモードは、状態を公開する場合にチームで使用可能になります。タスクが複数のセッションにまたがるたびに、これらのチェックポイントを記録します:
- 計画: 目的、所有者、受入基準、リスクのある外部システム。
- キュー: 作業アイテム、割り当てられたエージェントロール、ブランチ/ワークツリー、依存関係エッジ。
- 実行: アクティブなハーネス、現在のループステップ、最近の評価結果、利用可能な場合はトークン/コストシグナル。
- ゲート: テスト結果、ブラウザスクリーンショット、セキュリティレビュー、マージ準備完了。
- ハンドオフ: 完了したこと、失敗したこと、人間による判断が必要なこと。
リポジトリでECC2状態が有効になっている場合は、追跡されていないメモを散乱させる代わりに、ECCコントロールペーンまたは状態ストアバックアップスクリプトを介してチェックポイントを追加または読み取ることを推奨します。
評価ゲート
すべての動的ハーネスにはタスク固有の評価が必要です。最も安価で信頼性の高いゲートを選んでください:
| 作業タイプ | 評価ゲート |
|---|---|
| コード機能 | フォーカステスト、lint、カバレッジ、1つの統合パス |
| UI/コントロールペーン | スクリーンショットとオーバーフロー/エラーチェック付きブラウザスモーク |
| エージェントワークフロー | フィクスチャトランスクリプトまたは期待されるルーティング付きシードワークアイテム |
| 研究/コンテンツ | ソースに依存しないブリーフ、主張チェックリスト、公開準備完了のアウトライン |
| 統合 | ドライランコマンド、設定検証、シークレットスキャンなし |
評価を別のチームメイトが再実行できるようになるまでは、動的ワークフローが再利用可能であると主張しないでください。
アンチパターン
- 実際の意思決定ロジックをオペレーターから隠すスクリプトを生成すること。
- 動的ワークフローモードをテストをスキップする許可として扱うこと。
- 共有スキルやステータス成果物が本当の成果物である場合に、1回限りのドキュメントを作成すること。
- 所有権、マージゲート、競合ポリシーなしで複数のエージェントを実行すること。
- 生のプライベート研究データを公開ドキュメントに漏洩させること。
出力標準
次のもので締めくくります:
- ハーネスまたはスキルのパス。
- 評価コマンドと結果。
- コントロールペーンまたはハンドオフ成果物のパス。
- 次に再利用可能な抽出候補。