AgentSkillsCN

long-task-voice-progress

默认情况下，为大多数非 trivial 任务发出清晰的进度更新，并以语音播报里程碑状态。适用于工作包含多个阶段、可能涉及长时间运行的命令或测试、需要等待工具或代理完成，或受益于免手动的语音状态播报时使用。

SKILL.md
--- frontmatter
name: long-task-voice-progress
description: Emit clear progress updates by default for most non-trivial tasks and speak milestone status. Use whenever work has multiple phases, may include long-running commands or tests, involves waiting on tools or agents, or benefits from hands-free audible status.

Long Task Voice Progress

Overview

Emit concise milestone updates aligned to real execution state so progress reports stay trustworthy.

Trigger Heuristics

Use this skill by default for non-trivial work, especially when any of the following are true:

  • •The task has >=2 phases (for example: discovery, implementation, validation, completion).
  • •You are about to run commands or tests that may take >30s.
  • •You are waiting on tools, background jobs, or sub-agents and progress may otherwise appear stalled.

Workflow

  1. •Announce the interpreted task and first action.
  2. •Announce each major phase transition (context, implementation, validation, completion).
  3. •Announce blockers with the blocked step and immediate recovery action.
  4. •Announce completion with what changed and what verification ran.

Message Rules

  • •Keep spoken messages short (target under 18 words).
  • •Use present-tense action verbs and include the next concrete action.
  • •Mention concrete artifacts when relevant (file, service, test suite, migration).
  • •Avoid filler or generic status text.

Invocation

Run the helper script via Bash to emit an audible progress update:

code
bash scripts/say-progress.sh "Starting test suite for auth module"

The script path is relative to this skill directory. Use the full path when invoking from elsewhere:

The script always emits a [progress] text line to stdout regardless of audio availability, so progress is visible even when muted or on a headless machine.