ketchup-video

Ketchup video

/ketchup に従いますが、要約やビジュアルの代わりに、何が起きたかを短い無音動画で示します。動画の範囲は、以前の /ketchup より前ではなく、ユーザーが /ketchup-video の前に書いた最後のメッセージから始まります。リポジトリの外で動画を書き出してレンダリングすることだけが、読み取り専用ルールの例外です。返信は、ketchup の冒頭の一文、埋め込み動画、自分で対応できる残作業があればそれを示す一行、そしてアクション項目で構成します。動画で呼び出しのオプションを示す場合は、動画内で使われている名前で各オプションを呼びます。レンダリングに失敗した場合は、その旨を一行で伝え、呼び出しだけを提示します。

スライド

作業で生成されたスクリーンショット、録画、差分、データを使い、それらについてチャットで書かれた説明は使いません。描画する前に、ユーザーに覚えておいてほしい一文と、スライドごとの一行を書きます。ユーザーの理解を変えないスライドは削除します。スライドは最大10枚とし、少ないほど望ましいです。どちらのメモも返信には含めません。

各スライドでは、一つの要点を伝えます。関連のない画像に切り替えるのではなく、一つの画像をもとにスライドを作り、スライドごとにその画像を変化させます。色や形は、すべてのスライドで同じ意味を持たせます。システムの仕組み、各 PR の状態を示す PR スタック、修正前後、選択肢の並列比較など、作業内容を画像で示します。矢印、ハイライト、動きで変更点を示します。スライドを箇条書き、ステータス一覧、表、つながりのないボックスで構成してはいけません。

テキストは最小限にします。ラベルはすべて、それが指すものの上に、たとえば「テスト：合格」のようなタグではなく、人が口にする平易な言葉で配置します。画像の内容を説明するキャプションは付けず、スライド間やスライド下のテキストで同じ事実を二度示してはいけません。

ユーザーが依頼した各項目の結果と、完了、実行中、失敗、未確認のいずれであるかを示します。ユーザーの対応待ちのものを、完了として示してはいけません。途中で発見して修正したバグも示します。画面上の変更にスクリーンショットがない場合は、そのスライドにその旨を記し、画面上で何が変わったかを示します。確認できた事実だけを使います。数値を捏造してはいけません。また、撮影していない画面を描いてはいけません。

レンダリング

スライド間に動きを加えた、無音の横向き動画（mp4 など）を一つレンダリングします。すべてのフレームはスライドそのものとし、端まで表示します。フレームは画面録画ではなく、スライドから作成します。各スライドは読めるだけの時間表示します。追加する単語3語につき少なくとも1秒表示します。スクリーンショット内の単語は数えません。動画を埋め込む前に、レンダリングしたファイルから各スライドのフレームを1枚ずつ確認し、そのファイル内での表示時間に対して追加した単語数を数えます。その時間内に読めないスライドがあれば修正して再レンダリングし、もう一度確認します。