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

未关闭
#1,026 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

难度
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 小时
30 天内合并 PR
80

环境准备

  • 没有 Dockerfile 或 Docker Compose 文件
  • 有 Pull Request 模板
  • 没有贡献指南

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

OpenHands/docs 的其他 Issue

查看 OpenHands/docs 的全部 Issue

相似的 Issue

更多 Documentation Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。