360 Secure SkillHub
360 安全技能中心

Semantic Code Search

该 Skill 面向代码库语义检索：先用 AST 解析函数与类并生成嵌入索引，再按自然语言意图查询、查找相似实现和重复逻辑，并给出 CLI 用法；但 SKILL.md 中 CLI 引用的 scripts/search.py 未包含在文件列表中。

evezart
evezart
热度 25.37
最近更新 2026-05-12 20:26:50
分类：搜索依赖：代码执行 / 读写文件应用场景：代码审查 / 研究

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add semantic-code-search
Metadata
name
semantic-code-search
description
Semantic search engine for codebases that understands intent and finds functionally similar code. Use when searching code by meaning rather than text, finding similar implementations, discovering duplicate logic, or navigating unfamiliar codebases. Covers AST parsing, embedding generation, similarity search, and intent-based queries.

Semantic Code Search

Find code by meaning, not just text. Search across codebases using natural language intent.

Quick Start

from code_search import CodeIndex, SemanticSearch

index = CodeIndex("/path/to/codebase")
index.build()  # Parse AST, generate embeddings

search = SemanticSearch(index)
results = search.query("how is authentication handled?")
results = search.similar_to("src/auth/login.py:validate_token")

How It Works

  1. Parse — Walk codebase, extract functions/classes with AST
  2. Embed — Generate vector embeddings from code + docstrings
  3. Index — Store in vector index with metadata (file, line, type)
  4. Search — Query by intent or find similar code

Search Types

  • Intent search: "find error handling patterns" → returns matching code
  • Similarity search: Given a function, find others doing the same thing
  • Structural search: Find all functions matching a call pattern
  • Duplicate detection: Find code doing the same thing differently

CLI

python3 scripts/search.py index /path/to/codebase
python3 scripts/search.py query "database connection setup"
python3 scripts/search.py similar src/db/connect.py:10
python3 scripts/search.py duplicates