worktree-task-plugin

一个利用Git工作树和后台代理会话,自动化管理大型编码任务的Claude插件。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:worktree-task-plugin。
它的用途是:一个利用Git工作树和后台代理会话,自动化管理大型编码任务的Claude插件。
完整的 Skill 内容见:https://321skill.com/skills/worktree-task-plugin/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

'请实现一个完整的用户认证系统,包含OAuth2登录、JWT令牌管理和权限控制。这个任务比较耗时,请把它放到后台运行。' 它会自动识别这是一个大型任务,并调用Worktree Task Plugin,在独立的Git工作树中启动一个Claude Code代理来执行。完成后,你会收到系统通知。

介绍

Worktree Task Plugin 解决了开发者在处理大型、复杂或耗时的编码任务时,需要长时间占用主会话、担心网络中断或API限制导致任务失败的问题。它通过创建独立的Git工作树和后台代理会话,让任务在隔离的环境中自动运行,解放主会话用于其他工作。

使用方式非常灵活,既可以通过/worktree-task:launch等命令手动启动和管理任务,也可以在Claude主会话中描述大型任务时,由AI自动识别并触发该技能。插件会自动创建任务分支、启动代理(默认Claude Code)并监控执行。

该技能非常适合需要并行处理多个功能模块、进行大规模重构或运行长时间自动化脚本的全栈开发、后端开发和智能体开发者。对于需要将复杂任务拆解并独立运行的团队项目也很有帮助。

使用建议:对于关键任务,建议启用默认的自动恢复(auto-recovery)功能以应对API错误或网络中断。任务完成后,及时使用cleanup命令清理资源。注意,该技能依赖于Git和tmux环境,请确保它们已正确安装和配置。

核心特点

与普通后台任务插件不同,它深度集成Git工作树,为每个任务创建完全独立的代码环境,并内置了针对AI代理(如Claude Code)的自动错误恢复和冲突解决机制,能智能处理API限速、超时等问题,确保长任务稳定执行。

注意事项

不适合需要频繁交互或实时调试的快速原型开发和小型代码片段编写。

常见问题

任务运行中如何查看进度?

使用 `/worktree-task:status` 命令可以查看所有后台任务的运行状态和进度。

任务意外中断了怎么办?

插件默认启用自动恢复监控,会尝试自动重启。也可手动使用 `/worktree-task:resume <任务名>` 命令恢复。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/worktree-task-plugin/raw/index.md 读取 worktree-task-plugin 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。