| name | mizzen-cli |
| description | AI 访谈设计与管理技能。通过 Mizzen CLI 创建和管理用户研究访谈。
触发词: mizzen, mizzen-cli, create interview, design study guide, user research, user interview, 用户访谈, 访谈设计,
study guide, 调研, 创建访谈, 设计大纲, research interview, screener design,
采访, 问卷, 做个调研, 做个访谈, 出几道题, 设计问卷, 做用研, 出题, 设计几个问题.
核心能力: 访谈创建、大纲设计、题目设计、甄别筛选、对话数据获取。
|
Mizzen CLI Skill
通过 Mizzen CLI 设计和管理用户研究访谈。本 skill 包含访谈设计方法论和 CLI 使用指南。
CRITICAL — 使用任何 CLI 命令前，必须先确认认证状态：mizzen-cli auth status
版本更新通知
JSON 输出中的 _notice.update 是 CLI 的版本通知，不是业务数据。看到该字段时，先完成用户当前请求，再简短告知 current 与 latest 版本，并提议执行其 command 字段中的更新命令。
Core Concepts
- Interview：访谈项目，由
slug 标识。包含标题、研究背景、目标、欢迎语、结束语等配置
- Outline：访谈大纲，由多个 Section 组成
- Section：板块，由
section_id 标识。类型：flat（普通）/ screening（甄别）
- Question：题目，由
question_id 标识。类型：open_ended / multiple_choice / scale / submission / cascading / matrix / ranking / proportion / statement
- Conversation：一次对话（一个受访者的完整访谈过程），由
readable_id 标识
- Insight：洞察报告，基于多个已完成对话的 AI 分析
Resource Relationships
Interview (slug)
├── Outline
│ ├── Section (section_id)
│ │ ├── Question (question_id)
│ │ └── Question
│ └── Section
│ └── Question
├── Conversation (readable_id)
│ ├── Messages (role + content + timestamp)
│ ├── Transcript (纯文本逐字稿)
│ └── Answers (结构化回答)
└── Insight (洞察报告)
行为决策指引
意图识别：先判断用户要做什么，再选择对应的命令。不要混淆类似操作。
创建 vs 查看 vs 分析
| 用户意图 | 应该做什么 | 不要做什么 |
|---|
| "帮我设计一个访谈" | 走完整工作流（workflow.md）：理解目标 → 设计大纲 → 确认 → 创建 | 不要跳过方法论直接 interview create |
| "查看访谈数据" | conversation list → conversation get/transcript/answers | 不要用 interview get（那是看配置，不是看数据） |
| "有多少人参与了" | interview stats <slug> | 不要用 conversation list 手动计数 |
| "分析结果 / 出报告" | insight get → 没有则 insight generate | 不要自己逐个读 conversation 手动总结 |
| "修改题目" | 先 outline show 获取当前状态和 ID，再 question update | 不要凭记忆操作，先看当前大纲 |
| "访谈链接在哪" | interview get <slug> 返回管理链接和分享链接 | 不要用 interview list |
ID 获取规则
所有 ID 都必须从命令返回值获取，不要猜测或编造。
| 需要的 ID | 从哪里获取 |
|---|
slug | interview create 返回值 或 interview list |
section_id | outline section add 返回值 或 outline show |
question_id | outline question add 返回值 或 outline show |
readable_id（对话编号） | conversation list 返回的 # 列 |
核心原则
| 原则 | 规则 |
|---|
| 开放题优先 | 优先使用开放题探索"为什么"；选择题仅用于甄别或量化 |
| 问"为什么"和"怎么" | 关注动机和过程，而非只问"是什么"和"什么时候" |
| 具体化提问 | 必须问具体事件（"你昨天/上次……发生了什么"），禁止问泛泛感受（"你觉得……怎么样"） |
| 场景化切入 | 每道题要有明确的场景锚点（时间、地点、触发事件） |
| 追问深度 | 仅开放题支持 none / light / heavy / timed；timed 必须同时设置 --time-budget，结构题必须省略追问参数 |
| 结构题契约 | 量表、上传、级联、矩阵、排序和比重题必须提供对应的完整配置；配置格式见 question-design.md 和 outline.md |
| 稳定选项 ID | 选择、排序、比重等选项题按 ID 聚合；新增顶层 options 由 CLI 生成 UUID，修改已有选项必须保留原 ID |
| 访谈时长 | 目标约 20-30 分钟（10-15 题），最长不超过 1 小时 |
| 甄别选项 | 甄别题的选项用 + 标记通过、- 标记筛除，在 --options 中设置 |
方法论规则
CLI 命令参考
重要：使用命令前，先读取对应的 reference 文件了解参数和注意事项。
| 命令 | Reference | 说明 |
|---|
interview create/get/list/update/delete/publish/share/stats | interview.md | 访谈创建、查看、修改、发布、分享 |
outline show/section/question | outline.md | 大纲查看、板块管理、题目管理 |
conversation list/get/transcript/answers/export/hide/unhide | conversation.md | 对话数据读取、导出及可见性管理 |
insight get/generate | insight.md | 洞察报告获取与生成 |
auth/config | auth-config.md | API Key 管理、CLI 配置 |
