strzhao AI Todo - Task Management for AI Agents
通过 ai-todo CLI 管理任务、跟踪进度、维护工作日志。连接 ai-todo (https://ai-todo.stringzhao.life) 实现跨会话的持久化任务管理。
Prerequisites
运行任何命令前，先检查认证状态：
cat ~/.config/ai-todo/credentials.json 2>/dev/null
未认证则执行 ai-todo login。未安装则执行 npm install -g ai-todo-cli。
Command Discovery
命令从服务端动态加载，严禁硬编码。首次使用某命令前用 --help 发现参数：
ai-todo --help # 查看所有可用命令
ai-todo <command> --help # 查看具体命令的参数
关键约定：
- 默认输出 JSON，
tasks:tree输出纯文本 - 参数格式
--key <value>（snake_case，如--parent_id） - 命名空间：
tasks:*任务操作，spaces:*空间操作 - 退出码：0=成功，1=错误，2=未认证
核心工作流
第一步：了解任务结构（每次操作前必做）
ai-todo tasks:tree
输出树形文本，📌 标记项目空间，缩进显示父子关系。用于：
- 找到新任务应归属的项目空间或父任务
- 避免创建重复任务
- 理解现有任务拆分
关键原则：任务必须放到正确的项目和父任务下，不要在顶层随意创建。
查看任务
ai-todo tasks:tree # 全局任务树
ai-todo tasks:list --filter today # 今天的任务
ai-todo tasks:list --filter assigned # 分配给我的任务
创建任务
当用户描述工作计划或你识别到可拆分的事项时：
- 先
tasks:tree找到正确的归属位置 - 创建父任务（或复用已有的）
- 用
--parent_id创建子任务 - 合理设置优先级（P0=阻塞项，P1=核心，P2=非关键）
ai-todo tasks:create --title "实现支付功能" --priority P1
ai-todo tasks:create --title "对接微信支付" --parent_id <父任务ID> --tags backend
更新进度与完成任务
根据工作阶段选择合适的操作：
- 开始工作：
tasks:update --id <ID> --progress 20 - 阶段性进展：
tasks:update --id <ID> --progress 60+tasks:add-log --id <ID> --content "完成了XX" - 工作完成：
tasks:complete --id <ID>（自动完成子任务） - 只是记录：
tasks:add-log --id <ID> --content "做了XX"
当用户明确说"完成了"，直接用 tasks:complete；如果是阶段性进展，用 tasks:update 递增 progress。
Post-action（git commit/push/deploy 之后）
tasks:tree找到相关任务- 有关联任务 → 更新进度 + 添加日志 + 完成则
tasks:complete - 无关联任务 → 建议创建一个记录已完成的工作
- 轻量操作，一条日志总结即可
Pre-action（规划阶段）
用户讨论功能规划、技术方案、sprint 排期时：
- 从讨论中提取可执行事项
- 创建任务层级（父任务 + 子任务）
- 按依赖关系设置优先级
跨技能协作
- git-tools 完成后：记录进度到相关任务
- vercel:deploy 完成后：记录部署并完成相关任务
- brainstorming 结束后：将结论转化为任务层级