report-bug

Compounding Engineering プラグインのバグを報告する

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

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

AskUserQuestion ツールを使用して、次の情報を収集します。

質問 1：バグのカテゴリ

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

質問 2：該当するコンポーネント

• どのコンポーネントに問題がありますか？
• エージェント、コマンド、スキル、または MCP サーバーの名前を尋ねます

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

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

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

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

質問 5：再現手順

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

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

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

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

自動的に収集します：

# Get plugin version
cat ~/.claude/plugins/installed_plugins.json 2>/dev/null | grep -A5 "compound-engineering" | head -10 || echo "Plugin info not found"

# Get Claude Code version
claude --version 2>/dev/null || echo "Claude CLI version unknown"

# Get OS info
uname -a

ステップ 3：バグレポートを整形する

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

## Bug Description

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

## Environment

- **Plugin Version:** [from installed_plugins.json]
- **Claude Code Version:** [from claude --version]
- **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

[エラー出力]

## Additional Context

[Any other relevant information]

---
*Reported via `/report-bug` command*

ステップ 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 が認証されていない場合：先に gh auth login を実行するようユーザーに促します
• issue の作成に失敗した場合：整形済みのレポートを表示し、ユーザーが手動で issue を作成できるようにします
• 必須情報が不足している場合：該当する項目について再度尋ねます

プライバシーに関するお知らせ

このコマンドでは、次の情報は収集しません。

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

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