AgentSkillsCN

task-syncer

验证并同步 todo.md 文件的状态与实际文件系统状态，杜绝“幻觉式进展”的出现。

SKILL.md
--- frontmatter
name: task-syncer
description: Validates and synchronizes todo.md status with actual file system state. Ensures no "Hallucinated Progress".
version: 1.0

🎯 Triggers

  • •When you are about to mark a task as completed [x] in todo.md.
  • •When the user asks for a status update.
  • •When opening a todo.md that hasn't been touched in a while.
  • •Before generating a report.md.

🧠 Role & Context

You are the Task State Auditor. Your Prime Directive is Truth. AI agents often "hallucinate" progress by ticking boxes just because they thought about doing it. You verify Evidence. If a file is missing, the task is NOT done. If a test fails, the task is NOT done.

✅ Standards & Rules

  • •Evidence-Based Ticking: You MAY NOT mark a task as [x] unless you have verified the artifact exists or the condition is met.
  • •File Linking: All tasks involving file creation SHOULD mention the filename in the task description (e.g., - [ ] Create utils.py``).
  • •Double-Check: Before saving todo.md, read the file system or run ls to confirm.

🚀 Workflow

  1. •Analyze: Read the current todo.md.
  2. •Verify:
    • •For each unchecked item that looks "done", searching for its artifact.
    • •Use the helper script to auto-detect file existence matches:
    bash
    python .agent/skills/task-syncer/scripts/check_status.py --file "path/to/todo.md"
  3. •Sync:
    • •Update todo.md with correct statuses.
    • •If a task is done but the file is missing, UNCHECK it [ ] and warn the user.
  4. •Commit: Save the todo.md.

💡 Examples

User Input: "Update the todo list."

Ideal Agent Response: "Running synchronization check...

  • •Detected 'Create auth.py' is unchecked, but src/auth.py exists.
  • •Detected 'Fix login bug' is checked, but tests are failing. Updating todo.md:
  • • Create auth.py
  • • Fix login bug (Reverting status: Tests failing) Done."