用途:在需要改动项目(增删改文件、调整配置、修复 bug、实现功能等)且任务包含多个可独立验收步骤时,用项目根目录下的 CSV 清单显式跟踪进度,并与 update_plan 双轨同步。
主要能力:CSV 表头固定为 id,item,status,done_at,notes;status 取 TODO/IN_PROGRESS/DONE,done_at 为 ISO 8601 完成时间,notes 可记文件路径、验证方式、commit 等。状态仅允许 TODO→IN_PROGRESS→DONE,任意时刻最多 1 行 IN_PROGRESS。plan 映射为 TODO→pending、IN_PROGRESS→in_progress、DONE→completed,且 step 文案与 CSV 的 item 保持一致。
使用方式:任务含 ≥2 个可独立验收步骤时调用 update_plan,拆成 3–12 条动词开头的步骤,第 1 步 in_progress,其余 pending;在项目根目录(优先 Git 根目录,否则当前工作目录)创建“{任务名} TO DO list.csv”。每完成一项就同步一次 CSV 与 plan;新增步骤只追加、不重排重编号;暂停时保留 CSV。全部 DONE 后删除 CSV,并将 plan 全部标记 completed。
可选脚本 scripts/todo_csv.py 支持 init、path、plan(推荐 --normalize)、start、advance、status、cleanup 等命令,例如:python3 ~/.codex/skills/todo-list-csv/scripts/todo_csv.py init --title "修复登录 bug" --item "复现问题" "加回归测试" "修复实现" "运行测试/构建"。cleanup 在未全部 DONE 时会拒绝删除。
限制:资料未提供该技能的收费、平台支持范围及效果数据。