| name | chengfeng-report-bug |
| description | 整理、脱敏并上报 chengfeng-videocut 的 GitHub Bug。用户说上报 Bug、反馈剪口播问题、提交 GitHub Issue、这个问题告诉开发者，或要求继续提交已预览的 Bug 草稿时使用。不要用于功能建议、普通排错、代码提交或未获用户确认的自动上报。 |
| user-invocable | true |
上报 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 仓。
