pitch
実装結果を他者へ共有する前に、何が変わり、なぜそうしたかを説明したいときに使います。レビューしてほしい点も整理します。
渡す情報
計画、実装ノート、実装結果、検証結果、未解決事項を渡します。
依頼例
pitchを使って、担当者フィルターの変更をレビュー担当者へ説明してください。計画とnotesを参照し、URL保存の理由と確認してほしい点を含めてください。
進め方
- 背景と変更内容をつなげて説明します。
- 主要な判断理由とレビュー観点を整理します。
- 注意点と未解決事項を示します。
成果物の例
今回の実装と実行結果から作成した説明資料です。
到達点:レビュー用の説明資料作成。
移行時の確認:既存の実行記録を移行しました。本文の一致は確認しましたが、過去の実行時の同梱資料全体は特定できていません。
このハッシュは移行時の変更検出用の基準です。同梱資料全体をこの版で再実行した証拠ではありません。
実行した依頼
実成果物展示への修正で実際に生成した成果物と配信機構を、背景、変更内容、判断理由、レビュー観点、残事項へまとめてください。
実出力の抜粋
以下は保存した原本の冒頭です。全文は原本から取得できます。
# Pitch / Explainer
## 1. 背景
利用ガイドの「成果物の例」は架空の説明だったため、読者は実行後に得られる文章や画面を確認できなかった。ユーザーは全スキルページを実例へ置き換え、画像と原本の取得を求めた。
## 2. 変更内容
- 各正本を読んで、今回の要件、実検索コード、隔離したサンプルの実差分へ適用した。
- 文章の実出力、図と比較の単体HTML、HTML/Reactの初回画面案、実コミット、レビューHTMLを保存した。
- 原本をdocs/artifactsから配信し、Markdownの説明ページに実入力・抜粋・画面画像・取得リンクを載せる仕組みを追加した。
## 3. 主要な判断
- 表示のために成果物を作り直さず、実出力をそのまま渡す。画面画像は実ファイルを開いて撮影する。
- Reactのように複数ファイルを参照する成果物は、生成した表示一式のZIPを渡す。
成果物を取得する
確認した結果
- SKILL.mdを読み、今回の実要件と参照対象へ適用して出力を保存。内容の人間確認は未実施。
確認するポイント
変更と理由がつながっているか、レビュアーが何を見るべきか、未解決事項が隠れていないかを確認します。
関連するスキル
正本を読む
詳細な手順と制約はpitchのSKILL.mdを参照してください。