用途
recap-validate 是 Recap Studio 提供的一个验证技能,用于对 recap 页面内容进行多智能体质量审查并生成结构化报告。当用户输入 /recap validate、要求 Recap Studio“给页面打分”“运行验证”“对 recap 做 QA”,或希望获得多智能体质量报告时,应使用该技能。
主要能力
该技能运行一个验证委员会,由多个并行、相互隔离的审查者组成,各自从不同维度评估内容:
- fact-checker:每项声明必须引用 sourceMap id,且来源必须支持该声明;不受支持的声明会拉低分数。
- beginner-reviewer:面向聪明 18 岁读者的阅读时间不超过 5 分钟。
- accessibility-reviewer:检查分块、动效、焦点、密度。
- ux-design-reviewer:检查层级、打磨度、叙事性、响应式。
- performance-reviewer:检查打包体积、懒加载、静态优先、CWV 风险。
- security-privacy-reviewer:检查密钥、PII、提示注入线索、副作用面、不可信来源标记。
- skeptical-reviewer:检查过度声明、营销空话、隐藏复杂度。
每个审查者输出 { score: 1..10, findings: Finding[], blockers: string[] }。
使用方式
输入包括:
- 一个 RecapPageContent JSON(通过 packages/content-pipeline/src/load.ts 加载)。
- 渲染后的 Next.js 页面输出(apps/recap-web/.next/ 下的构建树),如果可用;否则审查者仅基于 JSON 工作,并相应降低性能与无障碍方面的置信度。
评分阈值(必须通过):事实 9、初学者 9、无障碍 9、UX 8、性能 8、安全 9、简洁性 9。
输出:写入 artifacts/<slug>/validation.json,并打印 Markdown 摘要,格式如下:
Validation report: <slug>
| Dimension | Score | Target | Status | Top finding |
|---|---|---|---|---|
| ... | ||||
| Blockers: |
- ... Auto-patchable:
- ...
适用场景
适用于需要对 recap 页面进行多维度质量把关的场合,例如在发布前运行验证、检查事实准确性、评估初学者可读性、无障碍、UX、性能、安全隐私以及是否存在过度声明等。
限制
该技能明确要求:绝不为了提高分数而虚报分数;绝不隐藏阻塞项;如果某个审查者无法运行(例如没有构建时无法进行性能审查),必须标记 confidence: low 并解释原因。