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/demo_agent/output/
Manager 与用户对话澄清需求的思考框架（4 维：goal/boundary/constraint/risk）。当人类消息 classify=new_requirement 时**一定**加载本 skill。逐维评估覆盖度、一次问 2-3 个问题、全覆盖后转 requirements_write。所有'帮我做 X / 新需求'触发都走此 skill。
Manager 扫描并列出已有 SOP 集合的 skill。当用户问'有哪些 SOP / 流程'或 Manager 自检是否需新建 SOP 时**一定**加载本 skill。扫 workspace/manager/skills/sop_* 目录，读每个 SKILL.md frontmatter 的 description，组装成列表。所有'列一下现有流程'触发都走此 skill。
团队邮箱操作（读自己 inbox 或给其他角色发邮件）。直接调用 send_mail / read_inbox / mark_done 工具，不要手动操作 JSON 文件。
QA 在沙盒里执行 qa/test_plan.md 所有用例、收集失败、写 defect 的 skill。当 QA 收到 type=task_assign 且 subject 含'测试执行/run tests'的邮件时**一定**加载本 skill。按 test_plan 跑 pytest → 通过标 pass、失败写 qa/defects/defect_{id}.md → 汇总 qa/test_report.md + task_done。如有 defect，顺带发 task_assign 给 RD 修复。所有'QA 真的跑测试'的时刻走此 skill。
RD 按 tech_design.md 在沙盒里实现代码 + 单测 + 跑 pytest 通过。当 RD 收到 type=task_assign 且 subject 含'实现代码/code'的邮件时**一定**加载本 skill。五层分目录写代码 + 单测 ≥80% 覆盖 + 最多 3 次失败重试 → task_done 回 Manager。所有'开始写 feature code'的时刻走此 skill。
| name | notify_human |
| type | reference |
| description | 通知 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 | 遇到无法自行处理的异常 |
run_script("mailbox/scripts/mailbox_cli.js", [
"send",
"--mailboxes-dir", "/mnt/shared/mailboxes",
"--from", "manager",
"--to", "human",
"--type", "{type}",
"--subject", "{简洁主题，不超过15字}",
"--content", "{文件路径 + 1-2句说明}"
])
run_script("mailbox/scripts/mailbox_cli.js", [
"check-human",
"--mailboxes-dir", "/mnt/shared/mailboxes",
"--type", "{type}"
])
返回 {"confirmed": true} 表示已确认可继续推进；{"confirmed": false} 表示未确认，本轮结束等待。
不要阻塞等待。发完消息后完成当前能做的事然后结束本轮。Human 会通过 human-cli.js 回复，下次运行时再检查确认状态。