Przejdź do treści
Biblioteka skilli
AI i agenci · Research

iterative-retrieval

/iterative-retrieval

Stopniowo doprecyzowuje pobieranie kodu i dowodów dla agentów przez wysyłanie, ocenę, poprawianie zapytań i ograniczone iteracje, gdy kontekst jest niepełny lub zaszumiony.

Repozytorium
AGI-Super-Team ↗
Licencja
MIT
Ostatnia zmiana repozytorium
20.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 20.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Stopniowo doprecyzowuje pobieranie kodu i dowodów dla agentów przez wysyłanie, ocenę, poprawianie zapytań i ograniczone iteracje, gdy kontekst jest niepełny lub zaszumiony.

Oryginalny opis (EN)

Progressively refine codebase and evidence retrieval for agents using dispatch, evaluation, query refinement, and bounded iteration. Use when a task spans unfamiliar modules, initial context is incomplete or noisy, an agent reports missing context, or parallel workers need compact evidence packets.

Jak działa

  1. When to Activate
  2. The Problem
  3. The Solution: Iterative Retrieval
  4. Practical Examples
  5. Integration with Codex Agents
  6. Best Practices
  7. Related
Sekcje z nagłówków SKILL.md, w oryginale · 210 linii, 767 słów
Podgląd SKILL.md
---
name: iterative-retrieval
description: Progressively refine codebase and evidence retrieval for agents using dispatch, evaluation, query refinement, and bounded iteration. Use when a task spans unfamiliar modules, initial context is incomplete or noisy, an agent reports missing context, or parallel workers need compact evidence packets.
---

# Iterative Retrieval Pattern

Solve the context problem in multi-agent workflows where agents do not know what evidence they need until investigation begins.

## When to Activate

- Spawning subagents that need codebase context they cannot predict upfront
- Building multi-agent workflows where context is progressively refined
- Encountering "context too large" or "missing context" failures in agent tasks
- Designing RAG-like retrieval pipelines for code exploration
- Optimizing token usage in agent orchestration

## The Problem

Subagents are spawned with limited context. They don't know:
- Which files contain relevant code
- What patterns exist in the codebase
- What terminology the project uses

Standard approaches fail:
- **Send everything**: Exceeds context limits
- **Send nothing**: Agent lacks critical information
- **Guess what's needed**: Often wrong

## The Solution: Iterative Retrieval

A 4-phase loop that progressively refines context:

```
┌─────────────────────────────────────────────┐
│                                             │
│   ┌──────────┐      ┌──────────┐            │
│   │ DISPATCH │─────│ EVALUATE │            │
│   └──────────┘      └──────────┘            │
│        ▲                  │                 │
│        │                  ▼                 │
│   ┌──────────┐      ┌──────────┐            │
│   │   LOOP   │─────│  REFINE  │            │
│   └──────────┘      └──────────┘            │
│                                             │
│        Max 3 cycles, then proceed           │
└─────────────────────────────────────────────┘
```

### Phase 1: DISPATCH

Initial broad query to gather candidate files:

```javascript
// Start with high-level intent
const initialQuery = {
  patterns: ['src/**/*.ts', 'lib/**/*.ts'],
  keywords: ['authentication', 'user', 'session'],
  excludes: ['*.test.ts', '*.spec.ts']
};

// Dispatch to retrieval agent
const candidates = await retrieveFiles(initialQuery);
```

### Phase 2: EVALUATE

Assess retrieved content for relevance:

```javascript
function evaluateRelevance(files, task) {
  return files.map(file => ({
    path: file.path,
    relevance: scoreRelevance(file.content, task),
    reason: explainRelevance(file.content, task),
    missingContext: identifyGaps(file.content, task)
  }));
}
```

Scoring criteria:
- **High (0.8-1.0)**: Directly implements target functionality
- **Medium (0.5-0.79)**: Contains related patterns or types
- **Low (0.2-0.49)**: Tangentially related
- **None (0-0.19)**: Not relevant, exclude

### Phase 3: REFINE

Update search criteria based on evaluation:

```javascript
function refineQuery(evaluation, previousQuery) {
  return {
    // Add new patterns discovered in high-relevance files
    patterns: [...previousQuery.patterns, ...extractPatterns(evaluation)],

    // Add terminology found in codebase
    keywords: [...previousQuery.keywords, ...extractKeywords(evaluation)],

    // Exclude confirmed irrelevant paths
    excludes: [...previousQuery.excludes, ...evaluation
      .filter(e => e.relevance < 0.2)
      .map(e => e.path)
    ],

    // Target specific gaps
    focusAreas: evaluation
      .flatMap(e => e.missingContext)
      .filter(unique)
  };
}
```

### Phase 4: LOOP

Repeat with refined criteria (max 3 cycles):

```javascript
async function iterativeRetrieve(task, maxCycles = 3) {
  let query = createInitialQuery(task);
  let bestContext = [];

  for (let cycle = 0; cycle < maxCycles; cycle++) {
    const candidates = await retrieveFiles(query);
    const evaluation = evaluateRelevance(candidates, task);

    const highRelevance = evaluation.filter(e => e.relevance >= 0.8);
    bestContext = mergeContext(bestContext, highRelevance);

    // Stop when the merged evidence is sufficient, not just the current cycle.
    if (bestContext.length >= 2 && !hasCriticalGaps(bestContext)) {
      return bestContext;
    }

    // Refine and continue
    query = refineQuery(evaluation, query);
  }

  return bestContext;
}
```

## Practical Examples

### Example 1: Bug Fix Context

```
Task: "Fix the authentication token expiry bug"

Cycle 1:
  DISPATCH: Search for "token", "auth", "expiry" in src/**
  EVALUATE: Found auth.ts (0.9), tokens.ts (0.8), user.ts (0.3)
  REFINE: Add "refresh", "jwt" keywords; exclude user.ts

Cycle 2:
  DISPATCH: Search refined terms
  EVALUATE: Found session-manager.ts (0.95), jwt-utils.ts (0.85)
  REFINE: Sufficient context (2 high-relevance files)

Result: auth.ts, tokens.ts, session-manager.ts, jwt-utils.ts
```

### Example 2: Feature Implementation

```
Task: "Add rate limiting to API endpoints"

Cycle 1:
  DISPATCH: Search "rate", "limit", "api" in routes/**
  EVALUATE: No matches - codebase uses "throttle" terminology
  REFINE: Add "throttle", "middleware" keywords

Cycle 2:
  DISPATCH: Search refined terms
  EVALUATE: Found throttle.ts (0.9), middleware/index.ts (0.8)
  REFINE: Need router patterns

Cycle 3:
  DISPATCH: Search "router", "express" patterns
  EVALUATE: Found router-setup.ts (0.8)
  REFINE: Sufficient context

Result: throttle.ts, middleware/index.ts, router-setup.ts
```

## Integration with Codex Agents

Give each Codex worker an evidence packet instead of the full parent transcript. Use native Codex agent dispatch only when delegation is permitted by the user or project instructions.

Use this block in an agent task:

```markdown
When retrieving context for this task:
1. Start with broad keyword search
2. Evaluate each file's relevance (0-1 scale)
3. Identify what context is still missing
4. Refine search criteria and repeat (max 3 cycles)
5. Return files with relevance >= 0.8
```

## Best Practices

1. **Start broad, narrow progressively** - Don't over-specify initial queries
2. **Learn codebase terminology** - First cycle often reveals naming conventions
3. **Track what's missing** - Explicit gap identification drives refinement
4. **Stop at "good enough"** - 3 high-relevance files beats 10 mediocre ones
5. **Exclude confidently** - Low-relevance files won't become relevant

## Related

- `native-agent-swarms` skill - For safe parallel dispatch and synthesis
- `context-engineering` skill - For selecting durable and task-local context
- Source adapted from Everything Claude Code at commit `0f84c0e2796703fbda87d577b2636351418c7442` (MIT)

Wersje

RepozytoriumWynikLicencja
Ta strona · aAAaqwq/AGI-Super-Team100MIT
affaan-m/ECC100MIT
SHRIJANAGAIN/Nemo-Cli100Apache-2.0
nasac0x/code-orchestrator100MIT
azure-samples/eshoplite100MIT

Migawka bazy z 13.11.2026 · wersja paczki 9916cf860f46 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 98agentic-rag
    Buduje systemy agentowego RAG z planowaniem zapytań, refleksją i iteracyjnym wyszukiwaniem w wielu źródłach.
  • 100aif-loop
    Prowadzi rygorystyczną wieloiteracyjną pętlę Reflex Loop z fazami PLAN, PRODUCE, EVALUATE, CRITIQUE i REFINE, aż artefakt spełni bramki jakości lub skończą się iteracje.
  • 100prompt-refinement
    Doprecyzowuje niejasne prośby, porządkuje wymagania i strukturyzuje zadania albo prompty do orkiestracji wielu agentów.
  • 100context-optimization
    Optymalizuje kompletny pakiet kandydatów na kontekst przez deduplikację, filtrowanie, porządkowanie i alokację budżetu tokenów, gdy zebrany materiał jest zaszumiony lub zbyt obszerny.
  • 100iterative-refinement
    Prowadzi zdyscyplinowaną, mierzalną iterację przy dużym dopracowaniu lub dochodzeniu: pętle względem warunków pass/fail, rozdzielanie pracy na subagenty i oszczędny główny kontekst.
  • 100context-retrieval
    Wyszukuje istotne informacje w bazie wiedzy metodą semantyczną, słów kluczowych lub hybrydową, by ugruntować zapytanie, gdy zadanie zaczyna się od korpusu lub indeksu.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.