squad-heartbeat

用途：扫描 squad 项目看板，找出在 todo、plan、plan_review、impl、impl_review、test 等活跃列中连续 N 天无活动的事件，done 列会被跳过；输出停滞任务 Markdown 表并可写入提醒。\n\n用法：命令为 /squad-heartbeat [--project X] [--days N] [--dry-run]。--project 只扫描指定项目，--days 设置停滞天数阈值（默认 3），--dry-run 只报告不写事件。凭证通过 SQUAD_AUTH_TOKEN、SQUAD_BASE_URL 环境变量或 ~/.squad/auth、~/.squad/config 读取，BASE_URL 默认 https://steloit-squad.vercel.app。\n\n主要能力：按项目拉取 /api/board，逐任务读 /api/task/{id}/activity 取最新 created_at，失败则回退任务的 created_at；按天数降序输出 ID、Project、Status、Days、Title 表，并打印汇总行。非 dry-run 时对每个停滞任务以单次原子 POST 写入标签为 Heartbeat 的活动事件。\n\n适用场景：需要定期巡检 squad 看板、发现长期无人推进的任务并进行提醒的团队。\n\n限制：仅对 squad 平台有意义，需要有效凭证与权限；活动读取失败只能回退 created_at，可能低估停滞天数；时间戳无法解析或没有时间戳的任务会被跳过；具体收费、集成范围等信息暂未提供。