| name | onboarding-interview |
| version | 1.0.0 |
| description | 首次使用配置——通过简短访谈构建实践画像，写入 profile.md 供全套件读取。当用户首次使用套件或说"重新配置""初始化"时触发。含排版规范分支，绑定「文书排版」skill 的 format-spec.md 参数源。 |
冷启动访谈（onboarding-interview）
触发条件
- 用户首次使用诉讼套件（profile.md 不存在或为空）
- 用户说"重新配置""初始化"或传入
--reset
核心原则
- 不重复问已知信息。 先读 Expert.md / profile.md，后补缺口。
- 每轮最多2-3个问题。 等待回答后再继续。
- 可跳过。 用户说"跳过"则标
[PLACEHOLDER]，后续随时可补。
- 快速完成。 全程5分钟内可走完。
Phase 1：身份与角色
从 awareness 系统提取已知信息后，确认/补充：
- 角色：执业律师 / 公司法务
- 立场倾向：主诉为主 / 被诉为主 / 混合
- 团队/组织（可跳过）
- 主要业务领域与案由（可跳过）
Phase 2：风格与偏好
- 风险偏好：一句话描述（如"稳健""积极进攻""保守防御"）
- 文书语调：正式 / 半正式 / 因场景而异
- 可选：提供示例文书供学习风格
Phase 3：案件管理配置
3.1 台账载体
案件数据放哪里？（套件用 COLLAB.sheet_* 能力槽调用，平台无关）
| 选项 | 说明 |
|---|
| (a) 钉钉 AI 表格 | 团队在线协同（钉钉环境，经 dws） |
| (b) 飞书多维表格 | 团队在线协同（飞书环境，经 lark-cli） |
| (c) 本地文件 | 单人/离线（零依赖） |
| (d) 暂不配置 | 先用着，后续再说（后果：case-manager将以本地文件模式运行，不支持团队在线协同） |
3.2 办案流程
你有自己的办案流程指引吗？
- (a) 有——请粘贴或上传，我提炼写入配置
- (b) 没有——使用套件默认通用流程（收案→梳理→文书→庭审→复盘）
3.3 期限提醒
| 配置项 | 选项 | 默认值 |
|---|
| 提醒渠道 | IM推送 / 日历日程（COLLAB.calendar_create）/ 仅查看 | IM推送 |
| 每日提醒时间 | 用户指定 | 09:00 |
接受默认？还是要调整？
Phase 3.5：排版规范绑定
「文书排版」skill 转 Word 时按 format-spec.md 中的参数（字体/字号/行距/边距/引用格式白名单/校验阈值）渲染。你要用哪一份？
| 选项 | 说明 |
|---|
| (a) 默认模板 | 使用套件根目录 format-spec.md（最高院诉讼文书样式 v2020 均值） |
| (b) 自定义配置 | 复制 format-spec.md 为 format-spec.<name>.md 后修改，本次配置指向该文件 |
| (c) 暂不配置 | 使用默认模板；后续可随时切换（后果：所有文书统一按默认规范，无法针对特定法院/法域微调） |
若选 (b)：
- 建议命名规范：
format-spec.<court-or-region>.md（如 format-spec.shanghai-2nd.md）
- 参数覆写点包括：字体、字号、行距、边距、
blocked_authors / blocked_books（正文引用屏蔽名单）、citation_tags（来源标记白名单）、verify_auto_fix_max / verify_reject_min（校验阈值）
- 记录用户指定的文件路径 → 写入 profile.md
format_spec_path 字段
md2docx_legal.py --spec <path> 与 verify_docx.py --spec <path> 均从该文件读取参数
若选 (a) 或 (c)：format_spec_path 留空，脚本自动发现套件根目录的 format-spec.md。
Phase 4：知识库配置
套件产出的研究、复盘成果要沉淀到哪里？选择你的知识库后端（可多选）：
| 选项 | 说明 |
|---|
| (a) qmind 云端知识库 | 语义检索，亚秒级响应（需安装 qmind-knowledge skill） |
| (b) 飞书知识库 | 团队在线协同（经飞书 Open API） |
| (c) 钉钉知识库 | 团队在线协同（经 dws） |
| (d) Obsidian Vault | 本地零依赖方案——指定 Vault 路径，套件通过 Grep/ripgrep 检索，Markdown 文件沉淀 |
| (e) ima 知识库 | 腾讯 ima 知识库（经 ima-mcp 连接器），支持语义检索与 RAG 问答 |
| (f) 暂不配置 | 后续再说（后果：知识不持久化，仅对话内可用，无法跨会话检索） |
若选 Obsidian Vault：
- 用户提供 Vault 路径（如
~/Documents/Obsidian/MyVault/）
- 套件按三区架构在 Vault 内建立目录：
A-部门法知识库/、B-办案笔记/、C-工作笔记/
- 检索降级链：rg/grep 全文搜索 → Read 读取上下文
- 沉淀方式：直接写入 Markdown 文件到对应目录
若选 ima 知识库：
- 确认已安装并授权
ima-mcp 连接器
- 在 ima 中创建对应知识库空间（部门法知识库 / 办案笔记 / 工作笔记）
- 用户提供各空间的 ID → 写入 profile.md
- 检索通过
KB.retrieve → ima-mcp 后端执行语义检索
若选 (a)/(b)/(c)：
- 引导创建 notebook/知识库空间
- 用户提供 ID → 写入 profile.md
- 验证连通性（试跑一次 retrieve）
混用方案：可同时选择多个后端，例如"qmind 负责检索 + Obsidian 负责本地沉淀"、"ima 负责语义检索 + 飞书负责团队协同"——在 profile.md 的 kb_backend 中按三区分开绑定。
Phase 5：后端探测与写入
- 用
MCP.list_tools 自动探测当前已连接的 MCP
- 向用户展示探测结果（哪些能力可用）
探测结果为空时的处理：
如探测到某类关键后端（法律检索/工商信息）完全不可用，向用户展示探测结果并给出配置引导：
"当前未检测到法律检索 MCP。套件在无此后端时仍可运行，但法条引用将无法自动校验，标注为 [L4-法条待验证]。
建议前往宿主平台的连接器/MCP 设置（Agent 运行时 / Claude Code / Cursor / Gemini CLI / OpenCode 等） 中搜索并安装「元典」或「北大法宝」连接器。
安装完成后回到本技能重新探测即可。"
对用户选择的处理：
- 用户选择去配置 → 提示配置完成后重新运行
/onboarding-interview
- 用户选择暂不配置 → 在 profile.md 对应后端字段写入 PLACEHOLDER 并附注降级影响
- 如有多家同类后端，询问首选
- 汇总全部配置写入
profile.md
- 向用户确认：
画像已生成，保存在 profile.md。
核心配置：{角色} / {立场} / {台账载体} / {排版规范} / {知识库方案}
已探测后端：{可用列表}
随时可以直接让我修改 profile.md 中的任何配置项。
快速模式
用户说"快速配置"时，仅收集：角色+立场+台账载体+知识库选择，其余全用默认值。排版规范默认指向套件根目录 format-spec.md。
本技能不做什么
- 不替用户决定策略框架
- 不硬编码任何供应商或公司名
- 不假装信息缺口不存在
