用途:当任务起点是产品评估而非明确的实现需求时使用。先评估产品,再提出具体改进候选;用户批准一项或多项后,实施到可合并状态,并重复评估循环。
主要能力:建立评估范围(产品、目标用户、主流程、成功标准、仓库、分支、部署或本地运行路径);读取 AGENTS.md 等本地说明;检查 git 状态并保留无关的用户改动;用 goal-manager 跟踪评估与实施目标;构建产品理解(读文档、路由、界面、测试、配置、近期变更,尽量本地运行;前端在真实浏览器中查看桌面与移动视口,API 或库检查公开接口、示例、错误行为、文档和测试覆盖);从用户价值、UX/UI、正确性、性能与可靠性、工程质量、安全与隐私等维度评估;在编辑前产出评估报告,按影响排序,区分必修缺陷、产品改进与猜测性想法;请求批准后实施;用 review 自审、默认开 ready-for-review PR(除非明确要求草稿)、监控 CI 与评审反馈、修正可处理问题;批准的改动实施后再复评并给出下一批候选。
使用方式:评估报告中的每项改进按“问题、影响、证据、修复方向、预估范围、风险、验证方式”组织。审批门用固定格式列出推荐项及影响/范围标签,并询问要实施哪几项。多选时按最小一致 PR 分组,不混入无关改进。视觉方向重要的 UI 改进先经 ui-imagegen-director;前端评估可配合 modern-web-guidance、Browser、Playwright;发布就绪评估用 release-check;PR 创建后需要跟进 CI 或评审时用 pr-guardian。
适用场景:产品整体评估、代码库端到端体检、从评估到实现再到 PR 的持续改进循环。
限制:不得虚构用户研究、指标、分析、安全发现或基准结果;间接证据须明确标注推断;评估可广泛检查,但实施不得超出批准范围;未经明确批准不得实施;沉默或含糊视为未批准;除非用户明确要求且仓库政策允许,否则不得合并 PR;无法合并时须清楚报告阻塞。最终报告应包含评估范围与证据、已实施的批准改进、PR 链接/分支/CI 与评审状态、实施前后验证、已解决的产品问题、待批准的剩余建议,以及使用目标跟踪时的目标状态。