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