file-todos

file-todos 技能提供了一种稳健、透明且持久的方法来管理工作项、功能需求和技术债。通过利用 .claude/todos/ 目录，该系统将带有 YAML 前置数据的 Markdown 文件转换为可查询的项目状态数据库。它专为在优先考虑代码文档化和可审计性的环境中工作的开发人员和智能体而设计。此技能允许系统性地捕获来自调查、代码审查和 PR 反馈的发现，确保在开发周期中不会遗失复杂任务。

• 支持使用问题 ID、状态追踪和优先级级别建立标准化的待办事项文件，以进行有效的分类。

• 支持问题之间的依赖关系管理，确保任务按正确的逻辑顺序完成。

• 在主动开发期间促进详细的工作日志记录，提供行动、学习成果和技术调整的时间顺序记录。

• 与 /triage 等自动化斜线指令集成，以实现快速审批和优先级排序工作流程。

• 使用 Markdown 和 YAML 进行存储，使其完全纳入版本控制，可通过 grep 等标准工具进行搜索，且易于移植。

• 当任务需要超过 15-20 分钟的精力、研究或多步骤规划时，请使用此技能。

• 若要建立新的待办事项，请复制 assets/todo-template.md 并填充必要章节，包括问题陈述、拟议解决方案和验收标准。

• 请务必确保状态字段（pending, ready, complete）和依赖关系列表准确无误，以便进行自动化筛选和管线集成。

• 依赖工作日志来记录文件级别的变更、执行的指令和关键技术见解，为未来的代码审查或调试会话提供背景信息。

• 对于 15 分钟以下的琐碎任务，建议采取标准化的立即行动，而非建立正式的追踪文件。