---
name: lishuangqiang/xunzhi-repo-map
source: https://app.decimal.ai/s/lishuangqiang-xunzhi-repo-map@1/SKILL.md
source_sha256: 882aed91a4b1
---

# xunzhi-repo-map

先用这层做路由，再切到对应业务 Skill。

## 使用顺序

- 先看 `references/request-to-module-map.md`，把需求归到一个主域。
- 再看 `references/common-entrypoints.md`，找到最先该打开的控制器、配置或工作流文件。
- 再看 `references/generated-api-index.md`，按接口前缀和认证方式快速定位实现。
- 如果需求涉及改接口、改配置、改工作流或跨多个域，立刻切到对应领域 Skill，不要长期停留在总路由层。

## 路由原则

- 先判断对象是什么，再判断它属于哪个域。
- 面试会话、出题、评分、追问、恢复、简历预览、神态分析，都归 `xunzhi-interview-domain`。
- 通用 Agent 聊天、会话历史、文件上传、Agent 属性管理，都归 `xunzhi-agent-domain`。
- 实时转写、WebSocket 推送、长文本 TTS，都归 `xunzhi-media-domain`。
- 运行时限流、守护、singleflight、线程池、配置语义，都归 `xunzhi-ai-runtime`。
- 登录、当前用户、权限、WebSocket 鉴权，都归 `xunzhi-auth-user`。
- 需求同时改接口、DTO、工作流、配置、缓存时，先用 `xunzhi-change-playbook`。
- 现象不清楚、怀疑卡死、重试、重复、恢复失败时，先用 `xunzhi-debug-playbook`。

## 什么时候继续下钻

- 需求已经明确落到某个 controller、service 或 workflow 时，不要继续停在 repo-map。
- 需要确认入参、出参、缓存键、状态机、限流策略时，优先打开对应域的 references。
- 如果你已经知道要改哪一层，就直接切换 Skill，不要再做二次路由。

## 参考资料

- `references/module-routing.md`
- `references/common-entrypoints.md`
- `references/request-to-module-map.md`
- `references/generated-api-index.md`
- `scripts/extract_api_index.py`