القائمة
通知 Human 在关键节点介入确认。规定何时通知、何时不通知、通知类型和内容格式。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| 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 回复，下次运行时再检查确认状态。
技术设计文档 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。