用途：code-search 用于在代码库中进行语义搜索，用自然语言描述要找的内容，而不是依赖精确关键字。它返回结构化结果，包含文件路径、行号、匹配内容与相关性分数，便于直接跳转阅读。
主要能力：支持自然语言查询；覆盖 102 种文件类型；结果按相关性排序（除非指定 sort-by）；支持过滤（max-results、min-score、sort-by）、目录范围（context.path）、文件类型（file-types）、排除模式（exclude-patterns）与超时（timeout）；输出含 status（success/empty/partial/error）、results 与 meta 信息。
使用方式：命令行执行 bun x codebasesearch "your natural language query"。也可通过 Skill 工具传入结构化 JSON，例如 {"prompt": "where is authentication handled"}，或带过滤与范围：{"prompt": "database connection setup", "filter": {"max-results": 20, "min-score": 0.7, "sort-by": "path"}}。查找文件时建议先少词、再逐步细化，可多次搜索。
适用场景：定位认证、数据库连接、错误日志、限流器、配置解析等实现位置；在阅读文件前先获取路径与行号。
限制：规则要求搜索代码时只用 bun x codebasesearch 或自定义代码，不使用其他 CLI 工具搜索代码库；超时查询返回 status=partial 的部分结果；无效参数返回 error 并附错误详情（如 INVALID_PATH、SCHEMA_VIOLATION）。具体安装、收费与平台支持暂未提供。