القائمة
Use only when explicitly asked to archive/prune/compact/roll over checked tasks from TODO.md into `.ai/todos/TODO_UNTIL_YYYY_MM_DD.md`, leaving unchecked tasks.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
Use only when explicitly invoked for Git commit workflows: stage intended changes, craft Conventional Prefix Format messages by default, Natural Language messages with --natural or configured repos, commit, and optionally --all, --staged, --deep, --close, or --push.
Use for dependency updates: update/bump deps, npm/pnpm/yarn/bun package upgrades, outdated checks, package.json updates, or taze.
Use for release versioning: bump/cut/tag a release, bump version, create a release, changelog updates, or version tagging.
Use for GitHub PR/issue/discussion workflows: create/update PRs or issues, post comments, start discussions; triggers include create/open PR, file/update issue, yeet.
Use to polish recently changed code: simplify for readability/maintainability and run a risk-profiled review that autonomously applies fixes. Default runs both passes; pass --simplify or --review for one. Covers code/PR review, audits, bug/security checks, reviewing diffs or changes, cleanup, refactoring, and reducing complexity.
Use for GitHub CLI automation: gh commands, repo info, workflow triggers, GitHub search, codespaces, PR status, issues, repo browsing, or command-line GitHub tasks.
| argument-hint | [path] [--date YYYY-MM-DD|YYYY_MM_DD] [--dry-run] [--force] |
| disable-model-invocation | false |
| name | todo-archive |
| user-invocable | true |
| description | Use only when explicitly asked to archive/prune/compact/roll over checked tasks from TODO.md into `.ai/todos/TODO_UNTIL_YYYY_MM_DD.md`, leaving unchecked tasks. |
Archive checked Markdown task-list items from TODO.md into .ai/todos/TODO_UNTIL_YYYY_MM_DD.md, then leave only unchecked tasks in TODO.md.
path (optional): Repository root or any path inside the repository. Default to the current directory.--date YYYY-MM-DD|YYYY_MM_DD (optional): Archive date. Default to today's local date.--dry-run (optional): Preview target paths and rendered content without writing.--force (optional): Overwrite the date-only archive in place instead of rolling a same-day re-run over to a timestamped file.Resolve the repository root:
git rev-parse --show-toplevel
If the command fails, use the provided path or current directory as the root.
Verify TODO.md exists at the root. If it is missing, stop and report the path checked.
Run the helper from this skill directory:
uv run python scripts/archive_todo.py --root "$repo_root"
Pass through --date, --dry-run, or --force when the user requested them.
Report the rewritten TODO.md, the created archive path, and the checked/unchecked task counts. If an archive for the date already exists, the helper rolls the new batch over to TODO_UNTIL_YYYY_MM_DD_HHMM.md and keeps the earlier file; report both paths. If the helper reports no checked tasks, treat it as a no-op.
If useful, inspect only the touched paths:
git diff -- TODO.md .ai/todos/
scripts/archive_todo.py:
<root>/TODO.md.<root>/.ai/todos/TODO_UNTIL_YYYY_MM_DD.md.<root>/TODO.md with unchecked tasks.# TODO stub when every task was archived.TODO_UNTIL_YYYY_MM_DD_HHMM.md sibling (appending a counter on a same-minute collision) so an earlier batch is never clobbered.--force is passed.