用途:find-code 用于在代码仓库中快速定位文件与代码位置。其核心规则是不让 AI 扫描整个仓库,而是运行检索工具、读取结果,然后直接跳到目标文件或细化搜索后重跑。
主要能力:通过脚本 find.sh 提供多种搜索模式,包括按文本或正则查找、按文件名查找、查找符号定义、查找函数的所有调用方、查找模块的所有导入,并支持按文件类型(--ext)和指定文件夹(--in)过滤。输出格式固定为 file:line: content,即文件路径、行号与内容,便于直接定位。
使用方式:命令形如 bash <skill-dir>/scripts/find.sh "createUser";按文件名搜索用 --file "userService";查找定义用 --def "createUser";查找调用方用 --callers "createUser";查找导入用 --imports "moduleName";限定类型用 --ext ts;限定目录用 --in src/services。结果过宽时逐步收窄,结果为空时可加 --flags "-i" 做大小写不敏感搜索或改用文件名搜索。拿到 file:line 后只读取该文件对应行,不再重新扫描。
适用场景:适合 AI 编程智能体在大型代码库中做符号定位、调用关系梳理、导入追踪和按类型或目录的定向检索。
限制:默认结果上限为 50 行,被截断时应收窄搜索而非提高上限;连续细化不超过 3 次就应向用户汇报;不应打开文件来在内部搜索,而应再次运行 find.sh。参考资料 REFERENCE.md 提供 grep 配方、按语言的 regex 模式与常见搜索场景。具体安装方式与平台支持暂未提供。