AgentSkillsCN

smaqit.task-complete

在完成任务后，通过验证操作标记任务为“已完成”。当您完成一项任务时，可使用此功能更新任务状态，并核对各项完成标准。

SKILL.md
--- frontmatter
name: smaqit.task-complete
description: Mark a task as completed with verification. Use when finishing tasks to update status and verify criteria.
metadata:
  version: "0.2.0"

Task Complete

Mark a task as done with the format: task.complete [id]

Steps

  1. •Load workflow rules by reading references/RULES.md
  2. •Read the task file to review acceptance criteria and task mode
  3. •Check task mode enforcement:
    • •Assisted mode: Verify this is user-invoked (not AI self-completion)
    • •Autonomous mode: AI may self-complete after verification
  4. •Verify all criteria are met - Do NOT complete if any criteria remain unfinished
  5. •Check off completed acceptance criteria (- [x])
  6. •Update task file status to "Completed" and add completion date
  7. •Move task from Active table to appropriate destination in .smaqit/tasks/PLANNING.md:
    • •Completed if successfully finished
    • •Abandoned if superseded, no longer relevant, or incorrect approach (include reason)

Mode-Aware Enforcement

Assisted Mode Tasks

CRITICAL: Assisted-mode tasks require user approval before completion.

Agent behavior:

  • •⛔ Agent MUST NOT invoke task-complete for assisted tasks
  • •✅ Agent implements the solution
  • •✅ Agent provides completion summary
  • •✅ Agent instructs user to run /task.complete [id] when ready

Example agent response:

"Implementation complete. This is an assisted-mode task requiring your approval. Please review the changes and run /task.complete 003 when satisfied."

Autonomous Mode Tasks

Agent behavior:

  • •✅ Agent implements the solution
  • •✅ Agent verifies ALL acceptance criteria
  • •✅ Agent MAY invoke task-complete autonomously
  • •✅ Agent documents completion rationale

Example agent response:

"All acceptance criteria verified. Task 005 completed autonomously."

Requirements

  • •CRITICAL: All acceptance criteria MUST be verified as complete (for Completed tasks)
  • •CRITICAL: Check task mode before completing (read references/RULES.md)
  • •Do NOT mark as Completed if criteria remain unfinished
  • •Do NOT complete assisted-mode tasks without user invocation
  • •Use Abandoned (not Completed) for tasks being superseded or discontinued
  • •Update both the individual task file AND the .smaqit/tasks/PLANNING.md file
  • •For Abandoned tasks, document the reason in .smaqit/tasks/PLANNING.md

Task Mode Detection

Check the task file for mode metadata:

markdown
**Mode:** Assisted | Autonomous
  • •If mode is missing, assume Assisted (default)
  • •Mode is set by task-start skill

Central Planning File

Remember: .smaqit/tasks/PLANNING.md contains three sections (Active, Completed, Abandoned) and must be updated when completing or abandoning tasks.