| 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. 搜索历史面谈记录
- 当用户在问“开过的会”“历史面谈”“最近发生过的面谈”“某段时间聊过什么”时，优先使用本技能。
- 默认先执行搜索，再决定是否继续读取会话文档。
- 搜索结果很多时，优先返回候选和预览，不要直接全量读取详情。
2. 读取会话文档
- 当用户已经指定会话，或明确需要摘要、待办、转写摘要、完整转写等内容时，再读取会话文档。
+documents 是 +search 之后的第二步动作，不应默认替代搜索。- 只有用户明确需要逐句完整转写时才开启
--fullDetail，避免不必要地读取和返回大体量内容。
3. 创建并发起面谈
- 当用户明确说“发起、预约、创建会议、安排面谈”时，才使用
+launch。
- 如果用户只说“准备一下、拟一个面谈安排”，不要发起；可以先整理参数或使用
--dry-run。
- 如果只给了人员姓名，优先按内部人员处理，先调用
ihr-cli base +selectStaffs 查找候选并确认 id，不能凭姓名猜 staffId；只有用户明确说明是外部人员，或内部人员查找无匹配且用户确认按外部人员处理时，才允许不传 staffId。
- 如果缺少时间、面谈官、面谈对象，先追问，不调用发起接口。
- 用户提供面谈大纲时，按 Markdown 文本传入
--outlineMdText 或 JSON 的 outline.mdText；未提供或内容为空时由服务端后台自动生成。
- 如果用户明确要求数字人面谈，先确认数字人面试模板：已有模板时可用
+search-avatar-template 查询；没有合适模板时可用 +create-avatar-template 创建。返回的 templateId 填到 +launch --interviewCode。
- 数字人面谈候选人必须有
name 和 phone 或 email，可以没有 staffId。
- 数字人面谈不要要求或构造
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 的操作优先使用。
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
可复用的自然语言测试问题集位于：
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。
