SuperAPI AI 工具集

cy-execute-task

智能体与模型

查看项目

更新于 10-16 03:17

技能介绍

用途:依据给定的任务规格与 PRD 上下文,端到端执行一个 PRD 任务,并更新任务跟踪状态。

必要输入:任务规格 Markdown、PRD 目录路径、任务文件路径、主任务文件路径、自动提交模式。可选输入:工作流记忆目录路径、共享工作流记忆路径、当前任务记忆路径。

主要流程:读取任务规格、调用方指定的仓库指引文件、PRD 目录下的文档(尤其是 _techspec.md 与 _tasks.md),以及 PRD 目录 adrs/ 子目录中的 ADR,理解架构决策背景。若任务规格、techspec 与 ADR 之间存在需求冲突,应停止并报告冲突,而不是猜测继续。若提供工作流记忆路径,需在改代码前使用已安装的 cy-workflow-memory 技能,并先校正当前工作区状态。

执行检查清单:提取交付物、验收标准,以及每一项显式的 Validation、Test Plan 或 Testing 条目,编号成清单并在实现前完整打印。同时捕获“改动前仍证明任务未完成”的具体信号。清单作为门禁,逐项产出证据后才推进到验证。

实现与验证:实现时严格限定在任务规格范围内,遵循仓库既有模式与真实依赖 API,超范围工作记录为后续事项而非静默扩大任务。运行任务规格中列出的全部测试与验证命令,并使用已安装的 cy-final-verify 技能,此步骤无论自动提交模式如何均为强制。验证后进行自查,解决所有阻塞问题再继续。

跟踪与提交:先更新记忆文件(记录决策、经验与涉及面),再按顺序更新任务文件复选框、任务状态、主任务文件,最后提交。仅当实现与证据真正完成才标记子任务完成,仅当验证与自查干净才改为 completed。应用状态、清单或提交更新时读取 references/tracking-checklist.md。若启用自动提交,在验证、自查与跟踪更新完成后创建一个本地提交;若禁用,保留 diff 供人工审查提交,绝不自动推送。

限制与错误处理:若改动前信号无法直接复现,捕获最强可得基线信号并说明局限;若验证失败,保持任务状态不变直至解决;若跟踪文件缺失,停止并报告缺失路径。官方文本暂未提供。