Communitygithub.com

MarkTripoli/skills

チケット範囲の配信決定を一元管理し、分離された再開可能なチケットブランチを使用して、ビデオ反復開発を通じて実行を委任します。

skills とは?

このスキルは、Jira エピック、GitHub Issue、または要件リストからチケットスコープの配信決定を一元管理するオーケストレーターです。各チケットに専用の実装エージェントとワークツリーを割り当て、ビデオ反復開発を使用して検証済みの提出物を生成します。オーケストレーターは解釈、スコープ、リポジトリ/レイヤー選択、依存関係順序、ブランチ/PR トポロジー、偏差、ブロッカー処理、ライフサイクル状態、最終承認、チケットレポートを排他的に所有し、中断された作業の発見と再開、Figma ビジュアルの抽出、機能準拠の検証、実装レビューなどのコンパニオンスキルを呼び出します。Slack 調整をサポートし、分離されたワークツリーとスタックされた依存ブランチを使用して、リカバリメカニズムとエビデンスゲートを備えた堅牢な配信パイプラインを提供します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/MarkTripoli/skills/tree/HEAD/skills/delivery/video-iterative-orchestration

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

ライティングガイドとコレクション規約を、草稿作成、改訂、または返信の前に読んでください。コレクションのチェックアウトには、両方が shared/ の下にあります。

ビデオ反復オーケストレーション

スキルタイプ: 固定的 — チケットスコープ、中断された作業、依存関係の祖先、およびエビデンスゲートを保持します。通常の障害はリカバリに入ります。実装の試行を終了させるものではありません。

目的と所有権

Jira エピック、GitHub Issue キュー、または明示的な要件リスト(必要に応じて名前付きチケットに絞り込む)を、耐久性のある配信キューに変換します。選択された各チケットまたは修正には、専用の実装エージェントとワークツリーが与えられます。ディスパッチ前に、オーケストレーターはバックエンドのみ、フロントエンドのみ、またはクロスレイヤーのスコープを選択し、完全な実行契約を提供します。すべての実装エージェントは video-iterative-development を使用してその契約を実行し、検証済みの提出物を生成します。

オーケストレーターは実行を委任し、決定権限は委任しません。これは、ソース解釈、チケットスコープ、製品動作、リポジトリとレイヤーの選択、依存関係の順序、ブランチと PR のトポロジー、偏差、ブロッカーの処理、ライフサイクル状態、最終承認、およびチケットレポートを排他的に所有します。コンパニオンを呼び出しますが、言い換えはしません。

  • resume-and-reconcile.md は、中断された作業の発見とマップされたソース変更検出を所有します。
  • extract-figma-visuals は、Figma 階層の選択、エクスポート、およびバンドル検証を所有します。
  • feature-conformance は、ソース権限、決定記録、トレーサビリティ、および配信クレーム検証を所有します。
  • video-iterative-development は、割り当てられた実装、リカバリメカニズム、エビデンス、および提出を所有します。観察結果と構造化された決定リクエストを返します。実行契約を変更したり、配信状態を割り当てたりすることはありません。
  • agent-implementation-reviewer は、独立した読み取り専用の計画から差分へのレポートを所有します。オーケストレーターは、その共有レビューアを変更せずに機能契約アダプターを適用します。
  • エンジニアリングガイダンスレビュー は、最終的な差分を該当するリポジトリ規約に対して検証します。好みを新しいチケット要件に変えることなく、具体的な結果と正当化された例外を記録します。

決定権限

重要な決定とは、ソース解釈、スコープ、製品または設計動作、参加リポジトリまたはレイヤー、依存関係の順序、ブランチまたは PR のトポロジー、必要なエビデンス、承認された偏差、ブロッカーの処理、または最終チケット状態を変更する選択です。オーケストレーターは、ディスパッチ前またはワーカーリクエストへの応答として、すべての重要な決定を行い記録します。このスキルによって承認された自動ソース解決も、オーケストレーターの決定です。

実装エージェントは、実行契約を変更しない、リポジトリ規約に従った可逆的なメカニズムのみを選択できます。たとえば、ローカルコード構成、コマンド順序、決定論的セレクターの詳細、またはスコープ内の障害の診断と再試行方法などです。指示が不完全、競合している、または重要な選択を必要とする場合、ワーカーは推測したり、スコープを拡大したり、プロンプターに連絡したり、それ自体に終端状態を割り当てたりしてはいけません。構造化された decision_request をオーケストレーターに返し、影響を受けない割り当てられた作業をすべて続行します。

入力

  • Jira エピックキー/リンク、GitHub Issue キュー、または明示的な優先順位付けされた要件リスト。リクエストから選択されたキューを解決します。Jira を必要とせず、GitHub またはトラッカーに依存しない実行も可能です。
  • 修正モードの場合、読み取り専用の所見 Markdown ドキュメント。
  • ワークスペースからリポジトリルートを発見できない場合のリポジトリルート。
  • オプションの読み取り専用設計ドキュメントまたはリンク。アーキテクチャはドキュメントのサブタイプであり、別の入力カテゴリではありません。
  • 該当する UI チケットの node-id を含む、オプションの読み取り専用 Figma ルートフレームリンク。
  • Slack を介した実行調整リクエスト(明示的に名前付けられた 1 つのチャンネル、または直接メッセージ実行の明示的なリクエストを含む)。どちらの宛先もない場合、slack-coordinator はリポジトリのデフォルトを使用します。
  • 明示的な外部権限または期限。

機能 ID、契約ファイル、承認フラグ、Figma リビジョン、またはレイヤー分類を要求しないでください。不足しているオプションの Figma または設計ドキュメントコンテキストはブロッカーではありません。

Slack 調整が要求された場合、オーケストレーションの一部として slack-coordinator を直接呼び出します。別の Slack エージェントまたはペインを生成しないでください。オーケストレーションには 1 つの Slack 実行とスレッドを使用します。オーケストレーターは唯一の Slack 連絡係であり、その run_id の唯一の消費者です。実装エージェントはオーケストレーターに報告し、コーディネーターを呼び出したり、所有者の入力を自分で消費したりすることはありません。

読み取り専用の取り込みがエピックと選択されたチケットを解決した後、アクティブなコーディネーター run_id の既存の元帳を検査します。存在する場合はその実行を再開します。それ以外の場合は、最初の状態変更アクションの前に、実行可能ファイルが利用可能であることを確認し、run start を呼び出します。エピックを作業、要求された成果を目標、選択されたチケットをスコープとして使用します。現在の指示で明示的に名前付けられた単一チャンネルに対してのみ --channel を渡し、プロンプターが直接メッセージ実行を明示的に要求した場合にのみ --dm を渡し、それ以外の場合はコーディネーターにリポジトリのデフォルトを使用させます。返された run_id、チャンネル、スレッドタイムスタンプ、およびパーマリンクを、最初の許可された書き込み時に元帳に記録します。チケットが開始、再開、再試行、または所有者を変更したという理由だけで、2 番目のコーディネーター実行を開始しないでください。

オーケストレーターのすべての状態変更アクションの直前、および実装作業を許可する各ディスパッチまたはフォローアップの直前に run check を実行します。終了コード 0 はアクションを許可します。終了コード 10 の場合、run resolve で所有者入力を適用、回答、または拒否してから、再度確認します。終了コード 11 の場合、一時停止し、短い待機後に再試行し、理由を報告します。調整が利用できない間は、状態を変更したり、作業をディスパッチしたり、別の Slack パスにフォールバックしたりしないでください。終了コード 12 はオペレーターの明示的な非常用決定であり、これ以上の Slack 呼び出しなしで実行を続行できます。

run event を、オーケストレーションフェーズの変更、チケットライフサイクルの変更、およびブロッカーの開始またはクリアに使用します。デーモンはサイレントインターバルのステータス再投稿を所有します。オーケストレーションが完了、失敗、またはキャンセルの最終結果に達したら、run finish を 1 回呼び出します。ここで弱めたり言い換えたりするのではなく、スタンドアロンスキルのコマンド、チャンネル選択、メッセージ、および障害契約に従ってください。Slack 調整が要求されなかった場合は、実行を開始せず、Slack ゲートを追加しないでください。

実行モードを選択

所見のない配信モードを使用します。Jira の場合は Jira 配信ワークフロー を、GitHub およびトラッカーに依存しないキューの場合は配信モード を読んでください。選択したキューに所見ドキュメントが含まれている場合は、修正モードを使用します。修正ワークフロー を読んでください。

どちらのモードでも、ワークツリーを作成する前に再開とソース調整を実行します。Jira の場合、ステータスが決定的です。In Progress および Code Review は resume_required であり、ベースから開始するのではなく、既存の作業を採用する必要があります。

チケットスコープと設計権限

選択されたチケットの要件と承認基準が作業の境界を定義します。エピックはメンバーシップ、順序、および依存関係コンテキストを提供します。これには、Figma または設計ドキュメントで表現されるすべての動作が含まれているとは想定されません。選択されたチケットを明確にする Figma ノードとドキュメントセクションのみをマッピングします。マッピングされていない設計コンテンツは、欠落、延期、または範囲外の作業ではなく、コンテキストです。

チケット境界内:

  1. マッピングされた Figma は、あいまいまたは競合するチケットの詳細を含む、視覚的およびインタラクション動作のデフォルトの権限です。
  2. マッピングされた Figma は、競合する設計ドキュメントを自動的にオーバーライドします。
  3. 該当する Figma がない場合、マッピングされた設計ドキュメントがあいまいなチケットの詳細を解決します。
  4. リポジトリと API の規約が、残りの実装の詳細を解決します。

各自動解決を .agent-evidence/orchestration/<run-id>/decision-log.md に記録します。その選択肢が製品スコープまたはユーザーの動作を実質的に変更する、まれな未解決の選択についてのみ、影響を受けるチケットを一時停止します。権限ソースからの明示的に承認された逸脱は approved_deviation です。通常の実装決定と Figma 解決は逸脱ではありません。

1 つの実行レベルの設計ドキュメントマニフェストを .agent-evidence/orchestration/<run-id>/design-documents/manifest.json に作成します。これには、ソース ID、ドキュメント全体の SHA-256、および選択されたチケットにマッピングされたセクションのみの安定した ID、タイトル、SHA-256 値が記録されます。feature-conformance はこのマニフェストを参照します。別のマニフェストを作成することはありません。

提供された各 UI ルートについて、ディスパッチ前に extract-figma-visuals を呼び出し、検証済みのバンドルを該当するワーカーに渡します。アクセスチェックと実質的に異なる再試行後も読み取れないままの提供された Jira、Figma、または設計ドキュメントソースは、影響を受けるチケットのみをブロックします。古いコンテンツ、再作成されたモック、または推測された要件を代用しないでください。

実行状態を確立

ディスパッチ前:

  1. 選択されたエピック作業に対して 1 つの目標を作成または継続します。いずれかのチケットに回復可能または独立した作業がある間は、アクティブに保ちます。
  2. リポジトリガイダンス、現在のステータス、ワークツリー、チケットブランチ、オープン PR、生成コードルール、および文書化された検証コマンドを検査します。既存の PR の場合、そのソースワークツリーと、そのワークツリーが使用できない理由を特定します。クロスレイヤー作業の場合、参加リポジトリの文書化された複合起動構成を、完全なプロセストポロジー(すべてのコマンド、引数、作業ディレクトリ、環境ソース、依存関係順序、ポート、ヘルス/機能プローブ、マイグレーション/フィクスチャステップ、クライアント生成ステップ、ランタイム定義、および Android Patrol コマンド)に解決します。選択されたワークツリー、検証コマンド、および解決されたトポロジーを実装エージェントに渡します。リポジトリに文書化された IDE 複合は、IDE を呼び出すための指示ではなく、トポロジー定義です。
  3. 選択されたトラッカーの認証済みインターフェースを介して、チケットと依存関係を解決し、再開/ソース調整を実行します。Jira は Jira MCP を使用します。GitHub または明示的なリスト実行は、それ自体のスコープとステータス権限を保持します。
  4. 該当する Figma バンドルを抽出して検証します。提供された場合は、単一の設計ドキュメントマニフェストを作成します。
  5. プリフライトモードで feature-conformance を呼び出します。エージェント生成のスキーマまたはマッピングエラーを修復して再実行します。それらをチケットブロッカーとして提示しないでください。
  6. 明示的なタスクディレクトリまたは構成されたタスクルートを解決します。以下に説明する不変のインデックス付きレシートを使用します。無視された元帳、decision-log.md、および再構築可能な resume-state.json および source-index.json キャッシュを作成します。Jira、Git、PR、現在のマニフェスト、および現在のソース読み取りは、キャッシュがない場合や古い場合でも、権威あるものとして残ります。
  7. 依存関係テーブルを作成し、所有者、選択されたスコープと変更されていないレイヤー、採用または新規の書き込みサーフェス、PR ターゲット、ソースマッピング、契約行、オーケストレーターの決定、エビデンスゲート、正規ランタイムリース状態、リカバリ状態、および最終状態を記録します。Slack 調整が有効な場合は、実行レベルでその run_id、チャンネル、スレッドタイムスタンプ、パーマリンク、および現在の調整状態も記録します。

正規の snake_case マシン状態を使用します: ready、waiting、resume_required、resume_needs_lineage、resume_source_missing、active、source_update_detected、reconciliation_active、correction_active、needs_product_decision、locally_verified、submitted、submitted_verified、および blocked。

インデックス付きレコードと証拠を保持

index.json はタスクアーティファクトに対して権威があります。契約レシートは feature-contract (design.contract)、準拠は feature-conformance (review.conformance)、提案されたブロッカーは delivery-disposition (delivery.disposition)、検証済みの提出レシートは submission-closure (delivery.closure) として記録します。耐久性のある改訂ごとに新しい不変のイテレーションを割り当て、その正確な JSON スナップショットパス/ハッシュ、チケット、ソースヘッド、および関連する契約/レビューレコードをバインドします。使用する前に現在のレコードを選択してダイジェスト検証します。無効なインデックスがスキャンにフォールバックすることはありません。隣接するオプションのタスクアーティファクトヘルパーまたは正確な手動規約を使用します。真にインデックス付けされていないレガシータスクのみが番号付きレコードを使用します。

実行元帳、再開インベントリ、およびソースインデックスは、不変の受け入れまたはレビューレシートの代わりではなく、再構築可能な運用キャッシュです。生のビジュアルバンドルとキャプチャは、除外されたローカル証拠のままです。GitHub PR 本文、個別の証拠コメント、直接ホストされたキャプチャ、および現在のヘッドの読み返しは、公開権限のままです。インストールされた公開フックまたはベースライン/現在の証拠要件を決して弱めないでください。

チケット作業を分離してスタック

各アクティブな実装エージェントに、それが変更するすべてのリポジトリ内で、1 つの排他的なワークツリーとブランチを与えます。可変のチェックアウトを共有したり、中断された変更を破棄したりしないでください。

  • In Progress および Code Review チケットの場合は、選択されたソースを採用します。これには、そのチケットに属する変更を含むダーティなワークツリーも含まれます。
  • 採用された作業のない対象チケットに対してのみ、新しい作業を作成します。
  • その前提条件の検証済み提出リモートヘッドから依存ブランチを作成します。
  • その前提条件ブランチを対象とする依存 PR を作成し、PR にはそのチケットのデルタのみが含まれるようにします。スタックされた祖先を記録します。
  • 既存の修正 PR ソースブランチと PR を再利用します。古いワークツリーが使用できない場合は、その正確なブランチのチェックアウトのみを再作成します。
  • 中断された作業をリセット、クリーン、スタッシュ、フォースプッシュ、または書き換えて、セットアップを簡略化しないでください。
  • 重複する書き込みサーフェスを順序付けるか、専用の統合チケットブランチを作成します。

提出された前提条件ブランチは、ダウンストリーム実装、ローカル検証、および提出に十分です。

...

[翻訳のために切り詰められました]

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

関連スキル