ihr-conference

name	ihr-conference
description	iHR360 面谈/会议：搜索历史面谈记录、按需读取会话文档预览或完整详情、带参创建并发起面谈。查询历史面谈时先搜索候选；读取内容时再取文档；发起面谈前必须确认人员 ID 和时间。
metadata	{"requires":{"bins":["ihr-cli"]},"cliHelp":"ihr-cli conference --help"}

conference (v1)

CRITICAL — 开始前 MUST 先阅读 ../ihr-shared/SKILL.md，其中包含共享运行规则、时间处理原则和 JSON 协议。

核心概念

• ConferenceSession：面谈/会议会话，通过 conferenceSessionId 标识。
• Search Result：首轮搜索返回的候选会话集合，包含 conferenceSessionIds、returnedCount、truncated 和可选 previewItems。
• Preview Item：标准化会话预览项，包含搜索状态、时间、多类预览文本，以及 currentQueryUserIdentity。搜索结果没有基础信息权限时会删除整条预览项，其他受限字段返回 null。
• Session Documents：按会话 ID 读取的文档化结果，是搜索后的第二步动作；每项通过 access 表达四类内容权限，按需使用 fullDetail=true 读取完整转写。
• Avatar Template：数字人面试配置模板。+search-avatar-template 和 +create-avatar-template 返回的 templateId 是数字人模板业务 ID，可作为 +launch --interviewCode 使用；它不是 conference 大纲模板 templateId。
• Launch Request：带参创建并发起面谈的请求。目的和模板使用静态 ID，普通系统内人员必须先通过 ihr-cli base +selectStaffs 查找并确认；可选 outline.mdText 传入 Markdown 格式面谈大纲。数字人面谈通过 thirdPartyPlatform=DIGITAL_AVATAR 或 interviewMode=DIGITAL_AVATAR 和 digitalAvatarConfig.interviewCode 选择，不暴露后端角色码。

核心场景

1. 搜索历史面谈记录

1. 当用户在问“开过的会”“历史面谈”“最近发生过的面谈”“某段时间聊过什么”时，优先使用本技能。
2. 默认先执行搜索，再决定是否继续读取会话文档。
3. 搜索结果很多时，优先返回候选和预览，不要直接全量读取详情。

2. 读取会话文档

1. 当用户已经指定会话，或明确需要摘要、待办、转写摘要、完整转写等内容时，再读取会话文档。
2. +documents 是 +search 之后的第二步动作，不应默认替代搜索。
3. 只有用户明确需要逐句完整转写时才开启 --fullDetail，避免不必要地读取和返回大体量内容。

3. 创建并发起面谈

1. 当用户明确说“发起、预约、创建会议、安排面谈”时，才使用 +launch。
2. 如果用户只说“准备一下、拟一个面谈安排”，不要发起；可以先整理参数或使用 --dry-run。
3. 如果只给了人员姓名，优先按内部人员处理，先调用 ihr-cli base +selectStaffs 查找候选并确认 id，不能凭姓名猜 staffId；只有用户明确说明是外部人员，或内部人员查找无匹配且用户确认按外部人员处理时，才允许不传 staffId。
4. 如果缺少时间、面谈官、面谈对象，先追问，不调用发起接口。
5. 用户提供面谈大纲时，按 Markdown 文本传入 --outlineMdText 或 JSON 的 outline.mdText；未提供或内容为空时由服务端后台自动生成。
6. 如果用户明确要求数字人面谈，先确认数字人面试模板：已有模板时可用 +search-avatar-template 查询；没有合适模板时可用 +create-avatar-template 创建。返回的 templateId 填到 +launch --interviewCode。
7. 数字人面谈候选人必须有 name 和 phone 或 email，可以没有 staffId。
8. 数字人面谈不要要求或构造 roleCode、DA_*、REGULAR_*。数字人面谈官用 sourceType=DIGITAL_HUMAN 表示，staffId 是数字人配置 ID；未给面谈官或唯一数字人面谈官未给 staffId 时会默认补 1。

资源关系

ConferenceSession
├── Search Result
│   ├── conferenceSessionIds[]
│   └── previewItems[]
│       ├── status
│       ├── startTime / endTime / createTime
│       ├── finalScore
│       ├── basicText / outlineText / smartMinutesText / topicText
│       ├── summaryText / todoText / transcriptSummaryText
│       └── currentQueryUserIdentity
└── Session Documents
    └── previewItems[]
        ├── access.basicInfo / outline / smartSummary / transcript
        ├── status
        ├── startTime / endTime / createTime
        ├── basicText / outlineText / smartMinutesText / topicText
        ├── summaryText / todoText / transcriptSummaryText
        ├── currentQueryUserIdentity
        └── transcriptSegments[]  # 仅 fullDetail=true 且允许查看转写时返回

Launch Request
├── purposeId / templateId
├── startTime / duration / interviewMode / thirdPartyPlatform
├── digitalAvatarConfig
├── interviewers[]
├── interviewees[]
├── others[]
└── outline.mdText

Avatar Template
├── templateId  # 用作 +launch --interviewCode
├── templateName / interviewName
├── jobTitle / digitalHumanId
├── questionsCount / usageCount / hasDraft
└── updatedAt

路由规则：用户先问“有哪些历史面谈/聊过什么/最近开过什么”时，优先使用 +search。只有在用户明确需要阅读内容、摘要、待办、转写摘要，或已指定 conferenceSessionId 时，才进入 +documents。用户明确要创建、预约或发起面谈，且关键参数已确认时，才进入 +launch。

禁止误用：+launch 有真实副作用，会创建会话并发起三方会议。人员、时间或意图不确定时不要调用。

默认策略：先搜候选，再按需读文档；不要把会话文档读取当成首轮入口。

权限语义：+search 与 +documents 的无权限响应不同。搜索没有基础信息权限时删除整条 previewItem，且不返回 access；文档批量读取会按请求顺序保留每个 session，无基础信息权限或 session 不可用时仅返回 conferenceSessionId 和四项全为 DENIED 的 access，其他业务字段为 null。

人员依赖：+launch 依赖 ihr-cli base +selectStaffs。拿到姓名时优先查找内部人员；分项参数或 JSON 里的内部人员必须使用已确认的 staffId，不要把姓名直接当作人员 ID。只有用户明确说明是外部人员，或内部人员查找无匹配且用户确认按外部人员处理时，外部人员才可以没有 staffId，但必须提供姓名、手机号、邮箱等足够识别和联系的信息。参与人未传 sourceType 时，有 staffId 的人员按当前产品补 IHR360/WORK100，没有 staffId 的人员补 EXTERNAL。

面谈大纲：+launch 支持 Markdown 格式大纲。传入 outline.mdText 后，服务端会直接保存该大纲，不触发后台自动生成；不传或传空白时，服务端按模板后台生成大纲。

数字人面谈：数字人面谈仍使用 +launch，传 thirdPartyPlatform=DIGITAL_AVATAR 或 interviewMode=DIGITAL_AVATAR，并传 digitalAvatarConfig.interviewCode。如果用户没有给出可用 interviewCode，先用 +search-avatar-template 搜索；没有合适模板时再用 +create-avatar-template 创建。候选人只允许一个，必须有联系方式；others 不支持；真人监考官只有在允许介入时才作为非 DIGITAL_HUMAN 面谈官传入，且必须且只能有一个。不要向用户暴露后端角色码。

Shortcuts（推荐优先使用）

Shortcut 是对常用操作的高级封装（ihr-cli conference +<verb>）。有 Shortcut 的操作优先使用。

Shortcut	说明
+search	搜索历史面谈记录，支持结构化条件、文本搜索和首轮预览
+documents	按会话 ID 读取文档化预览或完整转写详情
+search-avatar-template	查询已有数字人面试模板，返回可作为 interviewCode 的 templateId
+create-avatar-template	创建并发布数字人面试模板，返回可作为 interviewCode 的 templateId
+launch	带参创建并发起面谈，要求人员 ID 已确认

Current Implementation

当前主实现已经在 ihr-cli 子项目内：

Shortcut	当前命令
ihr-cli conference +search	ihr-cli conference +search
ihr-cli conference +documents	ihr-cli conference +documents
ihr-cli conference +search-avatar-template	ihr-cli conference +search-avatar-template
ihr-cli conference +create-avatar-template	ihr-cli conference +create-avatar-template
ihr-cli conference +launch	ihr-cli conference +launch

Scenes

可复用的自然语言测试问题集位于：

1. scenes/ihr-conference-skill-test-questions.txt

能力入口

公开入口只有 ihr-cli conference +search、ihr-cli conference +documents 和 ihr-cli conference +launch。字段契约通过命令 help 或 schema 能力确认；不要在 skill 中暴露底层路径，也不要使用 ihr-interface、raw API、curl/httpie/wget 或自写 HTTP client。