Communityコーディング&開発github.com

skillgram 報告スキル

skillgram のバグやスキルギャップを実際の証拠とともに報告します。チャネルを選択し、JSON を取得し、Issue を開きます。

skillgram 報告スキル とは?

このスキルは、skillgram に関連するバグや不足しているスキルのギャップを、再現可能な証拠に基づいて正確に報告するためのものです。開発者は、技能のインストールや登録が期待通りに動作しない場合、またはエージェントが必要な能力を欠いている場合に、このスキルを使用できます。サポート対象プラットフォームは、CLI 経由の skillgram とさまざまなハーネス(例:Claude Code、Cursor など)です。このスキルは、実際の出力、終了コード、JSON をキャプチャすることで、架空の報告を排除し、バグ報告と機能リクエスト(スキルギャップ)を明確に区別します。最終的には、テンプレートに基づいて GitHub Issue を作成するための構造化された証拠を提供し、ユーザーが手動で投稿するか、自動的に投稿します。

対応✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Xhuk/skillgram/tree/HEAD/skills/skillgram-report

Installed? Explore more コーディング&開発 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

skillgram-report

起動条件

以下のいずれかに該当する場合、このスキルを使用してください。

  • skillgram が ok:false を出力した、終了コード 1/2 で終了した、クラッシュした、またはディスクの状態と矛盾する内容を出力した (registered と表示されたがハーネス設定に対応するエントリがない、存在しないリンクがある、マニフェストにスキルがあるのにマウントがゼロスキルと報告した場合など)。
  • エージェントがある機能を必要としたが、skillgram missing "<query>" が found:false を返した。
  • インストールまたは登録が、ドキュメントに記載された再起動後もハーネスに反映されなかった。

以下の場合は対象外: "X の実行方法"(INSTALL.md を参照)、または観察されたギャップのない機能アイデア。

厳格なルール

  1. バグはスキルとして報告しないでください。壊れた動作を隠すために propose を実行しないでください。
  2. ギャップはバグとして報告しないでください。ハブに機能がないことは リクエスト です。
  3. 捏造された証拠は禁止です。すべての終了コード、パス、JSON 行は、あなたが今実行したコマンドからのものでなければなりません。
  4. 貼り付ける前に、トークン、パスワード、プライベートホスト、顧客名を編集(マスク)してください。構造はそのままで、値を変更します。
  5. skillgram のバグを隠すために、ハーネス設定(config.toml、config.yaml、.claude.json、.cursor/mcp.json)を手動で編集して "修正" しないでください。
  6. 成功を主張する前に、設定を読み戻してください: <harness> mcp get skillgram(または mcp list)と skillgram status。終了コードだけでは証拠になりません。

判断ゲート

観察内容チャネル
ok:false、非ゼロ終了コード、間違ったリンク、出力の虚偽、クラッシュバグ → bug_report.yml
実際に必要だった機能に対して found:falseスキルリクエスト → skill_request.yml
欠けているものがスキルではなく、skillgram のコマンド、フラグ、または動作である場合バグ(タイトルに "feature" と記載)
別のマシンまたはハーネスで動作する場合証拠として記載するが、修正ではない
判断に迷う場合両方の証拠を収集し、ユーザーにチャネルを選択させる

実行手順

  1. 一度再現し、正確なコマンドラインを記録します。CLI(skillgram <command> --json、またはインストールされていない場合は python <repo>/skillgram.py <command> --json)を使用し、終了コード(PowerShell の場合は $LASTEXITCODE、POSIX の場合は $?)を記録します。
  2. 環境を取得します。
    • skillgram status --json
    • skillgram doctor --json(読み取り専用。公開したくないパスは削除してください)
    • OS、Python バージョン、skillgram バージョン、ハーネス、使用したランチャー(PATH 上のものとは異なる場合は SKILLGRAM_MCP_CLI_<HARNESS>)
  3. 登録の主張については、成功を主張したコマンドの 後 に <harness> mcp get skillgram(または mcp list)を取得します。
  4. ギャップについては、skillgram missing "<query>" --json と skillgram demand --limit 20 を取得します(これにより、誰も回答できなかったクエリがランク付けされ、Issue と需要ログが一致します)。
  5. テンプレートから Issue を作成し、投稿前にユーザーに表示します。投稿は gh issue create --repo Xhuk/skillgram --template bug_report.yml(またはフォームを自分で入力する場合は --body-file <file>)を使用するか、テキストを手渡します。

出力契約

正確に以下を返答してください。

  • チャネル: bug または skill-request
  • 証拠: コマンド、終了コード、1 行の JSON
  • 環境: OS / Python / skillgram / ハーネス / ランチャー
  • 期待される動作: 1 文、推測なし
  • 処置: 投稿済み(Issue URL 付き)またはユーザーにテキストとして提供

関連スキル