crewbee 0.1.12 → 0.1.14
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 +175 -269
- package/README.zh-CN.md +157 -271
- package/dist/opencode-plugin.mjs +351 -108
- package/dist/src/adapters/opencode/config-merge.d.ts.map +1 -1
- package/dist/src/adapters/opencode/config-merge.js +2 -1
- package/dist/src/adapters/opencode/config-merge.js.map +1 -1
- package/dist/src/adapters/opencode/delegation/resolve-agent.d.ts +1 -0
- package/dist/src/adapters/opencode/delegation/resolve-agent.d.ts.map +1 -1
- package/dist/src/adapters/opencode/delegation/resolve-agent.js +8 -2
- package/dist/src/adapters/opencode/delegation/resolve-agent.js.map +1 -1
- package/dist/src/adapters/opencode/delegation/tools.d.ts.map +1 -1
- package/dist/src/adapters/opencode/delegation/tools.js +14 -3
- package/dist/src/adapters/opencode/delegation/tools.js.map +1 -1
- package/dist/src/adapters/opencode/model-resolution.d.ts.map +1 -1
- package/dist/src/adapters/opencode/model-resolution.js +50 -10
- package/dist/src/adapters/opencode/model-resolution.js.map +1 -1
- package/dist/src/adapters/opencode/permission-mapper.d.ts.map +1 -1
- package/dist/src/adapters/opencode/permission-mapper.js +4 -1
- package/dist/src/adapters/opencode/permission-mapper.js.map +1 -1
- package/dist/src/adapters/opencode/projection.d.ts +14 -0
- package/dist/src/adapters/opencode/projection.d.ts.map +1 -1
- package/dist/src/adapters/opencode/projection.js +70 -1
- package/dist/src/adapters/opencode/projection.js.map +1 -1
- package/dist/src/adapters/opencode/prompt-builder.d.ts.map +1 -1
- package/dist/src/adapters/opencode/prompt-builder.js +12 -7
- package/dist/src/adapters/opencode/prompt-builder.js.map +1 -1
- package/dist/src/adapters/opencode/tool-hooks.d.ts +1 -1
- package/dist/src/adapters/opencode/tool-hooks.d.ts.map +1 -1
- package/dist/src/adapters/opencode/tool-hooks.js +22 -27
- package/dist/src/adapters/opencode/tool-hooks.js.map +1 -1
- package/dist/src/agent-teams/constants.d.ts +5 -0
- package/dist/src/agent-teams/constants.d.ts.map +1 -1
- package/dist/src/agent-teams/constants.js +6 -1
- package/dist/src/agent-teams/constants.js.map +1 -1
- package/dist/src/agent-teams/filesystem.d.ts +4 -1
- package/dist/src/agent-teams/filesystem.d.ts.map +1 -1
- package/dist/src/agent-teams/filesystem.js +116 -6
- package/dist/src/agent-teams/filesystem.js.map +1 -1
- package/dist/src/agent-teams/parsers.d.ts.map +1 -1
- package/dist/src/agent-teams/parsers.js +14 -2
- package/dist/src/agent-teams/parsers.js.map +1 -1
- package/dist/src/cli/doctor.js +1 -1
- package/dist/src/cli/doctor.js.map +1 -1
- package/dist/src/cli/package-version.d.ts.map +1 -0
- package/dist/src/cli/package-version.js.map +1 -0
- package/dist/src/cli/version.js +1 -1
- package/dist/src/cli/version.js.map +1 -1
- package/dist/src/core/index.d.ts +2 -0
- package/dist/src/core/index.d.ts.map +1 -1
- package/dist/src/install/types.d.ts +1 -1
- package/dist/src/install/types.d.ts.map +1 -1
- package/dist/src/normalize/build-agent-prompt-document.d.ts +6 -0
- package/dist/src/normalize/build-agent-prompt-document.d.ts.map +1 -0
- package/dist/src/normalize/{build-agent-prompt-source.js → build-agent-prompt-document.js} +6 -6
- package/dist/src/normalize/build-agent-prompt-document.js.map +1 -0
- package/dist/src/normalize/{build-team-prompt-source.d.ts → build-team-prompt-document.d.ts} +2 -2
- package/dist/src/normalize/build-team-prompt-document.d.ts.map +1 -0
- package/dist/src/normalize/{build-team-prompt-source.js → build-team-prompt-document.js} +3 -3
- package/dist/src/normalize/build-team-prompt-document.js.map +1 -0
- package/dist/src/render/apply-prompt-projection.d.ts.map +1 -0
- package/dist/src/render/apply-prompt-projection.js.map +1 -0
- package/dist/src/render/build-prompt-catalog.d.ts.map +1 -0
- package/dist/src/render/build-prompt-catalog.js.map +1 -0
- package/dist/src/render/build-prompt-plan.d.ts.map +1 -0
- package/dist/src/render/build-prompt-plan.js.map +1 -0
- package/dist/src/render/prompt-document-renderer.js +3 -3
- package/dist/src/render/prompt-document-renderer.js.map +1 -1
- package/dist/src/render/structural-renderer.js +1 -1
- package/dist/src/render/structural-renderer.js.map +1 -1
- package/package.json +2 -2
- package/templates/crewbee.json +1 -0
- package/dist/src/catalog/build-prompt-catalog.d.ts.map +0 -1
- package/dist/src/catalog/build-prompt-catalog.js.map +0 -1
- package/dist/src/manager/index.d.ts +0 -24
- package/dist/src/manager/index.d.ts.map +0 -1
- package/dist/src/manager/index.js +0 -68
- package/dist/src/manager/index.js.map +0 -1
- package/dist/src/normalize/build-agent-prompt-source.d.ts +0 -6
- package/dist/src/normalize/build-agent-prompt-source.d.ts.map +0 -1
- package/dist/src/normalize/build-agent-prompt-source.js.map +0 -1
- package/dist/src/normalize/build-team-prompt-source.d.ts.map +0 -1
- package/dist/src/normalize/build-team-prompt-source.js.map +0 -1
- package/dist/src/plan/build-prompt-plan.d.ts.map +0 -1
- package/dist/src/plan/build-prompt-plan.js.map +0 -1
- package/dist/src/projection/apply-prompt-projection.d.ts.map +0 -1
- package/dist/src/projection/apply-prompt-projection.js.map +0 -1
- package/dist/src/version/package-version.d.ts.map +0 -1
- package/dist/src/version/package-version.js.map +0 -1
- /package/dist/src/{version → cli}/package-version.d.ts +0 -0
- /package/dist/src/{version → cli}/package-version.js +0 -0
- /package/dist/src/{projection → render}/apply-prompt-projection.d.ts +0 -0
- /package/dist/src/{projection → render}/apply-prompt-projection.js +0 -0
- /package/dist/src/{catalog → render}/build-prompt-catalog.d.ts +0 -0
- /package/dist/src/{catalog → render}/build-prompt-catalog.js +0 -0
- /package/dist/src/{plan → render}/build-prompt-plan.d.ts +0 -0
- /package/dist/src/{plan → render}/build-prompt-plan.js +0 -0
package/README.zh-CN.md
CHANGED
|
@@ -2,42 +2,52 @@
|
|
|
2
2
|
|
|
3
3
|
[English](README.md) | [简体中文](README.zh-CN.md)
|
|
4
4
|
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
5
|
+
> [!NOTE]
|
|
6
|
+
>
|
|
7
|
+
> [](https://crewbeelab.github.io)
|
|
8
|
+
> > **CrewBee 把研发工作中的 prompts、agents、规则、review 流程和验收标准,整理成可维护的 Agent Team 资产。<br />访问官网:[crewbeelab.github.io](https://crewbeelab.github.io)。**
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
CrewBee 是当前优先适配 OpenCode 的 **Agent Team 资产层**。
|
|
8
12
|
|
|
9
|
-
|
|
13
|
+
它把研发工作中的 prompts、agents、规则、review 流程和验收标准,整理成可维护的 **Agent Team 资产**。
|
|
10
14
|
|
|
11
|
-
CrewBee
|
|
15
|
+
CrewBee 帮助你为专项业务场景定制可复用 Agent Team:不只是 agents,还包括 tools / skills 策略、工作流、规则、review 和验收标准。
|
|
12
16
|
|
|
13
|
-
|
|
17
|
+
这里的“团队”不是为了默认启用更多 Agent,而是为了让复杂研发任务中的需求理解、代码定位、方案判断、实现变更、独立审查、验证确认和交付说明拥有清晰职责与协作边界。
|
|
14
18
|
|
|
15
|
-
|
|
19
|
+
不是 prompt pack。
|
|
20
|
+
不是平铺 agent 列表。
|
|
21
|
+
不是另一个大而全 multi-agent runtime。
|
|
22
|
+
|
|
23
|
+
**当前优先适配 OpenCode。** OpenCode 是 CrewBee 当前的首个正式适配宿主;Project Context、Team 模板生态和更多 Agent Harness 适配属于下一阶段方向。
|
|
16
24
|
|
|
17
25
|
---
|
|
18
26
|
|
|
19
|
-
##
|
|
27
|
+
## 为什么需要 CrewBee
|
|
20
28
|
|
|
21
|
-
|
|
22
|
-
* **根据任务复杂度切换单 Agent 与多 Agent 协作模式** —— 简单任务保持敏捷,复杂任务启用团队协作、支援、review 和验证。
|
|
23
|
-
* **主 Agent 持有最完整上下文** —— 由主 Agent 统一持有用户目标、项目约束、支援结论、review 意见和验证结果,保证关键决策依据更全面。
|
|
24
|
-
* **上下文隔离式委派** —— 支援 Agent 在独立上下文中完成探索、研究和审查,只把高信号结论回传给主 Agent,降低主 Agent 的上下文与注意力负担。
|
|
25
|
-
* **内置成熟 Coding Team** —— 内置 Coding Team 包含清晰角色分工、review 方式与验收标准,适合代码开发、修复、调试、重构和验证。
|
|
26
|
-
* **跨会话 Project Context 方向** —— 下一阶段将增强自动维护 project context 的能力,让长期项目持续保有项目定位、框架设计、历史记录、当前状态与计划等摘要信息。
|
|
27
|
-
* **可复制、可修改、可贡献的 Team 模板体系** —— Team 是可以沉淀、版本化和分享的工程资产。
|
|
29
|
+
复杂研发任务,需要可审查、可验证、可交付的 **工作结构**。
|
|
28
30
|
|
|
29
|
-
|
|
31
|
+
代码生成只是其中一环。真正影响交付质量的,往往是需求理解、代码定位、方案判断、实现变更、独立审查、验证确认和交付说明。
|
|
30
32
|
|
|
31
|
-
|
|
32
|
-
* Team Library 装配与校验
|
|
33
|
-
* Runtime Projection 与 formal leader 默认入口选择
|
|
34
|
-
* OpenCode agent 配置投影、别名、配置补丁与 session binding
|
|
35
|
-
* OpenCode 插件入口、delegation 工具、事件接线与系统提示注入
|
|
36
|
-
* 本地构建、用户级安装、doctor 校验与卸载流程
|
|
33
|
+
如果这些内容分散在 prompts、agents、rules、review checklist 和临时约定里,Agent 工作方式会越来越难维护,也更难判断结果是否真的完成。
|
|
37
34
|
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
35
|
+
### CrewBee 在 OpenCode 中运行
|
|
36
|
+
|
|
37
|
+
下图展示了 CrewBee 在 OpenCode 中运行时的界面:已选择 Coding Team 入口,并能看到带 review 支撑的任务执行过程。
|
|
38
|
+
|
|
39
|
+

|
|
40
|
+
|
|
41
|
+
CrewBee 让你把这些内容整理成可维护的 Agent Team 资产:定义 Team、选择 Leader,并在 OpenCode 中运行结构化 Agent Team 工作流。
|
|
42
|
+
|
|
43
|
+
简单任务保持轻量。
|
|
44
|
+
复杂任务再启用支援、review 和验收标准。
|
|
45
|
+
|
|
46
|
+
当前 CrewBee 最重要的三项产品力是:
|
|
47
|
+
|
|
48
|
+
* **Agent Team 资产层** —— 把 prompts、agents、规则、review 流程和验收标准组织成可维护资产。
|
|
49
|
+
* **专项业务场景 Team 工程能力** —— 为 Coding、调研、文档、发布等场景定制可复用 Agent Team。
|
|
50
|
+
* **内置 Coding Team 旗舰样板** —— 用 owner-centered、review-backed 的方式组织复杂代码任务。
|
|
41
51
|
|
|
42
52
|
---
|
|
43
53
|
|
|
@@ -86,9 +96,9 @@ CrewBee 统一使用单一的 **canonical agent id**,贯穿投影、默认选
|
|
|
86
96
|
|
|
87
97
|
## CrewBee 是什么
|
|
88
98
|
|
|
89
|
-
CrewBee
|
|
99
|
+
CrewBee 是一个当前优先适配 OpenCode 的 Agent Team 资产层。
|
|
90
100
|
|
|
91
|
-
在 CrewBee 里,真正的一等对象不是单个 Agent,而是 **Team**。一个 Team 不是几段 prompt
|
|
101
|
+
在 CrewBee 里,真正的一等对象不是单个 Agent,而是 **Team**。一个 Team 不是几段 prompt 的拼接,也不是平铺的角色列表,而是一套可以维护、复制、修改和复用的工作结构,通常包含:
|
|
92
102
|
|
|
93
103
|
* Team 身份与定位
|
|
94
104
|
* formal leader
|
|
@@ -96,304 +106,158 @@ CrewBee 是一个面向真实宿主运行时的 Agent Team 框架。
|
|
|
96
106
|
* workflow
|
|
97
107
|
* Team 共享规则
|
|
98
108
|
* Agent Profiles
|
|
99
|
-
*
|
|
100
|
-
*
|
|
109
|
+
* review flow
|
|
110
|
+
* completion criteria
|
|
111
|
+
* tools / skills 策略
|
|
112
|
+
* 模型偏好与宿主绑定
|
|
101
113
|
|
|
102
|
-
CrewBee
|
|
114
|
+
CrewBee 的目标,是把零散的 prompts、agents、规则、review 流程和验收标准沉淀为可维护的 Agent Team 资产。
|
|
103
115
|
|
|
104
116
|
当前阶段的基本使用方式是:
|
|
105
117
|
|
|
106
|
-
*
|
|
107
|
-
*
|
|
108
|
-
*
|
|
118
|
+
* 在 OpenCode 中选择 Team 的入口 Agent,例如 `coding-leader`
|
|
119
|
+
* 用 Team 定义组织 Leader、成员职责、规则、工作流、review 和验收标准
|
|
120
|
+
* 简单任务保持单 Agent 轻量路径,复杂任务再启用支援、review 和验证
|
|
109
121
|
|
|
110
|
-
|
|
122
|
+
Runtime Projection、OpenCode Adapter、setup、doctor、per-agent 模型配置和 projection-time fallback,是让这些 Team 资产在 OpenCode 中可用、可配置、可诊断的实现方案与可用性支撑;它们重要,但不作为 CrewBee 的长期核心优势来表述。
|
|
111
123
|
|
|
112
124
|
---
|
|
113
125
|
|
|
114
126
|
## CrewBee 解决什么问题
|
|
115
127
|
|
|
116
|
-
CrewBee
|
|
117
|
-
|
|
118
|
-
### 1. 为不同任务 / 项目设计不同 Agent Team
|
|
119
|
-
|
|
120
|
-
Coding、调研、写作、分析、推广、长期项目维护并不是同一种工作。它们需要不同的角色结构、工作规则、工具边界、review 方式和完成标准。
|
|
121
|
-
|
|
122
|
-
CrewBee 允许你为不同任务 / 项目设计不同 Agent Team,而不是用一套越来越长的通用 prompt 处理所有工作。
|
|
123
|
-
|
|
124
|
-
### 2. 根据任务复杂度灵活切换单 Agent 与多 Agent 协作模式
|
|
125
|
-
|
|
126
|
-
简单任务需要快速响应、少 token、少步骤;复杂任务才需要支援 Agent、独立 review、验证和更明确的完成闸门。
|
|
127
|
-
|
|
128
|
-
CrewBee 的设计目标不是默认让所有任务都变成多 Agent 协作,而是支持根据任务复杂度选择合适的执行方式。
|
|
129
|
-
|
|
130
|
-
### 3. 主 Agent 持有最完整上下文,保证决策依据的全面性
|
|
128
|
+
CrewBee 当前主要解决三类问题。
|
|
131
129
|
|
|
132
|
-
|
|
130
|
+
### 1. 把分散的 Agent 工作方式整理成资产
|
|
133
131
|
|
|
134
|
-
|
|
132
|
+
很多团队会逐步积累 prompts、agents、rules、review checklist、模型偏好和工具使用经验。问题是,这些内容一旦分散在不同配置和临时约定里,就很难维护、复用和审查。
|
|
135
133
|
|
|
136
|
-
|
|
134
|
+
CrewBee 把它们组织成 Agent Team 资产,让一类工作的方法可以被复制、修改、版本化和持续改进。
|
|
137
135
|
|
|
138
|
-
|
|
136
|
+
### 2. 为专项业务场景定制可复用 Agent Team
|
|
139
137
|
|
|
140
|
-
|
|
138
|
+
Coding、Code Review、ResearchOps、Documentation、ReleaseOps、Bug Triage 或内部团队流程,都可能需要不同的职责、工具 / 技能策略、工作流、规则、review 和验收标准。
|
|
141
139
|
|
|
142
|
-
|
|
140
|
+
CrewBee 支持你把某个专项业务场景整理成一支可复用 Agent Team,而不是把所有工作都塞进一套越来越长的通用 prompt。
|
|
143
141
|
|
|
144
|
-
|
|
142
|
+
### 3. 用内置 Coding Team 提供可运行样板
|
|
145
143
|
|
|
146
|
-
CrewBee
|
|
144
|
+
CrewBee 当前内置 Coding Team,用于代码开发、修复、调试、重构、验证和交付。
|
|
147
145
|
|
|
148
|
-
|
|
146
|
+
它不是一个单独的 Coder Agent,而是一支面向软件工程任务设计的 Team:有主线 owner,有代码定位,有专项实现,有独立 review,也有验收标准。
|
|
149
147
|
|
|
150
|
-
|
|
148
|
+
这让 CrewBee 不只停留在“可以定义 Team”的抽象层,而是提供一支当前就能在 OpenCode 中使用的旗舰样板。
|
|
151
149
|
|
|
152
|
-
|
|
150
|
+
### 当前边界
|
|
153
151
|
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
Team 不只是内部配置,也是可以复制、修改、版本化和贡献的工程资产。
|
|
157
|
-
|
|
158
|
-
这让用户可以从内置 Team 或模板出发,逐步沉淀自己的 Agent 工作方式。
|
|
152
|
+
Project Context、Team 模板生态和多宿主投影,都是下一阶段方向;当前 README 不把它们写成成熟优势。
|
|
159
153
|
|
|
160
154
|
---
|
|
161
155
|
|
|
162
156
|
## 核心特性
|
|
163
157
|
|
|
164
|
-
### 1.
|
|
158
|
+
### 1. Agent Team 资产层
|
|
165
159
|
|
|
166
160
|
CrewBee 把 Team 当成一等对象,而不是只关心一个个散落的 agent prompt。
|
|
167
161
|
|
|
168
|
-
一个 Team
|
|
162
|
+
一个 Agent Team 资产可以包含:
|
|
169
163
|
|
|
170
|
-
*
|
|
171
|
-
* 默认入口
|
|
172
|
-
*
|
|
173
|
-
*
|
|
164
|
+
* 任务定位与适用边界
|
|
165
|
+
* 默认入口 Leader
|
|
166
|
+
* 成员职责与协作边界
|
|
167
|
+
* Team 内部工作流
|
|
174
168
|
* 共享规则
|
|
175
|
-
*
|
|
176
|
-
* review
|
|
177
|
-
*
|
|
169
|
+
* tools / skills 策略
|
|
170
|
+
* review 流程
|
|
171
|
+
* 验收标准
|
|
178
172
|
* 输出风格
|
|
173
|
+
* 模型偏好与宿主绑定
|
|
179
174
|
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
* `CodingTeam`:代码开发、修复、调试、重构、验证
|
|
183
|
-
* `GeneralTeam`:调研、分析、写作、方案
|
|
184
|
-
* `ResearchOpsTeam`:证据检索、资料整理、结论收束
|
|
185
|
-
* `MarketingOpsTeam`:开源发布、推广、社区反馈
|
|
186
|
-
* `ProjectContextTeam`:项目上下文维护、状态更新、跨会话 handoff
|
|
187
|
-
* `WukongTeam`:高不确定性、强探索、长周期复杂任务
|
|
188
|
-
|
|
189
|
-
### 2. 根据任务复杂度灵活切换单 Agent 与多 Agent 协作模式
|
|
190
|
-
|
|
191
|
-
CrewBee 不把多 Agent 协作做成默认仪式,而是支持根据任务复杂度选择不同执行方式。
|
|
192
|
-
|
|
193
|
-
**单 Agent 执行模式** 适合:
|
|
194
|
-
|
|
195
|
-
* 简单问答
|
|
196
|
-
* 小范围代码修改
|
|
197
|
-
* 局部解释
|
|
198
|
-
* 快速整理
|
|
199
|
-
* 低风险任务
|
|
200
|
-
* 已经有明确上下文和明确目标的任务
|
|
201
|
-
|
|
202
|
-
**多 Agent 协作模式** 适合:
|
|
203
|
-
|
|
204
|
-
* 跨文件实现
|
|
205
|
-
* 复杂 bug 修复
|
|
206
|
-
* 外部资料调研
|
|
207
|
-
* 架构判断
|
|
208
|
-
* 独立 review
|
|
209
|
-
* 需要验证证据的任务
|
|
210
|
-
* 长周期项目工作
|
|
175
|
+
这让 Team 不再是一次性 prompt,而是一套可以维护、复制、修改、版本化和复用的工作结构。
|
|
211
176
|
|
|
212
|
-
|
|
177
|
+
### 2. 为专项业务场景定制可复用 Agent Team
|
|
213
178
|
|
|
214
|
-
|
|
179
|
+
CrewBee 的价值不只是“有内置 Team”,而是支持你把某类工作的方法沉淀成一支可复用 Agent Team。
|
|
215
180
|
|
|
216
|
-
|
|
181
|
+
专项业务场景可以是:
|
|
217
182
|
|
|
218
|
-
|
|
183
|
+
* Coding
|
|
184
|
+
* Code Review
|
|
185
|
+
* ResearchOps
|
|
186
|
+
* Documentation
|
|
187
|
+
* ReleaseOps
|
|
188
|
+
* Bug Triage
|
|
189
|
+
* Product Planning
|
|
190
|
+
* 团队内部特定流程
|
|
219
191
|
|
|
220
|
-
|
|
221
|
-
* 项目约束
|
|
222
|
-
* 当前任务状态
|
|
223
|
-
* 支援 Agent 回传的结论
|
|
224
|
-
* review 意见
|
|
225
|
-
* 验证结果
|
|
226
|
-
* 风险与未决事项
|
|
227
|
-
|
|
228
|
-
关键决策由主 Agent 基于这些信息完成,而不是由只掌握局部信息的支援 Agent 独立做全局判断。
|
|
229
|
-
|
|
230
|
-
### 4. 上下文隔离式委派,降低主 Agent 的上下文与注意力负担
|
|
231
|
-
|
|
232
|
-
CrewBee 的支援型协作强调上下文隔离式委派:
|
|
192
|
+
一支专项业务场景 Team 不只是 agents,还可以组织:
|
|
233
193
|
|
|
234
194
|
```text
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
|
|
195
|
+
Agent Team
|
|
196
|
+
+ tools / skills 策略
|
|
197
|
+
+ 工作流
|
|
198
|
+
+ shared rules
|
|
199
|
+
+ review flow
|
|
200
|
+
+ completion criteria
|
|
201
|
+
+ output contract
|
|
239
202
|
```
|
|
240
203
|
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
* 代码库探索
|
|
244
|
-
* 外部资料检索
|
|
245
|
-
* 证据整理
|
|
246
|
-
* 多模态资料解读
|
|
247
|
-
* 独立 review
|
|
248
|
-
* 高阶架构建议
|
|
204
|
+
用户不一定要修改 CrewBee core,也可以先从 Team 定义开始,沉淀自己的业务场景工作方式。
|
|
249
205
|
|
|
250
|
-
|
|
206
|
+
### 3. 内置 Coding Team 作为旗舰样板
|
|
251
207
|
|
|
252
|
-
|
|
208
|
+
CrewBee 当前最重要的可运行样板是内置 Coding Team。
|
|
253
209
|
|
|
254
|
-
|
|
255
|
-
|
|
256
|
-
它不是单个 Coder Agent,而是一支面向软件工程任务设计的 Agent Team,推荐结构包括:
|
|
210
|
+
它不是单个 Coder Agent,而是一支面向软件工程任务设计的 Agent Team:
|
|
257
211
|
|
|
258
212
|
```text
|
|
259
|
-
|
|
260
|
-
coding-executor
|
|
261
|
-
codebase-explorer
|
|
262
|
-
web-researcher
|
|
263
|
-
reviewer
|
|
264
|
-
principal-advisor
|
|
265
|
-
multimodal-looker
|
|
266
|
-
task-orchestrator
|
|
213
|
+
主线 owner + 代码定位 + 专项实现 + 独立 review + 验收标准
|
|
267
214
|
```
|
|
268
215
|
|
|
269
216
|
内置 Coding Team 采用直接职责命名,让用户快速理解每个 Agent 负责什么。
|
|
270
217
|
|
|
271
|
-
| 内置 Coding Team 角色 | 职责
|
|
272
|
-
| ------------------- |
|
|
273
|
-
| `coding-leader` | 默认入口、任务 owner
|
|
274
|
-
| `coding-executor` | 执行明确实现、修复、调试与局部重构
|
|
275
|
-
| `codebase-explorer` | 定位代码入口、调用链、相似实现和历史线索
|
|
276
|
-
| `web-researcher` | 查官方资料、外部文档、开源实现和版本差异
|
|
277
|
-
| `reviewer` | 独立审查风险、遗漏、验证证据和完成标准
|
|
278
|
-
| `principal-advisor` | 提供架构、性能、复杂度等高阶判断和主建议
|
|
279
|
-
| `multimodal-looker` | 解读截图、图表、PDF、界面图和视觉资料
|
|
280
|
-
| `task-orchestrator` | 处理大型计划、多波次任务和统一 QA 编排
|
|
281
|
-
|
|
282
|
-
Coding Team 的完成不应只依赖“Agent 认为完成了”,而应尽量包含明确验收标准,例如:
|
|
218
|
+
| 内置 Coding Team 角色 | 职责 |
|
|
219
|
+
| ------------------- | ----------------------- |
|
|
220
|
+
| `coding-leader` | 默认入口、任务 owner、最终判断与交付说明 |
|
|
221
|
+
| `coding-executor` | 执行明确实现、修复、调试与局部重构 |
|
|
222
|
+
| `codebase-explorer` | 定位代码入口、调用链、相似实现和历史线索 |
|
|
223
|
+
| `web-researcher` | 查官方资料、外部文档、开源实现和版本差异 |
|
|
224
|
+
| `reviewer` | 独立审查风险、遗漏、验证证据和完成标准 |
|
|
225
|
+
| `principal-advisor` | 提供架构、性能、复杂度等高阶判断和主建议 |
|
|
226
|
+
| `multimodal-looker` | 解读截图、图表、PDF、界面图和视觉资料 |
|
|
227
|
+
| `task-orchestrator` | 处理大型计划、多波次任务和统一 QA 编排 |
|
|
283
228
|
|
|
284
|
-
|
|
285
|
-
- 目标问题已定位
|
|
286
|
-
- 修改点有明确依据
|
|
287
|
-
- 已完成必要实现或修复
|
|
288
|
-
- 已运行可用的 diagnostics / build / tests
|
|
289
|
-
- reviewer 未发现真实阻塞
|
|
290
|
-
- 已说明未验证项和残余风险
|
|
291
|
-
```
|
|
292
|
-
|
|
293
|
-
### 6. Host-agnostic 定义与 OpenCode Runtime Projection
|
|
229
|
+
复杂代码任务中,真正有价值的不是默认拉起更多 Agent,而是:
|
|
294
230
|
|
|
295
|
-
|
|
231
|
+
* 有主执行 owner 持有任务主线;
|
|
232
|
+
* 有 codebase-explorer 提供代码定位和证据;
|
|
233
|
+
* 有 web-researcher 在必要时补充外部资料;
|
|
234
|
+
* 有 reviewer 提供独立质量视角;
|
|
235
|
+
* 有 completion criteria 防止“Agent 自证完成”。
|
|
296
236
|
|
|
297
|
-
|
|
237
|
+
### 4. 当前可用性支撑
|
|
298
238
|
|
|
299
|
-
|
|
239
|
+
为了让 Agent Team 资产真实落地到 OpenCode,CrewBee 也提供了一组可用性支撑:
|
|
300
240
|
|
|
301
|
-
*
|
|
302
|
-
* Team / Agent
|
|
241
|
+
* OpenCode 优先适配
|
|
242
|
+
* Team / Agent 校验
|
|
303
243
|
* Runtime Projection
|
|
304
|
-
* formal leader
|
|
305
|
-
* projected agent generation
|
|
306
|
-
* OpenCode config patch
|
|
307
|
-
* session binding
|
|
244
|
+
* formal leader 默认入口
|
|
308
245
|
* delegation tooling
|
|
309
|
-
*
|
|
310
|
-
*
|
|
311
|
-
*
|
|
312
|
-
|
|
313
|
-
|
|
314
|
-
|
|
315
|
-
### 7. 可复制、可修改、可贡献的 Team 模板体系
|
|
316
|
-
|
|
317
|
-
CrewBee 的 Team 是文件型工程资产,可以被复制、修改、版本化和贡献。
|
|
318
|
-
|
|
319
|
-
用户可以:
|
|
320
|
-
|
|
321
|
-
* 使用内置 Team
|
|
322
|
-
* 复制 Team 模板
|
|
323
|
-
* 修改角色结构
|
|
324
|
-
* 调整共享规则
|
|
325
|
-
* 固化自己的工作方式
|
|
326
|
-
* 为社区贡献 Team
|
|
327
|
-
|
|
328
|
-
很多用户不一定会修改 CrewBee core,但可以基于模板改出自己的 Team。
|
|
329
|
-
|
|
330
|
-
### 8. Prompt 既低耦合,又保留执行语义
|
|
331
|
-
|
|
332
|
-
CrewBee 没有回退到“每个字段一个 schema / 一个 renderer”的旧路,也没有退化成“top-level block 全透明 dump”。
|
|
333
|
-
|
|
334
|
-
当前采用的是:
|
|
335
|
-
|
|
336
|
-
> **少量公共语义骨架 section + 通用结构处理 + 结构渲染**
|
|
337
|
-
|
|
338
|
-
例如 Agent prompt 的骨架顺序会围绕执行心智组织:
|
|
339
|
-
|
|
340
|
-
* Persona Core
|
|
341
|
-
* Responsibility Core
|
|
342
|
-
* Core Principle
|
|
343
|
-
* Scope Control
|
|
344
|
-
* Ambiguity Policy
|
|
345
|
-
* Support Triggers
|
|
346
|
-
* Collaboration
|
|
347
|
-
* Task Triage
|
|
348
|
-
* Delegation & Review
|
|
349
|
-
* Todo Discipline
|
|
350
|
-
* Completion Gate
|
|
351
|
-
* Failure Recovery
|
|
352
|
-
* Operations
|
|
353
|
-
* Output Contract
|
|
354
|
-
* Templates
|
|
355
|
-
* Guardrails
|
|
356
|
-
* Heuristics
|
|
357
|
-
* Anti Patterns
|
|
358
|
-
* Tool Skill Strategy
|
|
359
|
-
|
|
360
|
-
这样模型更容易快速建立:
|
|
361
|
-
|
|
362
|
-
* 我是谁
|
|
363
|
-
* 我负责什么
|
|
364
|
-
* 我默认怎么行动
|
|
365
|
-
* 什么时候委派 / 评审 / 提问 / 停下
|
|
366
|
-
* 完成标准是什么
|
|
367
|
-
* 失败时如何恢复
|
|
368
|
-
|
|
369
|
-
### 9. Collaboration 会生成可直接委派的 Agent 清单
|
|
246
|
+
* per-agent 模型配置
|
|
247
|
+
* projection-time fallback
|
|
248
|
+
* user-level setup
|
|
249
|
+
* doctor checks
|
|
250
|
+
* 卸载与诊断脚本
|
|
370
251
|
|
|
371
|
-
|
|
252
|
+
这些能力让 CrewBee 更容易安装、配置、运行和排障;它们是实现方案、用户体验支撑和版本质量证据,不写成 CrewBee 的长期核心差异化优势。
|
|
372
253
|
|
|
373
|
-
|
|
374
|
-
* Team Manifest 中的 `members` 描述
|
|
375
|
-
* OpenCode 侧可解析的 projected id
|
|
254
|
+
### 5. 下一阶段方向
|
|
376
255
|
|
|
377
|
-
|
|
256
|
+
以下方向是 Roadmap,不是当前成熟优势:
|
|
378
257
|
|
|
379
|
-
*
|
|
380
|
-
*
|
|
381
|
-
*
|
|
382
|
-
|
|
383
|
-
便于在运行时直接委派。
|
|
384
|
-
|
|
385
|
-
### 10. Team Contract 压缩为可执行手册
|
|
386
|
-
|
|
387
|
-
Team prompt 最终不是直接渲染整块治理配置,而是收敛为:
|
|
388
|
-
|
|
389
|
-
* `Working Rules`
|
|
390
|
-
* `Approval & Safety`
|
|
391
|
-
|
|
392
|
-
这让 Team 合同更适合模型消费,也避免了治理字段机械展开。
|
|
393
|
-
|
|
394
|
-
### 11. 用户级安装与运维链路
|
|
395
|
-
|
|
396
|
-
CrewBee 已经具备完整的本地构建、用户级安装、doctor 校验和卸载链路,能够作为 OpenCode 的用户级插件稳定接入。
|
|
258
|
+
* **Project Context**:让长期项目中的 Agent 不再每次像新人入职。
|
|
259
|
+
* **Team 模板生态**:围绕专项业务场景沉淀更多可复用 Team。
|
|
260
|
+
* **更多 Agent Harness 适配**:探索 OpenCode 之外的宿主适配与 Team 资产迁移能力。
|
|
397
261
|
|
|
398
262
|
---
|
|
399
263
|
|
|
@@ -663,11 +527,13 @@ package.json
|
|
|
663
527
|
|
|
664
528
|
## 内置 Coding Team 的设计思想
|
|
665
529
|
|
|
666
|
-
CrewBee
|
|
530
|
+
CrewBee 当前最重要的旗舰样板,就是内置 Coding Team。
|
|
531
|
+
|
|
532
|
+
它证明 CrewBee 的产品力不只是“可以定义 Team”,而是可以把一个真实业务场景组织成一支可用的 Agent Team。
|
|
667
533
|
|
|
668
534
|
### 1. 主 Agent 持有最完整上下文
|
|
669
535
|
|
|
670
|
-
Coding Team 的主 Agent / formal leader 是默认入口、主线 owner
|
|
536
|
+
Coding Team 的主 Agent / formal leader 是默认入口、主线 owner、最终判断者和交付说明责任人。
|
|
671
537
|
|
|
672
538
|
它负责汇总:
|
|
673
539
|
|
|
@@ -691,7 +557,25 @@ CrewBee 认为:
|
|
|
691
557
|
|
|
692
558
|
因此,Coding Team 不应把所有任务都变成完整团队流程。
|
|
693
559
|
|
|
694
|
-
### 3.
|
|
560
|
+
### 3. Coding Team 的价值不是更多 Agent,而是更清晰的工作结构
|
|
561
|
+
|
|
562
|
+
复杂代码任务中,风险往往不在“AI 能不能写出代码”,而在:
|
|
563
|
+
|
|
564
|
+
* 是否改对目标;
|
|
565
|
+
* 是否定位到真正相关的代码;
|
|
566
|
+
* 是否影响其他模块;
|
|
567
|
+
* 是否遗漏边界情况;
|
|
568
|
+
* 是否运行过必要验证;
|
|
569
|
+
* 是否过度修改;
|
|
570
|
+
* 是否把未验证项说明清楚。
|
|
571
|
+
|
|
572
|
+
所以,Coding Team 的核心不是默认拉起更多 Agent,而是把复杂代码任务组织成:
|
|
573
|
+
|
|
574
|
+
```text
|
|
575
|
+
主线 owner + 代码定位 + 专项实现 + 独立 review + 验收标准
|
|
576
|
+
```
|
|
577
|
+
|
|
578
|
+
### 4. 最值得独立出去的通常不是 Planner,而是 Reviewer
|
|
695
579
|
|
|
696
580
|
在 Coding 场景里,计划、执行、验证是强耦合回路。
|
|
697
581
|
真正值钱的是:
|
|
@@ -709,7 +593,7 @@ CrewBee 认为:
|
|
|
709
593
|
|
|
710
594
|
而不是 O / P / E 三权平分。
|
|
711
595
|
|
|
712
|
-
###
|
|
596
|
+
### 5. 支援 Agent 独立上下文,主 Agent 统一收口
|
|
713
597
|
|
|
714
598
|
对于代码任务,CrewBee 更强调:
|
|
715
599
|
|
|
@@ -724,9 +608,9 @@ CrewBee 认为:
|
|
|
724
608
|
|
|
725
609
|
## 下一步:Project Context
|
|
726
610
|
|
|
727
|
-
Project Context 是 CrewBee
|
|
611
|
+
Project Context 是 CrewBee 下一阶段的重要产品力方向,不是当前 README 中应被写成成熟优势的能力。
|
|
728
612
|
|
|
729
|
-
|
|
613
|
+
它的目标,是让长期项目中的 Agent 不再每次像新人入职。理想状态下,长期项目可以持续持有高信号摘要信息,包括:
|
|
730
614
|
|
|
731
615
|
* 项目定位
|
|
732
616
|
* 框架设计
|
|
@@ -753,7 +637,7 @@ Project Context 不应只是一次性生成项目摘要,而应在项目推进
|
|
|
753
637
|
1. **减少手动提示补充**:用户不需要每次重新解释项目定位、历史决策和当前计划。
|
|
754
638
|
2. **减少完整阅读工程代码带来的上下文消耗**:Agent 可以先根据 project context 理解项目结构、关键模块和当前任务相关区域,再进行针对性代码阅读。
|
|
755
639
|
|
|
756
|
-
> 当前说明:Project Context
|
|
640
|
+
> 当前说明:Project Context 是下一阶段重点增强方向。README 中保留它作为 Roadmap 说明,但不把它表述为当前成熟产品优势。
|
|
757
641
|
|
|
758
642
|
---
|
|
759
643
|
|
|
@@ -850,8 +734,10 @@ npm run doctor
|
|
|
850
734
|
|
|
851
735
|
## 致谢
|
|
852
736
|
|
|
853
|
-
CrewBee 受 OpenCode 以及 oh-my-openagent
|
|
737
|
+
CrewBee 受 OpenCode 以及 oh-my-openagent 等社区项目启发。
|
|
738
|
+
|
|
739
|
+
OpenCode 提供了 CrewBee 当前优先适配的真实 AI coding 宿主环境;oh-my-openagent 等项目则启发了社区对 Agent Team、角色协作和工作流组织方式的探索。
|
|
854
740
|
|
|
855
741
|
感谢这些项目的开发者与维护者。
|
|
856
742
|
|
|
857
|
-
CrewBee
|
|
743
|
+
CrewBee 在这个方向上继续推进:不做另一个大而全 multi-agent runtime,而是把 prompts、agents、规则、review 流程和验收标准整理成可维护的 Agent Team 资产,并优先让它们在 OpenCode 中真实可用。
|