with one click
notify-human
通知 Human 在关键节点介入确认。规定何时通知、何时不通知、通知类型和内容格式。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Menu
通知 Human 在关键节点介入确认。规定何时通知、何时不通知、通知类型和内容格式。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
技术设计文档 SOP——从需求到设计方案,产出 Markdown 文件到 /workspace/output/
Agent 自我复盘:读取 L2/L3/L1 日志,调用 LLM 生成结构化改进提案, 写入 proposals.json 并发通知至 human.json 等待审批。 适用场景:Agent 在完成足够多任务后,触发自我评估和改进提案生成。
Manager 团队复盘:聚合所有 Agent 的 L2 质量指标,统计 L1 人类纠正事件, 识别瓶颈 Agent 并触发其自我复盘,调用 LLM 生成团队级改进提案, 向 human.json 发送周报。
审批复盘提案(Manager 专用)。收到 type=retro_report 邮件时加载此 Skill。按改动深度分档,memory 自动批准(加闸门),skill/agent 转 Human 确认,soul 标记高风险转 Human。
团队复盘思考框架(Manager 专用)。当你收到 type=team_retro_trigger 的邮件、或被要求"做团队复盘"时加载此 Skill。从聚合视角分析全员数据,发现跨 Agent 问题,级联触发瓶颈 Agent 的自我复盘,发周报给 Human。
自我复盘思考框架。当你收到 type=retro_trigger 的邮件、或被要求"反思本周工作"/"自我复盘"时加载此 Skill。用 log_query CLI 查数据,用 LLM 推理做分析,产出结构化复盘报告和改进提案。
| name | notify_human |
| type | reference |
| description | 通知 Human 在关键节点介入确认。规定何时通知、何时不通知、通知类型和内容格式。 |
当需要 Human 介入时(需求确认、SOP 审阅、设计审核、异常上报),通知 Human。
只有 Manager 可以向 human.json 发消息。
mailbox_cli.py 会强制校验:--to human --from pm 会返回 errcode=1| type | 触发时机 | 说明 |
|---|---|---|
needs_confirm | 需求文档写好后 | 请 Human 确认需求是否准确 |
sop_draft_confirm | SOP 草稿完成后 | 请 Human 审阅 SOP 设计 |
sop_confirm | SOP 选择完成后 | 请 Human 确认选定的 SOP |
checkpoint_request | 关键交付物完成后 | 请 Human 审阅产品文档等 |
error_alert | 遇到超出权限的异常 | 上报异常,不可自行处理 |
python3 /workspace/skills/mailbox/scripts/mailbox_cli.py send \
--mailboxes-dir /mnt/shared/mailboxes \
--from manager \
--to human \
--type {type} \
--subject "{简洁的主题}" \
--content "{关键路径 + 1-2句说明}"
Human 的时间宝贵。消息要简洁:
# 好的通知 ✅
主题:需求文档(第1轮)待确认
内容:需求文档路径:/mnt/shared/needs/requirements.md
# 差的通知 ❌
主题:请您抽空查看并审阅我们精心整理的需求文档
内容:[把需求文档全文复制进来...]
不要等待 Human 回复。发完消息,完成当前能做的事,结束本轮。
Human 会在自己方便的时候通过 human_cli.py 确认。
下次运行 main.py 时,Manager 检查 human.json 的 read 字段判断是否已确认。
python3 /workspace/skills/mailbox/scripts/mailbox_cli.py check-human \
--mailboxes-dir /mnt/shared/mailboxes \
--type needs_confirm
返回 confirmed: true 表示 Human 已确认,可以继续推进。