agent-autoloop(后台接活)

作者 设施特

用命令行 Agent 最烦的是“人得守着”,一走开事情就断。agent-autoloop 是个零外部依赖的自动化中台,装在你自己电脑上,一行配置就能接新 Agent。定时任务、GitHub Issue 自动派活,碰到要拍板的才发卡片到飞书或钉钉,你回完它接着干。

Github
Skill 编程开发 v1.0.0 热度 312

将提示词发送给你的 AI 安装该 Skill

复制下方提示词,粘贴到 Cursor / Claude Code / WorkBuddy 等本地 Agent,按说明安装。

请根据 https://www.cweto.cn/?ai_hub=skill_install ,安装本站 Skill @ai_hub/work-35(agent-autoloop(后台接活))。
详情页:https://www.cweto.cn/work-35.html
GitHub:https://github.com/KKKKhazix/agent-autoloop
请装到当前 Agent 的 skills 目录(见安装说明中的路径表),完成后重启或刷新 Agent。
安装说明 GitHub
支持的本地 Agent 目录
  • Claude Code → ~/.claude/skills/
  • Cursor → ~/.cursor/skills/
  • Windsurf → ~/.codeium/windsurf/skills/
  • Codex → ~/.codex/skills/
  • Gemini CLI → ~/.gemini/skills/
  • WorkBuddy → ~/.workbuddy/skills/
  • OpenClaw 变体 → 各自 skills 目录

Skill 说明

agent-autoloop 是什么

agent-autoloop 是一个极轻量的自动化中台,让你的命令行 Agent 在后台自己接活、自己跟进到底。平时不打扰你,遇到拿不准的事才发卡片找你拍板。

它把任务调度做成一个零外部依赖的内核,把事件来源、Agent、通知通道、甚至代码上线流水线全部拆成可随时插拔的插件。

特性说明
部署一台电脑一条命令,装在本机,不用云服务器,不开公网端口
接 Agent一行配置,不需要 SDK,不改 Agent 源码
界面没有后台界面,需要你决定时推卡片,看进展敲一行命令
通知通道飞书、钉钉、企微、Slack、Discord 或桌面通知
等待成本等你回复期间不占进程、不消耗 Token

它的运转逻辑:新事件进来(定时任务、GitHub 新 Issue、业务系统报错都变成标准事件)→ 内核按规则决定交给哪个 Agent、去哪个目录干活 → Agent 干完一轮就退出 → 碰到删数据、重启服务、花钱、对外发消息这类事,通过飞书或桌面通知发卡片问你 → 你选完,它接上原来的对话把剩下活干完。

agent-autoloop 怎么安装

支持 Windows、macOS 和 Linux。需要 Node 24 或更新、Git,以及一个已经登录的命令行 Agent;macOS/Linux 还需要 curl。

Windows PowerShell:

irm https://raw.githubusercontent.com/KKKKhazix/agent-autoloop/main/install.ps1 | iex

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/KKKKhazix/agent-autoloop/main/install.sh | sh

安装和 agent-autoloop update 都装最新 Release,是过了全部检查的版本。装好后用本机 Agent 真实走一遍流程:

agent-autoloop try

agent-autoloop 怎么使用

第一步:写规则。打开 ~/.agent-autoloop/rules.json,在 rules 里写清楚什么事、交给谁、在哪个目录干。比如每天早上 9 点写早报:

{
  "name": "早报",
  "when": { "cron": "0 9 * * *" },
  "to": "codex",
  "cwd": "~/notes",
  "prompt": "整理昨天的笔记和提交,写今天的早报。"
}

外部事件写法一样,只是要先在 sources 里登记来源。比如有人提新 Issue 时交给 Codex:

{
  "name": "处理 issue",
  "when": { "source": "github", "types": ["issues.opened"] },
  "to": "codex",
  "cwd": "~/code/app",
  "skill": "handle-issue",
  "parallel": 3
}

第二步:常用命令。保存后几秒内自动生效。

  • agent-autoloop check —— 检查规则
  • agent-autoloop rules explain —— 看生效的规则和下次定时
  • agent-autoloop pause <规则> / resume —— 暂停恢复
  • agent-autoloop run <规则> —— 立即跑一轮
  • agent-autoloop status —— 看进展和今日 Token 费用

第三步:Agent 怎么配合。中台对 Agent 只有一个约定——在最后一条回复里交代结果。需要请示时,回复末尾附一段 agent-autoloop 代码块,写明问题、选项和 key。除了提问,还能发通知、关闭卡片、预约复查、触发新事件。

就算 JSON 写错也不会重做业务,中台只让它在原会话里重写最后这段回复。

agent-autoloop 适合谁用

  • 用 Claude Code / Codex 但受不了必须守着终端的人
  • 想让定时任务、Issue 跟进、告警排查全自动跑
  • 不想为此买云服务器或开公网端口
  • 已经有飞书/钉钉/企微,想复用现有通知通道

仓库自带四套开箱即用的场景模板:每日早报、跟进 GitHub Issue、线上告警排查、用户反馈处理,每套都带规则、任务技能和启用说明。

agent-autoloop 项目地址

  • GitHub 仓库:https://github.com/KKKKhazix/agent-autoloop
  • 安装说明:https://github.com/KKKKhazix/agent-autoloop/blob/main/INSTALL.md