iterative-retrieval

Name: iterative-retrieval
Author: virgo777

311stars25forks

How to install iterative-retrieval?

virgo777/buddyme/iterative-retrieval

$npx -y skills add virgo777/buddyme --skill iterative-retrieval

Installs into the current project.

Summary

逐步优化上下文检索以解决子智能体（subagent）上下文问题的模式。

Files · 1

View on GitHub

SKILL.md

1	# 迭代检索模式（Iterative Retrieval Pattern）
2
3	解决了多智能体工作流（multi-agent workflows）中的“上下文问题”——子智能体（subagent）在开始工作前往往不知道自己需要哪些上下文。
4
5	## 何时激活
6
7	- 生成需要事先无法完全预测的代码库上下文（codebase context）的子智能体时
8	- 构建上下文需要逐步优化的多智能体工作流时
9	- 在智能体任务中遇到“上下文过大”或“缺失上下文”的失败时
10	- 为代码探索设计类 RAG 的检索流水线时
11	- 优化智能体编排（agent orchestration）中的 Token 使用时
12
13	## 问题背景（The Problem）
14
15	生成的子智能体通常只带有有限的上下文。它们并不清楚：
16	- 哪些文件包含相关的代码
17	- 代码库中存在哪些模式（patterns）
18	- 项目使用了哪些术语
19
20	标准方法往往会失败：
21	- 全部发送：超出上下文限制。
22	- 什么都不发：智能体缺少关键信息。
23	- 猜测需求：经常猜错。
24
25	## 解决方案：迭代检索（The Solution: Iterative Retrieval）
26
27	一个由 4 个阶段组成的循环，用于逐步优化上下文：
28
29	```
30	┌─────────────────────────────────────────────┐
31	│ │
32	│ ┌──────────┐ ┌──────────┐ │
33	│ │ 派发 │─────▶│ 评估 │ │
34	│ │ DISPATCH │ │ EVALUATE │ │
35	│ └──────────┘ └──────────┘ │
36	│ ▲ │ │
37	│ │ ▼ │
38	│ ┌──────────┐ ┌──────────┐ │
39	│ │ 循环 │◀─────│ 优化 │ │
40	│ │ LOOP │ │ REFINE │ │
41	│ └──────────┘ └──────────┘ │
42	│ │
43	│ 最多 3 个周期，然后继续 │
44	└─────────────────────────────────────────────┘
45	```
46
47	### 阶段 1：派发（DISPATCH）
48
49	初始的广泛查询，用于收集候选文件：
50
51	```javascript
52	// 从高层意图开始
53	const initialQuery = {
54	patterns: ['src/*/.ts', 'lib/*/.ts'],
55	keywords: ['authentication', 'user', 'session'],
56	excludes: ['.test.ts', '.spec.ts']
57	};
58
59	// 派发给检索智能体
60	const candidates = await retrieveFiles(initialQuery);
61	```
62
63	### 阶段 2：评估（EVALUATE）
64
65	评估检索到的内容的相关性：
66
67	```javascript
68	function evaluateRelevance(files, task) {
69	return files.map(file => ({
70	path: file.path,
71	relevance: scoreRelevance(file.content, task),
72	reason: explainRelevance(file.content, task),
73	missingContext: identifyGaps(file.content, task)
74	}));
75	}
76	```
77
78	评分标准：
79	- 高 (0.8-1.0)：直接实现了目标功能
80	- 中 (0.5-0.7)：包含相关的模式或类型
81	- 低 (0.2-0.4)：间接相关
82	- 无 (0-0.2)：不相关，排除
83
84	### 阶段 3：优化（REFINE）
85
86	根据评估结果更新搜索条件：
87
88	```javascript
89	function refineQuery(evaluation, previousQuery) {
90	return {
91	// 添加在高度相关文件中发现的新模式
92	patterns: [...previousQuery.patterns, ...extractPatterns(evaluation)],
93
94	// 添加在代码库中发现的术语
95	keywords: [...previousQuery.keywords, ...extractKeywords(evaluation)],
96
97	// 排除已确认为不相关的路径
98	excludes: [...previousQuery.excludes, ...evaluation
99	.filter(e => e.relevance < 0.2)
100	.map(e => e.path)
101	],
102
103	// 针对特定的缺口
104	focusAreas: evaluation
105	.flatMap(e => e.missingContext)
106	.filter(unique)
107	};
108	}
109	```
110
111	### 阶段 4：循环（LOOP）
112
113	使用优化后的条件重复执行（最多 3 个周期）：
114
115	```javascript
116	async function iterativeRetrieve(task, maxCycles = 3) {
117	let query = createInitialQuery(task);
118	let bestContext = [];
119
120	for (let cycle = 0; cycle < maxCycles; cycle++) {
121	const candidates = await retrieveFiles(query);
122	const evaluation = evaluateRelevance(candidates, task);
123
124	// 检查是否已有足够的上下文
125	const highRelevance = evaluation.filter(e => e.relevance >= 0.7);
126	if (highRelevance.length >= 3 && !hasCriticalGaps(evaluation)) {
127	return highRelevance;
128	}
129
130	// 优化并继续
131	query = refineQuery(evaluation, query);
132	bestContext = mergeContext(bestContext, highRelevance);
133	}
134
135	return bestContext;
136	}
137	```
138
139	## 实践案例
140
141	### 案例 1：Bug 修复上下文
142
143	```
144	任务："修复身份验证令牌过期 bug"
145
146	周期 1:
147	派发 (DISPATCH)：在 src/** 中搜索 "token", "auth", "expiry"
148	评估 (EVALUATE)：发现 auth.ts (0.9), tokens.ts (0.8), user.ts (0.3)
149	优化 (REFINE)：添加 "refresh", "jwt" 关键词；排除 user.ts
150
151	周期 2:
152	派发 (DISPATCH)：搜索优化后的术语
153	评估 (EVALUATE)：发现 session-manager.ts (0.95), jwt-utils.ts (0.85)
154	优化 (REFINE)：上下文已足够（2 个高度相关文件）
155
156	结果：auth.ts, tokens.ts, session-manager.ts, jwt-utils.ts
157	```
158
159	### 案例 2：功能实现
160
161	```
162	任务："为 API 端点添加速率限制 (rate limiting)"
163
164	周期 1:
165	派发 (DISPATCH)：在 routes/** 中搜索 "rate", "limit", "api"
166	评估 (EVALUATE)：无匹配项 —— 代码库使用的是 "throttle" 术语
167	优化 (REFINE)：添加 "throttle", "middleware" 关键词
168
169	周期 2:
170	派发 (DISPATCH)：搜索优化后的术语
171	评估 (EVALUATE)：发现 throttle.ts (0.9), middleware/index.ts (0.7)
172	优化 (REFINE)：需要路由器模式
173
174	周期 3:
175	派发 (DISPATCH)：搜索 "router", "express" 模式
176	评估 (EVALUATE)：发现 router-setup.ts (0.8)
177	优化 (REFINE)：上下文已足够
178
179	结果：throttle.ts, middleware/index.ts, router-setup.ts
180	```
181
182	## 与智能体（Agents）集成
183
184	在智能体提示词中使用：
185
186	```markdown
187	在为此任务检索上下文时：
188	1. 从广泛的关键词搜索开始
189	2. 评估每个文件的相关性（0-1 等级）
190	3. 识别仍然缺失的上下文
191	4. 优化搜索条件并重复执行（最多 3 个周期）
192	5. 返回相关性 >= 0.7 的文件
193	```
194
195	## 最佳实践
196
197	1. 由广入深，逐步缩小范围 —— 初始查询不要过于具体。
198	2. 学习代码库术语 —— 第一个周期通常能揭示命名规范。
199	3. 追踪缺失内容 —— 明确的缺口识别是驱动优化的关键。
200	4. 见好就收 —— 3 个高度相关的文件优于 10 个平庸的文件。
201	5. 果断排除 —— 低相关性的文件通常不会突然变得相关。
202
203	## 相关资源
204
205	- [长篇指南 (The Longform Guide)](https://x.com/affaanmustafa/status/2014040193557471352) —— 子智能体编排部分
206	- `continuous-learning` 技能 —— 用于随时间改进的模式
207	- `~/.claude/agents/` 中的智能体定义

People who liked this also viewed

6 picks

Type

azure-aiUse for Azure AI: Search, Speech, OpenAI, Document Intelligence. Helps with search, vector/hybrid search, speech-to-text, text-to-speech, transcription, OCR. WHEN: AI Search, query search, vector searSkillsJul 2026472k1.3k
just-scrapeSearch, scrape, crawl, extract structured data, and monitor web pages via the ScrapeGraph AI CLI. Use when the user asks to search the web, scrape a webpage, grab content from a URL, extract JSON fromSkillsJul 2026245k37
firecrawlCLI and Agent Skill for Firecrawl - Add scrape, search, and browsing capabilities to your AI agentsSkillsJul 202694k531
firecrawl-searchWeb search with full page content extraction. Use this skill whenever the user asks to search the web, find articles, research a topic, look something up, find recent news, discover sources, or says "SkillsJul 202676k531
firecrawl-agentAI-powered autonomous data extraction that navigates complex sites and returns structured JSON. Use this skill when the user wants structured data from websites, needs to extract pricing tiers, producSkillsJul 202674k531
firecrawl-mapDiscover and list all URLs on a website, with optional search filtering. Use this skill when the user wants to find a specific page on a large site, list all URLs, see the site structure, find where sSkillsJul 202674k531

iterative-retrieval

311stars25forks

View on GitHub

How to install iterative-retrieval?

virgo777/buddyme/iterative-retrieval

$npx -y skills add virgo777/buddyme --skill iterative-retrieval

Installs into the current project.

Summary

逐步优化上下文检索以解决子智能体（subagent）上下文问题的模式。

Files · 1

View on GitHub

SKILL.md

1	# 迭代检索模式（Iterative Retrieval Pattern）
2
3	解决了多智能体工作流（multi-agent workflows）中的“上下文问题”——子智能体（subagent）在开始工作前往往不知道自己需要哪些上下文。
4
5	## 何时激活
6
7	- 生成需要事先无法完全预测的代码库上下文（codebase context）的子智能体时
8	- 构建上下文需要逐步优化的多智能体工作流时
9	- 在智能体任务中遇到“上下文过大”或“缺失上下文”的失败时
10	- 为代码探索设计类 RAG 的检索流水线时
11	- 优化智能体编排（agent orchestration）中的 Token 使用时
12
13	## 问题背景（The Problem）
14
15	生成的子智能体通常只带有有限的上下文。它们并不清楚：
16	- 哪些文件包含相关的代码
17	- 代码库中存在哪些模式（patterns）
18	- 项目使用了哪些术语
19
20	标准方法往往会失败：
21	- 全部发送：超出上下文限制。
22	- 什么都不发：智能体缺少关键信息。
23	- 猜测需求：经常猜错。
24
25	## 解决方案：迭代检索（The Solution: Iterative Retrieval）
26
27	一个由 4 个阶段组成的循环，用于逐步优化上下文：
28
29	```
30	┌─────────────────────────────────────────────┐
31	│ │
32	│ ┌──────────┐ ┌──────────┐ │
33	│ │ 派发 │─────▶│ 评估 │ │
34	│ │ DISPATCH │ │ EVALUATE │ │
35	│ └──────────┘ └──────────┘ │
36	│ ▲ │ │
37	│ │ ▼ │
38	│ ┌──────────┐ ┌──────────┐ │
39	│ │ 循环 │◀─────│ 优化 │ │
40	│ │ LOOP │ │ REFINE │ │
41	│ └──────────┘ └──────────┘ │
42	│ │
43	│ 最多 3 个周期，然后继续 │
44	└─────────────────────────────────────────────┘
45	```
46
47	### 阶段 1：派发（DISPATCH）
48
49	初始的广泛查询，用于收集候选文件：
50
51	```javascript
52	// 从高层意图开始
53	const initialQuery = {
54	patterns: ['src/*/.ts', 'lib/*/.ts'],
55	keywords: ['authentication', 'user', 'session'],
56	excludes: ['.test.ts', '.spec.ts']
57	};
58
59	// 派发给检索智能体
60	const candidates = await retrieveFiles(initialQuery);
61	```
62
63	### 阶段 2：评估（EVALUATE）
64
65	评估检索到的内容的相关性：
66
67	```javascript
68	function evaluateRelevance(files, task) {
69	return files.map(file => ({
70	path: file.path,
71	relevance: scoreRelevance(file.content, task),
72	reason: explainRelevance(file.content, task),
73	missingContext: identifyGaps(file.content, task)
74	}));
75	}
76	```
77
78	评分标准：
79	- 高 (0.8-1.0)：直接实现了目标功能
80	- 中 (0.5-0.7)：包含相关的模式或类型
81	- 低 (0.2-0.4)：间接相关
82	- 无 (0-0.2)：不相关，排除
83
84	### 阶段 3：优化（REFINE）
85
86	根据评估结果更新搜索条件：
87
88	```javascript
89	function refineQuery(evaluation, previousQuery) {
90	return {
91	// 添加在高度相关文件中发现的新模式
92	patterns: [...previousQuery.patterns, ...extractPatterns(evaluation)],
93
94	// 添加在代码库中发现的术语
95	keywords: [...previousQuery.keywords, ...extractKeywords(evaluation)],
96
97	// 排除已确认为不相关的路径
98	excludes: [...previousQuery.excludes, ...evaluation
99	.filter(e => e.relevance < 0.2)
100	.map(e => e.path)
101	],
102
103	// 针对特定的缺口
104	focusAreas: evaluation
105	.flatMap(e => e.missingContext)
106	.filter(unique)
107	};
108	}
109	```
110
111	### 阶段 4：循环（LOOP）
112
113	使用优化后的条件重复执行（最多 3 个周期）：
114
115	```javascript
116	async function iterativeRetrieve(task, maxCycles = 3) {
117	let query = createInitialQuery(task);
118	let bestContext = [];
119
120	for (let cycle = 0; cycle < maxCycles; cycle++) {
121	const candidates = await retrieveFiles(query);
122	const evaluation = evaluateRelevance(candidates, task);
123
124	// 检查是否已有足够的上下文
125	const highRelevance = evaluation.filter(e => e.relevance >= 0.7);
126	if (highRelevance.length >= 3 && !hasCriticalGaps(evaluation)) {
127	return highRelevance;
128	}
129
130	// 优化并继续
131	query = refineQuery(evaluation, query);
132	bestContext = mergeContext(bestContext, highRelevance);
133	}
134
135	return bestContext;
136	}
137	```
138
139	## 实践案例
140
141	### 案例 1：Bug 修复上下文
142
143	```
144	任务："修复身份验证令牌过期 bug"
145
146	周期 1:
147	派发 (DISPATCH)：在 src/** 中搜索 "token", "auth", "expiry"
148	评估 (EVALUATE)：发现 auth.ts (0.9), tokens.ts (0.8), user.ts (0.3)
149	优化 (REFINE)：添加 "refresh", "jwt" 关键词；排除 user.ts
150
151	周期 2:
152	派发 (DISPATCH)：搜索优化后的术语
153	评估 (EVALUATE)：发现 session-manager.ts (0.95), jwt-utils.ts (0.85)
154	优化 (REFINE)：上下文已足够（2 个高度相关文件）
155
156	结果：auth.ts, tokens.ts, session-manager.ts, jwt-utils.ts
157	```
158
159	### 案例 2：功能实现
160
161	```
162	任务："为 API 端点添加速率限制 (rate limiting)"
163
164	周期 1:
165	派发 (DISPATCH)：在 routes/** 中搜索 "rate", "limit", "api"
166	评估 (EVALUATE)：无匹配项 —— 代码库使用的是 "throttle" 术语
167	优化 (REFINE)：添加 "throttle", "middleware" 关键词
168
169	周期 2:
170	派发 (DISPATCH)：搜索优化后的术语
171	评估 (EVALUATE)：发现 throttle.ts (0.9), middleware/index.ts (0.7)
172	优化 (REFINE)：需要路由器模式
173
174	周期 3:
175	派发 (DISPATCH)：搜索 "router", "express" 模式
176	评估 (EVALUATE)：发现 router-setup.ts (0.8)
177	优化 (REFINE)：上下文已足够
178
179	结果：throttle.ts, middleware/index.ts, router-setup.ts
180	```
181
182	## 与智能体（Agents）集成
183
184	在智能体提示词中使用：
185
186	```markdown
187	在为此任务检索上下文时：
188	1. 从广泛的关键词搜索开始
189	2. 评估每个文件的相关性（0-1 等级）
190	3. 识别仍然缺失的上下文
191	4. 优化搜索条件并重复执行（最多 3 个周期）
192	5. 返回相关性 >= 0.7 的文件
193	```
194
195	## 最佳实践
196
197	1. 由广入深，逐步缩小范围 —— 初始查询不要过于具体。
198	2. 学习代码库术语 —— 第一个周期通常能揭示命名规范。
199	3. 追踪缺失内容 —— 明确的缺口识别是驱动优化的关键。
200	4. 见好就收 —— 3 个高度相关的文件优于 10 个平庸的文件。
201	5. 果断排除 —— 低相关性的文件通常不会突然变得相关。
202
203	## 相关资源
204
205	- [长篇指南 (The Longform Guide)](https://x.com/affaanmustafa/status/2014040193557471352) —— 子智能体编排部分
206	- `continuous-learning` 技能 —— 用于随时间改进的模式
207	- `~/.claude/agents/` 中的智能体定义

People who liked this also viewed

6 picks

Type