ce-report-bug

Compound Engineering Plugin のバグを報告する

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

Step 1: バグ情報を収集する

次の質問を、プラットフォームのブロッキング型質問ツールを使用してユーザーに尋ねます。Claude Code では AskUserQuestion（スキーマが読み込まれていない場合は、先に select:AskUserQuestion を指定して ToolSearch を呼び出す）、Codex では request_user_input、Gemini では ask_user、Pi では ask_user（pi-ask-user 拡張機能が必要）を使用します。ハーネスにブロッキング型ツールがない場合、または呼び出しでエラーが発生した場合（Codex の編集モードなど）に限り、チャットで番号付きの選択肢を提示します。スキーマの読み込みが必要なことを理由にフォールバックしてはいけません。質問を黙って省略してはいけません。

質問 1：バグのカテゴリ

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

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

• 影響を受けている具体的なコンポーネントはどれですか？
• エージェント、コマンド、スキル、MCP サーバーの名前を尋ねます

質問 3：何が起きたか（実際の動作）

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

質問 4：本来どうなるべきだったか（期待される動作）

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

質問 5：再現手順

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

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

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

Step 2: 環境情報を収集する

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

OS 情報（すべてのプラットフォーム）：

uname -a

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

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

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

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

これらのいずれかに失敗した場合は、「不明」と記録して続行します。レポートの作成を中断してはいけません。

Step 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 `/ce-report-bug` skill*

Step 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]"

Step 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 情報以外のファイルパス

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