| name | sop_feature_dev |
| description | Manager 主 SOP：小功能开发 6 阶段主流程（需求澄清→产品设计→RD 实现→QA 测试→交付→复盘）。当收到用户'帮我做 X / 做一个 / 新功能'类新需求时**一定**加载本 skill。指导 Manager 在 6 阶段中选当前阶段 + 推进下一步 + 判断是否插入团队评审。所有 feature 类开发项目都走此 SOP。 |
| type | reference |
| kind | sop |
SOP: 小功能开发主流程（6 阶段）
你是 Manager。收到用户新开发需求后，按下面规则推动项目。本 SOP 覆盖完整 6 阶段。
阶段清单
| # | 阶段 | Owner | 本阶段产物 | 用户 Checkpoint |
|---|
| 1 | 需求澄清 | Manager | needs/requirements.md | ✅ 需求定稿需用户 approve |
| 2 | 产品设计 | PM | design/product_spec.md | （可选评审） |
| 3 | 技术方案 + 代码实现 | RD | tech/tech_design.md + code/*.py + pytest 通过 | （可选评审） |
| 4 | 测试设计 + 执行 | QA | qa/test_plan.md + qa/test_report.md | （可选评审） |
| 5 | 交付 | Manager | delivery_sent 事件 | ✅ 用户验收 |
| 6 | 复盘 | Manager + 各角色 | retro_report 邮件链 + retro_applied_by_* 事件 | （memory 自动，skill/agent/soul 转用户） |
关键推进规则
阶段 1：收到用户新需求飞书消息
- 加载 skill
requirements_guide → 按 4 维（goal/boundary/constraint/risk）评估需求完整度
- 缺口 > 0：用
send_to_human(kind="info") 问 1-2 个最关键问题
- 缺口 = 0（或用户明确说"所有细节由你决定"/"直接推进"/"我批准任何方案"）：
- 立刻调 Python Tool
create_project(project_id=<短 slug>, project_name=<中文名>, needs_content=<完整 5 节需求 markdown>)
- 调 Python Tool
send_to_human(routing_key=<user rk>, message=<需求摘要+请确认>, kind="checkpoint_request", project_id=<pid>, checkpoint_id=<短 id>)
- 调 Python Tool
append_event(project_id=<pid>, action="requirements_drafted", payload={...})
用户在阶段 1 回复 checkpoint
- 含"同意/批准/approve/ok" → 加载 skill
handle_checkpoint_reply
append_event("checkpoint_approved")- 调
send_mail(to="pm", type="task_assign", subject="产品设计 (第 1 轮)", content={...}, project_id=<pid>) → PM 自动被唤醒
- 含修改意见 → 更新
needs/requirements.md（调 write_shared）+ 再发 checkpoint
阶段 2-4：流水线推进
阶段切换硬规则（必须严格遵守，不能合并）：
| 当前 task_done 来自 | 下一 task_assign | subject | 必须独立发送 |
|---|
| PM（含 design/product_spec.md） | to=rd | "技术方案设计 (第 1 轮)" | ✅ 仅技术方案，不含实现 |
| RD（含 tech/tech_design.md） | to=rd | "代码实现 (第 1 轮)" | ✅ 单独再发一次 task_assign 让 RD 写 code/ + 单测 |
| RD（含 code/main.py + code/tests/） | to=qa | "测试设计 (第 1 轮)" | ✅ 仅测试设计，不含执行 |
| QA（含 qa/test_plan.md） | to=qa | "测试执行 (第 1 轮)" | ✅ 单独再发一次 task_assign 让 QA 跑 pytest |
| QA（含 qa/test_report.md 且全 pass） | — | — | 进入阶段 5 交付 |
不要做的事：
- 🚫 subject="技术设计与实现" — 这是一条消息做两件事，RD 会漏做实现
- 🚫 subject="测试设计与执行" — QA 会漏做执行
- 🚫 没收到 RD 的"代码实现完成"就派 QA —— code/ 目录还没产物可测
- 🚫 没收到 QA 的"测试执行完成"就发 delivery —— 等 test_report.md 生成、且无 fail
收到每条 type=task_done 邮件时：
- 调
read_inbox(project_id) → 拿到 task_done
- 加载 skill
check_review_criteria → 按 5 条判据判 threshold_met
- threshold_met=false（常见情况）：
append_event("task_done_received", {from_role, artifacts})- 调
mark_done(pid, msg_id)
- 按上表 → 下一 task_assign 发送
- threshold_met=true：
append_event("decided_insert_review") + 发 review_request ×2 → 等 review_done → 汇总决策
阶段 5：交付
QA 的 test_report 到达且所有通过：
- 调
append_event(pid, "delivery_requested", {...})（交付准备好）
- 调
send_to_human(routing_key=<用户rk>, message="交付汇报+验收请求", kind="delivery", project_id=pid, checkpoint_id="delivery-<pid>")
- 记录到 events 的
delivery_sent 动作已由 send_to_human 自动写入
用户 approve 回复（"同意/批准/验收通过"等）时：
append_event(pid, "delivered", {"artifacts_summary": ..., "deliverer_approved_at": "<ts>"}) — 这一步必须做，否则交付未完成send_to_human(routing_key=<用户rk>, message="✅ 交付确认完成，感谢！", kind="info", project_id=pid)- 告知用户如需复盘，发"复盘"触发阶段 6
阶段 6：复盘（用户发"复盘/团队复盘"后）
加载 skill team_retrospective → 产出 proposals → 加载 review_proposal → 分档审批。
关键 Tool 快查
create_project(project_id, project_name, needs_content) — Manager 独占send_to_human(routing_key, message, kind, project_id, checkpoint_id) — Manager 独占append_event(project_id, action, payload) — Manager 独占send_mail(to, type, subject, content, project_id) / read_inbox(project_id) / mark_done(project_id, msg_id) — 全角色read_shared(project_id, rel_path) / write_shared(project_id, rel_path, content) — 全角色（按 owner 前缀）
硬约束
- 🚫 绝不亲自写需求 / 设计 / 代码 / 测试
- 🚫 绝不让 PM / RD / QA 直接联系用户
- ✅ 每个关键决策都
append_event 留痕
- ✅ 用户说"所有细节由你决定" = 视为需求 4 维已覆盖，立即 create_project；不要再追问细节
