@nguyenquangthai/pi-todo
为Pi代码助手提供实时TUI待办清单，管理编码任务。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@nguyenquangthai/pi-todo。 它的用途是：为Pi代码助手提供实时TUI待办清单，管理编码任务。 完整的 Skill 内容见：https://321skill.com/skills/nguyenquangthai-pi-todo/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“启动pi-todo，并添加‘初始化项目结构’、‘编写用户模型’和‘配置数据库连接’到待办列表。” 它会初始化清单并添加任务，同时TUI界面会实时显示这三个待办项。随后，当你完成一项后，可以说：“将‘编写用户模型’标记为完成。” TUI界面会立即更新进度，帮助你聚焦下一个任务。
介绍
这个Skill为Pi编码代理提供了一个类似OpenCode的会话待办清单系统，旨在解决在复杂或长周期编码任务中，开发者容易忘记阶段性目标、上下文切换导致思路中断的问题。它通过todowrite和todoread命令，结合一个实时更新的TUI（文本用户界面）覆盖层，让AI助手和开发者都能清晰看到当前会话的任务列表、进度和下一步行动。
使用时，开发者可以在与Pi代理的对话中，通过自然语言指令（如“将重构用户模块添加到待办列表”）来管理清单。TUI覆盖层会持续显示在终端或编辑器侧边，实时反映清单的变更，确保任务始终可见。这创造了一个共享的、动态的任务看板，将AI的规划能力与开发者的执行流程无缝结合。
它非常适合需要Pi代理协助进行系统性编码、重构或调试的开发者，尤其是在处理多步骤项目时，能帮助双方保持目标一致。对于喜欢在终端内工作、追求高效上下文管理的程序员来说，这是一个提升协作效率的理想工具。
建议在开始一个新的编码会话前就初始化待办清单，并养成随时用自然语言更新它的习惯。请注意，TUI覆盖层依赖于兼容的终端环境，在部分简化的Web终端或IDE中可能无法正常显示，此时可依赖纯命令交互。
核心特点
核心区别在于其“实时TUI覆盖层”，将待办清单以持久、可视化的形式固定在工作界面上，而非需要主动查询才显示的静态列表；同时，它深度集成于Pi代理的会话中，支持用自然语言直接操作清单，实现了任务管理与编码对话的一体化。
注意事项
不适合在无法支持TUI渲染的简化终端环境或纯聊天界面中使用。
常见问题
pi-todo怎么安装？
通过npm安装：`npm install -g @nguyenquangthai/pi-todo`。
TUI界面不显示怎么办？
请确保在支持TUI的终端（如iTerm2, Windows Terminal）中运行，并检查终端尺寸和兼容性。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/nguyenquangthai-pi-todo/raw/index.md 读取 @nguyenquangthai/pi-todo 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/nguyenquangthai-pi-todo/raw/index.md（查看排版版本）