上報 Bug
這是 chengfeng-videocut 的支援入口,不是第三條剪輯流程。預設只產生公開 Issue 草稿;外部寫入必須經過脫敏預覽與用戶確認。
問題描述
|
v
最小唯讀診斷 -> 脫敏 -> 展示倉庫 / 標題 / 正文
|
用戶明確確認
|
v
認證 + 標籤檢查 + 查重
|
v
建立 GitHub Issue
1. 確認這是可重現 Bug
先區分:
- Bug:實際行為偏離既有契約、介面、版本能力或確定性結果。
- 功能建議:產品從未承諾該能力;不要偽裝成 Bug。
- 使用疑問:先回答或診斷,不自動上報。
只收集重現所需的最小事實。不得安裝 Runtime、啟動 Studio、改專案、重新剪片或上傳媒體來「補證據」。Runtime 存在時,可從插件根目錄執行 node scripts/ensure-runtime.cjs --json 做唯讀探測,只保留 state / kind / version / healthy / error.code;不要附完整 doctor 輸出。kind=desktop-managed 只表示安裝來源是桌面 App,不授權本 Skill 啟動 App、服務或重新安裝。不存在就寫「未檢測到」。
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": ["第一步", "第二步"],
"expected": "預期行為",
"actual": "實際行為",
"environment": {
"Runtime": "0.1.1",
"OS": "macOS"
},
"evidence": ["只放最小、可公開的診斷"],
"acceptance": ["可驗證的修復條件"]
}
禁止放入:
- API Key、Token、Cookie、
.env; - 影片、音訊、截圖、完整日誌或逐字稿正文;
- 客戶名、原影片名、真實
projectId、用戶絕對路徑; - 未經用戶允許的私人倉庫內容。
4. 先產生並展示脫敏草稿
從目前 SKILL.md 定位指令碼:
先依檢查更新「就緒檢查」第一步定位插件根
(從本 Skill 的實際原始檔路徑向上兩級;不得跑 codex plugin list 或搜尋其他
cache;下述 <插件根> 都代入該字面路徑)。本 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 仍必須等待明確回覆。確認只對當前任務中緊接著的一次提交有效,30 分鐘過期,不能跨任務或重複使用。
5. 確認後提交
只對剛剛展示、內容未變化的草稿提交:
node "<插件根>/skills/chengfeng-report-bug/scripts/report-bug.cjs" submit --input "<報告JSON檔案>" --target "<目標倉庫>" --confirmed --confirm-token "<確認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 倉。