SkillsAdd

smithery.ai

todo-list-csv

当需要修改项目（增删改文件）并希望将 update_plan 与 CSV 有机同步时使用此技能：在项目根目录创建“{任务名} TO DO list.csv”，用 TODO/IN_PROGRESS/DONE 驱动 plan 的 pending/in_progress/completed，同步推进，?

First seen Mar 17, 2026

Installation

$ npx skills add https://smithery.ai
View on skills.sh ↗ Website ↗

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

wecomcli-todo Similar name
wecomteam/wecom-cli

管理企业微信?

20.1K installs
wecomcli-get-todo-list Similar name
wecomteam/wecom-cli 2.5K installs
wecomcli-get-todo-detail Similar name
wecomteam/wecom-cli 2.5K installs
wecomcli-edit-todo Similar name
wecomteam/wecom-cli 2.5K installs
integrate-todo-list Similar name
cognitedata/builder-skills

TodoWrite panel for an already-approved in-app useAtlasChat UI. New AI features use integrate-f…

1.9K installs
todoist-api Similar name
intellectronica/agent-skills

This skill provides instructions for interacting with Todoist using the td CLI tool.

1.7K installs

Also in this package

Other skills from smithery.ai · top by installs.

npx skills add https://smithery.ai
smithery-ai-cli 7.8K frontend-design 6.2K skill-creator 2.5K ck:ui-ux-pro-max 1.3K pdf 1.2K xlsx 966 pptx 894 docx 884 webapp-testing 1 web-design-reviewer 657

Browse all from smithery.ai

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Skill metadata

Parsed from SKILL.md frontmatter.

Declared agents codex

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 4,478 B
  • docs SUMMARY.md 310 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 4 installs

SKILL.md

Todo List CSV

目标

在需要修改项目时，用一个位于项目根目录的 CSV 文件把工作拆成可勾选的步骤；在推进过程中持续更新；全部完成后删除该 CSV，避免把临时清单遗留或提交进仓库。

触发条件

  • 开始执行任何会改动项目内容的任务（新增/修改/删除文件、调整配置、修复 bug、实现功能等）
  • 任务具有多个可独立验收的小步骤，且需要显式跟踪完成状态

工作流（CSV + update_plan 双轨同步）

0) 启用 update_plan 的条件

  • 当任务包含 ≥2 个可独立验收步骤 时，调用 update_plan 建立计划并在执行过程中持续更新。

1) 拆解步骤并建立 plan（与 CSV 一一对应）

  • 拆成 3–12 条可验收步骤（动词开头，避免过长）。
  • 立即调用 updateplan 建立初始 plan：第 1 步 inprogress，其余 pending。
  • 保持 plan 的每个 step 文案与 CSV 的 item 完全一致（便于同步与审计）。

2) 在项目根目录创建 {任务名} TO DO list.csv

  • 确定“任务名”：优先取自用户请求的短标题；必要时做简化（去掉标点、过长截断）。
  • 计算“项目根目录”：优先使用 Git 仓库根目录；非 Git 项目则使用当前工作目录作为根目录。
  • 在项目根目录创建文件：{任务名} TO DO list.csv。

CSV 表头固定为（首行）：

id,item,status,done_at,notes

  • id：从 1 开始的整数
  • item：单条待办（与 plan 的 step 一致）
  • status：TODO / IN_PROGRESS / DONE
  • done_at：完成时间（ISO 8601，未完成留空）
  • notes：可选备注（文件路径、验证方式、PR/commit 等）

3) 状态机与映射（核心约束）

  • 仅允许状态流转：TODO → IN_PROGRESS → DONE（避免 TODO 直跳 DONE）。
  • plan 映射：TODO→pending，INPROGRESS→inprogress，DONE→completed。
  • 任意时刻 最多 1 行 INPROGRESS；只要仍有未完成项，尽量保持 恰好 1 行 INPROGRESS（与 plan 的唯一 in_progress 对齐）。

4) 推进时同步（每完成一项就同步一次）

  • 完成当前 IN_PROGRESS 项后：

1) 更新 CSV（推荐用脚本 advance 自动“完成当前项并启动下一项”） 2) 从 CSV 生成 plan payload（plan --normalize） 3) 调用 update_plan 使 plan 与 CSV 同步

5) 中途变更与暂停

  • 新增步骤：只做“追加”，避免重排/重编号；同时更新 CSV 与 plan。
  • 暂停等待反馈：保留 CSV；plan 当前步骤保持 inprogress，或追加“等待反馈”步骤并置为 inprogress。

6) 收尾与清理

  • 确认所有行均为 DONE，再删除该 CSV 文件（脚本 cleanup 会在未全 DONE 时拒绝删除）。
  • 调用 update_plan 将所有步骤标记为 completed，确保对话内计划闭环。

可选自动化脚本

使用 scripts/todo_csv.py 自动创建/更新/清理 CSV（优先用于避免手工编辑出错）。

示例命令：

  • 创建清单（默认第 1 条为 INPROGRESS）：python3 ~/.codex/skills/todo-list-csv/scripts/todocsv.py init --title "修复登录 bug" --item "复现问题" "加回归测试" "修复实现" "运行测试/构建"
  • 计算路径：python3 ~/.codex/skills/todo-list-csv/scripts/todo_csv.py path --title "修复登录 bug"
  • 从 CSV 生成 updateplan payload（推荐带 --normalize）：python3 ~/.codex/skills/todo-list-csv/scripts/todocsv.py plan --file "{csv_path}" --normalize --explanation "同步自 TODO CSV"
  • 启动指定步骤：python3 ~/.codex/skills/todo-list-csv/scripts/todocsv.py start --file "{csvpath}" --id 2
  • 推进一步（完成当前 INPROGRESS 并启动下一条 TODO）：python3 ~/.codex/skills/todo-list-csv/scripts/todocsv.py advance --file "{csv_path}" --notes "已通过单测"
  • 查看进度：python3 ~/.codex/skills/todo-list-csv/scripts/todocsv.py status --file "{csvpath}" --verbose
  • 全部完成后清理：python3 ~/.codex/skills/todo-list-csv/scripts/todocsv.py cleanup --file "{csvpath}"