SuperAPI AI 工具集

file-todos

通用与其它

查看项目

更新于 10-16 06:17

技能介绍

用途:在项目的 todos/ 目录下用 Markdown 文件记录和跟踪开发任务,供人类与智能体共同使用,适用于创建、分诊、列出和管理待办文件。

文件命名约定:{issue_id}-{status}-{priority}-{description}.md。issue_id 为顺序编号(001、002、003…),从不复用;status 取 pending(待分诊)、ready(已批准)、complete(已完成);priority 取 p1(关键)、p2(重要)、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、priority、issue_id、tags 数组、dependencies 数组(被哪些 issue ID 阻塞)。必需章节为 Problem Statement、Findings、Proposed Solutions、Recommended Action、Acceptance Criteria、Work Log;可选章节为 Technical Details、Resources、Notes。

关键区分:本技能是 todos/ 目录中的 Markdown 文件,用于开发/项目跟踪;应用层的 Todo 数据模型是面向用户的数据库任务管理,与此不同;TodoWrite 工具是智能体会话中的内存任务跟踪,临时且不落盘。

参考资料:workflows.md(创建、分诊、依赖、工作日志、完成待办、集成表);quick-reference.md(查找工作、依赖、搜索的 Bash 命令);todo-template.md(新待办文件模板)。具体命令、安装方式与限制暂未提供。