用途:这是 CodeCompass 的元技能(meta-skill),用于在会话开始时高效了解 CodeCompass 能做什么,避免手动探索或重复发现。适用于会话开始、用户询问“CodeCompass 能做什么”、实现功能前检查是否已存在、探索不熟悉的代码库、规划复杂工作流等场景。
主要能力:提供分层发现机制。第一层为 CLAUDE.md 快速参考,约 2000 tokens,含技术栈、基础设施、基本命令。第二层为 .ai/capabilities.json 结构化发现,约 2500 tokens,含全部领域、模块、关系与入口点,是“存在什么”的唯一事实来源。第三层为 .claude/skills/ 技能索引,约 700 tokens 元数据扫描,含工作流、角色与模式。第四层为 Weaviate 语义搜索,用于实现级发现。第五层为 src/modules/ 源代码,用于查看实现细节。
使用方式:快速发现可执行 cat .ai/capabilities.json | jq '.domains | keys' 查看领域,或 cat .ai/capabilities.json | jq '.domains.code_analysis' 查看具体领域。结构化发现按“读 capabilities.json → 识别相关领域 → 检查模块能力 → 加载相关技能”进行。语义发现使用 pnpm run cli -- search:semantic "查询内容"。决策树为:问“是什么”读 capabilities.json;问“怎么用”加载 .claude/skills/ 下相关技能;问“在哪实现”用 Weaviate 语义搜索;问“内部细节”读 src/modules/ 下文件。
适用场景:判断 CodeCompass 是否支持某功能、查找处理认证等特定模块、规划重构、调试集成问题、参考 common_workflows 中的常见任务步骤。
限制:资料未提供具体安装步骤、收费信息或平台支持范围。capabilities.json 需在模块变更时手动更新,否则信息可能过时。语义搜索依赖 Weaviate 数据库,token 消耗随查询结果变化。