ac-task-executor

AC Task Executor 是一个用于自主编码（autonomous coding）的功能实现任务执行器。它的核心用途是编排功能实现的执行过程，管理任务队列，并在规划、实现和验证三个阶段之间进行协调。

主要能力

该工具提供三种执行模式：

1. 单功能模式：一次执行一个功能，例如 result = await executor.execute_feature("auth-001")。
2. 队列模式：连续处理功能队列，例如 await executor.execute_queue(max_features=10)。
3. 批量模式：批量执行多个功能，例如 results = await executor.execute_batch(["auth-001", "auth-002"])。

任务生命周期

每个任务遵循以下阶段：

1. SELECT：从队列中选择下一个功能。
2. PREPARE：加载上下文，生成测试（RED）。
3. IMPLEMENT：编写代码以通过测试（GREEN）。
4. REFACTOR：在测试通过的前提下清理代码。
5. VALIDATE：运行标准验证。
6. COMMIT：提交 Git 变更。
7. UPDATE：将功能标记为 passes: true。
8. NEXT：继续处理下一个功能。

使用方式

通过脚本导入并实例化执行器：

from scripts.task_executor import TaskExecutor

executor = TaskExecutor(project_dir) result = await executor.execute_next_feature()

执行结果

执行结果以 JSON 形式返回，包含功能 ID、状态、各阶段（prepare、implement、validate、commit）的成功状态与耗时、提交哈希、测试总数与通过/失败数，以及 token 用量和预估成本等指标。

错误处理

• 验证失败：最多重试实现 3 次。
• 测试失败：分析失败原因，调整方案。
• 超时：保存状态，创建交接以便继续。
• 严重错误：回滚到上一个检查点。

集成关系

使用：ac-state-tracker、ac-test-generator、ac-criteria-validator。 触发：ac-commit-manager、ac-qa-reviewer。 汇报对象：ac-session-manager。

适用场景

适用于需要自动化执行功能实现任务的自主编码流程，例如运行功能实现、执行构建任务、处理功能队列或进行编排。

限制

关于该工具的具体收费、价格、支持平台、实际效果等事实，资料中暂未提供。完整实现请参见 scripts/task_executor.py。