skillgram-report
起動条件
以下のいずれかに該当する場合、このスキルを使用してください。
- skillgram が
ok:falseを出力した、終了コード1/2で終了した、クラッシュした、またはディスクの状態と矛盾する内容を出力した (registeredと表示されたがハーネス設定に対応するエントリがない、存在しないリンクがある、マニフェストにスキルがあるのにマウントがゼロスキルと報告した場合など)。 - エージェントがある機能を必要としたが、
skillgram missing "<query>"がfound:falseを返した。 - インストールまたは登録が、ドキュメントに記載された再起動後もハーネスに反映されなかった。
以下の場合は対象外: "X の実行方法"(INSTALL.md を参照)、または観察されたギャップのない機能アイデア。
厳格なルール
- バグはスキルとして報告しないでください。壊れた動作を隠すために
proposeを実行しないでください。 - ギャップはバグとして報告しないでください。ハブに機能がないことは リクエスト です。
- 捏造された証拠は禁止です。すべての終了コード、パス、JSON 行は、あなたが今実行したコマンドからのものでなければなりません。
- 貼り付ける前に、トークン、パスワード、プライベートホスト、顧客名を編集(マスク)してください。構造はそのままで、値を変更します。
- skillgram のバグを隠すために、ハーネス設定(
config.toml、config.yaml、.claude.json、.cursor/mcp.json)を手動で編集して "修正" しないでください。 - 成功を主張する前に、設定を読み戻してください:
<harness> mcp get skillgram(またはmcp list)とskillgram status。終了コードだけでは証拠になりません。
判断ゲート
| 観察内容 | チャネル |
|---|---|
ok:false、非ゼロ終了コード、間違ったリンク、出力の虚偽、クラッシュ | バグ → bug_report.yml |
実際に必要だった機能に対して found:false | スキルリクエスト → skill_request.yml |
| 欠けているものがスキルではなく、skillgram のコマンド、フラグ、または動作である場合 | バグ(タイトルに "feature" と記載) |
| 別のマシンまたはハーネスで動作する場合 | 証拠として記載するが、修正ではない |
| 判断に迷う場合 | 両方の証拠を収集し、ユーザーにチャネルを選択させる |
実行手順
- 一度再現し、正確なコマンドラインを記録します。CLI(
skillgram <command> --json、またはインストールされていない場合はpython <repo>/skillgram.py <command> --json)を使用し、終了コード(PowerShell の場合は$LASTEXITCODE、POSIX の場合は$?)を記録します。 - 環境を取得します。
skillgram status --jsonskillgram doctor --json(読み取り専用。公開したくないパスは削除してください)- OS、Python バージョン、
skillgramバージョン、ハーネス、使用したランチャー(PATH上のものとは異なる場合はSKILLGRAM_MCP_CLI_<HARNESS>)
- 登録の主張については、成功を主張したコマンドの 後 に
<harness> mcp get skillgram(またはmcp list)を取得します。 - ギャップについては、
skillgram missing "<query>" --jsonとskillgram demand --limit 20を取得します(これにより、誰も回答できなかったクエリがランク付けされ、Issue と需要ログが一致します)。 - テンプレートから 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 付き)またはユーザーにテキストとして提供