@4fu/pi-todo

在 pi 中管理任务和清单的会话感知工具

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:@4fu/pi-todo。
它的用途是:在 pi 中管理任务和清单的会话感知工具
完整的 Skill 内容见:https://321skill.com/skills/4fu-pi-todo/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

'创建一个任务,包含三个子项:存储、工具、测试',它会调用 todo 工具的 create 动作,将任务文本原样保存到当前会话中。之后你可以说'列出未完成的任务'来查看进度,或说'标记第一个任务完成'来更新状态。

介绍

这个 Skill 解决了在 AI 编码会话中无法持久化跟踪任务进度的问题。在实际开发中,开发者经常需要在多个对话分支中管理待办事项,但普通待办工具会修改原文或丢失上下文,导致进度混乱。

使用方式很简单,你只需要通过一个 todo 工具配合五个动作即可:create 创建任务(支持多级清单),list 查看未完成任务或单个任务详情,add 追加进度,complete 标记完成,cancel 取消任务。之后就可以通过自然语言指令来管理任务,所有数据自动保存在当前会话分支中,切换分支时进度自动跟随。

它非常适合需要频繁切换开发分支、管理多个并行任务的团队或个人。尤其是那些已经使用 pi 作为 AI 编码代理的用户,可以在不离开对话的情况下追踪任务状态,避免上下文丢失。

建议在开始新功能开发或项目迭代时统一使用此工具创建任务清单。需要注意的是,它主要依赖 pi 的会话分支机制,任务数据不会写入项目文件或全局存储,因此不适合需要跨会话长期保存的场景。

常见问题

任务数据保存在哪里?

任务数据存储在 pi 当前会话分支的工具结果事件中,切换分支时自动恢复,不会写入项目文件或全局存储。

如何查看已完成的任务?

使用 `list` 动作会显示未完成任务列表,并在末尾一行汇总已完成任务数量;使用 `list` 加任务 ID 可查看单个任务的完整进度历史。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/4fu-pi-todo/raw/index.md 读取 @4fu/pi-todo 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。