Communitygithub.com

报告 Bug

整理、脱敏并上报 chengfeng-videocut 的 GitHub Bug。用户说上报 Bug、反馈剪口播问题、提交 GitHub Issue、这个问题告诉开发者,或要求继续提交已预览的 Bug 草稿时使用。不要用于功能建议、普通排错、代码提交或未获用户确认的自动上报。

报告 Bug란 무엇인가요?

이 스킬은 사용자가 GitHub Issue를 통해 chengfeng-videocut 프로젝트에 버그를 신고할 수 있도록 지원합니다. 사용자가 '버그 신고', '클립/캐스팅 문제 피드백', 'GitHub Issue 제출', '이 문제를 개발자에게 알려주세요' 또는 '미리 본 버그 초안 제출'과 같은 요청을 할 때 트리거됩니다. 이 스킬은 기능 제안, 일반적인 문제 해결, 코드 커밋 또는 사용자 확인 없는 자동 제출에는 사용되지 않습니다. 지원되는 플랫폼은 chengfeng-videocut (제품) 및 chengfeng-videocut-skills (스킬, 마켓플레이스 등) 저장소입니다. 작동 방식은 최소한의 읽기 전용 진단을 수행하고, 민감한 정보를 제거하며, 버그 초안을 생성하여 사용자에게 표시한 후, 명시적인 확인을 받은 후에만 GitHub Issue를 생성합니다. 이 스킬은 Runtime이나 Studio를 설치하거나 시작하지 않으며, 사용자 확인 없이 데이터를 외부로 전송하지 않습니다.

지원 대상✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/2789927464king-jpg/video-skill-ku/tree/HEAD/chengfeng-videocut-skills/plugins/chengfeng-videocut/skills/chengfeng-report-bug

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

버그 신고

이것은 chengfeng-videocut의 지원 진입점이며, 세 번째 편집 워크플로우가 아닙니다. 기본적으로 공개 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는 설치 출처가 데스크톱 앱임을 나타낼 뿐이며, 이 스킬이 앱, 서비스 또는 재설치를 시작하도록 허용하지 않습니다. 존재하지 않으면 "감지되지 않음"이라고 기록하십시오.

2. 고정 저장소 선택

작업 공간 루트가 반드시 Git 저장소인 것은 아니며, 현재 디렉토리에서 remote를 추측하는 것이 금지됩니다:

문제 구성 요소targetGitHub 저장소
Runtime, Studio, UI, CLI, API, 타임라인, 렌더링productAgentchengfeng/chengfeng-videocut
스킬, 마켓플레이스, 설치 오케스트레이션, MCP 앱, 워크플로 설명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 키, 토큰, 쿠키, .env
  • 비디오, 오디오, 스크린샷, 전체 로그 또는 전사된 본문
  • 고객 이름, 원본 비디오 이름, 실제 projectId, 사용자 절대 경로
  • 사용자 허가 없는 개인 저장소 내용

4. 먼저 비식별화 초안 생성 및 표시

현재 SKILL.md에서 스크립트를 찾습니다:

먼저 업데이트 확인의 "준비 확인" 첫 번째 단계에 따라 플러그인 루트를 찾습니다. (이 스킬의 실제 소스 파일 경로에서 두 단계 위로 이동; codex plugin list를 실행하거나 다른 cache를 검색하지 마십시오. 아래 <플러그인 루트>는 모두 해당 리터럴 경로로 대체됩니다.) 이 스킬은 스크립트를 찾는 데에만 사용하며, 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과 만료 시간을 표시합니다. 사용자가 이 공개 내용을 명시적으로 확인하지 않으면 중단합니다. 오류 감지만으로는 신고 동의를 의미하지 않습니다. 토큰은 초안 내용에만 바인딩되며, 사용자 동의를 자체적으로 증명하지 않습니다. 에이전트는 여전히 명시적인 답변을 기다려야 합니다. 확인은 현재 작업에서 바로 다음에 오는 한 번의 제출에만 유효하며, 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 저장소로 변경 신고할지 결정하도록 하십시오.

Individual skills in this repo

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

2789927464king-jpg/video-skill-ku

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

2789927464king-jpg/video-skill-ku

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

2789927464king-jpg/video-skill-ku

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

2789927464king-jpg/video-skill-ku

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

2789927464king-jpg/video-skill-ku

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

2789927464king-jpg/video-skill-ku

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.

2789927464king-jpg/video-skill-ku

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

2789927464king-jpg/video-skill-ku

剪映 (JianYing) AI自动化剪辑的高级封装 API (JyWrapper),提供开箱即用的 Python 接口,支持录屏、素材导入、字幕生成、Web 动效合成及项目导出。全面适配 MacOS (Apple Silicon/Intel) 与 Windows,支持 v5.9+ (draft_info.json) 架构、工程自修复、智能配音字幕及录屏变焦。

관련 스킬