☰
派个任务就离场:Kiro Crew 自主任务运行器完整教程(规划、重试、检查点恢复)
2026/9/25 4:44:32 网站建设 项目流程

派个任务就离场:Kiro Crew 自主任务运行器完整教程(规划、重试、检查点恢复)

【免费下载链接】KiroCrewA persistent workspace for development work that self-improves and continues beyond one session.项目地址: https://gitcode.com/gh_mirrors/ki/KiroCrew

Kiro Crew是一个能自主运行开发任务的开源工作区(Task Runner)。你只需要把任务描述交给它的任务运行器(Task Runner),它会自动规划步骤 → 逐步执行 → 失败重试 → 中途检查点保存,全程无需你守在终端前。网关重启也不怕,进度还能从检查点恢复。本教程带你从零跑通这个自主任务运行器。

1 分钟上手:安装并进入 Task Runner

一键安装

curl -fsSL https://download.crew.kiro.dev/cli.sh | sh

然后打开http://localhost:5476,在左侧导航栏点击Task Runner即可看到任务运行面板(如上图所示)。

💡 也支持桌面应用、Docker 部署和从源码构建,见 安装指南。

三种方式派任务

入口用法适用场景
网页面板左侧栏Task Runner→ 输入描述最直观,支持可视化审批
CLIkirocrew run TASK.md阻塞式执行,终端实时看进度
Slack发送run <path>、run status、run cancel人在手机上也能盯任务

面板里还提供✨ Compose(自然语言写需求)、From Spec(粘贴规格文件)、From YAML(工作流形状的 YAML 直接确定性解析,跳过 LLM 分解)三种模式。

任务规划:把一句话需求拆成可执行步骤

Task Runner 的核心机制是"先规划、后执行":

  1. 分解(Decompose):LLM 读你的任务规格,拆成一组带依赖关系的有序步骤,并给出验收标准(acceptance criteria)。
  2. 计划预览与编辑:计划生成后你会收到"📋 Plan ready"通知,可在面板里增删改步骤、调整执行顺序,甚至整份替换计划,再点 Execute。
  3. 每步独立会话执行:每个步骤拥有全新 ACP 会话(自动注入记忆、技能、项目上下文),做完一步提交一次 git,再进入下一步。

规划能力由 task_planner.py 实现,它负责 LLM 分解、依赖归一化和并行分组。

失败重试:三道防线

自主运行最怕"卡死在同一个错误上"。Task Runner 用三层机制兜底:

  • 🔁有界重试:步骤失败后自动重试,重试提示词里会带上上次的错误信息,让模型有针对性地改正。
  • 🚦循环检测:同一个错误连续出现 2 次发警告,第 3 次判定为"死循环"直接失败该步骤,不再空转。
  • 🔄重新规划(Replan):某步用尽重试预算后,运行器会带着失败上下文重新制定剩余计划(带次数上限),而不是整个任务推倒重来。

额外细节:每步通过后会 commit 一次;独立审查会话(Self-Review)基于真实的git diff检查代码,审查不过就回退该步提交再重试。git 隔离与提交协调见 git_coord.py。

检查点恢复:断了还能接着跑

这是 Task Runner 最让人放心的设计:

  • 持久化快照:运行状态在整个生命周期中持续写入runs.json(原子写入 + fsync),进度文件TASK_PROGRESS.md与规格文件并存。
  • 崩溃恢复:网关重启后,处于running的任务自动转为paused——不会留下"看起来在跑其实没人驱动"的僵尸任务;有 git worktree 的安全任务会从检查点自动恢复,只重跑未通过的步骤,已通过的步骤绝不重做。
  • 手动恢复:暂停(Pause)/恢复(Resume)是显式操作,点 Resume 即从中断处继续,不丢任何进度。

相关实现位于 task_reporter.py(save_progress/load_checkpoint/build_resume_context)。

实用配置与通知

  • 并行执行:无依赖的步骤可并行跑,并发度由taskrunner.max_parallel_steps控制,且永远不会超过"主机安全上限"(根据可用内存自动计算),配置热更新无需重启。
  • 自动审批(auto_approve):面板上可为单个运行勾选自动批准工具调用,真正解放双手——但钩子拒绝列表和force_approval强制审批门依然生效,安全兜底不缩水。
  • 全程通知:任务启动 🚀、步骤通过 ✅、步骤失败 ❌、卡住警告 ⚠️、完成汇总……都会推回你发起任务的那个会话(Slack/面板),离场不等于失联。
  • 卡死看门狗:活动感知式的停滞检测,只在真正零活动时先告警、再重置会话恢复,不会误杀。

源码与文档索引

资料路径
TaskRunner 模块规格(完整机制说明)docs/system-specs/modules/taskrunner.md
API 处理层(启动/取消/规划/精修)dashboard/handlers/taskrunner.py
步骤执行与重试task_executor.py
面板路由dashboard/routes/taskrunner.py

一句话总结:把任务规格交给 Kiro Crew 任务运行器,它替你规划、执行、重试、保存检查点;你只负责在通知到达时看一眼结果。派完任务,就可以离场了。

【免费下载链接】KiroCrewA persistent workspace for development work that self-improves and continues beyond one session.项目地址: https://gitcode.com/gh_mirrors/ki/KiroCrew

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询