关于 file-todos
file-todos 是面向开发者和 Agent 的文件式待办跟踪技能，以 Markdown 文件记录项目事项，并用状态、优先级和依赖关系组织任务。
主要功能
- 01按编号、状态和优先级命名文件
- 02用 YAML 记录待办元数据
- 03提供问题与验收标准章节
- 04校验编号及状态字段
适用场景
- 01跟踪开发任务及其依赖
- 02记录待处理、已批准和已完成事项
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/file-todos确认已加载。
包含的文件
除 SKILL.md 外，安装时一起下载的参考资料和脚本。
SPEC.mdagents/openai.yamlassets/todo-template.mdreferences/quick-reference.mdworkflows.md详细介绍
基于文件的待办事项跟踪
文件命名约定
{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 为起点。YAML frontmatter：
---
status: ready # pending | ready | complete
priority: p1 # p1 | p2 | p3
issue_id: "002"
tags: [typescript, performance, database]
dependencies: ["001"] # Issue IDs this is blocked by
---
必需部分： Problem Statement、Findings、Proposed Solutions、Recommended Action、Acceptance Criteria、Work Log
可选部分： Technical Details、Resources、Notes
关键区别
文件待办事项系统（此技能）： todos/ 目录中的 Markdown 文件，用于开发／项目跟踪，供人类和 Agent 使用。
Application Todo 模型： 面向用户的任务管理数据库模型。与此基于文件的系统不同。
TodoWrite 工具： Agent 会话期间的内存任务跟踪。临时保存，不会写入磁盘。
验证
确认以下事项后，才可认为待办事项文件已正确编写：
issue_id唯一，且为todos/中下一个顺序编号（不可重复使用）。- 所有必需的 frontmatter 字段均已提供：
status、priority、issue_id。 status和priority的值与文件名及其枚举值一致（pending|ready|complete、p1|p2|p3）。
参考资料
- workflows.md - 创建、分类、依赖关系、工作日志、完成待办事项、集成表
- quick-reference.md - 用于查找工作、依赖关系和搜索的 Bash 命令
- todo-template.md - 新建待办事项文件的模板
评论
支持 Markdown