byted-data-quality-review-loop
byted-data-quality-review-loop
将“所有已完成任务产出都必须经过严格独立复审”这一工作原则 Skill 化。其目标不是生成内容本身,而是在产出完成后,强制进入 评审 -> 修改 -> 再评审 的闭环,直到没有需要优化的问题为止。
适用场景
- 准备交付/提交/发布/输出最终结果时
- 用户明确要求“评审/挑错/过一遍/复审/质量门禁”时
- 当前执行 Agent 需要对产出做高标准、零妥协的最终把关时
输入要求
- 当前产出物(必须):可以是代码、文档、方案、配置、脚本、图片、音频、视频、演示文稿、网页页面、数据结果、文件路径、链接等
- 任务上下文(可选但推荐):目标、约束、受众、风格要求、已有规范
- 若缺少明确验收标准,由 subAgent 基于自身 Soul 与任务上下文自行补全本轮评审准则,并在评审报告中明确声明
核心流程(多轮闭环)
- 当前执行 Agent 整理“当前产出版本”及可用的任务上下文。
- 通过
sessions_spawn启动 subAgent 进行独立评审(Round N)。 - subAgent 输出结构化《评审报告》(见下方固定格式),明确 Pass/Fail 与问题清单;如果本轮评审准则来自其自身 Soul 与任务上下文补全,也必须在报告中显式说明。
- 当前执行 Agent 按问题清单逐条修改,并做必要验证(按产物类型选择合适方式,例如:测试/对照示例/事实核对/一致性检查/链接可用性与引用完整性/格式与渲染检查/可复现步骤验证/音视频播放检查/字幕与画面同步检查/音频清晰度与噪声检查/封面与素材一致性检查等)。
- 回到步骤 2,重复评审与修改,直到满足终止条件。
终止条件与保护上限
- 默认通过门槛:
Blocker = 0且Major = 0 - 默认最多评审轮次:
3轮 - 超过上限仍未通过:当前执行 Agent 必须汇报剩余问题、风险与建议方案,并请求上层流程决定:
- 继续增加轮次,或
- 接受风险并交付当前版本
subAgent 评审规范(必须遵守)
- subAgent 只做“审核把关与挑错”,不直接改产出,不替当前执行 Agent 写最终版本。
- 坚持高标准、严要求、吹毛求疵:优先发现会导致失败/回滚/误导/维护成本上升的问题。
- 不做妥协:如果存在必须修复项,结论必须为 Fail 或 Pass with fixes。
- 每条问题必须可行动:包含证据、影响、修复建议、验证方法;禁止泛泛而谈。
- subAgent 必须独立:只基于“产出物 + 上下文 + 自身 Soul 补全的评审准则”判断,不依赖当前执行 Agent 的推理过程。
- subAgent 必须按产物媒介切换评审标准:代码关注正确性与回归风险,文档关注事实、结构与可读性,图片关注信息准确性与视觉一致性,音频关注清晰度、噪声、断句、语速与口播错误,视频关注画面内容、时序、转场、字幕、音画同步与信息传达完整性。
原则边界
- 这是“工作原则 Skill”,不是角色设定 Skill,不负责定义 Agent 的职业身份或人格。
- 角色、专业身份、表达风格等内容应继续保留在各自的
SOUL.md中。 - 本 Skill 只负责注入统一的质量控制原则:凡有产出,必须经过独立挑错、多轮修正、直到达标。
严重级别说明(Severity Levels)
Blocker | 阻断级:不修复则不能交付或不能通过本轮评审的问题。Major | 重大问题:不会立刻阻断,但会显著影响质量、可信度、可用性或用户理解的问题。Minor | 次要问题:不影响主结论或主流程,但存在明显瑕疵,建议修复。Nit | 细节优化:措辞、排版、节奏、风格一致性等非关键优化项。
评审报告固定格式(subAgent 输出模板)
Review Round N
Conclusion / 结论: Pass / Pass with fixes / Fail
Severity Rule / 严重级别规则:
- Blocker = 必须修复,否则不能通过
- Major = 原则上应在通过前修复
- Minor = 建议修复
- Nit = 可选优化
Scope / 评审范围
- 本轮评审覆盖的产出类型与范围(例如:代码/文档/方案/配置/脚本/图片/音频/视频/页面;或具体文件/链接)
Must Fix / 必须修正
- [Blocker | 阻断级] 标题 / Title: ...
证据:...
影响:...
修复建议:...
验证方法:...
- [Major | 重大问题] ...
Should Fix / 建议修正
- [Minor | 次要问题] ...
Nice to Have / 可选优化
- [Nit | 细节优化] ...
Re-check Focus / 下轮复查重点
- 下一轮重点复查点(列 1-5 条)
More from bytedance/agentkit-samples
byted-web-search
火山引擎联网搜索 API,返回网页/图片结果。联网搜索场景优先使用本 skill。触发词包括:查/搜/找、真的吗/靠谱吗/确认/核实、最近/今天/最新/近期、出处/来源/链接、有什么/有哪些/推荐、价格/政策/汇率/行情、对比/区别/哪个好、听说/据说/不太确定、热搜/热门/火、帮我看/了解一下、求证/辟谣、值不值得/该不该。任务依赖在线事实或时效性时优先使用。若回答可能依赖外部事实,优先调用本 skill 再作答。支持 API Key / AK/SK。
371byted-seedream-image-generate
Generate high-quality images from text prompts using Volcano Engine Seedream models. Supports multiple artistic styles and aspect ratios. Use this skill when users want to create images from text descriptions, generate artwork in various styles, create visual content for creative projects, or need AI-powered image generation capabilities.
186byted-las-video-edit
Extracts and clips video segments from long videos using natural language descriptions. AI-powered smart video editing, video trimming, and video cutting powered by Volcengine LAS. Describe what you want — scenes, people, objects, actions, events — and get trimmed clips automatically. Video search and video content retrieval: find and locate specific people, objects, or scenes in footage. Supports reference images for person matching and object matching (search video by image). Two modes: simple (fast) and detail (thorough, optional ASR). Use this skill when the user wants to edit/clip/cut videos using natural language descriptions, extract highlights or key moments from videos, find specific people/objects/scenes in video footage (by text or reference image), compile highlight reels from long videos, trim video segments, or do AI-powered smart video editing.
164byted-las-pdf-parse-doubao
Parses and reads PDF documents into structured Markdown text using Volcengine LAS Doubao AI models. PDF parsing, PDF OCR, and document recognition — extracts text, headings, paragraphs, tables, charts, and layout structure from PDF files with high fidelity. Performs layout analysis including multi-column recognition and complex table extraction. Two modes: normal (fast, cost-effective everyday parsing) and detail (deep analysis for complex tables, charts, and multi-column layouts). Converts PDF to Markdown, PDF to text, and structured data. Digitizes scanned PDF documents and scanned images via OCR. Supports TOS paths, HTTP URLs, and local file upload. Async submit-poll workflow with batch processing support. Use this skill when the user wants to parse PDF files into Markdown/text, extract text/tables/charts from PDFs, convert PDF to Markdown format, do OCR on scanned documents, recognize PDF layout structure, digitize paper documents, process PDFs in batch, or extract structured data from PDF documents.
130byted-seedance-video-generate
Generate videos using Seedance models. Invoke when user wants to create videos from text prompts, images, or reference materials.
111byted-data-search
|
107