用途:在项目的 todos/ 目录下用 Markdown 文件跟踪开发与项目任务,供人类和智能体共同使用。
文件命名:{issue_id}-{status}-{priority}-{description}.md。issue_id 为顺序编号(001、002…),永不复用;status 取 pending(待分诊)、ready(已批准)、complete(已完成);priority 取 p1(关键)、p2(重要)、p3(可选),与 ia-code-review 严重度对应:Critical→p1、Important→p2、Medium→p3、Minor→p3;description 用 kebab-case 简述。示例:001-pending-p1-mailer-test.md。
文件结构:以 todo-template.md 为起点,YAML frontmatter 含 status、priority、issue_id、tags、dependencies(被哪些 issue 阻塞)。必需章节:Problem Statement、Findings、Proposed Solutions、Recommended Action、Acceptance Criteria、Work Log;可选章节:Technical Details、Resources、Notes。
关键区分:本技能是 todos/ 目录下的 Markdown 文件系统,用于开发/项目跟踪;应用 Todo 模型是面向用户任务管理的数据库模型;TodoWrite 工具是智能体会话内的内存任务跟踪,不持久化到磁盘。
校验:写入前确认 issue_id 唯一且为 todos/ 中下一个顺序号(永不复用);frontmatter 必填字段 status、priority、issue_id 齐全;status 与 priority 取值与文件名及枚举一致。
参考:workflows.md(创建、分诊、依赖、工作日志、完成待办、集成表)、quick-reference.md(查找工作、依赖、搜索的 Bash 命令)、todo-template.md(新待办模板)。
限制:资料未提供安装命令、平台支持、收费与效果信息。