@bohuyeshan/openagent-labforge-core 3.13.0 → 3.13.2
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.ja.md +130 -130
- package/README.ko.md +128 -128
- package/README.md +235 -229
- package/README.ru.md +131 -131
- package/README.zh-cn.md +237 -231
- package/bin/openagent-labforge.js +192 -192
- package/bin/platform.test.ts +20 -20
- package/dist/cli/index.js +2 -2
- package/dist/hooks/atlas/idle-event.d.ts +8 -0
- package/dist/hooks/atlas/resolve-active-boulder-session.d.ts +11 -0
- package/dist/hooks/atlas/types.d.ts +3 -0
- package/dist/index.js +196 -140
- package/package.json +30 -30
package/README.ja.md
CHANGED
|
@@ -1,130 +1,130 @@
|
|
|
1
|
-
# OpenAgent Labforge
|
|
2
|
-
|
|
3
|
-
> [!NOTE]
|
|
4
|
-
> **派生プロジェクトについて**
|
|
5
|
-
>
|
|
6
|
-
> OpenAgent Labforge は `code-yeongyu/oh-my-openagent`
|
|
7
|
-
> (旧 `oh-my-opencode`)の派生版です。
|
|
8
|
-
> このフォークでは、上流のライセンス境界と来歴を保ったまま、
|
|
9
|
-
> OpenCode ネイティブな委譲、研究ワークフロー、MCP の使い分け、
|
|
10
|
-
> ローカル優先の運用に重点を移しています。
|
|
11
|
-
>
|
|
12
|
-
> 来歴とライセンスは `LICENSE.md`、`NOTICE`、`THIRD_PARTY_NOTICES.md`、
|
|
13
|
-
> `docs/licensing.md` を参照してください。
|
|
14
|
-
|
|
15
|
-
## このフォークで現在強化されていること
|
|
16
|
-
|
|
17
|
-
この README は、上流の宣伝文や歴史ではなく、**今このプロジェクトが何を
|
|
18
|
-
できるか**に焦点を当てています。
|
|
19
|
-
|
|
20
|
-
### 1. Agent の役割分担が明確
|
|
21
|
-
|
|
22
|
-
- オーケストレーターと専門エージェントの境界を整理
|
|
23
|
-
- `task(subagent_type=...)` を OpenCode 上で確認可能な child session の正規経路として扱う
|
|
24
|
-
- 主な役割分担:
|
|
25
|
-
- `librarian` -> 単一ライブラリ / フレームワーク / SDK の調査
|
|
26
|
-
- `github-scout` -> リポジトリ比較と学習候補の抽出
|
|
27
|
-
- `tech-scout` -> エコシステム / ベンチマーク / リリース分析
|
|
28
|
-
- `article-writer` -> 公開向け技術文章
|
|
29
|
-
- `scientific-writer` -> 研究・査読向け技術文章
|
|
30
|
-
- バックグラウンド委譲時の fallback-chain 管理も強化済み
|
|
31
|
-
|
|
32
|
-
### 2. 検索フローを「精度」と「広さ」で分離
|
|
33
|
-
|
|
34
|
-
- `websearch` -> 精度重視の検索
|
|
35
|
-
- `open_websearch_mcp` -> 多エンジンによる広い再現率
|
|
36
|
-
- `paper_search_mcp` -> 学術検索
|
|
37
|
-
- `context7` -> 公式ドキュメント / フレームワーク参照
|
|
38
|
-
- `grep_app` -> GitHub コード例
|
|
39
|
-
|
|
40
|
-
検索/分析モードの注入プロンプトも軽量化されており、明示的に選んだ専門
|
|
41
|
-
エージェントを無理に再ルーティングしないようになっています。
|
|
42
|
-
|
|
43
|
-
### 3. MCP の実運用を安定化
|
|
44
|
-
|
|
45
|
-
- `bing_cn_mcp` は `open_websearch_mcp` に置き換え済み
|
|
46
|
-
- `open_websearch_mcp` は `environment`、stdio、prompt-probe 互換、
|
|
47
|
-
バージョン固定、起動タイムアウトを適切化
|
|
48
|
-
- `paper_search_mcp` は、この Windows/OpenCode 環境で実際に動いた
|
|
49
|
-
ランチャ経路へ戻しています
|
|
50
|
-
- 精密検索 / 広域検索 / 学術検索の分担が明確です
|
|
51
|
-
|
|
52
|
-
### 4. Skill 検出を OpenCode 寄りに調整
|
|
53
|
-
|
|
54
|
-
- プロジェクトローカル skill は git ルート方向へ探索
|
|
55
|
-
- `SKILL.md` メタデータをより厳密に検証
|
|
56
|
-
- インストーラが `openagent-labforge` skill ディレクトリを自動生成し、
|
|
57
|
-
プラグイン能力の発見を安定化
|
|
58
|
-
|
|
59
|
-
### 5. リリース面もフォーク実態に合わせて整理中
|
|
60
|
-
|
|
61
|
-
- ルート README は上流の宣伝コピーではなく、現行プロダクトの説明に変更
|
|
62
|
-
- インストーラ文言、パッケージメタデータ、schema メタデータも現行 fork に調整
|
|
63
|
-
- 現時点での推奨経路は **ローカル build + ローカル install**
|
|
64
|
-
|
|
65
|
-
## 現在の agent 構成
|
|
66
|
-
|
|
67
|
-
### 中核オーケストレーター
|
|
68
|
-
|
|
69
|
-
- `sisyphus`
|
|
70
|
-
- `hephaestus`
|
|
71
|
-
- `prometheus`
|
|
72
|
-
- `atlas`
|
|
73
|
-
- `sisyphus-junior`
|
|
74
|
-
|
|
75
|
-
### 専門エージェント
|
|
76
|
-
|
|
77
|
-
- `explore`
|
|
78
|
-
- `librarian`
|
|
79
|
-
- `github-scout`
|
|
80
|
-
- `tech-scout`
|
|
81
|
-
- `article-writer`
|
|
82
|
-
- `scientific-writer`
|
|
83
|
-
- 必要に応じて bio / multimodal 系 specialist
|
|
84
|
-
|
|
85
|
-
## 現在のインストール現実
|
|
86
|
-
|
|
87
|
-
現状は次の流れを前提にしています。
|
|
88
|
-
|
|
89
|
-
1. ローカル build
|
|
90
|
-
2. ローカル tgz を生成
|
|
91
|
-
3. OpenCode 設定ディレクトリ内のローカルプラグインを置き換える
|
|
92
|
-
|
|
93
|
-
```bash
|
|
94
|
-
bun run build:skills-catalog
|
|
95
|
-
bun run build
|
|
96
|
-
bun pm pack
|
|
97
|
-
```
|
|
98
|
-
|
|
99
|
-
詳細は `docs/guide/installation.md` を参照してください。
|
|
100
|
-
|
|
101
|
-
## ドキュメント入口
|
|
102
|
-
|
|
103
|
-
- `docs/guide/installation.md` - 現在のインストール / 置き換え手順
|
|
104
|
-
- `docs/guide/overview.md` - 現行プロダクト形態
|
|
105
|
-
- `docs/guide/orchestration.md` - 計画 / 実行 / 委譲の関係
|
|
106
|
-
- `docs/reference/configuration.md` - 設定リファレンス
|
|
107
|
-
- `docs/reference/features.md` - 機能一覧
|
|
108
|
-
- `examples/README.md` - 設定例 / bundle 例
|
|
109
|
-
|
|
110
|
-
## 現在の既知の制限
|
|
111
|
-
|
|
112
|
-
- まだローカル優先であり、公開 npm リリース導線は完成していません
|
|
113
|
-
- 一部の二次文書にはまだ上流由来の用語が残っています
|
|
114
|
-
- ブラウザ系 MCP は、検索・ドキュメント系 MCP より環境依存が強いです
|
|
115
|
-
|
|
116
|
-
## 来歴
|
|
117
|
-
|
|
118
|
-
- Upstream: `https://github.com/code-yeongyu/oh-my-openagent`
|
|
119
|
-
- Current fork: `https://github.com/BOHUYESHAN-APB/openagent-labforge`
|
|
120
|
-
|
|
121
|
-
もし下位文書と実際の挙動が食い違う場合は、この README と
|
|
122
|
-
`docs/guide/installation.md` を優先してください。
|
|
123
|
-
|
|
124
|
-
## 他言語版
|
|
125
|
-
|
|
126
|
-
- [English](README.md)
|
|
127
|
-
- [简体中文](README.zh-cn.md)
|
|
128
|
-
- [日本語](README.ja.md)
|
|
129
|
-
- [한국어](README.ko.md)
|
|
130
|
-
- [Русский](README.ru.md)
|
|
1
|
+
# OpenAgent Labforge
|
|
2
|
+
|
|
3
|
+
> [!NOTE]
|
|
4
|
+
> **派生プロジェクトについて**
|
|
5
|
+
>
|
|
6
|
+
> OpenAgent Labforge は `code-yeongyu/oh-my-openagent`
|
|
7
|
+
> (旧 `oh-my-opencode`)の派生版です。
|
|
8
|
+
> このフォークでは、上流のライセンス境界と来歴を保ったまま、
|
|
9
|
+
> OpenCode ネイティブな委譲、研究ワークフロー、MCP の使い分け、
|
|
10
|
+
> ローカル優先の運用に重点を移しています。
|
|
11
|
+
>
|
|
12
|
+
> 来歴とライセンスは `LICENSE.md`、`NOTICE`、`THIRD_PARTY_NOTICES.md`、
|
|
13
|
+
> `docs/licensing.md` を参照してください。
|
|
14
|
+
|
|
15
|
+
## このフォークで現在強化されていること
|
|
16
|
+
|
|
17
|
+
この README は、上流の宣伝文や歴史ではなく、**今このプロジェクトが何を
|
|
18
|
+
できるか**に焦点を当てています。
|
|
19
|
+
|
|
20
|
+
### 1. Agent の役割分担が明確
|
|
21
|
+
|
|
22
|
+
- オーケストレーターと専門エージェントの境界を整理
|
|
23
|
+
- `task(subagent_type=...)` を OpenCode 上で確認可能な child session の正規経路として扱う
|
|
24
|
+
- 主な役割分担:
|
|
25
|
+
- `librarian` -> 単一ライブラリ / フレームワーク / SDK の調査
|
|
26
|
+
- `github-scout` -> リポジトリ比較と学習候補の抽出
|
|
27
|
+
- `tech-scout` -> エコシステム / ベンチマーク / リリース分析
|
|
28
|
+
- `article-writer` -> 公開向け技術文章
|
|
29
|
+
- `scientific-writer` -> 研究・査読向け技術文章
|
|
30
|
+
- バックグラウンド委譲時の fallback-chain 管理も強化済み
|
|
31
|
+
|
|
32
|
+
### 2. 検索フローを「精度」と「広さ」で分離
|
|
33
|
+
|
|
34
|
+
- `websearch` -> 精度重視の検索
|
|
35
|
+
- `open_websearch_mcp` -> 多エンジンによる広い再現率
|
|
36
|
+
- `paper_search_mcp` -> 学術検索
|
|
37
|
+
- `context7` -> 公式ドキュメント / フレームワーク参照
|
|
38
|
+
- `grep_app` -> GitHub コード例
|
|
39
|
+
|
|
40
|
+
検索/分析モードの注入プロンプトも軽量化されており、明示的に選んだ専門
|
|
41
|
+
エージェントを無理に再ルーティングしないようになっています。
|
|
42
|
+
|
|
43
|
+
### 3. MCP の実運用を安定化
|
|
44
|
+
|
|
45
|
+
- `bing_cn_mcp` は `open_websearch_mcp` に置き換え済み
|
|
46
|
+
- `open_websearch_mcp` は `environment`、stdio、prompt-probe 互換、
|
|
47
|
+
バージョン固定、起動タイムアウトを適切化
|
|
48
|
+
- `paper_search_mcp` は、この Windows/OpenCode 環境で実際に動いた
|
|
49
|
+
ランチャ経路へ戻しています
|
|
50
|
+
- 精密検索 / 広域検索 / 学術検索の分担が明確です
|
|
51
|
+
|
|
52
|
+
### 4. Skill 検出を OpenCode 寄りに調整
|
|
53
|
+
|
|
54
|
+
- プロジェクトローカル skill は git ルート方向へ探索
|
|
55
|
+
- `SKILL.md` メタデータをより厳密に検証
|
|
56
|
+
- インストーラが `openagent-labforge` skill ディレクトリを自動生成し、
|
|
57
|
+
プラグイン能力の発見を安定化
|
|
58
|
+
|
|
59
|
+
### 5. リリース面もフォーク実態に合わせて整理中
|
|
60
|
+
|
|
61
|
+
- ルート README は上流の宣伝コピーではなく、現行プロダクトの説明に変更
|
|
62
|
+
- インストーラ文言、パッケージメタデータ、schema メタデータも現行 fork に調整
|
|
63
|
+
- 現時点での推奨経路は **ローカル build + ローカル install**
|
|
64
|
+
|
|
65
|
+
## 現在の agent 構成
|
|
66
|
+
|
|
67
|
+
### 中核オーケストレーター
|
|
68
|
+
|
|
69
|
+
- `sisyphus`
|
|
70
|
+
- `hephaestus`
|
|
71
|
+
- `prometheus`
|
|
72
|
+
- `atlas`
|
|
73
|
+
- `sisyphus-junior`
|
|
74
|
+
|
|
75
|
+
### 専門エージェント
|
|
76
|
+
|
|
77
|
+
- `explore`
|
|
78
|
+
- `librarian`
|
|
79
|
+
- `github-scout`
|
|
80
|
+
- `tech-scout`
|
|
81
|
+
- `article-writer`
|
|
82
|
+
- `scientific-writer`
|
|
83
|
+
- 必要に応じて bio / multimodal 系 specialist
|
|
84
|
+
|
|
85
|
+
## 現在のインストール現実
|
|
86
|
+
|
|
87
|
+
現状は次の流れを前提にしています。
|
|
88
|
+
|
|
89
|
+
1. ローカル build
|
|
90
|
+
2. ローカル tgz を生成
|
|
91
|
+
3. OpenCode 設定ディレクトリ内のローカルプラグインを置き換える
|
|
92
|
+
|
|
93
|
+
```bash
|
|
94
|
+
bun run build:skills-catalog
|
|
95
|
+
bun run build
|
|
96
|
+
bun pm pack
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
詳細は `docs/guide/installation.md` を参照してください。
|
|
100
|
+
|
|
101
|
+
## ドキュメント入口
|
|
102
|
+
|
|
103
|
+
- `docs/guide/installation.md` - 現在のインストール / 置き換え手順
|
|
104
|
+
- `docs/guide/overview.md` - 現行プロダクト形態
|
|
105
|
+
- `docs/guide/orchestration.md` - 計画 / 実行 / 委譲の関係
|
|
106
|
+
- `docs/reference/configuration.md` - 設定リファレンス
|
|
107
|
+
- `docs/reference/features.md` - 機能一覧
|
|
108
|
+
- `examples/README.md` - 設定例 / bundle 例
|
|
109
|
+
|
|
110
|
+
## 現在の既知の制限
|
|
111
|
+
|
|
112
|
+
- まだローカル優先であり、公開 npm リリース導線は完成していません
|
|
113
|
+
- 一部の二次文書にはまだ上流由来の用語が残っています
|
|
114
|
+
- ブラウザ系 MCP は、検索・ドキュメント系 MCP より環境依存が強いです
|
|
115
|
+
|
|
116
|
+
## 来歴
|
|
117
|
+
|
|
118
|
+
- Upstream: `https://github.com/code-yeongyu/oh-my-openagent`
|
|
119
|
+
- Current fork: `https://github.com/BOHUYESHAN-APB/openagent-labforge`
|
|
120
|
+
|
|
121
|
+
もし下位文書と実際の挙動が食い違う場合は、この README と
|
|
122
|
+
`docs/guide/installation.md` を優先してください。
|
|
123
|
+
|
|
124
|
+
## 他言語版
|
|
125
|
+
|
|
126
|
+
- [English](README.md)
|
|
127
|
+
- [简体中文](README.zh-cn.md)
|
|
128
|
+
- [日本語](README.ja.md)
|
|
129
|
+
- [한국어](README.ko.md)
|
|
130
|
+
- [Русский](README.ru.md)
|
package/README.ko.md
CHANGED
|
@@ -1,128 +1,128 @@
|
|
|
1
|
-
# OpenAgent Labforge
|
|
2
|
-
|
|
3
|
-
> [!NOTE]
|
|
4
|
-
> **파생 프로젝트 안내**
|
|
5
|
-
>
|
|
6
|
-
> OpenAgent Labforge는 `code-yeongyu/oh-my-openagent`
|
|
7
|
-
> (구 `oh-my-opencode`)의 파생 버전입니다.
|
|
8
|
-
> 이 포크는 상위 프로젝트의 라이선스 경계와 출처를 유지하면서,
|
|
9
|
-
> OpenCode 네이티브 위임, 연구 워크플로우, MCP 사용성, 로컬 우선 운영에
|
|
10
|
-
> 더 집중하도록 방향을 바꿨습니다.
|
|
11
|
-
>
|
|
12
|
-
> 라이선스와 출처는 `LICENSE.md`, `NOTICE`, `THIRD_PARTY_NOTICES.md`,
|
|
13
|
-
> `docs/licensing.md`를 참고하세요.
|
|
14
|
-
|
|
15
|
-
## 이 포크에서 지금 달라진 점
|
|
16
|
-
|
|
17
|
-
이 README는 상위 프로젝트의 분위기나 마케팅 문구보다,
|
|
18
|
-
**현재 이 프로젝트가 실제로 무엇을 할 수 있는지**를 보여주는 데 집중합니다.
|
|
19
|
-
|
|
20
|
-
### 1. Agent 역할 분리가 더 명확해졌습니다
|
|
21
|
-
|
|
22
|
-
- 오케스트레이터와 전문 agent의 경계를 다시 정리했습니다
|
|
23
|
-
- `task(subagent_type=...)`를 OpenCode에서 확인 가능한 child session의 정식 경로로 봅니다
|
|
24
|
-
- 핵심 역할 분리:
|
|
25
|
-
- `librarian` -> 단일 라이브러리 / 프레임워크 / SDK 질문
|
|
26
|
-
- `github-scout` -> 저장소 비교, 학습 우선순위, 유지보수 신호
|
|
27
|
-
- `tech-scout` -> 생태계 / benchmark / 출시 흐름 분석
|
|
28
|
-
- `article-writer` -> 공개용 기술 글쓰기
|
|
29
|
-
- `scientific-writer` -> 연구 / 동료 검토 지향 글쓰기
|
|
30
|
-
- 백그라운드 child session의 fallback-chain 관리도 더 안정화했습니다
|
|
31
|
-
|
|
32
|
-
### 2. 검색 흐름을 “정밀도”와 “범위”로 분리했습니다
|
|
33
|
-
|
|
34
|
-
- `websearch` -> 더 정밀한 고품질 검색
|
|
35
|
-
- `open_websearch_mcp` -> 더 넓은 다중 엔진 검색
|
|
36
|
-
- `paper_search_mcp` -> 학술 검색
|
|
37
|
-
- `context7` -> 공식 문서 / 프레임워크 레퍼런스
|
|
38
|
-
- `grep_app` -> GitHub 코드 예시
|
|
39
|
-
|
|
40
|
-
검색/분석 모드의 주입 프롬프트도 더 가볍게 바꿨기 때문에,
|
|
41
|
-
이미 명시적으로 선택한 specialist agent를 다시 억지 라우팅하지 않습니다.
|
|
42
|
-
|
|
43
|
-
### 3. MCP 런타임 안정성을 높였습니다
|
|
44
|
-
|
|
45
|
-
- `bing_cn_mcp`는 `open_websearch_mcp`로 교체되었습니다
|
|
46
|
-
- `open_websearch_mcp`는 `environment`, stdio, prompt-probe 호환, 버전 고정,
|
|
47
|
-
시작 타임아웃까지 조정했습니다
|
|
48
|
-
- `paper_search_mcp`는 이 Windows/OpenCode 환경에서 실제로 작동한 경로로 되돌렸습니다
|
|
49
|
-
- 정밀 검색 / 광범위 검색 / 학술 검색 역할 분리가 명확해졌습니다
|
|
50
|
-
|
|
51
|
-
### 4. Skill 발견 로직을 OpenCode 쪽에 더 맞췄습니다
|
|
52
|
-
|
|
53
|
-
- 프로젝트 로컬 skill은 git 루트 방향으로 탐색합니다
|
|
54
|
-
- `SKILL.md` 메타데이터 검증을 더 엄격하게 했습니다
|
|
55
|
-
- 설치 시 `openagent-labforge` skill 디렉터리를 자동 생성해 플러그인 인식 안정성을 높였습니다
|
|
56
|
-
|
|
57
|
-
### 5. 릴리스 / 설치 표면도 현재 fork 실태에 맞게 정리 중입니다
|
|
58
|
-
|
|
59
|
-
- 루트 README는 더 이상 상위 프로젝트의 홍보 문서를 그대로 복사하지 않습니다
|
|
60
|
-
- 설치기 문구, 패키지 메타데이터, schema 메타데이터도 현재 fork 기준으로 조정했습니다
|
|
61
|
-
- 현재 권장 경로는 **로컬 build + 로컬 install** 입니다
|
|
62
|
-
|
|
63
|
-
## 현재 agent 구성
|
|
64
|
-
|
|
65
|
-
### 핵심 오케스트레이터
|
|
66
|
-
|
|
67
|
-
- `sisyphus`
|
|
68
|
-
- `hephaestus`
|
|
69
|
-
- `prometheus`
|
|
70
|
-
- `atlas`
|
|
71
|
-
- `sisyphus-junior`
|
|
72
|
-
|
|
73
|
-
### 전문 agent
|
|
74
|
-
|
|
75
|
-
- `explore`
|
|
76
|
-
- `librarian`
|
|
77
|
-
- `github-scout`
|
|
78
|
-
- `tech-scout`
|
|
79
|
-
- `article-writer`
|
|
80
|
-
- `scientific-writer`
|
|
81
|
-
- 필요 시 bio / multimodal specialist
|
|
82
|
-
|
|
83
|
-
## 현재 설치 현실
|
|
84
|
-
|
|
85
|
-
현재 프로젝트는 다음 흐름에 최적화되어 있습니다.
|
|
86
|
-
|
|
87
|
-
1. 로컬 build
|
|
88
|
-
2. 로컬 tgz 생성
|
|
89
|
-
3. OpenCode 설정 디렉터리 안의 로컬 플러그인 교체
|
|
90
|
-
|
|
91
|
-
```bash
|
|
92
|
-
bun run build:skills-catalog
|
|
93
|
-
bun run build
|
|
94
|
-
bun pm pack
|
|
95
|
-
```
|
|
96
|
-
|
|
97
|
-
자세한 절차는 `docs/guide/installation.md`를 보세요.
|
|
98
|
-
|
|
99
|
-
## 문서 입구
|
|
100
|
-
|
|
101
|
-
- `docs/guide/installation.md` - 현재 설치 / 교체 흐름
|
|
102
|
-
- `docs/guide/overview.md` - 현재 제품 형태
|
|
103
|
-
- `docs/guide/orchestration.md` - 계획 / 실행 / 위임 구조
|
|
104
|
-
- `docs/reference/configuration.md` - 설정 레퍼런스
|
|
105
|
-
- `docs/reference/features.md` - 기능 정리
|
|
106
|
-
- `examples/README.md` - 설정 예시 / bundle 예시
|
|
107
|
-
|
|
108
|
-
## 현재 알려진 제한
|
|
109
|
-
|
|
110
|
-
- 아직은 로컬 우선이며, 공개 npm 릴리스 흐름은 완전히 정리되지 않았습니다
|
|
111
|
-
- 일부 하위 문서에는 아직 상위 프로젝트 용어가 남아 있습니다
|
|
112
|
-
- 브라우저 계열 MCP는 검색/문서/코드 계열 MCP보다 환경 민감도가 높습니다
|
|
113
|
-
|
|
114
|
-
## 출처
|
|
115
|
-
|
|
116
|
-
- Upstream: `https://github.com/code-yeongyu/oh-my-openagent`
|
|
117
|
-
- Current fork: `https://github.com/BOHUYESHAN-APB/openagent-labforge`
|
|
118
|
-
|
|
119
|
-
하위 문서와 실제 동작이 충돌하면, 이 README와
|
|
120
|
-
`docs/guide/installation.md`를 우선 기준으로 보세요.
|
|
121
|
-
|
|
122
|
-
## 다른 언어 버전
|
|
123
|
-
|
|
124
|
-
- [English](README.md)
|
|
125
|
-
- [简体中文](README.zh-cn.md)
|
|
126
|
-
- [日本語](README.ja.md)
|
|
127
|
-
- [한국어](README.ko.md)
|
|
128
|
-
- [Русский](README.ru.md)
|
|
1
|
+
# OpenAgent Labforge
|
|
2
|
+
|
|
3
|
+
> [!NOTE]
|
|
4
|
+
> **파생 프로젝트 안내**
|
|
5
|
+
>
|
|
6
|
+
> OpenAgent Labforge는 `code-yeongyu/oh-my-openagent`
|
|
7
|
+
> (구 `oh-my-opencode`)의 파생 버전입니다.
|
|
8
|
+
> 이 포크는 상위 프로젝트의 라이선스 경계와 출처를 유지하면서,
|
|
9
|
+
> OpenCode 네이티브 위임, 연구 워크플로우, MCP 사용성, 로컬 우선 운영에
|
|
10
|
+
> 더 집중하도록 방향을 바꿨습니다.
|
|
11
|
+
>
|
|
12
|
+
> 라이선스와 출처는 `LICENSE.md`, `NOTICE`, `THIRD_PARTY_NOTICES.md`,
|
|
13
|
+
> `docs/licensing.md`를 참고하세요.
|
|
14
|
+
|
|
15
|
+
## 이 포크에서 지금 달라진 점
|
|
16
|
+
|
|
17
|
+
이 README는 상위 프로젝트의 분위기나 마케팅 문구보다,
|
|
18
|
+
**현재 이 프로젝트가 실제로 무엇을 할 수 있는지**를 보여주는 데 집중합니다.
|
|
19
|
+
|
|
20
|
+
### 1. Agent 역할 분리가 더 명확해졌습니다
|
|
21
|
+
|
|
22
|
+
- 오케스트레이터와 전문 agent의 경계를 다시 정리했습니다
|
|
23
|
+
- `task(subagent_type=...)`를 OpenCode에서 확인 가능한 child session의 정식 경로로 봅니다
|
|
24
|
+
- 핵심 역할 분리:
|
|
25
|
+
- `librarian` -> 단일 라이브러리 / 프레임워크 / SDK 질문
|
|
26
|
+
- `github-scout` -> 저장소 비교, 학습 우선순위, 유지보수 신호
|
|
27
|
+
- `tech-scout` -> 생태계 / benchmark / 출시 흐름 분석
|
|
28
|
+
- `article-writer` -> 공개용 기술 글쓰기
|
|
29
|
+
- `scientific-writer` -> 연구 / 동료 검토 지향 글쓰기
|
|
30
|
+
- 백그라운드 child session의 fallback-chain 관리도 더 안정화했습니다
|
|
31
|
+
|
|
32
|
+
### 2. 검색 흐름을 “정밀도”와 “범위”로 분리했습니다
|
|
33
|
+
|
|
34
|
+
- `websearch` -> 더 정밀한 고품질 검색
|
|
35
|
+
- `open_websearch_mcp` -> 더 넓은 다중 엔진 검색
|
|
36
|
+
- `paper_search_mcp` -> 학술 검색
|
|
37
|
+
- `context7` -> 공식 문서 / 프레임워크 레퍼런스
|
|
38
|
+
- `grep_app` -> GitHub 코드 예시
|
|
39
|
+
|
|
40
|
+
검색/분석 모드의 주입 프롬프트도 더 가볍게 바꿨기 때문에,
|
|
41
|
+
이미 명시적으로 선택한 specialist agent를 다시 억지 라우팅하지 않습니다.
|
|
42
|
+
|
|
43
|
+
### 3. MCP 런타임 안정성을 높였습니다
|
|
44
|
+
|
|
45
|
+
- `bing_cn_mcp`는 `open_websearch_mcp`로 교체되었습니다
|
|
46
|
+
- `open_websearch_mcp`는 `environment`, stdio, prompt-probe 호환, 버전 고정,
|
|
47
|
+
시작 타임아웃까지 조정했습니다
|
|
48
|
+
- `paper_search_mcp`는 이 Windows/OpenCode 환경에서 실제로 작동한 경로로 되돌렸습니다
|
|
49
|
+
- 정밀 검색 / 광범위 검색 / 학술 검색 역할 분리가 명확해졌습니다
|
|
50
|
+
|
|
51
|
+
### 4. Skill 발견 로직을 OpenCode 쪽에 더 맞췄습니다
|
|
52
|
+
|
|
53
|
+
- 프로젝트 로컬 skill은 git 루트 방향으로 탐색합니다
|
|
54
|
+
- `SKILL.md` 메타데이터 검증을 더 엄격하게 했습니다
|
|
55
|
+
- 설치 시 `openagent-labforge` skill 디렉터리를 자동 생성해 플러그인 인식 안정성을 높였습니다
|
|
56
|
+
|
|
57
|
+
### 5. 릴리스 / 설치 표면도 현재 fork 실태에 맞게 정리 중입니다
|
|
58
|
+
|
|
59
|
+
- 루트 README는 더 이상 상위 프로젝트의 홍보 문서를 그대로 복사하지 않습니다
|
|
60
|
+
- 설치기 문구, 패키지 메타데이터, schema 메타데이터도 현재 fork 기준으로 조정했습니다
|
|
61
|
+
- 현재 권장 경로는 **로컬 build + 로컬 install** 입니다
|
|
62
|
+
|
|
63
|
+
## 현재 agent 구성
|
|
64
|
+
|
|
65
|
+
### 핵심 오케스트레이터
|
|
66
|
+
|
|
67
|
+
- `sisyphus`
|
|
68
|
+
- `hephaestus`
|
|
69
|
+
- `prometheus`
|
|
70
|
+
- `atlas`
|
|
71
|
+
- `sisyphus-junior`
|
|
72
|
+
|
|
73
|
+
### 전문 agent
|
|
74
|
+
|
|
75
|
+
- `explore`
|
|
76
|
+
- `librarian`
|
|
77
|
+
- `github-scout`
|
|
78
|
+
- `tech-scout`
|
|
79
|
+
- `article-writer`
|
|
80
|
+
- `scientific-writer`
|
|
81
|
+
- 필요 시 bio / multimodal specialist
|
|
82
|
+
|
|
83
|
+
## 현재 설치 현실
|
|
84
|
+
|
|
85
|
+
현재 프로젝트는 다음 흐름에 최적화되어 있습니다.
|
|
86
|
+
|
|
87
|
+
1. 로컬 build
|
|
88
|
+
2. 로컬 tgz 생성
|
|
89
|
+
3. OpenCode 설정 디렉터리 안의 로컬 플러그인 교체
|
|
90
|
+
|
|
91
|
+
```bash
|
|
92
|
+
bun run build:skills-catalog
|
|
93
|
+
bun run build
|
|
94
|
+
bun pm pack
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
자세한 절차는 `docs/guide/installation.md`를 보세요.
|
|
98
|
+
|
|
99
|
+
## 문서 입구
|
|
100
|
+
|
|
101
|
+
- `docs/guide/installation.md` - 현재 설치 / 교체 흐름
|
|
102
|
+
- `docs/guide/overview.md` - 현재 제품 형태
|
|
103
|
+
- `docs/guide/orchestration.md` - 계획 / 실행 / 위임 구조
|
|
104
|
+
- `docs/reference/configuration.md` - 설정 레퍼런스
|
|
105
|
+
- `docs/reference/features.md` - 기능 정리
|
|
106
|
+
- `examples/README.md` - 설정 예시 / bundle 예시
|
|
107
|
+
|
|
108
|
+
## 현재 알려진 제한
|
|
109
|
+
|
|
110
|
+
- 아직은 로컬 우선이며, 공개 npm 릴리스 흐름은 완전히 정리되지 않았습니다
|
|
111
|
+
- 일부 하위 문서에는 아직 상위 프로젝트 용어가 남아 있습니다
|
|
112
|
+
- 브라우저 계열 MCP는 검색/문서/코드 계열 MCP보다 환경 민감도가 높습니다
|
|
113
|
+
|
|
114
|
+
## 출처
|
|
115
|
+
|
|
116
|
+
- Upstream: `https://github.com/code-yeongyu/oh-my-openagent`
|
|
117
|
+
- Current fork: `https://github.com/BOHUYESHAN-APB/openagent-labforge`
|
|
118
|
+
|
|
119
|
+
하위 문서와 실제 동작이 충돌하면, 이 README와
|
|
120
|
+
`docs/guide/installation.md`를 우선 기준으로 보세요.
|
|
121
|
+
|
|
122
|
+
## 다른 언어 버전
|
|
123
|
+
|
|
124
|
+
- [English](README.md)
|
|
125
|
+
- [简体中文](README.zh-cn.md)
|
|
126
|
+
- [日本語](README.ja.md)
|
|
127
|
+
- [한국어](README.ko.md)
|
|
128
|
+
- [Русский](README.ru.md)
|