SuperAPI AI 工具集

file-todos

办公与效率

查看项目

更新于 10-16 00:30

技能介绍

用途:在 todos/ 目录下用文件方式跟踪代码审查反馈、技术债、功能请求与工作项。每个待办是一个带 YAML frontmatter 和结构化章节的 Markdown 文件。

主要能力:创建待办、管理生命周期(pending → ready → complete)、对 pending 项分类审批、检查与管理依赖、把 PR 评论或代码发现转为跟踪项、执行时更新工作日志。

命名规范:{issue_id}-{status}-{priority}-{description}.md。issue_id 为顺序编号且不复用;status 为 pending/ready/complete;priority 为 p1/p2/p3;description 用 kebab-case。示例:001-pending-p1-mailer-test.md。

文件结构:必填章节包括 Problem Statement、Findings、Proposed Solutions、Recommended Action、Acceptance Criteria、Work Log;可选 Technical Details、Resources、Notes。frontmatter 字段含 status、priority、issue_id、tags、dependencies。

常用用法:创建时先确定下一个 ID:ls todos/ | grep -o '^[0-9]+' | sort -n | tail -1,再复制模板 cp assets/todo-template.md todos/{NEXT_ID}-pending-{priority}-{description}.md。分类时列出 ls todos/-pending-.md,审批后重命名并更新 status。依赖用 dependencies: ["002"] 表示被阻塞,可用 grep 查询阻塞关系。完成时核对验收标准、更新日志、重命名并改 status。

适用场景:超过 15-20 分钟、需要研究规划、有依赖、需审批或属大型重构的工作。琐碎问题建议直接处理。

限制:资料未提供安装方式、收费、平台与效果信息;该文件系统不同于 Rails Todo 模型和内存中的 TodoWrite 工具。