notify-human

name	notify_human
type	reference
description	通知 Human 在关键节点介入确认。规定何时通知、何时不通知、通知类型和内容格式。

通知 Human

单一接口原则

只有 Manager 可以向 human.json 发消息。PM 不能直接联系 Human——mailbox_cli.js 会校验 --from 字段，非 manager 发送会被拒绝（errcode=1）。

通知类型

type	触发时机
needs_confirm	需求文档写好后，请 Human 确认
sop_draft_confirm	SOP 草稿完成后，请 Human 审阅
sop_confirm	SOP 选定后，请 Human 确认
checkpoint_request	关键交付物完成后，请 Human 审阅
error_alert	遇到无法自行处理的异常

何时通知（必须通知）

• 需求文档写好后（needs_confirm）
• SOP 选定后（sop_confirm）
• 遇到连续工具失败、超出授权操作等异常（error_alert）

何时不通知（禁止打扰）

• Manager ↔ PM 之间的常规邮件往来
• 不需要决策的常规进度步骤

发送方式

run_script("mailbox/scripts/mailbox_cli.js", [
  "send",
  "--mailboxes-dir", "/mnt/shared/mailboxes",
  "--from", "manager",
  "--to", "human",
  "--type", "{type}",
  "--subject", "{简洁主题，不超过15字}",
  "--content", "{文件路径 + 1-2句说明}"
])

检查 Human 是否已确认

run_script("mailbox/scripts/mailbox_cli.js", [
  "check-human",
  "--mailboxes-dir", "/mnt/shared/mailboxes",
  "--type", "{type}"
])

返回 {"confirmed": true} 表示已确认可继续推进；{"confirmed": false} 表示未确认，本轮结束等待。

发送后

不要阻塞等待。发完消息后完成当前能做的事然后结束本轮。Human 会通过 human-cli.js 回复，下次运行时再检查确认状态。