Communitygithub.com

Bug 上报 Skill

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

Bug 上报 Skill とは?

この Skill は、`chengfeng-videocut` 製品の GitHub Issue を整理、匿名化、および提出するためのエントリポイントです。これは単なる「3 番目の編集フロー」ではなく、ユーザーが明示的に「バグを報告する」または「この問題を開発者に伝える」と要求した場合にのみ作動します。この Skill は、まずユーザーの問題が再現可能なバグであるかどうかを確認し、機能リクエストや使用方法に関する質問を除外します。次に、`product`(`Agentchengfeng/chengfeng-videocut`)または `skills`(`Agentchengfeng/chengfeng-videocut-skills`)のいずれかの固定された GitHub リポジトリを選択します。その後、バグレポートを JSON 形式で構造化し、API キー、顧客名、機密ファイルなどの機密情報を除去するために匿名化スクリプトを実行します。生成されたドラフトはユーザーに提示され、ユーザーが明示的に確認した場合にのみ、認証、ラベルチェック、重複チェックを経て GitHub Issue が作成されます。この Skill は、ユーザーの明示的な同意なしに自動提出を防ぎ、Runtime のインストールやプロジェクトの起動を必要とせず、GitHub 認証エラーや確認トークンの不一致などのエラーを優雅に処理します。

対応✓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 のサポートエントリであり、3 番目の編集フローではありません。デフォルトでは公開 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 を推測することは禁止されています:

問題のあるコンポーネント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": ["最初のステップ", "2 番目のステップ"],
  "expected": "期待される動作",
  "actual": "実際の動作",
  "environment": {
    "Runtime": "0.1.1",
    "OS": "macOS"
  },
  "evidence": ["最小限の公開可能な診断のみを記載"],
  "acceptance": ["検証可能な修正条件"]
}

以下のものを含めることは禁止されています:

  • API キー、トークン、Cookie、.env
  • ビデオ、オーディオ、スクリーンショット、完全なログ、または転写されたテキスト
  • 顧客名、元のビデオ名、実際の projectId、ユーザーの絶対パス
  • ユーザーの許可なくアクセスされたプライベートリポジトリの内容

4. 最初に下書きを生成して表示する(匿名化済み)

現在の SKILL.md からスクリプットを特定します:

まず、更新確認の「準備確認」の最初のステップに従ってプラグインルートを特定します (この Skill の実際のソースファイルパスから 2 つ上の階層へ移動します。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 は明確な返信を待つ必要があります。確認は、現在のタスクの直後の 1 回の提出に対してのみ有効で、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) 架构、工程自修复、智能配音字幕及录屏变焦。

関連スキル