docs: add an explainer for the boundaries between prompts, plugins/skills, custom scripts, and agent execution
メンテナーはふだん 1 日以内に返信
まだ誰も着手していません。
評価
- 難易度
- 4/5
- 見積もり時間
- 3〜5日
- 初心者へのやさしさ
- 48/100
- issue の種類
- ドキュメント
- 明瞭さ
- 明確に書かれている
- 活発さ
- 活発
- 技術スタック
- markdown
調査の方向性
Start by reading the Automations Overview and Agent Canvas managing-automations pages, then compare their terminology with extensions#816 and OpenHands#16412. Draft a comparison and decision table covering prompts, plugin-based and plugin-spec automations, custom scripts, skills, and agent execution. Done means the new page or section is cross-linked from both docs pages and uses taxonomy consistent with extensions#816.
索引モデルが issue の本文から書いたものです。
説明
Problem or Motivation
A user interview with a CTO and self-described power user showed they struggled to understand the boundaries between prompts, plugins/skills, custom scripts, and agent execution — even while evaluating automations in Agent Canvas. The concepts are each documented somewhere, but no page explains when to use which and how they compose.
Desired Behavior
Add a single docs page (Agent Canvas > Automations, or a concepts page) that explains, at a glance:
- Prompt-based automations — natural-language scheduled tasks; best for reports, monitoring, one-off LLM work.
- Plugin-based automations / plugin presets — automations that bundle plugins providing skills or capabilities; the extensions catalog path.
- Plugin-spec automations — reusable, code-backed, deterministic automations packaged as executable plugins (being documented in OpenHands/extensions#816 / PR #794).
- Custom scripts (
.automation.json/ tarball presets) — full packaging control and SDK lifecycle. - Skills vs plugins — what each is, where they live (scopes), and how they relate to automations and agent execution.
Include a comparison/decision table (similar in spirit to AmpCode's skills-locations table referenced in OpenHands/OpenHands#16412) and link it from:
- The Automations Overview page
- The Automations dashboard "Learn more" target
- OpenHands/OpenHands#16412's skills/plugins clarity work
Acceptance Criteria
- A new page (or clearly marked section) explaining the boundaries and when to use each.
- Cross-linked from the Automations docs and the Agent Canvas managing-automations page.
- Reviewed for consistency with extensions#816's plugin-spec documentation (same taxonomy, not competing ones).
References
- OpenHands/OpenHands#16412 (skills & plugins scopes consistency)
- OpenHands/extensions#816 (plugin-spec docs)
- OpenHands/OpenHands#16571 (SDLC automations guide)
This issue was created by an AI agent (OpenHands) on behalf of Graham Neubig.
- 主要言語
- MDX
- スター
- 19
- フォーク
- 104
- 平均マージ
- 2日 12時間
- マージ済み PR(30日)
- 80
環境構築
- Dockerfile・Docker Compose ファイルなし
- プルリクエストのテンプレートあり
- コントリビューションガイドなし
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
OpenHands/docs のほかの issue
-
docs: document FORGEJO_BASE_URL (self-hosted Forgejo host for the backend integration)対応中かも @remote-controlled-man が 18 日前に担当しました。 オープン
難易度 1/5 1時間未満 初心者へのやさしさ 85/100
メンテナーはふだん 1 日以内に返信
-
docs(sdk): custom-tools 'register_tool' example passes a factory function, which raises TypeErrorオープン
難易度 2/5 1〜3時間 初心者へのやさしさ 62/100
メンテナーはふだん 1 日以内に返信
-
難易度 1/5 1〜3時間 初心者へのやさしさ 83/100
メンテナーはふだん 1 日以内に返信
-
Docs: Child Conversations incorrectly implies the child's result is returned to the parent対応中かも @sahithib20 が 36 日前に担当しました。 オープン
難易度 2/5 1〜3時間 初心者へのやさしさ 82/100
メンテナーはふだん 1 日以内に返信
-
enhancement
難易度 2/5 1〜3時間 初心者へのやさしさ 68/100
OpenHands/docs#658 · コメント 2 件 ·
メンテナーはふだん 1 日以内に返信
似ている issue
-
[Docs] CONTRIBUTING points the Backend Remake milestone at a branch that does not exist対応中かも @franpts2 が今日担当しました。 オープンdocs
難易度 1/5 1時間未満 初心者へのやさしさ 90/100
メンテナーはふだん 3 日以内に返信
-
postgresql-rules / queue-rules: implicit KEY SHARE before a parent key update, and job self-overlapオープン
難易度 2/5 1〜3時間 初心者へのやさしさ 82/100
jonathanong/no-mistakes#3879 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 84/100
cloudflare/nimbus#423 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 70/100
NYCPlanning/data-engineering#2996 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 82/100
メンテナーはふだん 2 日以内に返信