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.mdreferences/common-entrypoints.mdreferences/request-to-module-map.mdreferences/generated-api-index.mdscripts/extract_api_index.py