Files
agent-aide/aide-marketplace/aide-plugin/commands/exec.md

3.7 KiB
Raw Blame History

description, argument-hint
description argument-hint
任务执行流程。基于任务细则执行任务,包含流程设计、迭代实现、验证交付、文档更新。
任务细则文档路径

Aide 任务执行

你正在执行 Aide 任务执行流程。基于任务细则完成实际的任务实施。

参数

  • $ARGUMENTS:任务细则文档路径(可选)
  • 未传入时使用配置中的默认路径

前置准备

首先触发 aide skill 学习 aide 命令的使用方法。

这是必要步骤,确保你了解 aide flow 等命令的正确用法。


开始

确定任务细则

# 如果传入了参数
细则文档 = $ARGUMENTS

# 如果未传入参数,使用配置默认值
aide config get task.spec

读取任务细则内容。如文档不存在,提示用户先执行 /aide:prep 或指定文档路径。

进入流程设计环节

aide flow next-part flow-design "进入流程设计环节"

环节 1流程设计 (flow-design)

理解任务细则

  • 明确任务目标和成功标准
  • 理解执行步骤和依赖关系
  • 识别技术决策和约束

分析项目环境

根据需要阅读相关代码/文档。

制定执行计划

  • 具体的实现步骤
  • 每个步骤的预期产出
  • 潜在风险和应对方案

复杂任务建议使用 sequential-thinking 进行结构化规划

创建流程图(如需要)

在配置指定的流程图目录创建 PlantUML 源文件。

aide flow next-step "流程图设计完成"

aide flow 会在此环节自动校验 PlantUML 语法

进入下一环节

aide flow next-part main "流程设计完成,进入实现环节"

aide flow 会自动生成 PNG 流程图


环节 2迭代实现 (impl)

按计划执行

对于每个实现步骤,完成后记录:

aide flow next-step "<完成内容简述>"

处理问题

# 一般问题(可继续)
aide flow issue "<问题描述>"

# 严重错误(需解决)
aide flow error "<错误描述>"

严重错误处理:

  1. 尝试自行解决最多3次
  2. 成功:在 discuss/ 创建分析文档
  3. 失败:停止并告知用户

需要回退时

# 回退到上一步
aide flow back-step "<原因>"

# 回退到之前环节
aide flow back-part <环节名> "<原因>"

进入下一环节

aide flow next-part verify "实现完成,进入验证环节"

环节 3验证交付 (verify)

对照任务细则验证

  • 每个成功标准是否满足
  • 每个交付物是否完成
  • 功能是否正常工作

执行测试

根据项目情况运行测试或手动验证。

记录结果

aide flow next-step "验证完成: <验证结论>"

验证失败时回退修复:

aide flow back-part main "验证失败: <原因>"

进入下一环节

aide flow next-part docs "验证通过,进入文档环节"

环节 4文档更新 (docs)

aide flow 会在进入此环节时提示更新 CHANGELOG

更新相关文档

  • README.md(如有用户可见变更)
  • CHANGELOG.md
  • 其他相关文档

记录完成

aide flow next-step "文档更新完成"

进入下一环节

aide flow next-part finish "文档更新完成,进入收尾"

aide flow 会校验 CHANGELOG 是否已更新


环节 5收尾 (finish)

清理工作

  • 删除临时文件和调试代码
  • 确保代码格式规范
  • 检查遗漏的 TODO

最终检查

确认所有计划步骤已完成。

记录完成

aide flow next-step "任务完成"

向用户汇报

总结本次任务:

  • 完成了什么
  • 主要变更点
  • 遗留问题(如有)