SuperAPI AI 工具集

todo-create

通用与其它

查看项目

更新于 10-15 21:39

技能介绍

用途:在基于文件的 todo 系统中创建持久工作项、管理 todo 生命周期,并跨会话跟踪代码评审反馈、技术债、功能请求等发现。

主要能力:todo 以 Markdown 文件加 YAML frontmatter 存储,含状态、优先级、issue_id、标签、依赖等字段。文件命名格式为 {issue_id}-{status}-{priority}-{description}.md,issue_id 为顺序编号且不复用,status 取 pending、ready、complete,priority 取 p1、p2、p3。必填章节包括问题陈述、发现、建议方案、推荐行动、验收标准、工作日志;可选章节有技术细节、资源、备注。

使用方式:写入规范路径 .context/compound-engineering/todos/,读取时同时检查该路径与旧路径 todos/。创建时先 mkdir -p .context/compound-engineering/todos/,搜索两处 [0-9]-.md 取最大编号加一并补零到三位,按模板写入。待办分诊时 glob -pending-.md,批准则将 pending 改为 ready 并填写推荐行动,延后则保持 pending。依赖通过 dependencies 字段声明,检查阻塞时搜索 {dep_id}-complete-*.md。完成时核对验收标准、更新工作日志,并将 ready 改为 complete。查找和读取优先用原生文件搜索工具,仅在无原生等价操作时用 shell。

适用场景:代码评审、自主评审、代码 TODO、规划等流程。

限制:该技能管理持久跨会话工作项;临时会话内步骤跟踪应使用平台任务工具。目录具有多会话生命周期,不应作为临时目录清理。资料未提供具体安装命令与收费信息。