let-me-know

name	let-me-know
description	Notify the user before starting any long-running task and keep them updated. Use when a task will take noticeable time (>2-3 minutes). Send a start message, schedule a 5‑minute heartbeat update, and send a completion message immediately when done.

Let Me Know

Purpose

Ensure the user is informed before long-running tasks start, gets periodic updates on a configurable interval (default 5 minutes), and receives an immediate completion/failure notice. Heartbeat messages must reflect real-time progress, not a repeated template.

Trigger

Use this skill whenever a task will take noticeable time (>2–3 minutes) or involves long-running installs/builds/tests.

Workflow (required)

1. Pre-flight message (before starting):

• Send a short message: what will run, estimated time, and explicitly state:
  • “完成或失败都会立刻通知你；期间我每 X 分钟 发一次进度心跳，您也可以修改心跳时间间隔。”

2. Start a heartbeat (configurable interval, with pre-check)

• Default interval = 5 minutes (everyMs=300000). If the user specifies a different interval, use it.
• Schedule repeating updates while the task runs.
• Before each heartbeat message, read the latest progress (state file/logs) and send current progress (no repeated template):
  • Running → include latest step, progress metrics, and next step.
  • Failed → send failure notice and stop the heartbeat.
• 优先推荐：同一条 agentTurn 内“原地心跳”（不创建额外 cron）：
  • 在长任务执行期间，用循环 sleep <interval> → 读取进度 → message send 发一次动态进度。