meeting-facilitate

Meeting Facilitate — 会议主持技能

本技能指导你（Leader 或具备主持职责的 Agent）端到端组织一场多 Agent 会议：选模板 → 创建会议 → spawn 真实参与者 → 签到 → 推进轮次 → 验证全员发言 → 结束并汇总。

前置要求

• 知道自己的 agent_id（用于以主持人身份发言）——它由 SubagentStart 注入的「你的 OS 身份」块给出； 拿不到就 GET /api/agents/whoami?name=<你的名字>&session_id=<会话id> 自查（服务端按 cc id / 会话+名 反查）
• 已明确：会议目的、需要的角色、目标产出
• 已知会议涉及的关键文件路径（用于 materials/context_files）

核心原则（看完这三条再往下读）

1. OS 不会自动 spawn 参与者 — meeting_create 只创建会议记录和 dispatch_plan，真正让参与者到场必须靠你亲自调用 Agent tool。光创建不 spawn = 没人到场 = 会议失败。
2. 绝不代打他人发言 — 你以主持人身份发言时，agent_id 和 caller_agent_id 必须都填你自己的 ID。用别人的 agent_id 发言会被 OS 标记为 impersonation=true 并写入审计日志。
3. conclude 前必须确认全员发言 — meeting_conclude 默认开启 validate_attendance，未发言者会让 conclude 返回 400。不要用 force=True 绕过——除非有不可抗力的技术理由。

---

主持流程（7 步）

Step 1: 选择会议模板

根据会议目的对照下表选模板。详细模板说明见 templates/<name>.md（progressive disclosure）。

目的	推荐模板	轮数	为何
发散创意、产生新想法	brainstorm	4	独立发散 → 交叉启发 → 评估 → 汇总
多方案中做选择	decision	3	陈述 → 质询 → 收敛
评审代码 / PR / 交付物	review	3	陈述 → 独立评审 → 回应裁定
项目复盘、提取教训	retrospective	3	4Ls → 改进方向 → 承诺计划
每日进度同步	standup	1	三问：完成 / 计划 / 阻塞
决策有重大分歧或风险	debate	4	正方陈述 → 反方质疑 → 正方回应 → 裁决
开放议程、自由议题	lean_coffee	3	议题收集 → 投票 → 时间盒讨论
架构 / 方案多视角评审	council	3	专家视角 → 交叉质询 → 裁决

不确定？用 template="free"，OS 会根据 topic 关键词自动推荐。

Step 2: 创建会议（拿到 dispatch_plan）

必须使用结构化 participants（dict 列表），否则 dispatch_plan 里的 launch_call 会是空的，无法 ready-to-paste。

meeting_create(
    topic="评审 v0.9 Prompt Registry 架构方案",
    template="council",                           # Step 1 选的模板
    team_id="repo-insight-arch",                  # 可省略，自动用活跃团队
    team_name="repo-insight-arch",                # 仅 OS 侧归属；不会写进 launch_call
    participants=[
        {
            "name": "arch-lead",
            "agent_template": "software-architect",
            "role": "评估架构整体可行性与分层合理性",
            "context_files": ["docs/v0.9-prompt-registry.md"],
            "expected_output": "三段式：可行性 / 风险 / 建议",
        },
        {
            "name": "backend-arch",
            "agent_template": "backend-architect",
            "role": "评估存储层与 API 设计",
            "context_files": ["docs/v0.9-prompt-registry.md", "src/aiteam/storage/repository.py"],
            "expected_output": "存储方案 + 接口契约 + 迁移路径",
        },
    ],
    rounds=[                                       # 可选，省略则用模板默认 rounds
        {"topic": "立场陈述", "rule": "每人 3 段：评估视角 / 风险点 / 评分 1-5"},
    ],
    materials=["docs/v0.9-prompt-registry.md"],   # 全员必读
)