スキル自身の言葉で
シニアモーションアドバイザーとしてコードベースのアニメーションとモーションのコードを調査し、優先順位付けされたオーディットと、他のエージェントが実行できる自己完結型の実装プランを返すアドバイザースキルです。判断力を要する部分——モーション表面を読み解き、修正に値するものを決定し、仕様を書くこと——には有能なモデルを使い、実行は安価なモデルを含む任意のエージェントに委ねます。
オーディットはAUDIT.mdの8つのカテゴリに対して実行され、プランのフォーマットはPLAN-TEMPLATE.mdから取られます。ソースに対しては読み取り専用であり、変更するのはplans/配下のファイルのみで、NNN-short-slug.mdという名前で現在のコミットが刻印されます。単一のdiffのレビューや修正の実装は行いません。
生成されるもの
- レバレッジの高さで並べられた、精査済みの調査結果を1つのテーブルにまとめたものです。各行はHIGH(UIの誤ったイージング、キーボードや高頻度アクションでのアニメーション、フレームの欠落、scale(0)などの、体感を損なうもの)、MEDIUM、LOWのいずれかで評価されます。
- 見逃されている2〜4件の機会を挙げた別の短いリストです——アニメーションしていないがすべき箇所を指し、修正的ではなく追加的なものとして扱われます。
- 選定された各調査結果につき、plans/配下に1つのプランファイルを作成し、既存のプランを尊重する単調増加の番号と短いスラッグで命名します。
- 推奨される実行順序、プラン間の依存関係、ステータス列を記録したplans/README.mdです。
仕組み
- 01まずモーション表面を調査する
何かを判断する前に、スタック、モーションライブラリ、モーションがどこに存在するか、既存のイージングとデュレーションのトークン、プロダクトの個性、そして頻繁に触れられるアニメーション要素とほとんど触れられない要素をマッピングしてください。
- 028つのカテゴリーに沿って監査する
検出結果は目的と頻度、イージングと持続時間、物理性と起点、割り込み可能性、パフォーマンス、アクセシビリティ、統一性とトークン、見逃された機会に分類されます。正確な値を含むカタログはAUDIT.mdです。
- 03読み取り専用のサブエージェントに分散する
小規模なリポジトリを超える場合、監査はカテゴリーごと、またはアプリ領域ごとに1つのサブエージェントで並列化されます。
- 04報告前に必ず検証する
引用されたコードは自分自身で必ず再確認し、意図的なもの、誤帰属、重複、または適用対象外のものは除外してください。モーダルの中央のtransform-originや、マーケティングページ上の遅い持続時間などです。
- 05レバレッジ順に並べた1つの表を提示し、そこで止める
検出結果は重大度、カテゴリー、場所、内容、修正方法の要約を含む1つの表にまとめられ、労力に対する効果の大きさで並べ替えられます。
- 06最も能力の低い実行者向けにプランを書く
選択された各検出結果は、正確なファイルパス、現行コードの抜粋、正確な目標値を含むプランになります。コンテキストもセンスもないモデルでも推測せずに実行できるように書かれています。