appbuilder-workfront — скилл для Claude Code
Скилл appbuilder-workfront для Claude Code направляет этапы создания UI-расширения Workfront на Adobe App Builder к скиллам по фронтенду, серверным функциям и тестированию.
Apache-2.0 245 установок ★ 335 обновлён 2026-10-24
npx skills add adobe/skills --skill appbuilder-workfront -a claude-codeЧто делает appbuilder-workfront
Скилл объясняет, как собрать расширение интерфейса Workfront из React-SPA на фронте и Runtime-действий на бэке. Вместо инструкций по коду даёт карту: что делается на каждом шаге (настройка, скаффолдинг, сборка, деплой, публикация) и какой дочерний скилл за это отвечает. workfront-ui-extension отвечает за экраны и extension points (главное меню, панель слева, виджеты в формах), workfront-actions — за серверные функции и вызовы Workfront Public API v21, workfront-local-testing — за запуск внутри Workfront через extensionOverride или Extension Manager.
Нужен Node 20, @adobe/aio-cli и вход в IMS-организацию. Шаблон проекта — @adobe/workfront-ui-ext-tpl. Браузер не вызывает API Adobe напрямую: токены остаются на сервере, авторизация течёт через sharedContext, который передаёт подписанного пользователя и хост инстанса.
Берите, когда пользователь спрашивает, с чего начать, как устроен процесс целиком или как связаны фронт, бэк и точки интеграции. Если задача уже конкретная — переходите сразу к соответствующему дочернему скиллу.
Какие задачи решает
- построить маршрут от идеи расширения Workfront до публикации приложения
- понять, какой скилл отвечает за фронтенд, какой — за серверные функции
- настроить окружение для Adobe App Builder с Node 20 и
aio-cli - выбрать extension point и шаблон для
aio app init
Примеры запросов агенту
- Объясни, как собрать расширение для Workfront на App Builder
- Какой скилл нужен для Runtime-действий в проекте Workfront?
- С чего начать проект UI-расширения для Workfront — дай roadmap
Как установить appbuilder-workfront
1Через Skills CLI (Vercel)
npx skills add adobe/skills --skill appbuilder-workfront -a claude-code2Вручную: положить файлы
~/.claude/skills/appbuilder-workfront/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/appbuilder-workfront/
1Через Skills CLI (Vercel)
npx skills add adobe/skills --skill appbuilder-workfront -a codex2Вручную: положить файлы
.agents/skills/appbuilder-workfront/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add adobe/skills --skill appbuilder-workfront -a cursor2Вручную: положить файлы
.cursor/skills/appbuilder-workfront/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install adobe/skills plugins/app-builder/skills/appbuilder-workfront2Вручную: положить файлы
.github/skills/appbuilder-workfront/SKILL.md1Через Skills CLI (Vercel)
npx skills add adobe/skills --skill appbuilder-workfront -a gemini-cli2Командой платформы
gemini skills install https://github.com/adobe/skills --path plugins/app-builder/skills/appbuilder-workfrontВручную: положить файлы
.devin/skills/appbuilder-workfront/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add adobe/skills --skill appbuilder-workfront -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об appbuilder-workfront
Как установить appbuilder-workfront в Claude Code?
Выполните npx skills add adobe/skills --skill appbuilder-workfront -a claude-code, затем откройте ~/.claude/skills/appbuilder-workfront/SKILL.md.
Что делает appbuilder-workfront?
Маршрутизирует этапы разработки UI-расширений Workfront к узким скиллам: workfront-ui-extension для фронтенда, workfront-actions для бэка, workfront-local-testing для проверки в браузере. Даёт общую карту процесса от настройки до публикации.
Какие дочерние скиллы вызывает appbuilder-workfront?
Фронтенд и extension points — workfront-ui-extension, серверные Runtime-действия и вызовы Workfront API — workfront-actions, локальное тестирование — workfront-local-testing, инициализация проекта — appbuilder-project-init.
Исходный текст
SKILL.md · Apache-2.0
---
name: appbuilder-workfront
description: "Use when orienting, onboarding, or planning before a concrete task — the entry point for building a customized Workfront UI on Adobe App Builder. Reach for this whenever the user is: brand new to Workfront UI extensions and asking where to start or what the process looks like; describing a Workfront customization idea and asking how to build it; asking for the end-to-end roadmap (set up → scaffold → build → test → deploy → publish); or asking how the React/Spectrum SPA, the serverless Runtime actions, and the Workfront extension points fit together. This umbrella routes each stage to its skill: workfront-ui-extension (front-end SPA + extension points), workfront-actions (Runtime actions + Workfront Public API v21), workfront-local-testing (previewing a build inside Workfront); machine setup and aio app init live in appbuilder-project-init. Skip it and go straight to the matching sub-skill when the user already has one specific task."
license: Apache-2.0
---
# Workfront UI extensions on App Builder
A customized Workfront UI, built as an **App Builder** app. It has two halves:
- a **front end** — the screens the user sees. Built with React/Spectrum (Adobe's UI toolkit); in App Builder terms it's the **SPA** ("single-page app"). → `workfront-ui-extension`
- a **back end** — small functions that run in Adobe's cloud (**Runtime actions**; "serverless" = you write the function, Adobe runs it, no server to manage). They hold the credentials and call the Workfront / Planning / Adobe APIs. → `workfront-actions`
The front end plugs into Workfront at fixed spots called **extension points**: a **Main Menu** button, an item in an object's **left panel**, or a **widget** embedded inside a custom form.
## End-to-end flow → which skill
| Step | What you do | Skill |
|------|-------------|-------|
| 0–1. Set up + create project | Node 20, install `@adobe/aio-cli`, `aio login`, pick IMS org, stage vs prod, **create the project** (Developer Console or `aio console project create`) | `appbuilder-project-init` |
| 2. Scaffold | `aio app init` with template **`@adobe/workfront-ui-ext-tpl`**; pick extension points | `appbuilder-project-init` + this skill's `references/commands.md` |
| 3. Build front end | Extension points (Main Menu, `secondaryNav`, widgets), routing, shared context, `actionWebInvoke` | `workfront-ui-extension` |
| 4. Build back end | Action anatomy, config, auth, inputs; call Workfront (Public API v21) / Planning / services | `workfront-actions` |
| 5. Run + test in Workfront | `aio app dev`, then `extensionOverride` (local build) or **Extension Manager / BYO** (deployed app, no publish) | `workfront-local-testing` |
| 6. Deploy | `aio app deploy` | `references/commands.md` |
| 7. Publish (org-wide) | Submit for approval from the **Production** workspace; make sure Production has every API/service your actions need. Not required for BYO/override testing. | — (see below) |
> **Publishing** makes the app available to everyone in the IMS org without an `extensionOverride`. Deploy from the **Production** workspace (`aio app deploy`), then submit for approval in the Developer Console / App Builder distribution UI (guide: `https://developer.adobe.com/uix/docs/guides/publication/`). To use a deployed app in one org **without** approval, register its URL in Workfront's **Extension Manager (Bring Your Own extension)** instead — see `workfront-local-testing`. After deploy, the app's **direct link** is the Experience Cloud shell URL `…/workfront/custom-applications/<extensionId>/<menuRoute>` (not the bare CDN) — build and hand it over per `workfront-local-testing`.
> **Hit a wall?** A symptom → cause → fix table of the real gotchas (Node/`aio` errors, the Main Menu `id` trap, `401 Org Id undefined`, BYO testing, and more) is in [`references/troubleshooting.md`](references/troubleshooting.md). The full `aio` command catalog is in [`references/commands.md`](references/commands.md).
## Plain-language glossary
| Term | In plain words |
|------|----------------|
| SPA / front end | The app screens the user sees inside Workfront. |
| Runtime action / "serverless" | A small function in Adobe's cloud that does the real work (fetching/saving data) and keeps credentials off the user's browser. |
| Extension point | A spot where your app appears in Workfront: the Main Menu, an object's left panel, or a custom-form widget. |
| Shared context | Info Workfront hands the app automatically — who's signed in, which object they're on, the instance URL. |
| `actionWebInvoke` | How the front end calls a back-end action. |
| IMS org | Your Adobe organization (identity / login). |
| Developer Console / workspace | Adobe's web admin where the project and its Production / Stage environments live. |
| Layout template | The Workfront admin setting that decides where an app actually shows up for users. |
## Invariants for the whole family
- **Auth comes from `sharedContext`** (`imsToken`, hostname) — Workfront hands the app the signed-in user and instance, so **never build a custom login**.
- **The browser never calls Workfront/Adobe APIs directly** — always through a Runtime action via `actionWebInvoke`, so login tokens stay on the server. (The IMS org id is already in `sharedContext` at `auth.imsOrgID` — no WF call needed.)
- Actions are **CommonJS** (`exports.main`; not ESM); secrets/inputs flow `.env` → action `inputs` → `params`, and are **never** read from `process.env` at runtime.
- Node **20**. The default environment is **prod** (live); targeting **stage** (test) needs `AIO_CLI_ENV=stage` plus a re-login.
- Workfront Public API is **v21.0**; custom `DE:` fields need `{field}_Mod=notblank` on search/count.
© adobe · Apache-2.0 · adobe/skills