docs: add an explainer for the boundaries between prompts, plugins/skills, custom scripts, and agent execution

オープン
#1,026 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

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

まだ誰も着手していません。

評価

難易度
4/5
見積もり時間
3〜5日
初心者へのやさしさ
48/100
issue の種類
ドキュメント
明瞭さ
明確に書かれている
活発さ
活発
技術スタック
markdown
領域
documentation

調査の方向性

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 の本文から書いたものです。

説明

priority:medium
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 ファイルなし
  • プルリクエストのテンプレートあり
  • コントリビューションガイドなし

はじめの一歩

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

OpenHands/docs のほかの issue

OpenHands/docs の issue をすべて見る

似ている issue

Documentation の issue をもっと見る

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

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