SuperAPI AI 工具集

implement_task

编程与开发

查看项目

更新于 10-16 07:51

技能介绍

用途

implement_task 是一个实现代理(Implementation Agent),被编排器(orchestrator)生成以执行大型计划中的单个任务。它使用全新上下文运行,完成工作后在返回前创建交接文档(handoff document)。该技能属于 continuous-claude-v3 项目,旨在通过任务链和交接文档实现跨会话的连续开发。

主要能力

  • 接收连续性账本(Continuity Ledger)、整体计划、具体任务、上一任务交接文档(如有)以及交接目录。
  • 按照测试驱动开发(TDD)执行任务:先写失败测试(RED),再写最小实现(GREEN),然后重构(REFACTOR),循环往复。
  • 支持两种代码编辑工具:morph-apply(适合大文件、批量编辑、尚未进入上下文的文件)和 Claude Edit(适合已读取的小文件、精确单次编辑)。
  • 可运行代码质量检查(如果配置了 qlty):qlty check --fix 或 uv run python -m runtime.harness scripts/qlty_check.py --fix。
  • 生成结构化交接文档,包含任务摘要、所做工作、修改文件、决策、模式/学习点、TDD 验证、代码质量、遇到的问题和下一任务上下文。
  • 在任务完成或被阻塞时均创建交接文档,并返回摘要给编排器。

使用方式

该代理由编排器通过 Task 调用生成,传入完整的 SKILL.md 内容以及上下文(连续性账本、计划、具体任务、上一交接、交接目录)。代理按照以下流程工作:

  1. 理解上下文:阅读上一交接(如有)和计划,明确任务在整体实现中的位置、成功标准和约束。
  2. 使用 TDD 实现:对每个功能点执行红-绿-重构循环。铁律:没有失败测试就不写生产代码。
  3. 选择编辑工具:根据文件大小和上下文选择 morph-apply 或 Claude Edit。
  4. 创建交接文档:使用指定目录和命名格式 task-NN-<short-description>.md,NN 为零填充任务编号。
  5. 返回编排器:返回任务编号、状态(success/partial/blocked)、交接文件路径和摘要。

交接文档模板包含 YAML 前置元数据(日期、任务编号、任务总数、状态)和正文各节。

适用场景

  • 大型实现计划被拆分为多个任务,需要逐个执行并保持上下文连续性。
  • 需要严格遵循 TDD 的开发流程。
  • 多代理协作开发,通过交接文档传递上下文。
  • 需要记录决策、学习点和阻塞情况以便后续任务参考。

限制

  • 该代理仅执行单个任务,不负责整体计划编排。
  • 依赖编排器提供上下文和交接目录。
  • 如果被阻塞,需在交接文档中记录阻塞原因并设置状态为 blocked,由编排器决定后续处理。
  • 代码质量检查仅在配置了 qlty 时可用。
  • 具体模型、收费、价格、平台等信息暂未提供。