Bug を報告する
これは chengfeng-videocut のサポート窓口であり、第三の編集フローではありません。デフォルトでは公開 Issue のドラフトのみを生成します。外部への書き込みは、必ず匿名化プレビューとユーザーの確認を経る必要があります。
問題の説明
|
v
最小限の読み取り専用診断 -> 匿名化 -> リポジトリ/タイトル/本文を表示
|
ユーザーが明示確認
|
v
認証 + ラベルチェック + 重複チェック
|
v
GitHub Issue を作成
1. 再現可能なバグであることを確認する
最初に区別します:
- バグ:実際の動作が、既存の契約、UI、バージョン機能、または確定結果から逸脱している。
- 機能提案:製品がその機能を約束したことはない。バグとして偽装しないこと。
- 使用上の疑問:まず回答するか診断し、自動報告しない。
再現に必要な最小限の事実のみを収集すること。Runtime のインストール、Studio の起動、プロジェクトの変更、再編集、または「証拠」を得るためのメディアのアップロードを行わないこと。Runtime が存在する場合、プラグインルートから node scripts/ensure-runtime.cjs --json を実行して読み取り専用のプローブを行い、state / kind / version / healthy / error.code のみを保持します。完全な doctor 出力は添付しないでください。kind=desktop-managed はインストール元がデスクトップアプリであることを示すだけで、このスキルがアプリやサービスを起動したり再インストールしたりすることを許可するものではありません。存在しない場合は「検出されませんでした」と記述します。
2. 固定リポジトリを選択する
ワークスペースのルートディレクトリは必ずしも Git リポジトリとは限りません。現在のディレクトリから remote を推測することは禁止されています。
| 問題のコンポーネント | target | GitHub リポジトリ |
|---|---|---|
| Runtime、Studio、UI、CLI、API、タイムライン、レンダリング | product | Agentchengfeng/chengfeng-videocut |
| スキル、マーケットプレイス、インストールオーケストレーション、MCP アプリ、ワークフロー説明 | skills | Agentchengfeng/chengfeng-videocut-skills |
複数コンポーネントにまたがる問題は、最初に契約に違反したリポジトリを優先し、本文で別のコンポーネントについて説明します。判断できない場合は、まずユーザーに確認します。
3. 構造化入力を生成する
umask 077 で、現在のタスクの一時ディレクトリに候補を JSON として書き込みます。製品仕様ファイルには書き込まないでください。提出が完了したら、一時 JSON と Markdown を削除します。
{
"schemaVersion": 1,
"target": "product",
"component": "Studio",
"title": "Runtime 0.1.1 で HyperFrames のトップレベル剪口播ビューが開けない",
"summary": "影響を一文で説明",
"steps": ["ステップ1", "ステップ2"],
"expected": "期待される動作",
"actual": "実際の動作",
"environment": {
"Runtime": "0.1.1",
"OS": "macOS"
},
"evidence": ["最小限で公開可能な診断情報のみ"],
"acceptance": ["検証可能な修正条件"]
}
以下は禁止:
- API キー、トークン、Cookie、
.env; - 動画、音声、スクリーンショット、完全なログ、または書き起こし本文;
- 顧客名、元の動画名、実際の
projectId、ユーザーの絶対パス; - ユーザーの許可なくプライベートリポジトリのコンテンツ。
4. まず匿名化ドラフトを生成して表示する
現在の SKILL.md からスクリプトの場所を特定します。
まず更新確認の「準備確認」のステップ 1 に従ってプラグインルートを特定します(このスキルの実際のソースファイルパスから 2 階層上に遡ります。codex plugin list を実行したり、他のキャッシュを検索したりしないでください。以下の <プラグインルート> はすべてそのリテラルパスに置き換えます)。このスキルはスクリプトの場所を特定するためだけにこれを使用し、Runtime のインストールやサービスの起動は行いません。
node "<プラグインルート>/skills/chengfeng-report-bug/scripts/report-bug.cjs" draft --input "<報告JSONファイル>" --output "<草稿出力ファイル>" --json
target は product または skills で明確に指定する必要があります。欠落やスペルミスの場合は処理を停止し、黙って別のリポジトリに報告してはいけません。スクリプトは一般的な秘密鍵、ローカルユーザー名、ボリューム名、パスの余分な部分、localhost のクエリパラメータを自動的に削除します。自動匿名化は任意の顧客名を認識できるわけではないため、必ず人手での確認が必要です。ユーザーに以下を表示します。
repo
label=bug
title
完全な匿名化本文
同時に、返された confirmationReceipt を保存し、confirmationToken と有効期限をユーザーに表示します。ユーザーがこの公開コンテンツを明示的に確認しない限り、処理を停止します。単にエラーが検出されただけでは、報告への同意とは見なされません。トークンはドラフトの内容にのみバインドされており、それ自体がユーザーの同意を証明するものではありません。エージェントは、明確な返答を待たなければなりません。確認は現在のタスクの直後の 1 回の提出にのみ有効で、30 分で期限切れになります。タスクをまたいだり、再利用したりすることはできません。
5. 確認後に提出する
表示したばかりで内容が変更されていないドラフトに対してのみ提出します。
node "<プラグインルート>/skills/chengfeng-report-bug/scripts/report-bug.cjs" submit --input "<報告JSONファイル>" --target "<目標リポジトリ>" --confirmed --confirm-token "<確認トークン>" --receipt "<確認領収書ファイル>" --json
固定ルール:
- 提出前にスクリプトは
gh auth status、ターゲットリポジトリ、およびbugラベルをチェックします。失敗した場合はドラフトを保持します。 - 同じコンポーネント、再現手順、実際の結果のフィンガープリントが既に存在する場合は、元の Issue URL を返します。広範なタイトルで重複を偽装しないでください。
- 確認後に本文が変更された場合は
confirmation_mismatchを返し、再プレビューが必要です。 - 確認資格情報の期限切れまたは既に使用済みの場合は
confirmation_expired / confirmation_replayedを返し、再プレビューが必要です。 - 作成結果に明確な Issue URL がない場合、自動的に再試行しません。既に作成されている可能性があります。
- GitHub Issue URL を取得した場合のみ、「報告済み」と伝えることができます。
エラー処理
github_auth_required:ドラフトは完了しているが未提出であることを説明し、成功したと主張することを禁止します。github_issue_create_failed:ドラフトと手動エントリを保持し、ループ再試行しません。confirmation_required/confirmation_mismatch:正確な公開コンテンツを再表示します。- ターゲットリポジトリへの権限がない、またはアクセスできない場合:任意のリポジトリに報告先を変更しないでください。ユーザーに公開スキルリポジトリへの報告先変更を許可するかどうかを判断させます。