@zcy2nn/agent-forge 1.1.3 → 1.1.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +188 -247
- package/agent-forge.schema.json +2 -265
- package/dist/agents/orchestrator.d.ts +1 -1
- package/dist/cli/index.js +90 -259
- package/dist/cli/providers.d.ts +0 -44
- package/dist/cli/types.d.ts +0 -2
- package/dist/config/constants.d.ts +3 -8
- package/dist/config/index.d.ts +0 -1
- package/dist/config/loader.d.ts +1 -1
- package/dist/config/schema.d.ts +1 -184
- package/dist/hooks/index.d.ts +0 -6
- package/dist/hooks/json-error-recovery/hook.d.ts +1 -1
- package/dist/hooks/todo-continuation/index.d.ts +2 -1
- package/dist/index.d.ts +1 -1
- package/dist/index.js +7875 -31853
- package/dist/tools/index.d.ts +0 -3
- package/dist/tui.js +5 -61
- package/dist/utils/index.d.ts +0 -2
- package/package.json +95 -104
- package/src/skills/brainstorming/SKILL.md +185 -186
- package/src/skills/brainstorming/scripts/frame-template.html +214 -214
- package/src/skills/brainstorming/scripts/server.cjs +354 -354
- package/src/skills/brainstorming/spec-document-reviewer-prompt.md +1 -1
- package/src/skills/requesting-code-review/SKILL.md +1 -1
- package/src/skills/subagent-driven-development/SKILL.md +1 -1
- package/src/skills/systematic-debugging/SKILL.md +318 -318
- package/src/skills/test-driven-development/SKILL.md +392 -392
- package/src/skills/verification-before-completion/SKILL.md +153 -153
- package/src/skills/writing-plans/SKILL.md +2 -2
- package/src/skills/writing-skills/graphviz-conventions.dot +171 -171
- package/dist/agents/council.d.ts +0 -27
- package/dist/agents/councillor.d.ts +0 -2
- package/dist/agents/designer.d.ts +0 -2
- package/dist/agents/explorer.d.ts +0 -2
- package/dist/agents/fixer.d.ts +0 -2
- package/dist/agents/implementer.d.ts +0 -2
- package/dist/agents/librarian.d.ts +0 -2
- package/dist/agents/observer.d.ts +0 -2
- package/dist/agents/oracle.d.ts +0 -2
- package/dist/agents/reviewer.d.ts +0 -2
- package/dist/cli/migration.d.ts +0 -46
- package/dist/config/council-schema.d.ts +0 -127
- package/dist/council/council-manager.d.ts +0 -49
- package/dist/council/index.d.ts +0 -1
- package/dist/hooks/phase-reminder/index.d.ts +0 -26
- package/dist/hooks/post-file-tool-nudge/index.d.ts +0 -19
- package/dist/skills/systematic-debugging/condition-based-waiting-example.d.ts +0 -51
- package/dist/tools/council.d.ts +0 -10
- package/src/skills/codemap/README.md +0 -59
- package/src/skills/codemap/SKILL.md +0 -163
- package/src/skills/codemap/codemap.md +0 -36
- package/src/skills/codemap/scripts/codemap.mjs +0 -483
- package/src/skills/codemap/scripts/codemap.test.ts +0 -129
- package/src/skills/codemap.md +0 -40
- package/src/skills/simplify/README.md +0 -19
- package/src/skills/simplify/SKILL.md +0 -138
- package/src/skills/simplify/codemap.md +0 -36
- package/src/skills/using-git-worktrees/SKILL.md +0 -226
package/README.md
CHANGED
|
@@ -1,247 +1,188 @@
|
|
|
1
|
-
<div align="center">
|
|
2
|
-
<p><i
|
|
3
|
-
<p><b>Open Multi Agent Suite</b> · 混合任意模型 · 自动委派任务</p>
|
|
4
|
-
|
|
5
|
-
<p><sub>by <b>Boring Dystopia Development</b></sub></p>
|
|
6
|
-
<p>
|
|
7
|
-
<a href="https://boringdystopia.ai/"><img src="https://img.shields.io/badge/boringdystopia.ai-111111?style=for-the-badge&logo=vercel&logoColor=white" alt="boringdystopia.ai"></a>
|
|
8
|
-
<a href="https://x.com/alvinunreal"><img src="https://img.shields.io/badge/X-@alvinunreal-000000?style=for-the-badge&logo=x&logoColor=white" alt="X @alvinunreal"></a>
|
|
9
|
-
<a href="https://t.me/boringdystopiadevelopment"><img src="https://img.shields.io/badge/Telegram-Join%20channel-2CA5E0?style=for-the-badge&logo=telegram&logoColor=white" alt="Telegram Join channel"></a>
|
|
10
|
-
</p>
|
|
11
|
-
</div>
|
|
12
|
-
|
|
13
|
-
---
|
|
14
|
-
|
|
15
|
-
## 这是什么
|
|
16
|
-
|
|
17
|
-
agent-forge 是 OpenCode
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
Agent
|
|
22
|
-
|
|
23
|
-
要了解各个 Agent,见 **[认识众神](#meet-the-pantheon)**。完整功能列表见 **[功能与工作流](#features-and-workflows)**。
|
|
24
|
-
|
|
25
|
-
### 快速开始
|
|
26
|
-
|
|
27
|
-
将以下提示复制粘贴到你的 LLM Agent(Claude Code、AmpCode、Cursor 等):
|
|
28
|
-
|
|
29
|
-
```
|
|
30
|
-
Install and configure agent-forge: https://cnb.cool/zcyoop/ai-assistant/agent-forge/-/git/raw/master/README.md
|
|
31
|
-
```
|
|
32
|
-
|
|
33
|
-
### 手动安装
|
|
34
|
-
|
|
35
|
-
```bash
|
|
36
|
-
bunx @zcy2nn/agent-forge@latest install
|
|
37
|
-
```
|
|
38
|
-
|
|
39
|
-
安装器会同时在 OpenCode 的 `tui.json` 中注册 TUI 插件,在侧边栏显示 Agent 状态和任务会话。手动安装时,需在 `opencode.json` 和 `tui.json` 的 `plugin` 数组中添加 `@zcy2nn/agent-forge`。
|
|
40
|
-
|
|
41
|
-
### 开始使用
|
|
42
|
-
|
|
43
|
-
安装器默认生成 OpenAI 和 OpenCode Go 两套预设,OpenAI 为默认激活。OpenAI 使用 `openai/gpt-5.5` 作为高判断力 Agent 的模型,`openai/gpt-5.4-mini` 作为快速执行 Agent 的模型。要使用 OpenCode Go,运行 `bunx @zcy2nn/agent-forge@latest install --preset=opencode-go`,或安装后在 `~/.config/opencode/agent-forge.json` 中修改默认预设。
|
|
44
|
-
|
|
45
|
-
安装后:
|
|
46
|
-
|
|
47
|
-
1. **登录你需要的 Provider**:
|
|
48
|
-
|
|
49
|
-
```bash
|
|
50
|
-
opencode auth login
|
|
51
|
-
```
|
|
52
|
-
2. **刷新 OpenCode 可见的模型列表**:
|
|
53
|
-
|
|
54
|
-
```bash
|
|
55
|
-
opencode models --refresh
|
|
56
|
-
```
|
|
57
|
-
3. **打开你的插件配置文件**:`~/.config/opencode/agent-forge.json`
|
|
58
|
-
|
|
59
|
-
4. **按需调整各 Agent 的模型**
|
|
60
|
-
|
|
61
|
-
> [!TIP]
|
|
62
|
-
> 建议理解自动委派的工作方式。**[Orchestrator prompt](https://cnb.cool/zcyoop/ai-assistant/agent-forge/-/git/blob/master/src/agents/orchestrator.ts#L28)** 包含委派规则、专家路由逻辑和阈值。你也可以手动委派:`@agentName <task>`
|
|
63
|
-
|
|
64
|
-
默认生成的配置包含 `openai` 和 `opencode-go` 两套预设:
|
|
65
|
-
|
|
66
|
-
```jsonc
|
|
67
|
-
{
|
|
68
|
-
"$schema": "https://cnb.cool/zcyoop/ai-assistant/agent-forge/-/git/raw/master/agent-forge.schema.json",
|
|
69
|
-
"preset": "openai",
|
|
70
|
-
"presets": {
|
|
71
|
-
"openai": {
|
|
72
|
-
"orchestrator": { "model": "openai/gpt-5.5", "skills": ["*"], "mcps": ["*", "!context7"] },
|
|
73
|
-
"researcher": { "model": "openai/gpt-5.4-mini", "variant": "low", "skills": [], "mcps": ["websearch", "context7", "grep_app"] }
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
| | |
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
| | |
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
|
158
|
-
|
|
159
|
-
|
|
|
160
|
-
|
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
###
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
| | |
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
|
177
|
-
|
|
178
|
-
|
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
|---|---|
|
|
190
|
-
| **角色** | `快速执行专家(执行 + 设计双模式)` |
|
|
191
|
-
| **Prompt** | [`implementer.ts`](src/agents/implementer.ts) |
|
|
192
|
-
| **默认模型** | `openai/gpt-5.4-mini` |
|
|
193
|
-
| **推荐模型** | `cerebras/zai-glm-4.7` · `fireworks-ai/accounts/fireworks/routers/kimi-k2p5-turbo` · `openai/gpt-5.4-mini` |
|
|
194
|
-
| **模型建议** | 选择快速可靠的编码模型,用于常规、有界的实现工作。Implementer 通常从 Orchestrator 接收具体计划或有界指令,因此适合高效执行任务,如测试、测试更新和直接的代码变更。 |
|
|
195
|
-
|
|
196
|
-
---
|
|
197
|
-
|
|
198
|
-
## 📚 文档导航
|
|
199
|
-
|
|
200
|
-
以此为地图:从安装开始,然后根据需要跳转到功能、配置或预设示例。
|
|
201
|
-
|
|
202
|
-
### 🚀 从这里开始
|
|
203
|
-
|
|
204
|
-
| 文档 | 内容 |
|
|
205
|
-
|-----|------|
|
|
206
|
-
| **[安装指南](docs/installation.md)** | 安装插件、CLI 参数、重置配置、故障排除 |
|
|
207
|
-
|
|
208
|
-
<a id="features-and-workflows"></a>
|
|
209
|
-
|
|
210
|
-
### ✨ 功能与工作流
|
|
211
|
-
|
|
212
|
-
| 文档 | 内容 |
|
|
213
|
-
|-----|------|
|
|
214
|
-
| **[Council](docs/council.md)** | 并行运行多个模型并综合为单一答案,使用 `@council` |
|
|
215
|
-
| **[多路复用器集成](docs/multiplexer-integration.md)** | 在 Tmux 或 Zellij 面板中实时观察 Agent 工作 |
|
|
216
|
-
| **[会话管理](docs/session-management.md)** | 通过短别名重用最近的子 Agent 会话,而非重新开始 |
|
|
217
|
-
| **[Todo 自动续行](docs/todo-continuation.md)** | Orchestrator 会话自动续行,带冷却时间和安全检查 |
|
|
218
|
-
| **[预设切换](docs/preset-switching.md)** | 运行时通过 `/preset` 切换 Agent 模型预设 |
|
|
219
|
-
| **[Codemap](docs/codemap.md)** | 生成层级代码地图,更快理解大型代码库 |
|
|
220
|
-
| **[Interview](docs/interview.md)** | 通过浏览器问答流程将粗略想法转化为结构化 Markdown 规格 |
|
|
221
|
-
| **[Divoom 显示](docs/divoom.md)** | 将 Orchestrator 和专家 Agent 活动镜像到 Divoom MiniToo 蓝牙显示器 |
|
|
222
|
-
|
|
223
|
-
### ⚙️ 配置与参考
|
|
224
|
-
|
|
225
|
-
| 文档 | 内容 |
|
|
226
|
-
|-----|------|
|
|
227
|
-
| **[配置参考](docs/configuration.md)** | 配置文件位置、JSONC 支持、Prompt 覆盖、完整选项参考 |
|
|
228
|
-
| **[维护者指南](docs/maintainers.md)** | Issue 分诊规则、标签含义、支持路由、仓库维护工作流 |
|
|
229
|
-
| **[Skills](docs/skills.md)** | 内置和推荐 Skills,如 `simplify`、`agent-browser`、`codemap` |
|
|
230
|
-
| **[MCPs](docs/mcps.md)** | `websearch`、`context7`、`grep_app`,以及 MCP 权限如何按 Agent 分配 |
|
|
231
|
-
| **[Tools](docs/tools.md)** | 内置工具能力,如 `webfetch`、LSP 工具、代码搜索和格式化器 |
|
|
232
|
-
|
|
233
|
-
### 💡 预设
|
|
234
|
-
|
|
235
|
-
| 文档 | 内容 |
|
|
236
|
-
|-----|------|
|
|
237
|
-
| **[作者预设](docs/authors-preset.md)** | 作者日常使用的混合 Provider 方案 |
|
|
238
|
-
| **[$30 预设](docs/thirty-dollars-preset.md)** | 约 $30/月的预算混合 Provider 方案 |
|
|
239
|
-
| **[OpenCode Go 预设](docs/opencode-go-preset.md)** | 安装器生成的 `opencode-go` 预设 |
|
|
240
|
-
|
|
241
|
-
---
|
|
242
|
-
|
|
243
|
-
## 📄 License
|
|
244
|
-
|
|
245
|
-
MIT
|
|
246
|
-
|
|
247
|
-
---
|
|
1
|
+
<div align="center">
|
|
2
|
+
<p><i>两位神明从代码的黎明中诞生,每一位都是其领域的不朽大师,等待你的命令,从混沌中锻造秩序,构建曾被认为不可能之物。</i></p>
|
|
3
|
+
<p><b>Open Multi Agent Suite</b> · 混合任意模型 · 自动委派任务</p>
|
|
4
|
+
|
|
5
|
+
<p><sub>by <b>Boring Dystopia Development</b></sub></p>
|
|
6
|
+
<p>
|
|
7
|
+
<a href="https://boringdystopia.ai/"><img src="https://img.shields.io/badge/boringdystopia.ai-111111?style=for-the-badge&logo=vercel&logoColor=white" alt="boringdystopia.ai"></a>
|
|
8
|
+
<a href="https://x.com/alvinunreal"><img src="https://img.shields.io/badge/X-@alvinunreal-000000?style=for-the-badge&logo=x&logoColor=white" alt="X @alvinunreal"></a>
|
|
9
|
+
<a href="https://t.me/boringdystopiadevelopment"><img src="https://img.shields.io/badge/Telegram-Join%20channel-2CA5E0?style=for-the-badge&logo=telegram&logoColor=white" alt="Telegram Join channel"></a>
|
|
10
|
+
</p>
|
|
11
|
+
</div>
|
|
12
|
+
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
## 这是什么
|
|
16
|
+
|
|
17
|
+
agent-forge 是 OpenCode 的 Agent 编排插件。内置 Orchestrator(主协调者)和 Researcher(搜索专家)两个 Agent,Orchestrator 负责任务路由和委派,Researcher 负责代码库搜索和外部文档检索。
|
|
18
|
+
|
|
19
|
+
核心理念很简单:将搜索工作委派给 Researcher,Orchestrator 专注于编码和执行,通过 Skill 系统动态扩展能力(如 brainstorming、writing-plans、TDD 等),在 **质量、速度、成本** 之间取得最优平衡。
|
|
20
|
+
|
|
21
|
+
当前架构为 **2 Agent 模式**:Orchestrator(全流程控制 + 编码执行)+ Researcher(搜索专家,只读)。Orchestrator 可按需加载 Skill,实现行为的动态扩展。
|
|
22
|
+
|
|
23
|
+
要了解各个 Agent,见 **[认识众神](#meet-the-pantheon)**。完整功能列表见 **[功能与工作流](#features-and-workflows)**。
|
|
24
|
+
|
|
25
|
+
### 快速开始
|
|
26
|
+
|
|
27
|
+
将以下提示复制粘贴到你的 LLM Agent(Claude Code、AmpCode、Cursor 等):
|
|
28
|
+
|
|
29
|
+
```
|
|
30
|
+
Install and configure agent-forge: https://cnb.cool/zcyoop/ai-assistant/agent-forge/-/git/raw/master/README.md
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
### 手动安装
|
|
34
|
+
|
|
35
|
+
```bash
|
|
36
|
+
bunx @zcy2nn/agent-forge@latest install
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
安装器会同时在 OpenCode 的 `tui.json` 中注册 TUI 插件,在侧边栏显示 Agent 状态和任务会话。手动安装时,需在 `opencode.json` 和 `tui.json` 的 `plugin` 数组中添加 `@zcy2nn/agent-forge`。
|
|
40
|
+
|
|
41
|
+
### 开始使用
|
|
42
|
+
|
|
43
|
+
安装器默认生成 OpenAI 和 OpenCode Go 两套预设,OpenAI 为默认激活。OpenAI 使用 `openai/gpt-5.5` 作为高判断力 Agent 的模型,`openai/gpt-5.4-mini` 作为快速执行 Agent 的模型。要使用 OpenCode Go,运行 `bunx @zcy2nn/agent-forge@latest install --preset=opencode-go`,或安装后在 `~/.config/opencode/agent-forge.json` 中修改默认预设。
|
|
44
|
+
|
|
45
|
+
安装后:
|
|
46
|
+
|
|
47
|
+
1. **登录你需要的 Provider**:
|
|
48
|
+
|
|
49
|
+
```bash
|
|
50
|
+
opencode auth login
|
|
51
|
+
```
|
|
52
|
+
2. **刷新 OpenCode 可见的模型列表**:
|
|
53
|
+
|
|
54
|
+
```bash
|
|
55
|
+
opencode models --refresh
|
|
56
|
+
```
|
|
57
|
+
3. **打开你的插件配置文件**:`~/.config/opencode/agent-forge.json`
|
|
58
|
+
|
|
59
|
+
4. **按需调整各 Agent 的模型**
|
|
60
|
+
|
|
61
|
+
> [!TIP]
|
|
62
|
+
> 建议理解自动委派的工作方式。**[Orchestrator prompt](https://cnb.cool/zcyoop/ai-assistant/agent-forge/-/git/blob/master/src/agents/orchestrator.ts#L28)** 包含委派规则、专家路由逻辑和阈值。你也可以手动委派:`@agentName <task>`
|
|
63
|
+
|
|
64
|
+
默认生成的配置包含 `openai` 和 `opencode-go` 两套预设:
|
|
65
|
+
|
|
66
|
+
```jsonc
|
|
67
|
+
{
|
|
68
|
+
"$schema": "https://cnb.cool/zcyoop/ai-assistant/agent-forge/-/git/raw/master/agent-forge.schema.json",
|
|
69
|
+
"preset": "openai",
|
|
70
|
+
"presets": {
|
|
71
|
+
"openai": {
|
|
72
|
+
"orchestrator": { "model": "openai/gpt-5.5", "skills": ["*"], "mcps": ["*", "!context7"] },
|
|
73
|
+
"researcher": { "model": "openai/gpt-5.4-mini", "variant": "low", "skills": [], "mcps": ["websearch", "context7", "grep_app"] }
|
|
74
|
+
},
|
|
75
|
+
"opencode-go": {
|
|
76
|
+
"orchestrator": { "model": "opencode-go/glm-5.1", "skills": [ "*" ], "mcps": [ "*", "!context7" ] },
|
|
77
|
+
"researcher": { "model": "opencode-go/minimax-m2.7", "skills": [], "mcps": [ "websearch", "context7", "grep_app" ] }
|
|
78
|
+
}
|
|
79
|
+
}
|
|
80
|
+
}
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
### 其他 Provider
|
|
84
|
+
|
|
85
|
+
使用自定义 Provider 或混合 Provider 配置,请参考 **[配置参考](docs/configuration.md)** 的完整选项说明。如果需要开箱即用的方案,查看 **[作者预设](docs/authors-preset.md)** 和 **[$30 预设](docs/thirty-dollars-preset.md)**——`$30` 预设是最具性价比的方案。
|
|
86
|
+
|
|
87
|
+
配置指南还涵盖了自定义子 Agent(`agents.<name>`),你可以为自定义 Agent 定义 `prompt` 和 `orchestratorPrompt`。
|
|
88
|
+
|
|
89
|
+
模型建议见下方各 Agent 的推荐模型列表。
|
|
90
|
+
|
|
91
|
+
### ✅ 验证安装
|
|
92
|
+
|
|
93
|
+
安装并认证后,验证所有 Agent 已配置并响应:
|
|
94
|
+
|
|
95
|
+
```bash
|
|
96
|
+
opencode
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
然后运行:
|
|
100
|
+
|
|
101
|
+
```
|
|
102
|
+
ping all agents
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
如果有 Agent 未响应,检查你的 Provider 认证和配置文件。
|
|
106
|
+
|
|
107
|
+
---
|
|
108
|
+
|
|
109
|
+
<a id="meet-the-pantheon"></a>
|
|
110
|
+
|
|
111
|
+
## 🏛️ 认识众神
|
|
112
|
+
|
|
113
|
+
### 01. Orchestrator: 秩序的化身
|
|
114
|
+
|
|
115
|
+
Orchestrator 诞生于第一个代码库在其自身复杂性下崩溃之时。神与凡人都不愿承担责任——于是 Orchestrator 从虚空中涌现,从混沌中锻造秩序。它确定达到任何目标的最优路径,在速度、质量和成本之间取得平衡。它指导团队,为每项任务召唤合适的专家并委派执行,以实现最佳结果。
|
|
116
|
+
|
|
117
|
+
| | |
|
|
118
|
+
|---|---|
|
|
119
|
+
| **角色** | `主委派者和战略协调者` |
|
|
120
|
+
| **Prompt** | [`orchestrator.ts`](src/agents/orchestrator.ts) |
|
|
121
|
+
| **默认模型** | `openai/gpt-5.5` |
|
|
122
|
+
| **推荐模型** | `openai/gpt-5.5` · `anthropic/claude-opus-4.6` |
|
|
123
|
+
| **模型建议** | 选择你最强的全能编码模型。Orchestrator 既是主编码 Agent 又是委派者,需要强大的实现能力、良好的判断力和可靠的指令遵从能力。 |
|
|
124
|
+
|
|
125
|
+
---
|
|
126
|
+
|
|
127
|
+
### 02. Researcher: 永恒的漫游者
|
|
128
|
+
|
|
129
|
+
> Researcher 合并了 Explorer(本地代码搜索)和 Librarian(外部文档检索),成为统一的搜索专家。只读:搜索代码和获取文档,从不修改文件。
|
|
130
|
+
|
|
131
|
+
Researcher 是一位不朽的漫游者,自编程诞生之初便穿行于百万代码库和图书馆的回廊之中。他们将本地代码库搜索(glob、grep、AST 模式)与外部文档检索(websearch、context7、grep_app)合为一体。他们返回的不是原始数据——而是结构化的发现。
|
|
132
|
+
|
|
133
|
+
| | |
|
|
134
|
+
|---|---|
|
|
135
|
+
| **角色** | `代码库和外部文档搜索专家(只读)` |
|
|
136
|
+
| **Prompt** | [`researcher.ts`](src/agents/researcher.ts) |
|
|
137
|
+
| **默认模型** | `openai/gpt-5.4-mini` |
|
|
138
|
+
| **推荐模型** | `cerebras/zai-glm-4.7` · `fireworks-ai/accounts/fireworks/routers/kimi-k2p5-turbo` · `openai/gpt-5.4-mini` |
|
|
139
|
+
| **模型建议** | 选择快速、低成本的模型。Researcher 负责广泛的侦察工作,速度和效率通常比最强推理模型更重要。 |
|
|
140
|
+
|
|
141
|
+
---
|
|
142
|
+
|
|
143
|
+
## 📚 文档导航
|
|
144
|
+
|
|
145
|
+
以此为地图:从安装开始,然后根据需要跳转到功能、配置或预设示例。
|
|
146
|
+
|
|
147
|
+
### 🚀 从这里开始
|
|
148
|
+
|
|
149
|
+
| 文档 | 内容 |
|
|
150
|
+
|-----|------|
|
|
151
|
+
| **[安装指南](docs/installation.md)** | 安装插件、CLI 参数、重置配置、故障排除 |
|
|
152
|
+
|
|
153
|
+
<a id="features-and-workflows"></a>
|
|
154
|
+
|
|
155
|
+
### ✨ 功能与工作流
|
|
156
|
+
|
|
157
|
+
| 文档 | 内容 |
|
|
158
|
+
|-----|------|
|
|
159
|
+
| **[Todo 自动续行](docs/todo-continuation.md)** | Orchestrator 会话自动续行,带冷却时间和安全检查 |
|
|
160
|
+
| **[预设切换](docs/preset-switching.md)** | 运行时通过 `/preset` 切换 Agent 模型预设 |
|
|
161
|
+
| **[Interview](docs/interview.md)** | 通过浏览器问答流程将粗略想法转化为结构化 Markdown 规格 |
|
|
162
|
+
| **[Divoom 显示](docs/divoom.md)** | 将 Orchestrator 和专家 Agent 活动镜像到 Divoom MiniToo 蓝牙显示器 |
|
|
163
|
+
|
|
164
|
+
### ⚙️ 配置与参考
|
|
165
|
+
|
|
166
|
+
| 文档 | 内容 |
|
|
167
|
+
|-----|------|
|
|
168
|
+
| **[配置参考](docs/configuration.md)** | 配置文件位置、JSONC 支持、Prompt 覆盖、完整选项参考 |
|
|
169
|
+
| **[维护者指南](docs/maintainers.md)** | Issue 分诊规则、标签含义、支持路由、仓库维护工作流 |
|
|
170
|
+
| **[Skills](docs/skills.md)** | 内置和推荐 Skills,如 `simplify`、`agent-browser`、`codemap` |
|
|
171
|
+
| **[MCPs](docs/mcps.md)** | `websearch`、`context7`、`grep_app`,以及 MCP 权限如何按 Agent 分配 |
|
|
172
|
+
| **[Tools](docs/tools.md)** | 内置工具能力,如代码搜索和格式化器 |
|
|
173
|
+
|
|
174
|
+
### 💡 预设
|
|
175
|
+
|
|
176
|
+
| 文档 | 内容 |
|
|
177
|
+
|-----|------|
|
|
178
|
+
| **[作者预设](docs/authors-preset.md)** | 作者日常使用的混合 Provider 方案 |
|
|
179
|
+
| **[$30 预设](docs/thirty-dollars-preset.md)** | 约 $30/月的预算混合 Provider 方案 |
|
|
180
|
+
| **[OpenCode Go 预设](docs/opencode-go-preset.md)** | 安装器生成的 `opencode-go` 预设 |
|
|
181
|
+
|
|
182
|
+
---
|
|
183
|
+
|
|
184
|
+
## 📄 License
|
|
185
|
+
|
|
186
|
+
MIT
|
|
187
|
+
|
|
188
|
+
---
|