基于文件的待办事项追踪

文件命名规范

{issue_id}-{status}-{priority}-{description}.md

• issue_id：连续编号（001, 002, 003...），永不重复使用
• 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、002-ready-p1-fix-n-plus-1.md、005-complete-p2-refactor-csv.md

文件结构

请以 [todo-template.md](./assets/todo-template.md) 作为新建文件的起点。YAML frontmatter 示例：

---
status: ready              # pending | ready | complete
priority: p1               # p1 | p2 | p3
issue_id: "002"
tags: [typescript, performance, database]
dependencies: ["001"]      # 此任务所依赖的其他任务编号
---

必填部分：问题陈述、发现、建议方案、推荐操作、验收标准、工作日志

可选部分：技术细节、参考资料、备注

核心区别

文件型待办系统（本技能）：在 todos/ 目录中使用 Markdown 文件进行开发与项目追踪，供人类和智能体使用。

应用待办模型：用于用户可见的任务管理的数据库模型，与本文件系统不同。

TodoWrite 工具：在智能体会话期间进行内存中的任务追踪，临时存在，不会持久化到磁盘。

验证要求

在确认一个待办文件编写正确前，请检查：

• issue_id 是唯一的，且为 todos/ 目录中下一个连续编号（永不重复使用）
• 所有必需的 frontmatter 字段均存在：status、priority、issue_id
• status 和 priority 的值与文件名一致，并符合枚举范围（pending|ready|complete，p1|p2|p3）

参考资料

• [workflows.md](./references/workflows.md) - 创建、分类、依赖关系、工作日志、完成待办事项、集成表
• [quick-reference.md](./references/quick-reference.md) - 查找工作、依赖项、搜索的 Bash 命令
• [todo-template.md](./assets/todo-template.md) - 新建待办文件的模板