Claude 技能用于构建 New Frontend 和 Backend Systems 的 Backstage 插件。

可用技能

后台-前端插件

用新前端系统（createFrontendPlugin）、蓝图、路由、实用工具API、测试工具构建后台前端插件。用于创建页面、导航项、实体内容或卡片。

包括：

• 基于当前yarn new前端插件模板（已NFS有线）的逐步开发流程
• 扩展蓝图指南（PageBlueprint、SubPageBlueprint、EntityContentBlueprint、ApiBlueprint，应用级蓝图），附有已弃用的NavItemBlueprint 注释
• 工具API模式（含从 @backstage/frontend-plugin-api 导入）及最佳实践
• 包含@backstage/frontend-test-utils（renderInTestApp、createExtensionTester(...).reactElement()、mockApis.*）的综合测试指南

后台-后台插件

构建带有createBackendPlugin、核心服务和扩展点的Backstage插件和模块。用于REST/HTTP接口、后台作业、数据处理、集成以及扩展现有插件的模块。

包括：

Backstage Agent Skills

Claude skills for building Backstage plugins with the New Frontend and Backend Systems.

Available Skills

backstage-frontend-plugin

Build Backstage frontend plugins with the New Frontend System (createFrontendPlugin, blueprints, routes, Utility APIs, testing). Use for creating pages, navigation items, entity content, or cards.

Includes:

• Step-by-step development workflow against the current yarn new frontend-plugin template (already NFS-wired)
• Extension blueprints guide (PageBlueprint, SubPageBlueprint, EntityContentBlueprint, ApiBlueprint, app-level blueprints) with notes on the deprecated NavItemBlueprint
• Utility API patterns (with imports from @backstage/frontend-plugin-api) and best practices
• Comprehensive testing guide with @backstage/frontend-test-utils (renderInTestApp, createExtensionTester(...).reactElement(), mockApis.*)

backstage-backend-plugin

Build Backstage backend plugins and modules with createBackendPlugin, core services, and extension points. Use for REST/HTTP APIs, background jobs, data processing, integrations, and modules that extend existing plugins.

Includes:

• Step-by-step development workflow against the current yarn new backend-plugin template (src/router.ts, express-promise-router, zod, service refs)
• Core services reference covering every coreServices.* entry (httpRouter, logger, database, httpAuth, userInfo, auth, scheduler, cache, urlReader, permissions, permissionsRegistry, auditor, lifecycle, rootHealth, …)
• Modules + extension points (createBackendModule, env.registerExtensionPoint)
• Production-ready patterns for validation, error handling (via MiddlewareFactory / root error middleware), and security
• Comprehensive testing guide with @backstage/backend-test-utils (startTestBackend + supertest, mockServices, mockCredentials, MSW v2, TestDatabases)

Installation and Usage

Each skill is a self-contained folder with:

• SKILL.md - Main skill instructions and workflow
• reference/ - Detailed reference documentation loaded on-demand

These are Agent Skills, instructions that an AI coding agent loads to do better work. They do not hook into Backstage tooling directly, so placing them in .github/ or running yarn new yourself will not use them. Instead, the agent reads the skill and then runs yarn new, converts the scaffold, and writes code following the skill’s guidance.

Claude Code

Copy a skill folder into your workspace and Claude Code discovers it automatically.

# Project-level (this workspace only)
mkdir -p .claude/skills
cp -r backstage-frontend-plugin .claude/skills/

# Or user-level (all your projects)
cp -r backstage-frontend-plugin ~/.claude/skills/