用途：该技能是 CodeCompass 中语义搜索的决策框架与执行指南，帮助在语义搜索与 grep/glob 之间选择，并按含义而非名称查找代码。
主要能力：适合概念型查询（如“处理支付流程的代码”）、意图型查询（如“用户认证如何实现”）、跨语言跨文件搜索、模糊探索以及自然语言查询。精确类名/函数名、语法模式、结构查询或性能敏感场景应改用 grep/glob。
使用方式：先确认已索引，可访问 http://localhost:8081/v1/schema 查看 CodeContext、AtlasCode 等集合；未索引则运行 codecompass batch:index <path-to-codebase>。随后执行 codecompass search:semantic "business logic for payment processing"。查询建议采用“[动作/目的] for [具体实体] with [上下文/约束]”的公式，避免过于宽泛的词。结果按相关度分数解读：>0.8 高度相关，0.7-0.8 良好，0.6-0.7 中等，<0.6 较弱。结果过多可增加上下文或提高 certainty 阈值，过少可放宽查询或降低阈值。
技术细节：查询经 Ollama mxbai-embed-large 生成 1024 维向量，再由 Weaviate 以余弦相似度检索，使用 HNSW 索引。相关配置项包括 EMBEDDING_SERVICE、OLLAMA_EMBEDDING_MODEL、OLLAMA_URL、CODECOMPASS_WEAVIATE_URL。
适用场景与限制：适合中大型代码库的概念探索与陌生代码理解；速度约 100-500ms，慢于 grep 的毫秒级。常见问题包括未索引即搜索、查询过泛、期望精确匹配、忽略相关度分数、复杂问题只用单次查询。资料未提供收费、价格或平台支持信息。