Git 分布式待办
将以下提示词粘贴到你的 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 历史、但要避免同步会话/凭据的集成开发者