issue について
issue は、GitHub issue の作成・管理に使うスキルです。ユーザーの意図を保つ簡潔なタイトルや Markdown の扱いに加え、添付ファイル、編集後の確認、issue-management スキルを通じた issue 間の関係管理を扱います。
主な機能
- 01ユーザーの意図を保つタイトル
- 02パッケージ名や領域名の接頭辞
- 03ファイル経由の複数行本文作成
- 04画像と動画の添付
- 05編集後の issue 内容確認
- 06issue 関係は別スキルに委任
活用シーン
- 01明確な GitHub issue タイトルの作成
- 02複数行 Markdown を含む issue の作成
- 03issue へのスクリーンショットや動画の追加
- 04編集後の issue 内容の確認
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ remotion-dev/ remotion --skill issueインストール後、Claude Code で/issueを入力して読み込まれたか確認します。
詳細
タイトル
ユーザーの意図を保った、簡潔なタイトルを作成します。Issue には問題の説明や指示が含まれることがあります。ユーザーが解決策を提示または明示的に求めていない限り、問題を特定の解決策を指示するタイトルに変えないでください。
パッケージ固有の Issue には、パッケージ名をプレフィックスとして付けます。
`@remotion/package`: Issue description
より広範な領域については、対応するプレフィックスを使用します。
Docs: Issue description
Studio: Issue description
Build: Issue description
CI: Issue description
Repo: Issue description
Bug、Fix issue、Examples follow-up のような曖昧なタイトルは避けてください。
Markdown 本文とコメント
複数行の Markdown をシェル引数にインラインで渡さないでください。Issue の本文や複数行のコメントは、一時的な Markdown ファイルに書き込み、できれば write ツールを使用して、--body-file で渡してください。
Issue の作成または編集後に、タイトルと本文を確認してください。
gh issue view <number> --json title,body
内容が正しく、複数行の Markdown にリテラルの \n ではなく実際の改行が含まれていることを確認してください。
添付ファイル
ユーザーから画像または動画が提供された場合は、gh issue create、edit、または comment で --attach を指定してアップロードしてください。
gh issue edit <number> --attach '/tmp/screenshot.png#Description of the screenshot'
複数のファイルを添付する場合は、このフラグをファイルごとに指定してください。画像では # の後に代替テキストを指定できますが、動画では指定できません。添付ファイルは末尾に追加されます。または、一致するローカルの Markdown 参照がアップロード先の URL に書き換えられます。--attach のみを指定して編集した場合、既存の本文は保持されます。
アップロードが一部失敗した場合は、重複を避けるため、再試行する前に Issue を確認してください。詳細については、gh issue <command> --help を参照してください。
関連付け
親 Issue、サブ Issue、ブロックされる関係、ブロックする関係には、issue-management スキルを使用してください。