Communitygithub.com

agentkitco/agentkit-dev-skills

マージされたプルリクエストとコミットから、エビデンスに基づいたブラグ・ドキュメントや自己レビューの下書きを作成します。結果が不明な箇所は明確なギャップとして残します。レビュー時期、昇格申請、履歴書の更新にご利用ください。

agentkit-dev-skills とは?

このスキルは、開発者が実際にリリースしたGit履歴をもとに、エビデンスに基づいたブラグ・ドキュメント(自己アピール資料)の下書きを作成するためのものです。マージされたプルリクエストをGitHub CLIで取得し、Gitログからコード貢献を収集し、さらにインシデント対応やメンタリング、レビュー、発表などGitに記録されない成果もユーザーに追加入力させます。これらのアイテムをテーマごとにグループ化し、各テーマに対して「何をしたか」「結果」「エビデンス」「スコープ」を明確に記述します。特に結果が不明な箇所は `[GAP: ...]` として明示的にギャップを残し、架空の数値やインパクトを決して作りません。最終的には自己レビュー、昇格申請資料、履歴書の箇条書きとして出力可能です。Claude Code や Cursor などのAIエージェントプラットフォームで使用でき、正直かつ強力な成績文書を作成するのに役立ちます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/agentkitco/agentkit-dev-skills/tree/HEAD/skills/brag-doc-from-git

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

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

ドキュメント

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形式で出力すること。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

関連スキル