Agent Skills
返回列表
Git 分布式待办

Git 分布式待办

AI Agent 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ae24263a/git-distributed-todo。

技能介绍

要解决什么问题

当你在多台机器或多个 Agent 运行时各自跑着独立的 AI Agent,却又需要一起维护同一份待办——而环境里没有公网 IP、不想搭中心库,也懒得常驻一台协调服务——常见做法是往共享网盘或一个大 JSON 里抢写,结果冲突、覆盖和「谁该改这条任务」一团乱。本技能把可移植的任务记录放进一个共享 Git 仓库,用拉取/提交来对齐状态,同时明确规定:不同步各 Agent 的数据库、会话、记忆、cron 或凭据。

如何工作

任务存储:tasks/ 下每个任务一个 JSON 文件,禁止全员改同一个 todos.json。字段里用 created_by 记录创建方,executor 指定唯一生命周期写入者(创建后只有 executor 能推进 start/complete/cancel)。

Agent 身份:每台参与主机配置稳定的 lowercase ID(如 nas-agent、dev-agent),可通过一次性 setup 写入 .git-distributed-todo.json,减少对环境变量的依赖。

同步纪律:决策与写入前先 pull/sync;CLI 在冲突时会 fetch、rebase 并重试,不自动 force-push。远程不可达时,不假设其他 Agent 已看到本地提交。

提醒合并:恰好一个 Agent 承担面向用户的 notifier;其它 Agent 不得各自发到期提醒。先汇总全库 due 且未通知的任务,拼成一条 digest(含 executor 标签),发送成功后再在 receipts/ 记录,避免用改 task 文件来标记「已提醒」。

生命周期:todo → doing → done;todo/doing 可 cancelled。CLI 会校验 executor 归属,错派请求会路由到声明的 executor,而不是抢写所有权。

边界与注意

这不是高频分布式队列或锁;需要亚秒级派发、强一致或大量竞争 worker 时,应使用数据库/消息队列。也不要用本技能镜像 Agent 私有运行时状态——只同步本工作流产生的任务 JSON。

使用场景

  • 家庭 NAS 与笔记本各跑一个 Agent,需把「备份检查」「依赖升级」分派给不同 executor 并共用同一远程仓库
  • 内网多台无公网 IP 的主机通过 GitHub/GitLab 出站 push,汇总各 Agent 的 open 任务给单一 notifier 发提醒
  • Dev 机创建任务指派给 `workbuddy-laptop`,在笔记本 Agent 上 start/complete,期间按规则先 sync 再写入
  • 线下先本地 bare 仓库试跑,确认 `tasks/` 一任务一文件与 executor 归属后再推到团队私有 Git

适合人员

  • 在多台内网机器部署 OpenClaw/Cursor 类 Agent、又不愿维护中心化待办服务的个人运维
  • 负责给不同主机上的 Agent 定 stable ID、划分 executor 与唯一 notifier 的 Agent 平台维护者
  • 用私有 Git 托管跨机任务、需要明确「谁有权改生命周期」的 small-team 工程师
  • 正在把 Agent 间协作从共享文档迁到可审计 Git 历史、但要避免同步会话/凭据的集成开发者