Cadence Skill 技能

Cadence — Git 原生的 AI Todo CLI

技能简介

Cadence 是一款专为 AI 智能体设计的一级用户（first-class user）打造的本地 Todo CLI 工具。与其他 Todo 应用不同，Cadence 将 Git（你本来就装着的版本控制工具）作为任务的历史记录层、同步层和撤销层，而不是自己另起炉灶做一个功能更弱的历史系统。其核心价值在于：每一次任务变更（包括 AI 智能体发起的变更）都有可追溯的原因记录和原子级的撤销能力，真正让 AI 参与任务管理变得安全可控。

核心能力

• 任务分解：将模糊的大任务分解为具体的独立可执行子任务，支持 MCP 协议工具 decompose_task
• Git 驱动的历史追溯：每一次 reprioritise、schedule、edit 都是一个 Git 提交，执行 cadence why 可以直接看到任务变更的历史原因
• 原子级撤销：cadence undo 相当于 git revert，撤销上一个操作（无论是你还是 AI 执行的），不像传统 todo 应用只支持部分操作的撤销
• 无服务器同步：cadence sync 通过 Git remote（可以是私有仓库、U 盘、或任何 Git 可访问的地方）同步任务列表，无需任何账号或托管后端
• MCP 服务器：内置 MCP 协议服务，AI 智能体可以通过 MCP 工具直接操作任务列表
• 任务优先级管理：支持 none/low/medium/high 四级优先级，配合 --reason 参数记录变更原因
• 纯本地优先：无需网络账户，任务数据存储在本地 .cadence 目录，隐私完全由用户掌控

安装配置

前置要求：Python ≥ 3.11，Git

Debian/Ubuntu 系统（使用 pipx 安装，规避 externally-managed-environment 错误）：

sudo apt install -y pipx
pipx ensurepath
pipx install cadence-todo

macOS（Homebrew Python）：

pipx install cadence-todo

手动 venv 安装（任何系统）：

python3 -m venv ~/.venvs/cadence
source ~/.venvs/cadence/bin/activate
pip install cadence-todo

验证安装：打开新终端后执行 cadence --version

使用步骤

1. 添加任务：cadence add "计划玛拉的 30 岁生日派对"
2. 分解任务：cadence decompose 1 --into "预订场地" "订蛋糕" "发邀请函"（将任务 #1 分解为三个子任务）
3. 调整优先级：cadence reprioritise 2 high --reason "场地预订最快满额"
4. 查询变更原因：cadence why 2（查看任务 #2 的完整变更历史）
5. 撤销操作：cadence undo（撤销上一条命令造成的变更）
6. 同步任务列表（通过 Git remote）：

   cadence sync  # 推送到远程 Git 仓库并拉取更新

7. 连接 MCP 客户端：启动 MCP 服务器后，在 Claude Desktop 等支持 MCP 的客户端中配置连接 Cadence

适用场景

• AI 智能体参与任务管理：让 Claude Code 等 AI 工具帮你管理任务，同时保留完整的操作历史和人工监督能力
• 多人协作项目：通过 Git remote 同步任务，团队成员各自维护本地任务列表，通过 Git 分支管理
• 个人时间管理：需要精确追踪「为什么这个任务优先级被调整了」的高要求用户
• 软件开发流程：作为项目管理的轻量级工具，用 Git 管理任务变更，与代码变更在同一个工作流中

适用人群

• AI 编程重度用户：使用 Claude Code、Cursor 等工具，希望 AI 能够帮你管理任务清单的开发者
• Git 爱好者：已经习惯用 Git 管理一切，对基于 Git 的任务管理方式有天然接受度
• 注重审计追溯的用户：需要精确知道每个任务变更的原因和时间，不接受「黑箱」操作
• 隐私敏感用户：不希望任务数据存在任何第三方服务器上，完全本地存储

工作原理

Cadence 的核心设计思想是「用你已经信任的 Git 来管理任务」：

1. 任务数据库存储在 .cadence 目录，本质是一个 Git 仓库
2. 每次任务变更（add/decompose/reprioritise/schedule/done 等）执行 git commit
3. cadence undo 调用 git revert 撤销上一个提交，实现原子级撤销
4. cadence why 调用 git log 和 git blame 显示任务变更历史
5. cadence sync 执行 git push 和 git pull 实现无服务器的设备间同步

官方链接

• PyPI：https://pypi.org/project/cadence-todo/
• GitHub：https://github.com/dominicplouffe/Cadence