Hacktoberfest 2026:メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

docs/config: subagent_depth defaults to 1 and is undocumented, so subagents can't delegate

オープン 初心者向け
#59,826 コメント 1 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

@nateEc がすでに取り組んでいます。

2026年10月28日 から。

  • #59905 @nateEc による — オープン

評価

難易度
2/5
見積もり時間
1〜3時間
初心者へのやさしさ
65/100
issue の種類
ドキュメント
明瞭さ
おおむね明確
活発さ
活発
技術スタック
typescript

調査の方向性

V2 agents と config のドキュメントページから始め、issue によると設定が記載されている唯一の場所である config schema で experimental.subagent_depth を検索してください。デフォルト値と、ネストされた委譲の深さを設定する方法を説明してください。ユーザーが V2 ドキュメントでこの説明を見つけられるようになれば完了です。issue ではドキュメントのファイルパスやテストは指定されていません。

索引モデルが issue の本文から書いたものです。

説明

Summary

experimental.subagent_depth defaults to 1 in 2.1.4, so a subagent cannot spawn another subagent ("Subagent depth limit reached (1)"). The default and the setting are not mentioned in the V2 docs (agents / config pages), so agent designs that delegate one level down (for example a coder subagent spawning explore) fail with no documented fix.

Environment

  • opencode version: 2.1.4
  • OS: Darwin 25.6.0 (darwin arm64); also Linux
  • Install/channel: latest (official installer)
  • Active plugins: not required to reproduce

Reproduction

  1. Define a subagent coder whose permissions allow subagent on explore.
  2. From the main session, spawn coder and ask it to delegate a search to explore.

Expected Behavior

Either a documented default and setting, or a default that allows at least one nested level (common pattern: main → specialist → explore).

Actual Behavior

The nested spawn fails with Subagent depth limit reached (1). Setting experimental.subagent_depth: 3 in opencode.json fixes it; the only place we found the setting was the config schema.

Additional Context

Related closed issues on depth-2 behaviour: #49342, #39112.

主要言語
TypeScript
スター
221k
フォーク
29.6k
平均マージ
5時間 32分
マージ済み PR(30日)
492

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

anomalyco/opencode のほかの issue

anomalyco/opencode の issue をすべて見る

似ている issue

TypeScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。