バグ報告と改善提案¶
SpecBind の CLI、製品管理のスキル、エージェント連携、インストール済みファイル、 ドキュメントに問題があるときや、ワークフローを改善したいときは、GitHub の Issue フォームから報告できます。CLI で入口を確認するには、プロジェクトの外でも次を実行できます。
このコマンドは、バグ報告と改善提案それぞれのフォーム URL、報告に含める情報、 公開前の注意を表示します。ブラウザを開かず、ネットワークへ接続せず、環境情報やプロジェクト内容を収集・送信しません。
バグを報告する¶
Bug report / バグ報告 では、次の情報を入力します。
- 問題の概要
specbind --versionの出力全体- 問題がある領域
- OS ・実行環境、インストール方法、関係する Agent やクライアントとそのバージョン
- 関係する CLI コマンド、スキル、またはインストール済みファイル
- 最小限の再現手順
- 期待した結果と実際の結果
- 診断コードを含む CLI 出力、生成された成果物、Git 差分などの観測可能な証拠
スキルの問題では、機密情報を除去した元の依頼も再現手順へ含めます。どのスキルが関係するか判断できない場合は、関連するコマンドまたはスキル欄にunknownと記載できます。
再現に必要な情報を残しつつ、アクセストークン、利用者名、非公開リポジトリ名、 ローカルパス、Spec や成果物の非公開内容は伏せてください。出力をそのまま公開してよいか、各行を確認してから送信します。
改善を提案する¶
Improvement proposal / 改善提案 では、対象領域、現在困っていること、対象ワークフロー、望ましい結果を入力します。 対象領域には CLI、製品管理のスキルやオーケストレーション、エージェント連携、成果物、 ドキュメントなどを選べます。
具体的なコマンドや実装案がなくても提案できます。まず問題と利用場面を説明し、 提案する振る舞いや現在の回避策がある場合だけ任意欄へ記載してください。
どちらにも当てはまらない場合¶
GitHub では blank Issue も利用できます。ただし、再現可能な不具合にはバグ報告、 製品やワークフローの変更案には改善提案フォームを使うと、確認に必要な情報を揃えやすくなります。