SuperAPI AI 工具集

recipe-front-adjust

前端与建站

查看项目

更新于 10-16 04:07

技能介绍

用途

recipe-front-adjust 是一个用于在会话内调整已实现 UI 的工作流技能,其核心目标是在编辑后对照设计源进行验证。它适用于已经实现的前端功能,通过「编辑 → 对照设计源检查 → 细化」的验证循环在父会话中运行,而将一次性任务委派给子代理处理。

主要能力

该技能包含以下能力:

  • 按 external-resource-context 技能进行外部资源听取
  • 在父会话中检查现有模式和写入集
  • 通过 documentation-criteria 进行结构边界判断
  • 执行调整编辑并对照设计源进行验证(在本会话中运行)
  • 通过 quality-fixer-frontend 进行质量验证
  • 提交已确认的调整结果

使用方式

执行流程按以下步骤进行:

  1. 外部资源听取:仅当外部证据能改变当前调整目标或验证结果时,才运行听取协议;否则继续使用现有仓库/UI Spec 证据,并记录无外部引用。
  2. 确定路由和写入集:检查指定或当前 UI 以及识别可能写入集和保留可见行为所需的最小充分仓库证据。当 UI Spec 创建条件适用时,路由到 recipe-front-design 并停止。
  3. 规模判断:读取候选写入集,应用结构规模判断。0 个文件时升级给用户;直接调整时继续;需要设计时升级到完整前端设计阶段。
  4. 调整上下文:构建最小调整上下文,包括调整请求原文、现有 UI 模式和保留的可见行为、受影响文件列表、外部资源摘要和访问方法,并呈现给用户审查。此处有 [STOP] 标记,等待用户确认。
  5. 调整 + 验证(父会话):在规划或应用调整编辑前执行 frontend-ai-guide、typescript-rules、implementation-approach 技能;在添加或更改测试前执行 test-implement 技能。然后规划编辑、应用编辑,并对照外部源进行验证,细化并重新验证直到匹配。
  6. 质量验证:调用 quality-fixer-frontend 子代理,根据返回状态(pass、stub_detected、verification_incomplete、blocked)进行路由。
  7. 提交:在提交边界使用仓库状态作为主要证据,提交已确认的调整。

适用场景

适用于对已实现的前端 UI 进行会话内调整,且调整遵循现有组件、状态、交互和验证模式,处于单一职责边界内。

限制

当请求跨越职责或已批准的 UI 边界、需要完整设计文档,或包含通过 documentation-criteria 的 Choice 和 Durability 过滤器的技术选择时,会升级到完整的前端设计阶段。当项目层文件声明某个轴没有自动验证机制时,需要用户手动确认结果,或在有规范文件时使用基于文件的比较。