バグを報告する
これは chengfeng-videocut のサポートエントリであり、3 番目の編集フローではありません。デフォルトでは公開 Issue の下書きのみを生成します。外部への書き込みは、必ず匿名化プレビューとユーザーの確認を経てから行います。
問題の説明
|
v
最小限の読み取り専用診断 -> 匿名化 -> リポジトリ / タイトル / 本文を表示
|
ユーザーが明示的に確認
|
v
認証 + ラベルチェック + 重複チェック
|
v
GitHub Issue を作成
1. これが再現可能なバグであることを確認する
まず、以下の違いを区別します:
- バグ:実際の動作が、既存の契約、インターフェース、バージョン機能、または決定論的な結果から逸脱している。
- 機能リクエスト:製品がその機能を約束したことはない。バグとして偽装しないこと。
- 使用方法に関する質問:最初に回答するか診断し、自動報告しない。
再現に必要な最小限の事実のみを収集します。Runtime をインストールしたり、Studio を起動したり、プロジェクトを変更したり、クリップを再編集したり、メディアをアップロードして「証拠を補う」ことは絶対に行わないでください。Runtime が存在する場合は、プラグインのルートディレクトリから node scripts/ensure-runtime.cjs --json を実行して読み取り専用のプローブを行い、state / kind / version / healthy / error.code のみを保持します。完全な doctor 出力は添付しないでください。kind=desktop-managed はインストール元がデスクトップアプリであることを示すだけで、この Skill がアプリ、サービス、または再インストールを起動することを許可しません。存在しない場合は「未検出」と記述します。
2. 固定リポジトリを選択する
ワークスペースのルートディレクトリは Git リポジトリであるとは限りません。現在のディレクトリから remote を推測することは禁止されています:
| 問題のあるコンポーネント | target | GitHub リポジトリ |
|---|---|---|
| Runtime、Studio、UI、CLI、API、タイムライン、レンダリング | product | Agentchengfeng/chengfeng-videocut |
| Skill、Marketplace、インストールオーケストレーション、MCP App、ワークフロー説明 | 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": ["最初のステップ", "2 番目のステップ"],
"expected": "期待される動作",
"actual": "実際の動作",
"environment": {
"Runtime": "0.1.1",
"OS": "macOS"
},
"evidence": ["最小限の公開可能な診断のみを記載"],
"acceptance": ["検証可能な修正条件"]
}
以下のものを含めることは禁止されています:
- API キー、トークン、Cookie、
.env - ビデオ、オーディオ、スクリーンショット、完全なログ、または転写されたテキスト
- 顧客名、元のビデオ名、実際の
projectId、ユーザーの絶対パス - ユーザーの許可なくアクセスされたプライベートリポジトリの内容
4. 最初に下書きを生成して表示する(匿名化済み)
現在の SKILL.md からスクリプットを特定します:
まず、更新確認の「準備確認」の最初のステップに従ってプラグインルートを特定します
(この Skill の実際のソースファイルパスから 2 つ上の階層へ移動します。codex plugin list を実行したり、他の
キャッシュを検索したりしないでください。以下の <プラグインルート> はすべてそのリテラルパスに置き換えてください)。この Skill はスクリプトの特定にのみ使用し、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 と有効期限をユーザーに表示します。ユーザーがこの公開内容を明確に確認しない限り、停止します。エラーが検出されただけでは、報告への同意とはみなされません。トークンは下書きの内容にのみバインドされており、それ自体でユーザーの同意を証明するものではありません。Agent は明確な返信を待つ必要があります。確認は、現在のタスクの直後の 1 回の提出に対してのみ有効で、30 分で期限切れになり、タスクをまたいだり、再利用したりすることはできません。
5. 確認後に提出する
表示された直後で、内容が変更されていない下書きに対してのみ提出します:
node "<プラグインルート>/skills/chengfeng-report-bug/scripts/report-bug.cjs" submit --input "<レポートJSONファイル>" --target "<ターゲットリポジトリ>" --confirmed --confirm-token "<確認トークン>" --receipt "<確認レシートファイル>" --json
固定ルール:
- 提出前に、スクリプトは
gh auth status、ターゲットリポジトリの Issues、および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:正確な公開内容を再表示します。- ターゲットリポジトリに権限がない、または表示されない場合:任意のリポジトリに報告し直さないでください。ユーザーが公開 Skills リポジトリに報告し直すかどうかを決定できるようにします。