SuperAPI AI 工具集

reviewing-ffmpeg-skill-changes

办公与效率

查看项目

更新于 10-15 23:44

技能介绍

用途:审查 ffmpeg-skill 仓库的变更,重点是结果文档(JSON)中声明的真实性。该产品的消费者是读取 JSON 的智能体,而非观看视频,因此变更可能在 FFmpeg 层和 Python 层都正确,却在关键层说谎,如 status:"completed" 与非零退出码并存、verified:true 但工具未测量、无损裁剪因关键帧对齐移动 1.24 秒。

主要能力:检查每个写入工具输出的成功文档字段是否被实际测量。核心字段包括 status(非零退出码时 die() 必须设为 failed)、verified、reencodes_*、dropped_non_av_streams、keyframe_snapped 与 duration_delta_seconds、mode、error.kind 与 error.retryable(须为 false)。--dry-run 下 info() 应改写 wrote X 为 [dry-run] would write X;写入工具在 dry-run 下打印写入声明即缺陷。

使用方式:先建立评审基线,读取被评审提交的树而非摘要或工作副本:git fetch origin && git log --oneline -1 origin/main;git diff --stat origin/main...HEAD;git show origin/main:docs/design-decisions.md | head -40。报告任何发现前,须指明所读文件与行号并确认符号仍存在。撰写前先 grep docs/design-decisions.md,避免重报已决定事项;并 grep 集中化检查:grep -rn "validate_color(" scripts/、grep -rn "apply_common()" scripts/、grep -rn "time_arg(" scripts/。

仓库规则:契约优先,python3 scripts/_contract.py --json 为工具名、标志、dry-run 语义和错误种类的来源;每个表面都需更新;SKILL.md 保持在 30,000 字节以内;每个脚本须出现在某演示命令行中;修复须附回归测试;仅标准库,Python 3.9+;不得有 AI/LLM 内容判断、云或 API 密钥、脚本外原始 ffmpeg/ffprobe 调用、输入文件变更。运行 npm test、npm run release-check、python3 scripts/_contract.py doctor。CI 为三 OS 矩阵,覆盖 FFmpeg 5.1、6.1、7.1、8.x/9.x,单机通过不等于已验证。

限制:评审按成本排序,先是结果文档中的虚假声明,其次缺失表面或测试,最后风格;报告须说明已运行与未验证的检查。深度安全审计留给专门的安全审查。参考文件包括 references/result-honesty.md、references/surfaces.md、references/review-checklist.md。该技能为仓库本地,不重复 writing-defect-reports、verifying-external-behavior、reproducing-ci-locally,而是指向它们。