GrepAI搜索增强配置指南：优化代码搜索优先级，提升开发效率

grepai-search-boosting by yoanbernabeu/grepai-skills

292 周安装量

15 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/yoanbernabeu/grepai-skills --skill grepai-search-boosting

开发自动化代码质量

🇨🇳中文介绍

GrepAI 搜索增强

此技能涵盖配置分数增强功能，以优先处理相关代码路径，并降低测试、文档和第三方代码的优先级。

何时使用此技能

优先处理源代码而非测试代码
降低供应商/第三方代码的优先级
提升重要目录的优先级
自定义结果排序

什么是增强？

增强功能根据文件路径调整搜索分数：

原始分数：0.85 (src/auth.go)
加成 (+10%)：0.935

原始分数：0.85 (tests/auth_test.go)
惩罚 (-50%)：0.425

这确保了生产代码在内容相似的情况下比测试代码排名更高。

配置

基础配置

# .grepai/config.yaml
search:
  boost:
    enabled: true
    penalties:
      - pattern: /tests/
        factor: 0.5
    bonuses:
      - pattern: /src/
        factor: 1.1

完整配置

search:
  boost:
    enabled: true

    # 降低分数 (factor < 1.0)
    penalties:
      # 测试文件
      - pattern: /tests/
        factor: 0.5
      - pattern: /__tests__/
        factor: 0.5
      - pattern: _test.
        factor: 0.5
      - pattern: .spec.
        factor: 0.5
      - pattern: .test.
        factor: 0.5

      # 文档
      - pattern: /docs/
        factor: 0.6
      - pattern: /documentation/
        factor: 0.6

      # 供应商/第三方代码
      - pattern: /vendor/
        factor: 0.3
      - pattern: /node_modules/
        factor: 0.3
      - pattern: /third_party/
        factor: 0.3

      # 生成的代码
      - pattern: /generated/
        factor: 0.4
      - pattern: .gen.
        factor: 0.4
      - pattern: .pb.go
        factor: 0.4

      # 示例和样例
      - pattern: /examples/
        factor: 0.7
      - pattern: /samples/
        factor: 0.7

    # 提高分数 (factor > 1.0)
    bonuses:
      # 核心源代码
      - pattern: /src/
        factor: 1.1
      - pattern: /lib/
        factor: 1.1
      - pattern: /app/
        factor: 1.1
      - pattern: /core/
        factor: 1.2
      - pattern: /internal/
        factor: 1.1

      # 重要目录
      - pattern: /services/
        factor: 1.1
      - pattern: /handlers/
        factor: 1.1
      - pattern: /controllers/
        factor: 1.1

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

系数	效果	用例
0.3	降低 70%	重度惩罚 (供应商代码)
0.5	降低 50%	中度惩罚 (测试代码)
0.7	降低 30%	轻度惩罚 (示例代码)
1.0	无变化	中性
1.1	提高 10%	轻度提升 (src)
1.2	提高 20%	中度提升 (core)
1.5	提高 50%	重度提升

标准配置 (推荐)

search:
  boost:
    enabled: true
    penalties:
      - pattern: /tests/
        factor: 0.5
      - pattern: _test.
        factor: 0.5
      - pattern: .spec.
        factor: 0.5
      - pattern: /vendor/
        factor: 0.3
      - pattern: /docs/
        factor: 0.6
    bonuses:
      - pattern: /src/
        factor: 1.1
      - pattern: /lib/
        factor: 1.1

search:
  boost:
    enabled: true
    penalties:
      - pattern: /__tests__/
        factor: 0.5
      - pattern: .test.
        factor: 0.5
      - pattern: .spec.
        factor: 0.5
      - pattern: /node_modules/
        factor: 0.3
      - pattern: .stories.
        factor: 0.6
      - pattern: /storybook/
        factor: 0.6
    bonuses:
      - pattern: /src/
        factor: 1.1
      - pattern: /components/
        factor: 1.1
      - pattern: /hooks/
        factor: 1.1

search:
  boost:
    enabled: true
    penalties:
      - pattern: _test.go
        factor: 0.5
      - pattern: _mock.go
        factor: 0.5
      - pattern: /testdata/
        factor: 0.5
      - pattern: /vendor/
        factor: 0.3
      - pattern: .pb.go
        factor: 0.4
    bonuses:
      - pattern: /internal/
        factor: 1.1
      - pattern: /cmd/
        factor: 1.1
      - pattern: /pkg/
        factor: 1.1

search:
  boost:
    enabled: true
    penalties:
      - pattern: /tests/
        factor: 0.5
      - pattern: test_
        factor: 0.5
      - pattern: _test.py
        factor: 0.5
      - pattern: /conftest
        factor: 0.5
      - pattern: /fixtures/
        factor: 0.6
    bonuses:
      - pattern: /src/
        factor: 1.1
      - pattern: /app/
        factor: 1.1
      - pattern: /core/
        factor: 1.2

search:
  boost:
    enabled: true
    penalties:
      - pattern: /tests/
        factor: 0.5
      - pattern: _test.
        factor: 0.5
      - pattern: /packages/deprecated/
        factor: 0.3
      - pattern: /packages/legacy/
        factor: 0.4
    bonuses:
      - pattern: /packages/core/
        factor: 1.2
      - pattern: /packages/api/
        factor: 1.1
      - pattern: /packages/shared/
        factor: 1.1

要完全禁用增强功能：

search:
  boost:
    enabled: false

或者从配置中移除 boost 部分。

方法	效果	用例
忽略	完全排除	依赖项、构建输出
惩罚	仍可搜索，排名较低	测试、文档、示例
中性	默认排名	常规源代码
提升	排名更高	核心业务逻辑

何时忽略 vs 惩罚

忽略： 你绝不想搜索的文件 (node_modules, .git)
惩罚： 你很少需要但可能需要的文件 (tests, docs)

配置增强功能后：

# 搜索并观察排名
grepai search "authentication"

# 检查测试文件是否被正确降低优先级
grepai search "test authentication"  # 应该仍能找到测试文件，但排名较低

从惩罚开始： 首先降低测试/供应商代码的优先级
谨慎添加提升： 仅用于真正重要的路径
用真实查询测试： 验证结果是否合理
不要过度惩罚： 对于测试文件，0.5 通常足够
记录你的选择： 在配置中添加注释

❌ 问题： 测试文件总是显示在最前面 ✅ 解决方案： 为你的测试命名约定添加惩罚模式

❌ 问题： 无法在被惩罚的路径中找到代码 ✅ 解决方案： 惩罚会降低排名，但不会隐藏。如需完全排除，请使用忽略。

❌ 问题： 分数超过 1.0 似乎不对 ✅ 解决方案： 提升可以将分数推高到 1.0 以上；这是正常现象

❌ 问题： 模式不匹配 ✅ 解决方案： 检查模式是否出现在完整路径中（使用 /tests/ 而不仅仅是 tests）

增强配置状态：

✅ 搜索增强已配置

   状态：已启用

   惩罚 (5)：
   - /tests/      → 0.5 (降低 50%)
   - _test.       → 0.5
   - .spec.       → 0.5
   - /vendor/     → 0.3 (降低 70%)
   - /docs/       → 0.6

   提升 (3)：
   - /src/        → 1.1 (提升 10%)
   - /lib/        → 1.1
   - /core/       → 1.2 (提升 20%)

   效果：源代码在内容相似时比测试代码排名更高

🇺🇸English

GrepAI Search Boosting

This skill covers configuring score boosting to prioritize relevant code paths and deprioritize tests, docs, and vendor code.

When to Use This Skill

Prioritizing source code over tests
Penalizing vendor/third-party code
Boosting important directories
Customizing result ranking

What is Boosting?

Boosting modifies search scores based on file paths:

Original score: 0.85 (src/auth.go)
Bonus (+10%):   0.935

Original score: 0.85 (tests/auth_test.go)
Penalty (-50%): 0.425

This ensures production code ranks higher than tests with similar content.

Configuration

Basic Configuration

# .grepai/config.yaml
search:
  boost:
    enabled: true
    penalties:
      - pattern: /tests/
        factor: 0.5
    bonuses:
      - pattern: /src/
        factor: 1.1

Full Configuration

search:
  boost:
    enabled: true

    # Reduce scores (factor < 1.0)
    penalties:
      # Test files
      - pattern: /tests/
        factor: 0.5
      - pattern: /__tests__/
        factor: 0.5
      - pattern: _test.
        factor: 0.5
      - pattern: .spec.
        factor: 0.5
      - pattern: .test.
        factor: 0.5

      # Documentation
      - pattern: /docs/
        factor: 0.6
      - pattern: /documentation/
        factor: 0.6

      # Vendor/third-party
      - pattern: /vendor/
        factor: 0.3
      - pattern: /node_modules/
        factor: 0.3
      - pattern: /third_party/
        factor: 0.3

      # Generated code
      - pattern: /generated/
        factor: 0.4
      - pattern: .gen.
        factor: 0.4
      - pattern: .pb.go
        factor: 0.4

      # Examples and samples
      - pattern: /examples/
        factor: 0.7
      - pattern: /samples/
        factor: 0.7

    # Increase scores (factor > 1.0)
    bonuses:
      # Core source code
      - pattern: /src/
        factor: 1.1
      - pattern: /lib/
        factor: 1.1
      - pattern: /app/
        factor: 1.1
      - pattern: /core/
        factor: 1.2
      - pattern: /internal/
        factor: 1.1

      # Important directories
      - pattern: /services/
        factor: 1.1
      - pattern: /handlers/
        factor: 1.1
      - pattern: /controllers/
        factor: 1.1

How Factors Work

Factor	Effect	Use Case
0.3	70% reduction	Strong penalty (vendor)
0.5	50% reduction	Moderate penalty (tests)
0.7	30% reduction	Mild penalty (examples)
1.0	No change	Neutral
1.1	10% increase	Mild boost (src)
1.2	20% increase	Moderate boost (core)
1.5	50% increase	Strong boost

Pattern Matching

Patterns match against the full file path:

/project/src/auth/middleware.go
         ^^^^
         Matches "/src/" pattern

Pattern Types

Pattern	Matches	Doesn't Match
`/tests/`	`src/tests/auth.go`	`tests.go`
`_test.`	`auth_test.go`	`test_auth.go`
`.spec.`	`auth.spec.ts`

Effect on Rankings

Without Boosting

Score: 0.85 | tests/auth_test.go:10-30
Score: 0.82 | src/auth/middleware.go:15-45
Score: 0.80 | src/auth/jwt.go:23-55

With Boosting

penalties:
  - pattern: /tests/
    factor: 0.5
bonuses:
  - pattern: /src/
    factor: 1.1



Score: 0.90 | src/auth/middleware.go:15-45  (0.82 × 1.1)
Score: 0.88 | src/auth/jwt.go:23-55        (0.80 × 1.1)
Score: 0.43 | tests/auth_test.go:10-30     (0.85 × 0.5)

Common Configurations

Standard (Recommended)

search:
  boost:
    enabled: true
    penalties:
      - pattern: /tests/
        factor: 0.5
      - pattern: _test.
        factor: 0.5
      - pattern: .spec.
        factor: 0.5
      - pattern: /vendor/
        factor: 0.3
      - pattern: /docs/
        factor: 0.6
    bonuses:
      - pattern: /src/
        factor: 1.1
      - pattern: /lib/
        factor: 1.1

Frontend Project

search:
  boost:
    enabled: true
    penalties:
      - pattern: /__tests__/
        factor: 0.5
      - pattern: .test.
        factor: 0.5
      - pattern: .spec.
        factor: 0.5
      - pattern: /node_modules/
        factor: 0.3
      - pattern: .stories.
        factor: 0.6
      - pattern: /storybook/
        factor: 0.6
    bonuses:
      - pattern: /src/
        factor: 1.1
      - pattern: /components/
        factor: 1.1
      - pattern: /hooks/
        factor: 1.1

Go Project

search:
  boost:
    enabled: true
    penalties:
      - pattern: _test.go
        factor: 0.5
      - pattern: _mock.go
        factor: 0.5
      - pattern: /testdata/
        factor: 0.5
      - pattern: /vendor/
        factor: 0.3
      - pattern: .pb.go
        factor: 0.4
    bonuses:
      - pattern: /internal/
        factor: 1.1
      - pattern: /cmd/
        factor: 1.1
      - pattern: /pkg/
        factor: 1.1

Python Project

search:
  boost:
    enabled: true
    penalties:
      - pattern: /tests/
        factor: 0.5
      - pattern: test_
        factor: 0.5
      - pattern: _test.py
        factor: 0.5
      - pattern: /conftest
        factor: 0.5
      - pattern: /fixtures/
        factor: 0.6
    bonuses:
      - pattern: /src/
        factor: 1.1
      - pattern: /app/
        factor: 1.1
      - pattern: /core/
        factor: 1.2

Monorepo

search:
  boost:
    enabled: true
    penalties:
      - pattern: /tests/
        factor: 0.5
      - pattern: _test.
        factor: 0.5
      - pattern: /packages/deprecated/
        factor: 0.3
      - pattern: /packages/legacy/
        factor: 0.4
    bonuses:
      - pattern: /packages/core/
        factor: 1.2
      - pattern: /packages/api/
        factor: 1.1
      - pattern: /packages/shared/
        factor: 1.1

Disabling Boosting

To disable boosting entirely:

search:
  boost:
    enabled: false

Or remove the boost section from config.

Boosting vs Ignoring

Approach	Effect	Use Case
Ignore	Completely excluded	Dependencies, build output
Penalty	Still searchable, lower rank	Tests, docs, examples
Neutral	Default ranking	Regular source code
Bonus	Higher rank	Core business logic

When to Ignore vs Penalize

Ignore: Files you NEVER want to search (node_modules, .git)
Penalize: Files you RARELY want but might need (tests, docs)

Testing Your Configuration

After configuring boosting:

# Search and observe rankings
grepai search "authentication"

# Check if tests are properly deprioritized
grepai search "test authentication"  # Should still find tests, but ranked lower

Best Practices

Start with penalties: Deprioritize tests/vendor first
Add bonuses sparingly: Only for truly important paths
Test with real queries: Verify results make sense
Don't over-penalize: 0.5 is usually enough for tests
Document your choices: Add comments in config

Common Issues

❌ Problem: Tests always show up first ✅ Solution: Add penalty patterns for your test naming convention

❌ Problem: Can't find code in penalized paths ✅ Solution: Penalties reduce rank, don't hide. Use ignore for complete exclusion.

❌ Problem: Scores above 1.0 seem wrong ✅ Solution: Bonuses can push scores above 1.0; this is normal

❌ Problem: Pattern not matching ✅ Solution: Check that pattern appears in full path (use /tests/ not just tests)

Output Format

Boosting configuration status:

✅ Search Boosting Configured

   Status: Enabled

   Penalties (5):
   - /tests/      → 0.5 (50% reduction)
   - _test.       → 0.5
   - .spec.       → 0.5
   - /vendor/     → 0.3 (70% reduction)
   - /docs/       → 0.6

   Bonuses (3):
   - /src/        → 1.1 (10% boost)
   - /lib/        → 1.1
   - /core/       → 1.2 (20% boost)

   Effect: Source code ranks higher than tests with similar content

Weekly Installs

292

Repository

yoanbernabeu/gr…i-skills

GitHub Stars

First Seen

Jan 28, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

opencode237

codex230

gemini-cli213

github-copilot212

kimi-cli197

amp195

agent-browser 浏览器自动化工具 - Vercel Labs 命令行网页操作与测试

140,500 周安装

GrepAI搜索增强配置指南：优化代码搜索优先级，提升开发效率

🇨🇳中文介绍

GrepAI 搜索增强

何时使用此技能

什么是增强？

配置

基础配置

完整配置

相关 Skills

系数如何工作

模式匹配

模式类型

对排名的影响

未启用增强时

启用增强后

常见配置