用途:审查 Shopware 6 的 GitHub 拉取请求或本地 diff,可由交互式路径驱动,也可在 GitHub Agentic Workflows(gh aw)中无人值守运行,以 PR 评论形式发布发现。两种模式共用 .github/aw/shared/sw-review-policy.md 的评分标准与相同 personas/、references/ 文件,避免实质漂移。
主要能力:按角色划分审查视角,角色 slug 为 security、architecture、code-style、ux、open-source,用户可覆盖强制指定某一角色。编排流程先一次性收集上下文(PR 用 gh auth status、gh repo view、gh pr view、仅名称 diff,再取完整/分页 diff;本地基干回退 main/master),然后分类路径与统计、标记生成/锁文件、标记公共 API、UI、迁移与依赖信号;大型 PR 按 DIFF-DISCIPLINE.md 上限节流,至少保留 needs_human_review 决策;按 COST.md 分层路由成本(不出现供应商或模型名);按角色分片 diff(security 看边界、配置、依赖、日志;architecture 看源码、测试、迁移、API、热路径;code-style 只看源码;ux 看 admin、storefront、snippets、Twig、SCSS;open-source 看 UPGRADE、弃用、公共 API、提交)并并行派发,每个 worker 仅得相关分片。合并阶段解析 worker JSON、按 CLASSIFICATION.md 去重、丢弃低于置信度下限的发现,计算评审字段与简短 persona_summaries,且不打印被丢弃的低置信候选。
使用方式:输入块支持旧式 <input_json> 与密封式 <input_json_[a-f0-9]+>;密封模式以约定 nonce 的首个块为准,旧式为第一个 <input_json> 获胜;persona 与 personas 同时存在时 persona 优先。首个可信输入块决定角色:缺失时为编排器(交互),输出紧凑 Markdown;带 personas 或两者皆无时为编排器(包装喂入),输出合并 JSON;带 persona:"<slug>" 时为角色 worker,输出每角色 JSON。worker 提示要求加载 personas/[slug].md、references/RUNTIME.md、references/CLASSIFICATION.md,必要时才加载 DIFF-DISCIPLINE.md,并加载 SCHEMA.md 确定 JSON 形状;只读被分配的 diff 切片,仅在出现候选发现后才扩展上下文,只输出一个 JSON 对象。优先使用 diff_path;若必须内联 diff,需转义以防不可信内容关闭输入块。
输出与限制:交互模式输出紧凑 Markdown,最多 5 条发现,每条为三行块(claim、Evidence、Fix),置信度显示如 confidence 0.85,状态行后附一行运行摘要,隐藏 persona 摘要、被跳过的角色及 requires_human(除非影响决策);无发现时输出 No findings.;发现严重度为 blocking、major、minor、nit,不把评审风险当作发现严重度。包装喂入/CI 模式仅输出模式兼容的合并 JSON,persona_summaries 保持简短("No findings." 或一条缺口),不输出成本或运行遥测。决策映射:comment→approve、request_changes→request changes、block→block、needs_human_review→needs human review。运行中不加载 SKILL.md、无关角色与 tests/;tests/ 仅作评估夹具。其余平台、价格等细节资料暂未提供。