mcpField
S
summarizing-shipped-work

summarizing-shipped-work

github.com/bostonaholic生産性262 回インストール今日更新
リポジトリ

summarizing-shipped-work について

マージ済みプルリクエストから簡潔な作業報告を作成するスキルです。対象リポジトリや期間の決定、製品領域ごとの変更整理、報告ルールを定めています。

主な機能

  1. 01指定期間の解決
  2. 02マージ済みプルリクエストの取得
  3. 03製品やシステム単位での変更整理
  4. 04報告項目の選別と順位付け
  5. 05報告形式とリンク規則の適用

活用シーン

  1. 01指定期間にマージされた作業の要約
  2. 02複数リポジトリにまたがる関連変更の統合
  3. 03ユーザー向けリリース・進捗報告の作成

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/bostonaholic/skills --skill summarizing-shipped-work

インストール後、Claude Code で/summarizing-shipped-workを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

agents/
openai.yaml
references/
report-format.md
scripts/
fetch-shipped-prs.sh
resolve-timeframe.mjs

詳細

出荷済みの作業を要約する

対象範囲

最初に質問はしません。ユーザーが所有者を指定した場合は、その所有者のみを検索します。ユーザーが作業のみを求めた場合は、個人用および些細なリポジトリを除外し、レポートの最後に1行で名前を挙げます。

期間

<skill-dir> をこのスキルの絶対パスに解決します。依頼を scripts/resolve-timeframe.mjs のヘッダーにある PERIOD トークンのいずれかに対応付け（ユーザーが指定しない場合は this-week）、次を実行します。

node "<skill-dir>/scripts/resolve-timeframe.mjs" PERIOD

START END が出力されます。終了コードが64の場合は、トークンを修正して再実行します。

マージ済みPRの取得

<out> を一時ディレクトリとして、次を実行します。

"<skill-dir>/scripts/fetch-shipped-prs.sh" START END [OWNER...] > <out>/shipped.jsonl; echo "rc=$?"

終了コードが0以外の場合：

  • スクリプトのエラーを報告して停止します。ファイルは不完全です。
  • ファイル内のPRを要約、列挙、グループ化したり、不完全なものとして提示したりしてはいけません。また、その提案もしてはいけません。
  • 終了コードが64の場合は、日付または引数を修正して再実行します。
  • HTTP 5xxなど、その他のエラーの場合は、解消後にもう一度実行するようユーザーに伝えます。

グループ化と要約

リポジトリ単位ではなく、製品またはシステム単位でグループ化します。サービスの変更、そのUI画面、ドキュメントは、ひとつの項目にまとめます。各領域内では、太字のテーマ別サブ見出しを追加し、リファクタリング、テスト基盤、CI、lintの修正は、その領域の最後にある エンジニアリングの健全性 サブ見出しにまとめます。

変更1件につき1文で、システムのユーザーに伝わる平易な言葉で書きます。ひとつの変更を出荷するPRは1行にまとめ、類似したPRが続く場合は件数を付けて1行にまとめます。

除外対象：バージョン更新、同じ期間内にマージされた作業の取り消し、その前のPRの修正だけを内容とするPR。

リンクは各行の末尾に、かっこ内にカンマ区切りで記載します。順番はPR、次に課題です。

  • PRラベル：pr_label。
  • 課題ラベル：チケットキー（OPS-123）、またはGitHubの課題の場合は repo#number。
  • 課題の情報源は、次の順に使用します。title_ticket_links 内のURL。それがない場合は、PR本文でPR自体のチケットとして引用されている issue_links。本文で関連する文脈や後続作業としてのみ言及されているチケットは除外します。
  • title_ticket_links のキーにURLがなく、セッション内の課題追跡ツールからもURLが得られない場合は、リンクなしのままにします。

レポート

レポートを作成する際は、references/report-format.md を読みます。Markdownテンプレート、セクションの順序、順位付けルールが記載されています。

実績アピール文書

  • レポートの後、ユーザーが実績アピール文書を指定しているか、AGENTS.md またはメモリに記録されている場合は、その文書にハイライトを追加することを提案します。それ以外の場合は、レポートで終了します。
  • 文書の既存の構成に合わせ、提案する差分をそのまま示し、承認を得てから書き込みます。
  • 既存の内容は上書きしたり削除したりせず、文章を追加します。

コメント

Markdown 対応