report-bug-ce

Compound Engineering Plugin のバグを報告する

compound-engineering プラグインの使用中に発生したバグを報告します。このスキルでは、構造化された情報を収集し、メンテナー向けの GitHub issue を作成します。

ステップ 1：バグ情報を収集する

次の質問をユーザーに提示してください（プラットフォームのブロッキング質問ツールを使用します。例：Claude Code の AskUserQuestion、Codex の request_user_input、Gemini の ask_user。または番号付きの選択肢を提示して、返信を待ちます）。

質問 1：バグのカテゴリ

• どのような問題が発生していますか？
• 選択肢：エージェントが動作しない、コマンドが動作しない、スキルが動作しない、MCP サーバーの問題、インストールの問題、その他

質問 2：具体的なコンポーネント

• どのコンポーネントに影響していますか？
• エージェント、コマンド、スキル、または MCP サーバーの名前を尋ねます

質問 3：発生したこと（実際の動作）

• 「このコンポーネントを使用したとき、何が起きましたか？」と尋ねます
• 実際の動作について明確な説明を得ます

質問 4：本来起きるべきだったこと（期待される動作）

• 「代わりにどのような動作を期待していましたか？」と尋ねます
• 期待される動作について明確な説明を得ます

質問 5：再現手順

• 「バグが発生する前に、どのような手順を実行しましたか？」と尋ねます
• 再現手順を取得します

質問 6：エラーメッセージ

• 「エラーメッセージは表示されましたか？表示された場合は、内容を共有してください」と尋ねます
• エラー出力があれば取得します

ステップ 2：環境情報を収集する

環境の詳細を自動的に収集します。コーディングエージェントのプラットフォームを検出し、取得可能な情報を収集します。

OS 情報（全プラットフォーム）：

uname -a

プラグインのバージョン： プラグインのマニフェストまたはインストール済みプラグインのメタデータを読み取ります。一般的な場所：

• Claude Code：~/.claude/plugins/installed_plugins.json
• Codex：.codex/plugins/ またはプロジェクト設定
• その他のプラットフォーム：プラットフォームのプラグインレジストリを確認します

エージェント CLI のバージョン： プラットフォームのバージョンコマンドを実行します。

• Claude Code：claude --version
• Codex：codex --version
• その他のプラットフォーム：該当する CLI バージョンフラグを使用します

取得に失敗した情報は「不明」と記録して続行してください。レポートの作成を中断しないでください。

ステップ 3：バグレポートを作成する

次の内容を含む、適切に構成されたバグレポートを作成します。

## Bug Description

**Component:** [Type] - [Name]
**Summary:** [Brief description from argument or collected info]

## Environment

- **Plugin Version:** [from plugin manifest/registry]
- **Agent Platform:** [e.g., Claude Code, Codex, Copilot, Pi, Kilo]
- **Agent Version:** [from CLI version command]
- **OS:** [from uname]

## What Happened

[Actual behavior description]

## Expected Behavior

[Expected behavior description]

## Steps to Reproduce

1. [Step 1]
2. [Step 2]
3. [Step 3]

## Error Messages

[Any error output]

## Additional Context

[Any other relevant information]

---
*Reported via `/report-bug-ce` skill*

ステップ 4：GitHub issue を作成する

GitHub CLI を使用して issue を作成します。

gh issue create \
  --repo EveryInc/compound-engineering-plugin \
  --title "[compound-engineering] Bug: [Brief description]" \
  --body "[Formatted bug report from Step 3]" \
  --label "bug,compound-engineering"

注： ラベルが存在しない場合は、ラベルを付けずに作成します。

gh issue create \
  --repo EveryInc/compound-engineering-plugin \
  --title "[compound-engineering] Bug: [Brief description]" \
  --body "[Formatted bug report]"

ステップ 5：送信を確認する

issue の作成後：

1. issue の URL をユーザーに表示します
2. バグを報告してくれたことへの感謝を伝えます
3. メンテナーの Kieran Klaassen に通知されることを伝えます

出力形式

Bug report submitted successfully!

Issue: https://github.com/EveryInc/compound-engineering-plugin/issues/[NUMBER]
Title: [compound-engineering] Bug: [description]

Thank you for helping improve the compound-engineering plugin!
The maintainer will review your report and respond as soon as possible.

エラー処理

• gh CLI がインストールされていない、または認証されていない場合：まずインストールまたは認証するようユーザーに促します
• issue の作成に失敗した場合：ユーザーが手動で issue を作成できるよう、整形済みのレポートを表示します
• 必須情報が不足している場合：該当する項目について再度尋ねます

プライバシーに関する通知

このスキルでは、次の情報を収集しません。

• 個人情報
• API キーや認証情報
• プロジェクトの非公開コード
• 基本的な OS 情報を超えるファイルパス

レポートには、バグに関する技術情報のみが含まれます。