SuperAPI AI 工具集

task-execution-simple

编程与开发

查看项目

更新于 10-15 10:05

技能介绍

用途

Task Execution Simple 用于端到端执行一个已准备的任务,不重新打开规划或规格工作。它适用于 task-preparation 已完成、任务本地文档已评审并就绪、下一步工作是分支隔离、实现、验证和收尾的场景。

不适用于以下情况:任务本地 spec.md 缺失、未评审或仍被阻塞;编码前发现 plan.md 触发条件且任务本地规划尚未完成;当前工作是路线图重塑、任务选择或任务本地设计。

主要能力

该技能负责:执行隔离、编码前就绪检查、实现、验证、由实现引起的文档与状态更新、实现评审暂停、分支关闭选择与破坏性清理门禁。

不负责:路线图分解或里程碑重塑、任务本地 spec.md 或 plan.md 的编写、因执行困难而扩大任务范围、将一般性的前进动作视为破坏性关闭操作的许可。

使用方式

进入条件:仅当任务本地文档完整到可直接实现时进入。若所需任务本地文档缺失、被阻塞或未评审,则路由回 task-preparation。默认在当前工作区创建专用任务分支;仅在用户明确选择时留在当前分支;仅在用户明确需要或并行/高冲突执行明显更优时使用 worktree。

默认流程:

  1. 创建执行隔离,完成编码前就绪工作。
  2. 实现所选任务。
  3. 验证行为,运行任务完成自检,并在同一轮更新受影响的文档。
  4. 在任务分支上提交已验证的实现工作。
  5. 暂停以进行实现评审。
  6. 评审后,更新任务文档状态以反映已接受的完成,并提交该后续更新。
  7. 进入分支关闭选择。
  8. 仅执行明确选择的关闭结果。

执行规则:以已批准的 spec.md 和可选 plan.md 作为范围与验证预期的依据。当代码与文档分歧时,代码是事实来源;当实现改变行为、API 形态、任务状态、架构假设或稳定约束时,在同一轮更新相关文档。执行中发现的未来工作默认放入当前里程碑 index.md 的 Handoff Notes,除非用户明确将其重新优先纳入当前工作。若相关现有自动化测试在任务期间失败,不能因任务未要求新增单元测试而忽略;优先修复生产代码以保持现有测试表达相同行为;若因任务有意改变行为而需要语义变更,需解释原因并在修改测试断言前获得用户确认;保持原始断言意图的小型测试文件修复无需单独确认。若 plan.md 包含提交检查点,将其视为可选稳定边界而非强制逐片提交。

任务状态规则:进入执行时任务应已处于 in_progress;若仍为 planned,则在编码开始前移至 in_progress。在隔离、实现、验证、实现评审或分支关闭尚未解决期间,保持任务为 in_progress。当因真实外部依赖、失败的前置条件、未解决的验证阻塞或用户明确暂停而无法继续时,使用 blocked。一旦可继续,将 blocked 任务移回 in_progress。在暂停进行实现评审前,完成任务级自检:验证通过、所需文档更新完成、任务本地清单项诚实可勾选。当已知任务清单或所需文档/状态更新仍不完整时,不要请求用户进行实现评审。实现评审被接受后,将任务标记为 completed,记录已接受的清单状态,并在呈现合并/删除/丢弃选项前提交该评审后任务文档更新。若用户之后选择丢弃工作,作为丢弃流程的一部分将任务状态从 completed 回退。

何时路由回:编码前若出现以下任一情况,路由回 task-preparation:所需任务本地文档缺失或不完整;任务仍有阻塞性的 Undecided 项;编码前出现真实的 plan.md 触发条件且 plan 尚不存在;任务边界看起来错误到执行将不得不发明新范围。

评审与默认后续:仅在已验证的实现工作已提交后暂停于实现评审,除非该提交被无关用户编辑、未解决的验证失败或用户明确指示阻塞。将实现评审后明确的前进语言视为许可,以最终确定已接受的任务文档状态并提交该非破坏性后续。实现评审后的默认后续:如需要更新任务本地清单状态;更新任务状态为 completed;提交已接受的任务文档状态更新;然后呈现关闭选项而不选择其一。分支关闭在明确选择一个结果前保持未解决。分支关闭未解决时不得开始另一个任务。

关闭结果:合并并保留分支、合并并删除分支、丢弃工作。使用 references/task-execution-detailed-rules.md 中的固定提示以编号选择呈现关闭结果。

硬性门禁:continue、ok 或 next 可进入关闭选择,但不选择关闭结果。git merge(包括快进合并)在合并结果明确前不得运行。删除分支或 worktree 始终需要在执行时明确确认。丢弃工作始终需要针对当前任务的全新明确确认。

输出

隔离、实现结果、验证结果、文档/状态更新、评审前完成检查、评审暂停、评审后任务状态更新、关闭选择。

停止点

实现评审暂停、关闭选择提示,或关于执行就绪或测试语义的直接阻塞性问题。

交接

Decided、Undecided、Next skill、Stop point。

限制

参考资料 references/task-execution-detailed-rules.md 仅用于低频执行边缘情况和固定关闭提示。