버그 제출
이것은 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는 설치 출처가 데스크톱 앱임을 나타낼 뿐, 이 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": ["첫 번째 단계", "두 번째 단계"],
"expected": "예상 동작",
"actual": "실제 동작",
"environment": {
"Runtime": "0.1.1",
"OS": "macOS"
},
"evidence": ["최소한의 공개 가능한 진단만 포함"],
"acceptance": ["검증 가능한 수정 조건"]
}
다음 항목은 금지됩니다:
- API Key, Token, Cookie,
.env; - 비디오, 오디오, 스크린샷, 전체 로그 또는 전사된 본문;
- 고객명, 원본 비디오명, 실제
projectId, 사용자 절대 경로; - 사용자 허가 없이 개인 저장소 내용.
4. 먼저 생성하여 비식별화된 초안 표시
현재 SKILL.md에서 스크립트를 찾습니다:
먼저 업데이트 확인의 "준비 확인" 첫 번째 단계에 따라 플러그인 루트를 찾습니다.
(이 Skill의 실제 소스 파일 경로에서 두 단계 위로 이동합니다. 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는 여전히 명시적인 응답을 기다려야 합니다. 확인은 현재 작업에서 바로 다음에 오는 한 번의 제출에만 유효하며, 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 저장소로 변경하여 보고할지 결정하도록 합니다.