docs: add an explainer for the boundaries between prompts, plugins/skills, custom scripts, and agent execution
维护者通常 1 天内回复
还没有人认领这个 Issue。
评估
- 难度
- 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 小时
- 30 天内合并 PR
- 80
环境准备
- 没有 Dockerfile 或 Docker Compose 文件
- 有 Pull Request 模板
- 没有贡献指南
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 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
维护者通常 1 天内回复
相似的 Issue
-
难度 1/5 1 小时以内 新手友好度 85/100
-
难度 1/5 1 小时以内 新手友好度 90/100
ethereum/execution-apis#1017 ·
维护者通常 3 天内回复
-
[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 小时 新手友好度 72/100
pearu/agent-sandbox#451 ·
维护者通常 1 天内回复