SuperAPI AI 工具集

file-todos

通用与其它

查看项目

更新于 10-15 22:17

技能介绍

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

文件命名:{issue_id}-{status}-{priority}-{description}.md。issue_id 为顺序编号(001、002…),永不复用;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。

文件结构:以 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 工具是智能体会话内的内存任务跟踪,不持久化到磁盘。

校验:写入前确认 issue_id 唯一且为 todos/ 中下一个顺序号(永不复用);frontmatter 必填字段 status、priority、issue_id 齐全;status 与 priority 取值与文件名及枚举一致。

参考:workflows.md(创建、分诊、依赖、工作日志、完成待办、集成表)、quick-reference.md(查找工作、依赖、搜索的 Bash 命令)、todo-template.md(新待办模板)。限制:资料未提供安装命令、平台支持与收费信息。