ds-pr について
ds-prは、GitHub Pull Requestを作成または更新するスキルです。変更内容を明確に引き継ぐため、タイトルと説明の構成を定め、差分、機密情報、PRの状態を確認します。
主な機能
- 01ブランチの既存PRを確認して更新
- 02ベースブランチとの差分で変更範囲を確認
- 03最近マージされたPRのタイトル形式を参照
- 04問題・修正・検証に沿って説明を構成
- 05機密情報を検査してレビュー可能なPRを作成
活用シーン
- 01現在のブランチにレビューしやすいPRを作成
- 02既存PRを現在の変更内容に合わせて更新
- 03提出前にPR本文や添付ファイルの機密情報を確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ aicodeking/ deepseek-stack --skill ds-prインストール後、Claude Code で/ds-prを入力して読み込まれたか確認します。
詳細
レビュー担当者が 10 秒で読めるタイトルと説明を付けて、実際の PR を 1 件作成します。
手順
- このブランチですでに PR が作成されているか確認します(
gh pr list --head <branch>)。作成済みの場合は更新します。 - ブランチとそのベース(通常は
origin/main)との差分を確認します。差分が目的に合致しており、無関係な内容が含まれていないことを確認します。 - 最近マージされた PR のタイトルをいくつか確認し、形式を踏襲します。
- どの関数を移動したかではなく、ユーザー向けに何を変更したのか、そしてそれがなぜ重要なのかを伝えるタイトルを書きます。例:「圧縮で WebSocket フレームを 70% 削減」は「permessage-deflate をネゴシエート」より適切です。
- 次の順序で説明を書きます。
- 問題点を、ユーザーの依頼に基づいて平易な文章で 1~2 文にまとめます。
- 修正内容を 1~2 文で説明します。
- 確証がある場合は、それをどのように検証したかを 1 行で書きます。
- 締めの行として、
Created with <model> in <harness>.と記載します。ハーネスが報告したモデル名を使用します。報告がない場合は、ハーネス名のみを記載します。
- タイトル、本文、添付ファイルにシークレット、トークン、非公開のパス、個人情報が含まれていないか確認し、あれば削除します。
- レビュー用に、ドラフトではなくレビュー可能な状態で PR を作成し、レビューボットが実行されるようにします。
- GitHub から返された PR の URL を出力します。
次の場合は停止します
- GitHub から PR の URL が返された場合。ユーザーが監視を依頼している場合は、
ds-watch-prに引き継ぎます。 gh pr createが 2 回失敗した場合。エラーが GraphQL のレート制限であれば、REST 経由で 1 回再試行します:gh api repos/<owner>/<repo>/pulls -f title=... -f head=... -f base=... -F [email protected]。それも失敗した場合は、エラーを報告します。
ルール
- 説明にファイルごとの変更一覧を記載しないでください。
- 依頼に必要な場合を除き、フォローアップのコメントを投稿しないでください。その場合は
ds-pr-commentsを使用します。 - モデル名を推測しないでください。
コメント
Markdown 対応