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