# Chengfeng Report Bug

整理、脱敏并上报 chengfeng-videocut 的 GitHub Bug。用户说上报 Bug、反馈剪口播问题、提交 GitHub...

- Repository: https://github.com/Agentchengfeng/chengfeng-videocut-skills (3168 stars)
- Category: Git and review
- License: Apache-2.0
- Last updated: 2026-10-10
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add Agentchengfeng/chengfeng-videocut-skills --skill chengfeng-report-bug -g -a claude-code -y`
Codex: `npx skills add Agentchengfeng/chengfeng-videocut-skills --skill chengfeng-report-bug -g -a codex -y`
Cursor: `npx skills add Agentchengfeng/chengfeng-videocut-skills --skill chengfeng-report-bug -g -a cursor -y`
Gemini CLI: `npx skills add Agentchengfeng/chengfeng-videocut-skills --skill chengfeng-report-bug -g -a gemini-cli -y`

## Description

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

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 上报 Bug

这是 `chengfeng-videocut` 的支持入口，不是第三条剪辑流程。默认只生成公开 Issue 草稿；外部写入必须经过脱敏预览与用户确认。

```text
问题描述
   |
   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：

```json
{
  "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` 定位脚本：

先按[检查更新](../chengfeng-check-updates/SKILL.md)「就绪检查」第一步定位**插件根**
（从本 Skill 的实际源文件路径向上两级；不得跑 `codex plugin list` 或搜索其他
cache；下述 `<插件根>` 都代入该字面路径）。本 Skill 只用它定位脚本，
不装 Runtime、不起服务：

The rest: https://github.com/Agentchengfeng/chengfeng-videocut-skills/blob/HEAD/plugins/chengfeng-videocut/skills/chengfeng-report-bug/SKILL.md