用途:signal-write 让工作台(desk)以结构化方式向操作者或其他工作台发出信号,用于升级、汇报进度、完成任务和协调质量。
主要能力:支持五类信号——hands-up(两个工作台分歧且无法以外在事实解决)、blocked(缺少权限、范围不清或需操作者决策)、done(完成待审)、checkpoint(重要进展但仍在继续)、partnership(由 TA 报告协调质量,含 intent、confidence、accuracy、completeness 自评)。信号类型映射为 signal_type/subtype:hands-up 与 blocked 为 escalation,done 与 checkpoint 为 execution,partnership 为 partnership;subtype 保留具体状态,signal_type 控制排序优先级(escalation 置顶)。
使用方式:在 desks/<desk-name>/.signals/ 创建时间戳命名的 JSON 文件,包含 signal_type、subtype、timestamp(ISO 8601 UTC)、可选 run_id、agent_name、self_assessment、patterns、escalation 等字段;同时在日志中追加简短标记(## <date> — [signal:<type>] <summary>)。可选 outcome 信号由评审者写入同一目录,含 quality_rating(0–5)、effort_to_merge(minimal/moderate/significant)、issues_found,并用相同 run_id 关联,仪表盘据此对比自评置信度计算诚实差距。
适用场景:多个工作台协作、需要操作者介入的升级、进度标记、完成待审与协调质量回顾。
限制:仪表盘按 timestamp 排序,缺失时才回退到文件 mtime,而 git 克隆/检出会重置 mtime,因此不应依赖 mtime;不要为常规进度发信号;blocked 指真正阻塞;自评应诚实而非乐观。资料未提供安装命令、收费或具体平台信息。