issue-reporting

問題の報告

ワークスペースのコンテキスト

質問する前に、ブートストラップのコンテキストを読み込んでください。ブランド、対象者、オファー、チャネル、ツール、制約、指標については strategy/brand.md を、個人の文体については about/me.md を、コンテンツの計画については content/ideas.md と content/calendar.md を確認します。従来のプロダクトマーケティングのコンテキストファイルは、ほかに手段がない場合にのみ使用してください。生成した下書きは content/<platform>/drafts/YYYY-MM-DD_short-topic-slug.md に保存し、長期的に役立つ学びは strategy/brand.md、about/me.md、または content/ideas.md に反映してください。

運用上の契約

このスキルは、フロントマターで定義された範囲において単独で機能します。ローカルの指示、参考資料、スクリプト、アセットを手順書として使用し、タスク固有の入力が不足している場合にのみ質問してください。範囲を広げるのではなく、関連するスキルに引き継ぎ、実行可能な成果物、判断、計画、下書き、または診断結果を返してください。

GTM スキルの問題を、メンテナーがすばやく修正できるよう、ユーザーが明確かつ詳細に報告できるよう支援します。

このスキルが起動する条件

• スキルが誤った、または有害なアドバイスをしたとユーザーが伝えた場合
• 起動すべきときにスキルが起動しないとユーザーが伝えた場合
• ブランドのコンテキストが適用されなかったとユーザーが伝えた場合
• 出力形式が誤っている、または予想と異なるとユーザーが伝えた場合
• バグの報告や Issue の作成を希望した場合
• スキルについて「何かが壊れている」とユーザーが伝えた場合

ステップ 1 — 問題を特定する

何がうまくいかなかったのかをユーザーに尋ねます。次の点を確認してください。

1. どのスキルか — 正確なスキル名を確認します（例：seo-and-aeo-strategy、copywriting-core）
2. 何を依頼したか — Claude に送った正確なプロンプトまたはタスク
3. 何が起きたか — 実際の出力または動作
4. 何を期待していたか — 代わりにどうなってほしかったか

ユーザーの説明が曖昧な場合（「ひどいアドバイスだった」など）は、具体的に何が誤っていたのか、なぜ誤りなのかを尋ねてください。

ステップ 2 — コンテキストを収集する

問題の診断に役立つコンテキストがないか、ユーザーのプロジェクトを確認します。

コンテキストファイル

次のファイルが存在するかを確認し、存在状況を記録してください。

• strategy/brand.md — ブランドのポジショニング、メッセージ、対象者
• about/me.md — 個人の文体、文章のスタイル
• CLAUDE.md — AI への指示

コンテキストファイルがないことは、「誤ったアドバイス」の最も一般的な原因です。strategy/brand.md または about/me.md がない場合は、ユーザーに次のように伝えてください。

「ブランドのコンテキストファイルがないため、スキルが一般的なアドバイスを返した可能性があります。/bootstrap を実行してファイルを設定してください。その後もスキルが誤ったアドバイスを返す場合は、報告する価値のある実際のバグです。」

プラグインのバージョン

.claude-plugin/plugin.json で現在のバージョン番号を確認します。

インストール方法

プラグインをどのようにインストールしたか（Claude Code、Cowork、Skills CLI、git clone、submodule）を尋ねます。

ステップ 3 — 問題を分類する

次のいずれかに分類します。

種類	説明	よくある原因
誤ったアドバイス	スキルが誤った、または有害な推奨事項を出した	古いフレームワーク、誤った分野の前提
起動しない	起動すべきスキルが起動しなかった	説明との不一致、トリガーフレーズの不足
誤った起動	起動すべきでないときにスキルが起動した	説明の範囲が広すぎる
コンテキストの欠落	ブランドや文体が出力に反映されなかった	コンテキストファイルがない、または読み込まれていない
不適切な形式	出力の構成が誤っている	スキルのテンプレートに関する問題
クラッシュ／エラー	実行の途中でスキルが失敗する	スキル内の構文エラー、参照パスの誤り

ステップ 4 — Issue を作成する

バグ報告テンプレートを使って GitHub Issue を作成します。ユーザーがコピーして貼り付けるか、リンクから直接移動できる形式にしてください。

直接リンク（テンプレートに内容をあらかじめ入力します）：

https://github.com/manojbajaj95/claude-gtm-plugin/issues/new?template=bug_report.yml

書式設定済みの Issue 本文（手動で貼り付ける場合）：

**Skill**: [skill-name]
**Type**: [category from Step 3]
**Plugin Version**: [version]
**Installation**: [method]

### What I asked
[exact prompt]

### What happened
[actual output — include relevant excerpt]

### What I expected
[expected behavior]

### Context files present
- [ ] strategy/brand.md
- [ ] about/me.md
- [ ] CLAUDE.md

### Steps to reproduce
1. [step-by-step if applicable]

### Impact
[Critical / High / Medium / Low]

ステップ 5 — 次の手順を提案する

Issue を作成したら、次のことを行います。

1. 報告用の直接リンクを伝えます：https://github.com/manojbajaj95/claude-gtm-plugin/issues/new?template=bug_report.yml
2. コンテキストファイルの欠落が問題なら、先に /bootstrap を実行するよう提案します
3. スキルのバグであることが明らかな場合は、プラグインの改善につながるため、ぜひ報告するよう勧めます
4. 報告してくれたことに感謝します。明確な Issue を作成してくれる貢献者は、かけがえのない存在です

重要

• ユーザーの不満を決して軽視しないでください。アドバイスが間違っていると考えている場合は、真摯に受け止めてください
• スキルを自分で修正しようとしないでください。このスキルの目的は報告であり、パッチの適用ではありません
• 問題を具体的に伝えてください。「うまくいかなかった」のような曖昧な報告では、対応が困難です
• 可能であれば実際の出力を含めてください。メンテナーが何が問題だったのかを確認できます