resilient-coding-agent-skill
让长时运行的AI编程任务在tmux中持久化,抵御中断与重启。
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:resilient-coding-agent-skill。 它的用途是:让长时运行的AI编程任务在tmux中持久化,抵御中断与重启。 完整的 Skill 内容见:https://321skill.com/skills/resilient-coding-agent-skill/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请使用resilient-coding-agent技能,在项目`/home/user/project`中启动一个名为`refactor-auth`的长期任务,让Claude Code自动重构用户认证模块。” 它会创建一个安全的临时目录存放任务详情,并在后台启动一个独立的tmux会话来运行Claude Code代理。即使你的AI工作流主程序重启,这个重构任务也会在tmux中继续运行,完成后会通知你。
介绍
该Skill解决了在AI辅助编程中,长时运行任务(如大型代码生成、重构)因编排器重启、进程崩溃或网络波动而意外中断的问题。它通过将AI编程代理(如Codex CLI、Claude Code)的运行环境与编排器解耦,利用tmux会话进行托管,并借助代理原生的会话恢复能力,实现任务中断后的自动续跑。
使用时,用户通过编排器启动任务,该Skill会自动创建安全的临时目录存放任务提示词和事件日志,并在独立的tmux会话中执行AI代理命令。即使编排器重启,tmux会话中的任务进程依然存活,并可从中断点恢复。
它适合需要长时间、稳定运行AI编程任务的开发者,尤其是在处理复杂项目、进行大规模代码生成或自动化重构时,对任务连续性和可靠性有较高要求的场景。
与直接调用AI代理或使用普通后台任务相比,其核心区别在于引入了tmux作为进程守护层,并结合了安全的临时文件管理机制,不仅保证了任务存活,还通过严格的提示词文件化处理避免了命令注入风险,实现了生产级可靠性与安全性。
核心特点
核心区别在于将AI编程代理进程与编排器进程通过tmux彻底解耦,确保编排器重启不影响任务执行;同时,它设计了安全的临时文件工作流,将提示词写入文件而非拼接命令,从根本上防止了shell注入风险。
注意事项
不适合运行时间短(如5分钟内)的简单编程任务,因为引入tmux会带来额外的开销。
常见问题
这个Skill和直接后台运行AI代理命令有什么区别?
直接后台运行的任务与启动它的shell终端绑定,终端关闭或编排器重启会导致任务被终止。而本Skill使用tmux会话作为独立容器,任务生命周期与tmux服务绑定,不受上层进程影响。
任务中断后如何恢复?
恢复是双重的:首先,tmux会话本身保持活动,进程未终止;其次,对于支持会话恢复的AI代理(如Codex),Skill会自动捕获并存储其会话ID,以便在需要时(如进程意外退出后)能通过`--resume`等参数从断点续跑。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/resilient-coding-agent-skill/raw/index.md 读取 resilient-coding-agent-skill 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/resilient-coding-agent-skill/raw/index.md(查看排版版本)