Community生產力與協作github.com

wshobson/向量索引調校

優化向量索引在延遲、召回率與記憶體上的效能。適用於調整 HNSW 參數、選擇量化策略或擴展向量搜尋基礎架構時。

向量索引調校 是什麼?

此技能專為開發者與AI代理設計,用於優化向量索引的關鍵效能指標,包括延遲、召回率和記憶體使用效率。它支援調整 HNSW 參數(如 M、efConstruction 和 efSearch)、選擇合適的量化策略(如 PQ、SQ 或 OPQ),並協助擴展向量搜尋基礎架構。技能提供結構化的指南和最佳實踐,幫助使用者根據具體應用場景(如近似最近鄰搜尋的精度與速度權衡)來調整索引設定。透過使用此技能,開發者能夠系統性地分析索引效能瓶頸,並應用正確實踐以在生產環境中達到理想的搜尋效能與資源利用平衡。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/wshobson/agents/tree/main/skills/vector-index-tuning

Installed? Explore more 生產力與協作 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

向量索引調校 是做什麼的?

用於優化向量索引在延遲、召回率與記憶體上的效能。適用於調整 HNSW 參數、選擇量化策略或擴展向量搜尋基礎架構時。

概述

本技能提供全面的指引,幫助調整向量索引的效能,涵蓋延遲、召回率和記憶體使用等關鍵指標。它專為處理 HNSW 索引演算法參數最佳化、量化策略選擇以及向量搜尋基礎架構擴展的開發者與 AI 代理設計。

主要功能

  • HNSW 參數調校:指導調整 M、efConstruction 和 efSearch 等參數,以平衡建置速度、查詢延遲與召回率。
  • 量化策略選擇:協助評估並選擇合適的量化方法(如乘積量化 PQ、純量量化 SQ 或最佳化乘積量化 OPQ),以減少記憶體佔用並維持可接受的召回率。
  • 基礎架構擴展:提供擴展向量搜尋基礎架構的建議,包括水平擴展、分片策略與混合搜尋方法。

使用方法

  1. 分析當前的索引效能瓶頸(延遲、召回率或記憶體)。
  2. 根據特定應用需求(例如高召回率優先或低延遲優先)選取調校目標。
  3. 遵循本技能提供的逐步指南調整 HNSW 參數或選擇量化策略。
  4. 在生產環境中實施變更前,先在測試環境驗證調整結果。

適用平台

本技能提供的准則適用於多種向量資料庫與搜尋庫,包括但不限於 FAISS、Annoy、Milvus、Qdrant 與 Weaviate。具體參數名稱與範圍可能因實作而異。

注意事項

  • 在調整參數前,務必定義清晰的效能目標(如 P99 延遲小於 50 毫秒,召回率高於 95%)。
  • 量化策略通常會犧牲部分召回率以換取顯著的記憶體節省;請根據應用場景仔細評估取捨。
  • 擴展向量搜尋基礎架構時,需考量資料分發、負載平衡與容錯機制。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

wshobson/accessibility-compliance

Implement WCAG 2.2 compliant interfaces with mobile accessibility, inclusive design patterns, and assistive technology support. Use when auditing accessibility, implementing ARIA patterns, building for screen readers, or ensuring inclusive user experiences.

wshobson/airflow-dag-patterns

Build production Apache Airflow DAGs with best practices for operators, sensors, testing, and deployment. Use when creating data pipelines, orchestrating workflows, or scheduling batch jobs.

wshobson/angular-migration

Migrate from AngularJS to Angular using hybrid mode, incremental component rewriting, and dependency injection updates. Use when upgrading AngularJS applications, planning framework migrations, or modernizing legacy Angular code.

wshobson/anti-reversing-techniques

Understand anti-reversing, obfuscation, and protection techniques encountered during software analysis. Use this skill when analyzing malware evasion techniques, when implementing anti-debugging protections for CTF challenges, when reverse engineering packed binaries, or when building security research tools that need to detect virtualized environments.

wshobson/api-design-principles

Master REST and GraphQL API design principles to build intuitive, scalable, and maintainable APIs that delight developers. Use when designing new APIs, reviewing API specifications, or establishing API design standards.

wshobson/architecture-decision-records

Write and maintain Architecture Decision Records (ADRs) following best practices for technical decision documentation. Use when documenting significant technical decisions, reviewing past architectural choices, or establishing decision processes.

wshobson/architecture-patterns

Implement proven backend architecture patterns including Clean Architecture, Hexagonal Architecture, and Domain-Driven Design. Use this skill when designing clean architecture for a new microservice, when refactoring a monolith to use bounded contexts, when implementing hexagonal or onion architecture patterns, or when debugging dependency cycles between application layers.

wshobson/async-python-patterns

Master Python asyncio, concurrent programming, and async/await patterns for high-performance applications. Use when building async APIs, concurrent systems, or I/O-bound applications requiring non-blocking operations.

wshobson/attack-tree-construction

Build comprehensive attack trees to visualize threat paths. Use when mapping attack scenarios, identifying defense gaps, or communicating security risks to stakeholders.

wshobson/auth-implementation-patterns

Master authentication and authorization patterns including JWT, OAuth2, session management, and RBAC to build secure, scalable access control systems. Use when implementing auth systems, securing APIs, or debugging security issues.

wshobson/avoid-ai-writing

Audit and rewrite prose so it stops reading as machine-generated. Use this skill when asked to remove AI-isms, clean up AI writing, edit a draft for AI tells, audit a README, changelog, release note, PR description, or blog post for machine-sounding prose, or make text sound less like AI. Supports a detect-only mode, a rewrite mode, and an edit-in-place mode, with optional voice and context profiles.

wshobson/backtesting-frameworks

Build robust backtesting systems for trading strategies with proper handling of look-ahead bias, survivorship bias, and transaction costs. Use when developing trading algorithms, validating strategies, or building backtesting infrastructure.

wshobson/bash-defensive-patterns

Master defensive Bash programming techniques for production-grade scripts. Use when writing robust shell scripts, CI/CD pipelines, or system utilities requiring fault tolerance and safety.

wshobson/bats-testing-patterns

Master Bash Automated Testing System (Bats) for comprehensive shell script testing. Use when writing tests for shell scripts, CI/CD pipelines, or requiring test-driven development of shell utilities.

wshobson/bazel-build-optimization

Optimize Bazel builds for large-scale monorepos. Use when configuring Bazel, implementing remote execution, or optimizing build performance for enterprise codebases.

wshobson/before-you-build

Pre-build product and feature risk review for founders, product managers, and AI-assisted builders. Use this skill when the user is about to build a landing page, MVP, SaaS product, internal tool, agent workflow, or major feature and needs to check demand, positioning, monetization, retention, trust, distribution, and adoption risk before implementation starts.

wshobson/billing-automation

Build automated billing systems for recurring payments, invoicing, subscription lifecycle, and dunning management. Use when implementing subscription billing, automating invoicing, or managing recurring payment systems.

wshobson/binary-analysis-patterns

Master binary analysis patterns including disassembly, decompilation, control flow analysis, and code pattern recognition. Use when analyzing executables, understanding compiled code, or performing static analysis on binaries.

wshobson/block-no-verify-hook

Configure a PreToolUse hook to prevent AI agents from skipping git pre-commit hooks with --no-verify and other bypass flags. Use when setting up Claude Code projects that enforce commit quality gates.

wshobson/brand-landingpage

Brand-first landing page designer — runs a brand-identity interview (colors, typography, shape language), then generates and iterates on a polished landing page via Stitch with deployment-ready HTML. Use when the user asks to create, design, or build a landing page, homepage, or marketing page and has no established visual direction. Skip when they have a design mockup, need a dashboard or app UI, are working at component level, building a multi-page app, or restyling with known design tokens — use frontend-design instead.

相關技能