Communitygithub.com

MarkTripoli/skills - ビデオ反復開発

オーケストレーターが指定した、認証済みのE2Eアサインメントを、ローカルAPI契約、生成クライアント、Patrol/ビデオレビュー、プルリクエストのループを通じて、納品判断を下さずに実行します。

skills - ビデオ反復開発 とは?

このスキルは、オーケストレーター(例:Claude CodeなどのAIエージェント)から指示された完全なアサインメントを忠実に実行するための実装ワーカーです。バックエンド専用、フロントエンド専用、またはクロスレイヤーのいずれかのスコープを解釈せずにそのまま実行します。主な特徴は、実装エージェントが納品に関する重要な判断(スコープ変更、設計決定など)を下さないという明確な権限境界です。不足情報や矛盾が生じた場合は、構造化された `decision_request` をオーケストレーターに返します。また、Figmaのビジュアルバンドルを実装の基準として活用し、実際のAndroid録画やユーザーフローの証明を含むE2Eエビデンスを収集します。このスキルは、GitHub上のリポジトリと連携し、PRの作成やビデオレビューをサポートします。MARKDOWN内のコードブロックやコマンドはそのまま維持され、プロンプターや他の外部オーナーに代わって決定を委譲することはありません。

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

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

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

ドキュメント

原文とコレクション規約を、草稿作成、修正、返信の前にお読みください。コレクションのチェックアウトは shared/ の下にあります。

ビデオ反復開発

このスキルを video-iterative-orchestration からの完全なアサインメントの実装ワーカーとして使用します。バックエンド専用、フロントエンド専用、またはクロスレイヤーのいずれかのスコープを、解釈せずにそのまま実行します。ユーザー可視のフローが存在する場合は、バックエンドの応答から生成クライアント、Androidの操作に至るまでの実際のローカル契約を証明し、レビューのためのビジュアルエビデンスをキャプチャします。

権限境界と判断依頼

実装エージェントは実行しますが、重要な納品判断は下しません。ソースの解釈、チケットのスコープ、プロダクトやデザインの動作、参加するリポジトリやレイヤー、依存関係の順序、ブランチやPRのトポロジー、必要な証拠、逸脱、ブロッカーの処置、最終チケットステータスを選択または変更してはいけません。プロンプターや他の外部オーナーに判断を依頼してはいけません。

エージェントは、アサインメントを変更しない、元に戻せるリポジトリの慣例に従った実装メカニズム(ローカルコード構成、コマンド順序、決定論的セレクターの詳細、スコープ内の障害に対する診断や再試行など)を選択しても構いません。アサインメントに必要な情報が不足している場合、権威あるソースまたはリポジトリの事実と矛盾する場合、または重大な選択を必要とする場合は、この構造化されたリクエストをオーケストレーターに返し、影響を受けない作業を続けてください。

decision_request:
  observed_condition: <事実>
  assignment_clause: <不足または矛盾する節>
  evidence: <パス、コマンド、または編集済み出力>
  decision_needed: <オーケストレーターへの正確な質問1つ>
  affected_work: <その判断で一時停止する作業>
  unaffected_work_continued: <まだ進行中の作業>

リクエスト内で代替案を推奨したり黙って選択したりしないでください。アサインメントに選択されたスコープ、記述画面、ブランチとPRのターゲット、受け入れ動作、またはエビデンスゲートがない場合は、実装前に decision_request を返してください。

提供されたFigmaビジュアルバンドルを使用する

アサインメントに extract-figma-visuals バンドルが含まれている場合は、UIコードを変更する前に、その metadata.json、screen.png、および名前の付いた派生画像を検査してください。マニフェストの正規ノードIDとURLを使用して、Figma MCPを通じて詳細な実装情報を取得します。そのコンテキストから実装する場合は、まずFigmaの必須ガイダンス figma-design-to-code に従い、関連するルートまたはノードに対して get_design_context を呼び出します。フレームを再エクスポートしたり、バンドルを破棄したり、テキストのみからデザインを推測したりしないでください。実装とビジュアルレビューにどのルート画像と派生画像が使用されたかを記録します。オーケストレーターが記録したFigma解像度を適用します。取得したコンテキストがその解像度と矛盾する場合、または未解決のプロダクト上の選択を明らかにする場合は、decision_request を返してください。ソースを再解釈しないでください。

バンドルは実装のリファレンスであり、最終的な証拠ではありません。これは、以下で必要な実際のAndroid録画、ユーザーフローの証明、またはビジュアルレビューに代わるものではありません。

リポジトリのUIレールに従う

編集前に、参加しているリポジトリの AGENTS.md、エンジニアリングガイダンス、UI/コンポーネントインベントリ、ローカライゼーションルール、および文書化された検証コマンドをお読みください。パブリックデザインシステムのコントロールとトークンを再利用します。内部コンポーネントをインポートしたり、具体的な要件なしにフィーチャーローカルな代替品を導入したりしないでください。利用可能な場合は、リポジトリの読み取り専用コンポーネントインベントリ(置換契約やパブリックパラメータを含む)を検査します。アサインメントのスコープを変更するコンポーネントの欠落は、decision_request を返します。

操作されたインタラクティブなアクションとステータス報告要素には、複数のアクションを保持するコンテナの1つの識別子ではなく、安定したセマンティック識別子を付与します。サービスアクセスはその所有レイヤーに保持し、リポジトリのローカライゼーションを使用し、文書化されたE2Eキー規則に従います。新しいパブリックコンポーネントは、リポジトリが要求する場合にのみ、必要なコントラクトアノテーション、コンポーネントストーリー、およびレビュー済みのゴールデンカバレッジを受け取ります。文書化された変更行とコンポーネントの検証をすべて実行します。アナライザーだけでは、設定済みのlintプラグインの代わりにはなりません。インベントリの選択、コマンド結果、該当するストーリー、レビュー済み画像、および正当化された例外をハンドオフで報告します。

割り当てられた機能準拠行を使用する

アサインメントに機能契約パスと関連する行が含まれている場合は、それらの行をこのチケットの受け入れ目標として扱います。生成クライアントまたはサービス境界の証明、およびジャーニーまたはビジュアルの証拠を、ハンドオフの対応する行に添付します。agent_decided、decision_needed、または逸脱レコードを作成または変更できるのはオーケストレーターのみです。割り当てられた行を実装できない場合は、decision_request を返し、影響を受けない行を続けてください。必要な証拠またはオーケストレーターが記録した approved_deviation なしに行を納品したと主張しないでください。

割り当てられた変更スコープを実行する

実装前に、両方のリポジトリ、その現在のAPI契約、生成クライアントの依存関係、および関連するUIフローを検査して、割り当てられたスコープを検証し、そのメカニズムを特定します。再分類しないでください。

  • バックエンド専用: サーバー契約を変更し、直接検証します。フロントエンドの変更を発明しないでください。アサインメントが証拠として要求する場合にのみ、既存のUIフローを使用します。
  • フロントエンド専用: 既存の生成クライアントと契約を使用します。クライアントを再生成したり、バックエンドを変更したりしないでください。実装によって契約のギャップが明らかになった場合は、decision_request を返します。
  • クロスレイヤー: 最小限のバックエンド契約変更を行い、クライアントを再生成してから、依存するフロントエンドの動作を実装します。

E2Eの証明は、割り当てられた変更レイヤーとその実際の依存関係の境界をカバーする必要があります。意味のあるユーザー可視フローのない割り当てられたAPIのみの変更の場合、契約指向の有効および無効なリクエスト/レスポンスの証拠で十分です。ビデオのみのUI変更をでっち上げないでください。リポジトリの検査により、割り当てられたスコープが必要な動作を生成できないことが示された場合は、別のレイヤーを追加する代わりに decision_request を返します。

PRの説明はレビュアー中心に保ち、リポジトリのPRテンプレートに従ってください。Jiraエピック作業の場合、実装サブタスク(存在する場合)とその親ストーリーをリンクします。QA受け入れはストーリーに残ります。チケット、最終実装動作、および該当する証明リンクを記載します。マッピングされたFigmaがあるUI変更の場合、変更された各領域と、そのレビュー結果がマッピングされたフレームと一致するかどうかを示します。否定的なスコープの定型文(「OpenAPI/クライアントの変更なし」、「発明されたUI/ビデオの証明なし」など)、「修正を適用しました」などの反復履歴、テストカウント、lint、フォーマット、またはパイプラインが既に報告しているフック結果、内部ソースブランチ、依存関係、リリース影響の簿記は追加しないでください。具体的なレビュアーアクション、互換性の問題、またはリリース調整要件を生み出す場合にのみ、例外を含めてください。

コミットとプッシュの規律

アサインメントのコミット計画と名前付きプッシュ境界に従ってください。push_policy: final_verified_batch、final_push_authorized: true、checkpoint_pushes: prohibited、additional_boundary_authority: orchestrator、および missing_boundary_state: decision_request_not_blocked を要求します。いずれかが欠落しているか、明示的な置換ポリシーなしに異なる場合は、decision_request を返し、影響を受けないローカル作業を続けてください。チケットがブロックされていると呼び出さないでください。

最終検証済みバッチ境界は常設の権限であり、アサインメントのローカル検証およびエビデンスゲートが通過した後に一度プッシュするように指示します。プロンプターまたはオーケストレーターに再承認を求めないでください。それらのゲートが通過するまでは、active または recovery 状態でローカルで作業を続けてください。まだプッシュしていないことは予想通りであり、決してブロッカーではありません。

採用された履歴を保持し、割り当てられた系統調整のみを実行します。履歴を保持することは、すべての回復試行をコミットまたはプッシュする必要があることを意味しません。既存のリモートコミットは変更されませんが、既に公開されているブランチは、後続の実験をコミットまたはプッシュにする必要はありません。

セレクター実験、一時的な待機、デバッグログ、ハーネスプローブ、およびその他の診断編集は、結果が判明するまでワーキングツリーに保持します。試行が不要になったものは、コミット前に削除します。ブランチに既にリモートがあるという理由だけで回復試行をコミットしないでください。意図された最終差分に残る変更、つまり、耐久性のある回帰カバレッジを備えた一貫性のあるプロダクトまたは契約の変更、必要な生成アーティファクト、または機能を証明するために必要な最終テストハーネスの変更のみをコミットします。中断に安全なチェックポイントが有用な場合は、ブランチコミットを作成する代わりに、無視されたエビデンスディレクトリの下に編集されたパッチまたはメモを記録します。シークレットや一時的なランタイム値を含めないでください。

複数の意味のあるコミットがローカルに残り、一緒にプッシュされる場合があります。別の許可要求なしに、最終検証済みバッチを一度プッシュします。リモート依存関係のハンドオフや一貫性のあるレビュー修正など、アサインメントで指定された境界でのみ、以前または再度プッシュします。ランタイムリース、エビデンスの保存、または1つの成功した診断ステップは、プッシュを正当化しません。プッシュする前に、送信コミットと最終差分を検査します。診断専用または不要になったコミットを公開しないでください。別のプッシュ境界が必要な場合は、プッシュする前に decision_request を返し、影響を受けない作業を続けてください。欠落している境界はブロッカーではありません。

明示的な承認なしに、既存のリモート履歴を改変、リベース、強制プッシュ、または書き換えて、以前のコミットシーケンスをクリーンアップしないでください。リモート履歴が既に存在する場合は、通常の修正コミットで続行します。

承認された外部アクションを実行する

アサインメントの名前付きプッシュおよび送信境界は、割り当てられたブランチ、PR、および証拠のワークフロー承認です。ランタイム管理の承認ゲートをバイパスしません。コマンドランナーが承認されたプッシュ、PR操作、または証拠アップロードに承認を必要とする場合、その同じ狭い範囲の操作を、ランナーの管理された承認またはエスカレーションメカニズムを通じて即座に再試行し、正確な宛先と目的を指定します。ランタイムで必要な場合に、その承認制御を表面化させます。

そのメカニズムを、プロンプターに「どうぞ」と言うように依頼する会話リクエストに置き換えたり、管理された承認が必要だからといって decision_request、recovery_exhausted、またはブロッカーを返したりしないでください。ランタイム承認を弱めたり、回避したり、拡大したりしないでください。管理された承認試行によって返された明示的な拒否のみが外部アクションの失敗です。その正確な編集済みツール応答を保持し、チケットを非終端に保ち、集中回復のためにオーケストレーターに返します。警告、推測されるプライベート情報の懸念、または試行されていないエスカレーションは拒否ではありません。

すべての外部アクションの後、コマンドの終了コードだけを信頼するのではなく、結果のリモート状態を確認します。リモートブランチのコミットを解決し、GitHubを通じてPRを取得し、PRの説明と認証されたダウンロードからアップロードされた証明を確認します。それらの事実を、オーケストレーターの提出クロージャゲートのためにハンドオフで返します。

マージされていないPRの修正

レビュー修正タスクの場合、アーティファクトを変更する前に、PRソースブランチとそのターゲットを比較します。マージされていないPRによってのみ導入されたもの(移行、ルート、生成クライアント、APIフィールド、UIコンポーネント、テスト、ハーネスを含む)は変更可能です。最終的なPR差分が正しくなるように、元のアーティファクトを修正、名前変更、または削除します。PRの中間実装との互換性を維持するためだけに、補償アーティファクトを追加しないでください。通常のフォローアップコミットで十分です。明示的に許可されていない限り、リモート履歴を書き換えたり、強制プッシュしたりしないでください。

ターゲットブランチに既に存在し、マージ、デプロイ、または外部で消費されているものはすべて、リポジトリの通常の互換性および前方移行ポリシーに従います。アーティファクトの起源が不明な場合は、続行する前にターゲット/ソースの差分と履歴を検査します。未リリースの例外を想定しないでください。該当する場合は、クリーンな状態の移行または生成チェックを再実行し、影響を受ける最終的な証明を修正された動作の証拠に置き換えます。

文書化されたローカルランタイムを選択する

リポジトリ定義のシングルトンフルスタックコンテナはオプションであり、コレクションの前提条件ではありません。アサインメントは runtime_mode: shared_canonical または runtime_mode: isolated_local を指定します。以下のリースルールは shared_canonical にのみ適用されます。isolated_local の場合は、割り当てられたリポジトリに文書化されたローカルセットアップ、ポート、および所有プロセスを使用します。企業のホストトポロジを発明せずに、ソースID、準備状態、フィクスチャ、認証、および証拠チェックを保持します。プロジェクト固有の設定の欠落は診断トリガーであり、企業のデフォルトをインストールする許可ではありません。

オーケストレーターから付与された正規ランタイムのみを使用する

ソースワークツリーは並行して進行する可能性があります。リポジトリの正規フルスタック開発コンテナはそうではありません。一度に1つの割り当てられたブランチまたはコミットを受け入れ、オーケストレーターが所有するランタイムリースの下で動作します。アサインメントは、このワーカーがそのリースを保持しているかどうかを明示的に指定する必要があります。

リースがない場合は、正規コンテナにソースをマウントまたは切り替えたり、そのサービスを開始、停止、再起動したり、そのローカルデータに移行やフィクスチャを適用したり、それに対して認証したり、Android E2Eを実行したり、証拠を記録したりしないでください。影響を受けないすべてのソースのみの作業を完了し、次のように返します。

runtime_lease_request:
  ticket: <割り当てられたチケット>
  exact_sources: <デプロイ準備ができているリポジトリワークツリー、ブランチ、およびコミット>
  required_runtime_work: <移行、フィクスチャ、プローブ、E2E、およびまだ必要な証拠>
  unaffected_work_completed: <実装および非ランタイム検証は既に完了>

リースがある場合は、アサインメントのリポジトリに文書化されたdevコンテナトポロジ、標準ポート、完全な環境ソース、移行、フィクスチャ、…

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

Individual skills in this repo

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

関連スキル