К основному содержанию
скилл CX Codex

forge-app-review — скилл для Claude Code: что делает и как установить

Скилл forge-app-review для Claude Code проводит аудит приложений Atlassian Forge перед релизом. Запускается по запросам на ревью манифеста, проверку готовности к деплою или общее качество кода.

Apache-2.0 542 установок ★ 33 обновлён 2026-10-20

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add atlassian/forge-skills --skill forge-app-review -a claude-code
Открыть на GitHub

Что делает forge-app-review

Скилл проверяет готовность приложения Atlassian Forge к публикации без изменения исходных файлов. Он сверяет manifest.yml и package.json, контролирует привязку модулей, ресурсов и обработчиков, а также сопоставляет имена резолверов на бэкенде с вызовами во фронтенде UI Kit или Custom UI.

В проверку входят базовые риски: отсутствие сетевых разрешений egress для внешних вызовов, избыточные скоупы, вызовы api.asApp() без проверок прав и хардкод секретов. Если в манифесте объявлен модуль graph:connector или подключён @forge/teamwork-graph, аудит задействует отдельный чеклист коннекторов.

Глубокий анализ безопасности, профилирование расходов и отладку упавших сборок скилл не выполняет, направляя такие задачи специализированным инструментам вроде forge-security-review, forge-cost-optimizer или forge-debugger.

Какие задачи решает

  • найти несоответствия между резолверами бэкенда и вызовами во фронтенде
  • проверить manifest.yml на отсутствующие обработчики и пути ресурсов
  • выявить нехватку сетевых разрешений egress и скоупов перед деплоем
  • обнаружить явные антипаттерны в логировании и обращении к хранилищу

Примеры запросов агенту

  • Проверь readiness моего Forge-приложения перед релизом
  • Сделай pre-deploy check для текущего манифеста Forge
  • Посмотри manifest.yml и зависимости, готово ли приложение к деплою

Как установить forge-app-review

1Через Skills CLI (Vercel)

npx skills add atlassian/forge-skills --skill forge-app-review -a claude-code

2Вручную: положить файлы

~/.claude/skills/forge-app-review/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/forge-app-review/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о forge-app-review

Как установить forge-app-review в Claude Code?

Выполните команду npx skills add atlassian/forge-skills --skill forge-app-review -a claude-code. Файл навыка сохранится по пути ~/.claude/skills/forge-app-review/SKILL.md.

Что делает forge-app-review?

Проводит первичную ревизию Forge-проекта: валидирует связи модулей в манифесте, настройки среды, вызовы API, фронтенд-мосты и базовые требования к надёжности перед деплоем.

Заменяет ли этот скилл аудит безопасности Forge?

Нет. Для детального SAST-анализа, изоляции данных и проверки уязвимостей документация скилла предписывает переходить к forge-security-review.

Исходный текст

SKILL.md · Apache-2.0
---
name: forge-app-review
description: >
  Performs a lightweight pre-release readiness review of Atlassian Forge apps across manifest/module wiring,
  architecture, runtime compatibility, dependency posture, tests, deploy readiness, and obvious security,
  cost, or reliability smells. Use when the user asks "review my Forge app", "pre-deploy check",
  "is this app ready to ship", "review manifest", "general app review", "release readiness", or asks for a
  broad quality pass. Do not use for deep security audits/SAST/exploitability review, cost optimization,
  or diagnosing a known broken app; route those to forge-security-review, forge-cost-optimizer, or
  forge-debugger respectively.
---

# Forge App Review

Run a general Forge release-readiness review. This skill is the front door for broad app review, not a replacement for specialist security, cost, or debugging skills.

## Boundaries

Use this skill for:

- Pre-deploy and release-readiness checks.
- General architecture and maintainability review.
- Manifest/module/resource/function wiring.
- Runtime, dependency, package, and script sanity checks.
- Basic tests/deploy readiness and operational hygiene.
- Obvious security, cost, or reliability smells that should trigger a deeper specialist pass.

Use another skill instead when the user's primary intent is:

- Deep security audit, SAST, authz, secrets, tenant isolation, exploitability, or CVSS reporting -> `forge-security-review`.
- Cost optimization, invocations, GB-seconds, storage/log volume, trigger frequency, or memory tuning -> `forge-cost-optimizer`.
- A known failure, error message, blank UI, failed deploy/install, broken resolver, missing app, or logs/tunnel diagnosis -> `forge-debugger`.

If a broad review finds a deep security/cost/debug concern, include it as a handoff recommendation rather than duplicating the specialist workflow.

## Review Rules

- Audit first. Do not modify app files unless the user explicitly asks to apply fixes.
- Read the codebase before making claims.
- Prefer concrete file/line evidence.
- Keep findings focused on bugs, release blockers, meaningful risks, and missing validation.
- Do not run full SAST or cost tooling from this skill. Recommend the specialist skill when warranted.
- Do not report speculative security or cost observations as confirmed vulnerabilities or savings.

## Module & Capability Routing
Detect modules declared in `manifest.yml` or package dependencies, and load specific review guides:

- **Teamwork Graph / Forge Connectors:**
  - If the app declares `graph:connector`, `teamwork-graph-connector`, or imports `@forge/teamwork-graph`:
  - 👉 **Follow and evaluate against [`./modules/connector-review.md`](./modules/connector-review.md)**.

---

## Workflow

1. Read `manifest.yml` or `manifest.yaml`.
   - Identify modules, resources, functions, resolver bindings, triggers, web triggers, remotes, permissions, runtime, and memory settings.
   - Verify referenced handlers/resources exist.
2. Read `package.json`.
   - Check Forge package fit, scripts, runtime assumptions, direct dependencies, and obvious unused/missing packages.
3. Inspect source files.
   - Backend/resolvers: `resolver.define`, handler exports, product API calls, storage usage, external fetches, logging, error handling.
   - Frontend: UI Kit or Custom UI resource entry points, `invoke()` patterns, bridge usage, loading/error states.
4. Inspect tests and project docs when present.
   - Note missing tests only when behavior risk justifies it.
5. Produce a prioritized readiness report.

## What To Check

### Release Blockers

- Manifest references a missing handler, resource path, or module key.
- Resolver names called by the frontend do not match `resolver.define()` names.
- Required scopes or egress permissions are missing for actual API/fetch usage.
- Runtime, package versions, or module syntax likely fail `forge lint`, build, deploy, or install.
- App has no clear way to exercise its primary user flow.

### Architecture And Maintainability

- Module type matches the intended UX surface.
- Resolver boundaries are coherent and not overly monolithic for the app size.
- Sensitive or privileged logic stays backend-side.
- UI-only formatting/transforms are not unnecessarily forced through backend functions.
- Error handling is sufficient for user-facing workflows.
- Code organization matches existing project style.

### Lightweight Security Signals

Only flag obvious signals and recommend `forge-security-review` for deep validation:

- Broad/write/admin scopes without visible usage.
- `api.asApp()` in user-triggered resolvers without obvious authorization checks.
- Hardcoded credentials or token-like literals.
- External fetches without manifest egress entries.
- Web triggers without visible authentication strategy.
- Full payload/request logging that may expose user, tenant, or secret data.

### Lightweight Cost Signals

Only flag obvious signals and recommend `forge-cost-optimizer` for deep analysis:

- Resolver invoked only to return static data or product context.
- Multiple independent `invoke()` calls on page load.
- Scheduled triggers that look like broad polling.
- Product triggers without filters or `ignoreSelf` where applicable.
- Full payload/API response logging in hot paths.
- Storage writes on every invocation.

### Lightweight Debuggability Signals

Only flag readiness gaps; use `forge-debugger` when there is an observed failure:

- Missing loading/error states around async UI paths.
- Logs are either too noisy or absent around important failures.
- README or scripts do not explain how to lint/build/deploy/test.
- App has no obvious local verification command besides `forge lint`.

## Output Format

Return a concise Markdown report. **Findings must be a table** (not a numbered list). Include a **Source** column for every finding so the reader knows which review guide or area produced it.

**Source values** (use the most specific that applies — Source is the **checklist/module or review area**, not merely the file type):

- `manifest` — general Forge manifest wiring, scopes, egress, or module keys **not** covered by a module-specific guide
- `resolver` — backend/resolver wiring and runtime behavior
- `frontend` — UI Kit / Custom UI invoke and bridge patterns
- `dependencies` — `package.json` / runtime package fit
- `tests` — missing or inadequate verification
- `general` — cross-cutting readiness hygiene not covered above
- Module-specific labels — when a module review guide is loaded (under `./modules/`), use the Source label that guide defines (for example `connector`). Do **not** re-label those findings as `manifest` just because evidence lives in `manifest.yml`.

**Location rules** (do not path-only):

- Always cite precise `path:line` or `path:start-end` (multiple citations OK).
- Include the contributing code excerpt in the Location cell — the exact lines that produced the signal, not just the filename.
- Because Markdown table cells cannot nest ` ``` ` fences reliably, wrap the excerpt in HTML: `<pre><code>...</code></pre>`.
- Keep excerpts tight (typically ≤15 lines). For absences (e.g. a missing required block), show the nearest enclosing stanza and note what is missing in Description.

```markdown
# Forge App Review Results

## Summary
- Readiness: Ready | Needs changes | Blocked
- Highest-risk area: <manifest | resolver wiring | permissions | dependencies | tests | operational hygiene | module-specific>
- Files inspected: <short list>
- Specialist handoffs: <none | security | cost | debugger>

## Findings

| Severity | Source | Finding | Location | Description | Doc | Fix |
|----------|--------|---------|----------|-------------|---------|-----|
| Critical \| Warning \| Info | <source> | <short title> | `path:start-end`<br><pre><code>…excerpt…</code></pre> | <why this matters / observed pattern> | <DAC or checklist anchor title + URL> | <specific remediation> |

Sort rows Critical → Warning → Info. Omit the Doc column cell only when no public/doc anchor applies; keep the column.

## Clean Areas
- <important categories checked with no issues>

## Suggested Next Step
- <apply fixes | run specialist review | deploy/lint/test command>
```

If there are no findings, say the app looks ready from this general review and list any residual specialist reviews that were intentionally out of scope.

© atlassian · Apache-2.0 · atlassian/forge-skills

Похожие скиллы

Все скиллы по теме «Код-ревью и рефакторинг» →
jira-integration affaan-m Скилл jira-integration для Claude Code получает и разбирает задачи Jira, меняет их статус и добавляет комментарии. Запускается при работе с требованиями, критериями приёмки и обновлениями задач. CX Codex +1 6 800установок atlassian-admin Alireza Rezvani Скилл atlassian-admin для Claude Code управляет пользователями, группами, доступом и настройками Jira и Confluence. Охватывает администрирование всей организации. CX Codex +1 682установок atlassian-mcp https://github.com/Jeffallan Скилл atlassian-mcp для работы с Jira и Confluence через MCP-серверы: запросы на JQL и CQL, создание тикетов, спринты, поиск страниц. CX Codex +1 4 800установок pm-skills Alireza Rezvani Скилл pm-skills оркестрирует проектную работу через 8 PM-скиллов: Jira, Confluence, спринты, отчёты и коммуникации. Подходит для маршрутизации запросов и контроля delivery-цикла. CX Codex +1 1 975установок triage-issue atlassian Скилл triage-issue помогает разобрать баг-репорт или текст ошибки: ищет похожие тикеты в Jira, предлагает закомментировать существующий или завести новый. CX Codex +1 1 200установок search-company-knowledge atlassian Скилл search-company-knowledge ищет информацию о процессах и системах одновременно в Confluence и Jira. Скилл пригодится, когда агенту нужно собрать факты из документации и тикетов со ссылками на источники. CX Codex +1 505установок

Из того же набора8

forge-app-builder Скилл forge-app-builder для Claude Code и Codex проектирует, создаёт и расширяет приложения Atlassian Forge для Jira и Confluence. Включается при работе с манифестом, интерфейсом UI Kit, Custom UI или бэкенд-логикой. CX Codex +1 552установок forge-debugger Скилл forge-debugger для Claude Code, который ищет и исправляет ошибки в приложениях Atlassian Forge. Запускается при сбоях деплоя, пустом интерфейсе, ошибках резолвера и проблемах с правами. CX Codex +1 533установок forge-connector Скилл forge-connector для Claude Code, создающий приложения коннекторов Atlassian Forge Teamwork Graph для передачи внешних данных в поиск Rovo. CX Codex +1 453установок forge-security-review Скилл forge-security-review для Claude Code проверяет безопасность приложений Atlassian Forge по коду и Forge-правилам. Запускается по запросу аудита, проверки авторизации или анализа изоляции арендаторов. CX Codex +1 442установок forge-cost-optimizer Скилл forge-cost-optimizer для Claude Code анализирует расходы приложений Atlassian Forge. Находит лишние вызовы функций, запросы к API, записи в хранилище и частые триггеры. CX Codex +1 418установок forge-onboarding Скилл forge-onboarding для Claude Code и Codex пошагово проводит через создание и деплой агента Forge Guru. Запускается при первом знакомстве с Atlassian Forge или Rovo. CX Codex +1 173установок forge-skills С набором скиллов и MCP-конфигурацией под Atlassian Forge. Скаффолдит приложения, проверяет их перед деплоем, чинит прод и держит агента в курсе API Forge. ★ 33звёзд репо

Ещё в каталоге

Спонсоры проекта

Компании, которые помогают держать аналитику открытой