SuperAPI AI 工具集

go-backend-dev-harness

办公与效率

查看项目

更新于 10-15 23:42

技能介绍

用途:在开始任何功能开发前初始化文档导航,或在需要重置、刷新 tasks/todo.md 的“参考文档”小节时调用。它把当前功能的各类文档文件名集中记录到 tasks/todo.md,供后续开发流程按名查找。

主要能力与使用方式:

  1. 确保 tasks/todo.md 存在。直接执行 mkdir -p {project_root}/tasks,并检查该文件与“## 参考文档”小节是否存在,缺失则创建。

  2. 确定功能文档目录。若调用时传入目录名,先判断该目录是否位于项目根目录下:在项目内则转为相对路径使用;在项目外则保留绝对路径,不做相对转换,适用于以外部文档仓库管理计划文件的场景。随后与“参考文档”小节中已记录的目录名做同样规则归一化比较,一致则沿用;不一致或小节为空则清空该小节并按新目录名重新生成。若未提供目录名,则根据当前功能名在 docs/ 下确定子目录,格式为 docs/{feature-name}。

  3. 扫描功能文档目录并赋值。按文件前缀匹配:plan-、arch-、ops-.md、ops-.sh、report-、review-,每类取最近修改的一个;没有则按 {feature-name} 与当天日期 yyyy-mm-dd 生成新文件名。文档明确要求必须执行给定命令,不得跳过或替换为主观判断,输出结果即为最终文件名,不再改动。

  4. 写入 tasks/todo.md。将结果覆盖写入“## 参考文档”小节,列出当前功能文档目录、计划文档、架构文档、操作手册、操作脚本、测试记录文档、评审记录文档,最后执行 cat {project_root}/tasks/todo.md 验证并展示结果。

适用场景:Go 后端项目在功能开发启动阶段统一整理与刷新文档清单,让计划、架构、运维手册、操作脚本、测试与评审记录有固定引用位置。

限制:资料未提供该工具的安装方式、运行环境版本要求、收费或价格信息、与其它流程的集成细节,也未说明文件命名约束之外的更多规则;使用前需确认 project_root、功能名与日期等变量的取值。