xunzhi-interview-domain

name	xunzhi-interview-domain
description	AI 面试业务域 Skill。当需求涉及 /api/xunzhi/v1/interview/** 的会话、出题、答题、评分、追问、神态分析、恢复、雷达图报告，或关键词"题号/状态机/FlowState/single-flight/快照/工作流契约"时使用。

xunzhi-interview-domain

面试核心 AI 链路：状态机 + 答题管线 + 评分追问 + 长会话状态治理。

使用顺序

• 先看 references/api-map.md，确认需求对应哪个端点。
• 改答题/评分行为，看 references/answer-pipeline.md 与 references/scoring-followup-rules.md。
• 改会话状态推进，看 references/state-machine.md 与 references/invariants.md。
• 改恢复/结束/快照，看 references/restore-and-finalize.md。
• 改出题/评分/神态的 AI 输出契约，看 references/workflow-contracts.md 与 references/generated-workflow-contracts.md。
• 对象归属分不清时看 references/object-dictionary.md，踩坑先看 references/gotchas.md。

关键入口

• app/interview/router.py（23 个端点）
• app/interview/pipeline.py（答题管线 execute）
• app/interview/flow.py（状态机 FlowState）
• app/interview/followup.py（追问 7 节点链）
• app/interview/runtime/（热冷快照 + rehydrate）
• app/interview/flight/（分布式 single-flight）

必守约束

• 题号格式 \d+ / \d+-F\d+，追问不计入总分。
• flow 推进必须按预期题号/version 原子提交（CAS）。
• 外部 AI 输出必须过解析防御层，工作流错误信封优先于结构化解析。

参考资料

• references/object-dictionary.md
• references/invariants.md
• references/lifecycle.md
• references/answer-pipeline.md
• references/state-machine.md
• references/scoring-followup-rules.md
• references/api-map.md
• references/workflow-contracts.md
• references/generated-workflow-contracts.md
• references/restore-and-finalize.md
• references/gotchas.md
• scripts/extract_workflow_contracts.py（生成 references/generated-workflow-contracts.md）