Git履歴からブラグ・ドキュメントを作成する
目標: 実際にリリースしたものを編集可能な下書きに変換し、インパクトを捏造しないこと。ブラグ・ドキュメントは成果と結果を列挙するものですが、このスキルは成果を収集し、結果が不明なすべての箇所を埋めるべきギャップとして明示します。
ステップ1: エビデンスを収集する
時間範囲(デフォルトは過去6ヶ月)とリポジトリを尋ねます。次に、GitHub CLIにサインインしている状態で以下のコマンドを実行します。
gh search prs --author @me --merged --merged-at ">=YYYY-MM-DD" --json title,url,closedAt,repository --limit 200
GitHub上にないコードについては、各リポジトリで git log --author="<名前またはメール>" --since="YYYY-MM-DD" --no-merges --pretty="%h %ad %s" --date=short を実行します。また、Gitで表示できないもの(インシデント対応、メンタリング、レビュー、発表、ドキュメント、オンコール、設計判断、同僚からの感謝の言葉など)をユーザーにペーストしてもらうよう依頼します。
ユーザーが指定していないプライベートリポジトリは読み込みません。名前、チーム、数値を推測してはいけません。
ステップ2: グループ化し、まだ要約しない
項目をテーマ別にグループ化します(例:信頼性、新機能、パフォーマンス、ツール、メンタリング、クロスチーム業務)。各項目をテーマの下に、日付とリンク付きでリストします。重複を統合します(機能PRとその後の修正PRなど)。
ステップ3: 各テーマの下書きを作成する
各テーマについて以下のように記述します。
- 私が行ったこと: プレーンな動詞で1~2文。タイトル、差分、ユーザーノートで裏付けられる内容のみを使用。
- 結果: 数値、引用、成果が提供された場合のみ記述。それ以外は
[GAP: ユーザーやチームにとって何が変わったか?前後でのメトリクスは?]と書く。 - エビデンス: リンク。
- スコープシグナル(可能な場合): 主導した、単独で行った、チーム間で連携した、オンコールだった、他者をレビューした、など。
ステップ4: ギャップと質問で締めくくる
すべての [GAP] を、それがケースをどれだけ強化するかの順にランク付けしてリストし、最も付加価値の高い3つの質問を記載します。最終版を自己レビュー、昇格申請資料、または履歴書の箇条書きに変換するオファーをします。
ルール
- メトリクス、パーセンテージ、顧客名、役職、スコープを決して捏造しないこと。見えるギャップの方が、でっち上げた数値より優れています。
- 誇張しないこと:「貢献した」は「貢献した」のまま。動詞をエビデンスに合わせること。
- ユーザーの功績を正直に保つこと:PRがチーム作業だった場合、ユーザーの担当部分を明記すること。
- ユーザーが社内文書だと明示しない限り、プライベートまたは機密の詳細は含めないこと。
- ユーザーがノートに貼り付けられるMarkdown形式で出力すること。