youchu-lawhub/cn-litigation-toolkit/onboarding-interview

冷启动访谈（onboarding-interview）

触发条件

• 用户首次使用诉讼套件（profile.md 不存在或为空）
• 用户说"重新配置""初始化"或传入 --reset

核心原则

1. 不重复问已知信息。 先读 Expert.md / profile.md，后补缺口。
2. 每轮最多2-3个问题。 等待回答后再继续。
3. 可跳过。 用户说"跳过"则标 [PLACEHOLDER]，后续随时可补。
4. 快速完成。 全程5分钟内可走完。

Phase 1：身份与角色

从 awareness 系统提取已知信息后，确认/补充：

• 角色：执业律师 / 公司法务
• 立场倾向：主诉为主 / 被诉为主 / 混合
• 团队/组织（可跳过）
• 主要业务领域与案由（可跳过）

Phase 2：风格与偏好

• 风险偏好：一句话描述（如"稳健""积极进攻""保守防御"）
• 文书语调：正式 / 半正式 / 因场景而异
• 可选：提供示例文书供学习风格

Phase 3：案件管理配置

3.1 台账载体

案件数据放哪里？（套件用 COLLAB.sheet_* 能力槽调用，平台无关）

3.2 办案流程

你有自己的办案流程指引吗？

- (a) 有——请粘贴或上传，我提炼写入配置

- (b) 没有——使用套件默认通用流程（收案→梳理→文书→庭审→复盘）

3.3 期限提醒

接受默认？还是要调整？

Phase 3.5：排版规范绑定

「文书排版」skill 转 Word 时按 format-spec.md 中的参数（字体/字号/行距/边距/引用格式白名单/校验阈值）渲染。你要用哪一份？

若选 (b)：

1. 建议命名规范：format-spec.<court-or-region>.md（如 format-spec.shanghai-2nd.md）
2. 参数覆写点包括：字体、字号、行距、边距、blocked_authors / blocked_books（正文引用屏蔽名单）、citation_tags（来源标记白名单）、verify_auto_fix_max / verify_reject_min（校验阈值）
3. 记录用户指定的文件路径 → 写入 profile.md format_spec_path 字段
4. md2docx_legal.py --spec <path> 与 verify_docx.py --spec <path> 均从该文件读取参数

若选 (a) 或 (c)：format_spec_path 留空，脚本自动发现套件根目录的 format-spec.md。

Phase 4：知识库配置

套件产出的研究、复盘成果要沉淀到哪里？选择你的知识库后端（可多选）：

若选 Obsidian Vault：

1. 用户提供 Vault 路径（如 ~/Documents/Obsidian/MyVault/）
2. 套件按三区架构在 Vault 内建立目录：A-部门法知识库/、B-办案笔记/、C-工作笔记/
3. 检索降级链：rg/grep 全文搜索 → Read 读取上下文
4. 沉淀方式：直接写入 Markdown 文件到对应目录

若选 ima 知识库：

1. 确认已安装并授权 ima-mcp 连接器
2. 在 ima 中创建对应知识库空间（部门法知识库 / 办案笔记 / 工作笔记）
3. 用户提供各空间的 ID → 写入 profile.md
4. 检索通过 KB.retrieve → ima-mcp 后端执行语义检索

若选 (a)/(b)/(c)：

1. 引导创建 notebook/知识库空间
2. 用户提供 ID → 写入 profile.md
3. 验证连通性（试跑一次 retrieve）

混用方案：可同时选择多个后端，例如"qmind 负责检索 + Obsidian 负责本地沉淀"、"ima 负责语义检索 + 飞书负责团队协同"——在 profile.md 的 kb_backend 中按三区分开绑定。

Phase 5：后端探测与写入

1. 用 MCP.list_tools 自动探测当前已连接的 MCP
2. 向用户展示探测结果（哪些能力可用）

探测结果为空时的处理： 如探测到某类关键后端（法律检索/工商信息）完全不可用，向用户展示探测结果并给出配置引导：

"当前未检测到法律检索 MCP。套件在无此后端时仍可运行，但法条引用将无法自动校验，标注为 [L4-法条待验证]。

建议前往宿主平台的连接器/MCP 设置（Agent 运行时 / Claude Code / Cursor / Gemini CLI / OpenCode 等） 中搜索并安装「元典」或「北大法宝」连接器。

安装完成后回到本技能重新探测即可。"

对用户选择的处理：

• 用户选择去配置 → 提示配置完成后重新运行 /onboarding-interview
• 用户选择暂不配置 → 在 profile.md 对应后端字段写入 PLACEHOLDER 并附注降级影响

1. 如有多家同类后端，询问首选
2. 汇总全部配置写入 profile.md
3. 向用户确认：

画像已生成，保存在 profile.md。

核心配置：{角色} / {立场} / {台账载体} / {排版规范} / {知识库方案}

已探测后端：{可用列表}

随时可以直接让我修改 profile.md 中的任何配置项。

快速模式

用户说"快速配置"时，仅收集：角色+立场+台账载体+知识库选择，其余全用默认值。排版规范默认指向套件根目录 format-spec.md。

本技能不做什么

• 不替用户决定策略框架
• 不硬编码任何供应商或公司名
• 不假装信息缺口不存在