名称: workshop 描述: “促进结构化需求研讨会（JAD风格）。指导议程，捕获决策，解决冲突，并生成整合的需求。支持多种研讨会格式。” 参数提示: “[–domain <领域名称>] [–format jad|discovery|refinement|prioritization] [–duration short|standard|extended]” 允许工具: Task, Read, Write, Glob, Grep, Skill, AskUserQuestion

研讨会命令

促进遵循联合应用开发（JAD）模式的结构化需求研讨会。

交互式研讨会配置

使用AskUserQuestion来配置研讨会会话：

# 问题1：研讨会格式（MCP：JAD方法论模式）
问题: "您需要哪种类型的需求研讨会？"
标题: "格式"
选项:
  - 标签: "发现（推荐）"
    描述: "探索和理解问题空间"
  - 标签: "JAD（完整）"
    描述: "包含所有利益相关者的全面需求定义"
  - 标签: "细化"
    描述: "澄清和分解现有需求"
  - 标签: "优先级排序"
    描述: "就需求优先级达成共识"

# 问题2：会话持续时间（MCP：CLI最佳实践 - 范围选择）
问题: "研讨会会话应该持续多长时间？"
标题: "持续时间"
选项:
  - 标签: "短（推荐）"
    描述: "30分钟 - 聚焦单一目标"
  - 标签: "标准"
    描述: "2小时 - 包含所有阶段的完整研讨会"
  - 标签: "扩展"
    描述: "4+小时 - 全面的多会话研讨会"

使用这些响应来定制研讨会格式和时间分配。

用法

/requirements-elicitation:workshop
/requirements-elicitation:workshop --domain "库存"
/requirements-elicitation:workshop --domain "crm" --format discovery
/requirements-elicitation:workshop --domain "计费" --format prioritization --duration short

参数

参数	必需	描述
–domain	否	研讨会的领域（默认：当前/最近的）
–format	否	研讨会格式：`jad`, `discovery`, `refinement`, `prioritization`（默认：`jad`）
–duration	否	预期持续时间：`short`（30分钟）, `standard`（2小时）, `extended`（4小时+）（默认：`standard`）

研讨会格式

JAD（联合应用开发）

全面的需求研讨会格式。

jad_workshop:
  目的: "与所有利益相关者协作定义需求"
  参与者:
    必需:
      - "执行赞助人"
      - "业务利益相关者"
      - "最终用户（代表）"
      - "技术团队"
    可选:
      - "主题专家"
      - "合规/法律"

  议程:
    1_开场:
      持续时间: "15分钟"
      活动:
        - "欢迎和介绍"
        - "审查目标和基本规则"
        - "确认范围边界"

    2_背景:
      持续时间: "30分钟"
      活动:
        - "展示当前状态"
        - "审查已知需求"
        - "识别差距和痛点"

    3_需求:
      持续时间: "60分钟"
      活动:
        - "按类别头脑风暴需求"
        - "澄清和细化每个需求"
        - "识别依赖和冲突"
        - "捕获验收标准"

    4_优先级排序:
      持续时间: "30分钟"
      活动:
        - "应用MoSCoW或其他方法"
        - "解决优先级冲突"
        - "定义MVP范围"

    5_总结:
      持续时间: "15分钟"
      活动:
        - "总结决策"
        - "识别行动项"
        - "安排后续会议"

发现研讨会

专注于探索和理解问题空间。

discovery_workshop:
  目的: "在定义解决方案之前理解问题"

  议程:
    1_问题陈述:
      持续时间: "20分钟"
      活动:
        - "我们要解决什么问题？"
        - "谁面临这个问题？"
        - "不解决的后果是什么？"

    2_利益相关者映射:
      持续时间: "20分钟"
      活动:
        - "识别所有利益相关者"
        - "映射他们的利益和影响力"
        - "注意冲突视角"

    3_当前状态:
      持续时间: "30分钟"
      活动:
        - "今天如何处理这个问题？"
        - "存在哪些变通方法？"
        - "什么工作良好？什么不佳？"

    4_期望状态:
      持续时间: "30分钟"
      活动:
        - "成功是什么样子？"
        - "最重要的结果是什么？"
        - "存在哪些约束？"

    5_差距分析:
      持续时间: "20分钟"
      活动:
        - "从当前到期望还缺什么？"
        - "最大的障碍是什么？"
        - "还有哪些问题未解答？"

细化研讨会

深入探讨特定需求以澄清和完成。

refinement_workshop:
  目的: "澄清、分解和验证现有需求"

  议程:
    1_审查:
      持续时间: "15分钟"
      活动:
        - "审查要细化的需求"
        - "识别模糊之处"
        - "注意问题和关切"

    2_澄清:
      持续时间: "45分钟"
      每个需求:
        - "朗读需求"
        - "识别模糊术语"
        - "定义验收标准"
        - "捕获边界情况"

    3_分解:
      持续时间: "30分钟"
      活动:
        - "将大需求分解成小块"
        - "识别隐藏的子需求"
        - "映射依赖关系"

    4_验证:
      持续时间: "20分钟"
      活动:
        - "与利益相关者验证"
        - "检查完整性"
        - "确认优先级是否准确"

    5_文档化:
      持续时间: "10分钟"
      活动:
        - "更新需求陈述"
        - "记录做出的决策"
        - "注意开放问题"

优先级排序研讨会

专注于需求优先级决策的会议。

prioritization_workshop:
  目的: "就需求优先级达成共识"

  议程:
    1_背景:
      持续时间: "10分钟"
      活动:
        - "审查约束（时间、预算、资源）"
        - "确认优先级标准"
        - "选择优先级方法"

    2_评分:
      持续时间: "40分钟"
      活动:
        - "应用选定方法（MoSCoW、WSJF等）"
        - "捕获个人分数"
        - "识别分歧"

    3_冲突解决:
      持续时间: "20分钟"
      活动:
        - "讨论不同分数"
        - "呈现不同视角"
        - "达成共识或升级"

    4_最终化:
      持续时间: "10分钟"
      活动:
        - "记录最终优先级"
        - "定义MVP范围"
        - "计划推迟项"

研讨会工作流

研讨会前

pre_workshop:
  1. 识别并邀请参与者
  2. 分发预读材料
  3. 准备议程和模板
  4. 设置协作工具
  5. 定义基本规则

研讨会期间

during_workshop:
  主持人职责:
    - "保持讨论在轨道上"
    - "确保所有声音都被听到"
    - "捕获决策和行动项"
    - "管理时间"
    - "解决或搁置冲突"

  捕获模板:
    需求:
      id: "REQ-xxx"
      陈述: "..."
      理由: "为什么需要这个？"
      来源: "谁请求了这个？"
      优先级: "必须|应该|可以|不要"
      验收标准: ["..."]
      问题: ["..."]
      决策: ["..."]

研讨会后

post_workshop:
  1. 整合笔记和决策
  2. 分发总结给参与者
  3. 更新需求库
  4. 安排后续会话
  5. 跟踪行动项完成

研讨会输出

workshop_report:
  元数据:
    领域: "{领域}"
    格式: "jad"
    日期: "{ISO-8601}"
    持续时间: "2小时"
    主持人: "Claude AI"

  参与者:
    出席:
      - 角色: "产品负责人"
        姓名: "模拟"
      - 角色: "最终用户代表"
        姓名: "模拟"
      - 角色: "技术负责人"
        姓名: "模拟"

  议程结果:
    开场:
      目标确认: true
      范围边界: ["...", "..."]

    背景:
      当前状态摘要: "..."
      已知差距: ["...", "..."]

    需求:
      新需求: 12
      细化需求: 8
      移除需求: 2

    优先级排序:
      使用方法: "MoSCoW"
      必须计数: 5
      应该计数: 8
      可以计数: 4
      不要计数: 3

  捕获需求:
    - id: "REQ-WS-001"
      陈述: "..."
      优先级: "必须"
      验收标准: ["..."]
      决定方式: "共识"

  做出决策:
    - 主题: "认证方法"
      决策: "使用OAuth2与SSO"
      理由: "企业要求"
      参与者: ["所有"]

  行动项:
    - 行动: "与信息安全验证安全要求"
      负责人: "技术负责人"
      截止日期: "2025-01-03"
      状态: "开放"

  待办事项:
    - 项: "移动应用范围"
      原因: "此版本超出范围"
      重新审查日期: "Q2规划"

  开放问题:
    - 问题: "与遗留系统集成？"
      分配人: "技术负责人"
      截止日期: "2025-01-05"

  下一步:
    - "分发研讨会总结"
    - "为前5个需求安排细化会话"
    - "设置利益相关者验证会议"

示例会话

/requirements-elicitation:workshop --domain "费用管理" --format discovery

═══════════════════════════════════════════════
需求研讨会：费用管理
格式：发现研讨会
═══════════════════════════════════════════════

📋 议程
1. 问题陈述（20分钟）
2. 利益相关者映射（20分钟）
3. 当前状态分析（30分钟）
4. 期望状态愿景（30分钟）
5. 差距分析（20分钟）

─────────────────────────────────────────────
阶段1：问题陈述
─────────────────────────────────────────────

主持人：“我们要解决什么问题？”

捕获问题陈述：
“员工在费用报告上花费过多时间，财务部门难以确保政策合规，经理缺乏团队支出可见性。”

不解决的后果：
• 每位员工每月花费4+小时在费用管理上
• 15%的费用报告需要返工
• 延迟报销影响员工满意度
• 预算可见性有限

─────────────────────────────────────────────
阶段2：利益相关者映射
─────────────────────────────────────────────

识别利益相关者：
┌─────────────────────────────────────────┐
│ 高影响力                               │
│   CFO - 预算控制、政策所有者           │
│   财务团队 - 处理、合规               │
├─────────────────────────────────────────┤
│ 高利益                                 │
│   员工 - 提交费用                     │
│   经理 - 批准、预算可见性             │
└─────────────────────────────────────────┘

注意冲突利益：
• 财务希望更严格控制
• 员工希望更快批准
• 经理希望预算内灵活性

─────────────────────────────────────────────
阶段3：当前状态
─────────────────────────────────────────────

当前流程：
1. 员工收集纸质收据
2. 填写Excel模板
3. 发送邮件给经理
4. 经理审查，转发给财务
5. 财务验证政策
6. 财务处理报销

痛点：
❌ 纸质收据丢失（35%的索赔）
❌ 无移动捕获选项
❌ 手动政策检查（易出错）
❌ 无实时支出可见性
❌ 报销需2-3周

工作良好：
✓ 熟悉的Excel格式
✓ 经理批准链

─────────────────────────────────────────────
阶段4：期望状态
─────────────────────────────────────────────

成功愿景：
“从移动设备一键费用捕获，自动政策验证，实时批准工作流，同周报销。”

关键结果：
• <5分钟每份费用报告
• 提交时0%政策违规
• <3天报销
• 实时预算可见性

─────────────────────────────────────────────
阶段5：差距分析
─────────────────────────────────────────────

关键差距：
1. 无移动捕获 → 需要移动应用
2. 手动验证 → 需要政策引擎
3. 邮件工作流 → 需要批准系统
4. 无可见性 → 需要仪表板

新兴需求：
• 移动收据捕获带OCR
• 自动化政策验证
• 多级批准工作流
• 实时预算仪表板
• 与工资单集成

═══════════════════════════════════════════════
研讨会完成
═══════════════════════════════════════════════

总结：
• 问题明确定义 ✓
• 6名利益相关者映射 ✓
• 8个痛点识别 ✓
• 5个期望结果定义 ✓
• 12个需求候选生成 ✓

保存到：.requirements/expense-management/workshop/WS-20251226-170000.yaml

下一步：
1. 运行 /simulate 从利益相关者角度验证
2. 运行 /brainstorm 获取额外功能想法
3. 运行 /discover 形式化需求

输出位置

output_locations:
  报告: ".requirements/{领域}/workshop/WS-{时间戳}.yaml"
  需求: ".requirements/{领域}/workshop/requirements-{时间戳}.yaml"
  决策: ".requirements/{领域}/workshop/decisions-{时间戳}.yaml"

与其他命令的集成

研讨会前

# 收集上下文
/requirements-elicitation:research --domain "费用"

# 审查现有需求
/requirements-elicitation:gaps --domain "费用"

研讨会后

# 通过利益相关者模拟验证
/requirements-elicitation:simulate --domain "费用"

# 优先级排序捕获的需求
/requirements-elicitation:prioritize --domain "费用" --method moscow

# 导出到正式格式
/requirements-elicitation:export --domain "费用" --format ears

错误处理

error_handling:
  上下文不足:
    消息: "研讨会上下文不足"
    操作: "先运行 /research 或 /discover"

  无利益相关者:
    消息: "无利益相关者视角可用"
    操作: "先运行 /simulate 创建角色"