SuperAPI AI 工具集

todo-archive

通用与其它

查看项目

更新于 10-16 03:16

技能介绍

用途:将 TODO.md 中已勾选(checked)的任务归档到 .ai/todos/YYYY-MM/DD.md,未勾选任务保留在 TODO.md。

主要能力:支持可选参数 path(仓库根或仓库内路径,默认当前目录);--hint TEXT 仅归档标题包含该文本(不区分大小写子串)的章节及其子章节,未匹配章节内的已勾选任务保留;--date YYYY-MM-DD|YYYY_MM_DD 指定归档日期,默认本地今天;--dry-run 预览目标路径与渲染内容但不写入。助手仅读取 <root>/TODO.md,写入 <root>/.ai/todos/YYYY-MM/DD.md,并重写 TODO.md 保留剩余任务,原样保留无任务章节与正文(全部归档时只留最小 # TODO 占位)。同日重复运行会把新批次追加到当天文件,仅在新增的开头 H1 与已有归档的开头 H1 完全一致时移除该新增 H1。

使用方式:先解析仓库根: git rev-parse --show-toplevel 若失败则用提供的 path 或当前目录作为根。确认根处存在 TODO.md,否则停止并报告检查路径。解析技能目录并运行助手: uv run python "<skill-dir>/scripts/archive_todo.py" --root "$repo_root" 按用户要求传入 --hint、--date 或 --dry-run。完成后报告被重写的 TODO.md、创建或合并的归档路径、匹配章节(使用 --hint 时)以及归档/剩余数量。TODO.md 与 .ai/ 约定被 git 忽略,应检查文件系统而非 git diff: cat TODO.md && find .ai/todos -type f | sort

限制:--hint 无匹配标题时助手以非零退出并列出可用章节;助手报告无已勾选任务时视为无操作(no-op)。完成消息按单行格式输出,归档路径相对仓库根,不在最终消息重复 dry-run 内容或为文件、路径、命令、诊断添加装饰。资料未提供收费、平台与价格信息。