用途
recipe-front-adjust 是一个用于在会话内调整已实现 UI 的工作流技能,其核心目标是在编辑后对照设计源进行验证。它适用于已经实现的前端功能,通过「编辑 → 对照设计源检查 → 细化」的验证循环在父会话中运行,而将一次性任务委派给子代理处理。
主要能力
该技能包含以下能力:
- 按 external-resource-context 技能进行外部资源听取
- 在父会话中检查现有模式和写入集
- 通过 documentation-criteria 进行结构边界判断
- 执行调整编辑并对照设计源进行验证(在本会话中运行)
- 通过 quality-fixer-frontend 进行质量验证
- 提交已确认的调整结果
使用方式
执行流程按以下步骤进行:
- 外部资源听取:仅当外部证据能改变当前调整目标或验证结果时,才运行听取协议;否则继续使用现有仓库/UI Spec 证据,并记录无外部引用。
- 确定路由和写入集:检查指定或当前 UI 以及识别可能写入集和保留可见行为所需的最小充分仓库证据。当 UI Spec 创建条件适用时,路由到 recipe-front-design 并停止。
- 规模判断:读取候选写入集,应用结构规模判断。0 个文件时升级给用户;直接调整时继续;需要设计时升级到完整前端设计阶段。
- 调整上下文:构建最小调整上下文,包括调整请求原文、现有 UI 模式和保留的可见行为、受影响文件列表、外部资源摘要和访问方法,并呈现给用户审查。此处有 [STOP] 标记,等待用户确认。
- 调整 + 验证(父会话):在规划或应用调整编辑前执行 frontend-ai-guide、typescript-rules、implementation-approach 技能;在添加或更改测试前执行 test-implement 技能。然后规划编辑、应用编辑,并对照外部源进行验证,细化并重新验证直到匹配。
- 质量验证:调用 quality-fixer-frontend 子代理,根据返回状态(pass、stub_detected、verification_incomplete、blocked)进行路由。
- 提交:在提交边界使用仓库状态作为主要证据,提交已确认的调整。
适用场景
适用于对已实现的前端 UI 进行会话内调整,且调整遵循现有组件、状态、交互和验证模式,处于单一职责边界内。
限制
当请求跨越职责或已批准的 UI 边界、需要完整设计文档,或包含通过 documentation-criteria 的 Choice 和 Durability 过滤器的技术选择时,会升级到完整的前端设计阶段。当项目层文件声明某个轴没有自动验证机制时,需要用户手动确认结果,或在有规范文件时使用基于文件的比较。