Communitygithub.com

Agentchengfeng/chengfeng-videocut-skills

整理、脫敏並上報 chengfeng-videocut 的 GitHub Bug。用戶說上報 Bug、反饋剪口播問題、提交 GitHub Issue、這個問題告訴開發者,或要求繼續提交已預覽的 Bug 草稿時使用。不要用於功能建議、普通排錯、代碼提交或未獲用戶確認的自動上報。

chengfeng-videocut-skills 是什麼?

此技能專為 chengfeng-videocut 產品生態設計,提供結構化的 GitHub Issue 上報流程。它能自動化地將用戶反饋的 Bug 整理成脫敏草稿,並在獲得用戶明確確認後提交至指定 GitHub 倉庫,支援 product(主倉庫)和 skills(技能倉庫)兩個目標。技能會執行最小只讀診斷、脫敏處理、標籤檢查與重複檢測,確保 Issue 品質與資訊安全。支援 Claude Code、Cursor 和 Codex 等 AI 輔助開發工具,嚴格避免自動提交或繞過用戶同意。

相容平台✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/Agentchengfeng/chengfeng-videocut-skills/tree/HEAD/plugins/chengfeng-videocut/skills/chengfeng-report-bug

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

上報 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:

問題元件targetGitHub 倉庫
Runtime、Studio、UI、CLI、API、時間線、渲染productAgentchengfeng/chengfeng-videocut
Skill、Marketplace、安裝編排、MCP App、工作流程說明skillsAgentchengfeng/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 倉。

Individual skills in this repo

This repo contains 7 individual skills — each has its own dedicated page.

Agentchengfeng/chengfeng-videocut-skills

剪辑环境的唯一管理者:就绪检查(skills 是否最新 → Runtime 是否配套)、Skills 更新激活、Runtime 安装与体检。用户说检查更新、安装剪辑环境、装播放器、检查剪辑环境、剪辑环境就绪了吗、配置转录凭证时使用;业务 Skill(剪口播/字幕/画面/导出)第 0 步也引用本 Skill 的就绪检查。不用于剪辑、字幕、画面、导出本身或项目数据迁移。

Agentchengfeng/chengfeng-videocut-skills

剪辑中文口播原素材:逐词转录、词典修字出修字表、五轮扫描找口误与重复、汇总表与重复句子表、打开 Studio 让用户复核、复盘沉淀用户偏好与词典。只产出一份已复核的删词账本,不切媒体、不做字幕、不做分镜动画。用户说剪口播、处理口误、生成口播基础素材、继续剪口播,或确认卡回传 action=return_cut_review 时使用。不要用于执行物理剪切、导出剪后视频、单独安装、单独打开工作台或口播分镜成片。

Agentchengfeng/chengfeng-videocut-skills

把剪好的口播烧成一个成片文件:账本切片段、推近、字幕、HTML 画面层,一次全部烧进 mp4。用户说导出、出成片、烧字幕、渲染、导出视频、生成最终文件时使用。不要用于生成删词候选、写字幕、做画面动画。

Agentchengfeng/chengfeng-videocut-skills

给剪好的口播做字幕:直接用已有的逐词稿加账本算出剪后时间(不必导出、不必重新转录)、用词典和作者文稿改写听错的专名、按句子分屏、在 Studio 里逐屏复核。用户说做字幕、加字幕、改字幕、重新分屏、字幕不对时使用。不要用于删词剪辑、物理剪切、分镜动画或成片渲染。

Agentchengfeng/chengfeng-videocut-skills

操作 chengfeng-videocut 剪辑工作台的已有工程,通过 Runtime CLI 查工程与词句位置、添加或替换画面覆盖层、移除画面、删除明确指定的词句或片段、拆分裁剪移动已有片段、调整画布比例并回读核验。用户说插入片段、删掉这句、移除动画、换个画面、调整顺序或管理时间线时使用;先区分画面覆盖与主轨顺延插入,不负责自动判断口误、创作动画、制作字幕、导出或排查安装故障。

Agentchengfeng/chengfeng-videocut-skills

Create Ian Xiaohei-style HTML/SVG motion illustrations for Chinese articles, scripts, storyboard scenes, workflow explanations, concept metaphors, and short video visual aids. Use when the user asks for 小黑 SVG、漫画感 HTML、分层 SVG 动效、把小黑生图做成 HTML/SVG、可编辑矢量动效、口播流程动画、手绘漫画动效、正文配图动画, or wants a Xiaohei illustration style adapted into controllable HTML/SVG/GSAP output instead of raster image generation.

Agentchengfeng/chengfeng-videocut-skills

给剪好的口播配画面:在录屏上盖 HTML 层(圈重点标注 / 小黑整屏动画 / 推近),层绑字幕屏、由播放器逐帧驱动、直接在预览里看。用户说做分镜、配画面、加动画、圈重点、B-roll、做 storyboard 时使用。不要用于删词剪辑、字幕、物理剪切或成片渲染。

相關技能