用途:把仓库中 .ai/TODO.md 里已勾选的任务移到按日期分目录的归档文件,未勾选任务继续留在原文件。
主要能力:默认归档整份文件中的已勾选任务;用 --hint TEXT 只归档标题中包含该文本(不区分大小写)的章节及其子节,其余已勾选任务保留在原文件;用 --date YYYY-MM-DD|YYYY_MM_DD 指定归档日期,默认今天本地日期;用 --dry-run 预览目标路径与渲染内容而不写盘。同一天重复运行会把新批次追加到当天归档文件。
使用方式:可传入可选 path(仓库根目录或仓库内任意路径,默认当前目录),随后按提示运行辅助脚本:uv run python "<skill-dir>/scripts/archive_todo.py" --root "$repo_root",并按需传递 --hint、--date、--dry-run。流程先用 git -C "$start_dir" rev-parse --show-toplevel 解析仓库根,再确认根下存在 .ai/TODO.md。
输出与限制:结果以单行报告归档路径与已归档、剩余任务数;无已勾选任务视为成功的空操作;--hint 无匹配时脚本以非零状态退出并列出可用章节。脚本只读取 .ai/TODO.md,写入 .ai/todos/YYYY-MM/DD.md 并重写原文件,逐字保留无任务章节与说明文字。若文件被 Git 忽略,应比较文件系统快照而非依赖 git diff。资料未提供安装与价格信息。