Backstage Dev AI Hub

Dev AI Hub--后台插件

一个集中的人工智能资产中心——指令、代理、技能和工作流——可供 GitHub Copilot, 克劳德代码, 谷歌双子座, 光标以及其他AI编码工具。

该插件将一个或多个Git存储库同步为事实来源，将资产存储在Backstage数据库中，通过UI公开它们，并通过嵌入式 MCP（模型上下文协议）服务器 因此，人工智能工具可以自动发现和安装资产。

Project Screenshot

https://github.com/user-attachments/assets/5728807d-2587-408b-88f2-4c2853606285

______________________________________________________________________

安装

1.添加包

在您的Backstage monorepo中：

yarn workspace backend add @julianpedro/plugin-dev-ai-hub-backend
yarn workspace app add @julianpedro/plugin-dev-ai-hub

2.注册后端插件

在 packages/backend/src/index.ts:

backend.add(import('@julianpedro/plugin-dev-ai-hub-backend'));

3.注册前端插件

新前端系统（NFS）

在 packages/app/src/App.tsx:

import { devAiHubPlugin } from '@julianpedro/plugin-dev-ai-hub';

const app = createApp({
  features: [
    // ...existing features
    devAiHubPlugin,
  ],
});

侧边栏项目是自动注册的，不需要额外的配置。

传统前端系统

在 packages/app/src/App.tsx，在内部添加路线 ``:

import { DevAiHubPage } from '@julianpedro/plugin-dev-ai-hub';

// inside :
} />

在 packages/app/src/components/Root/Root.tsx，添加侧边栏项：

import HubIcon from '@mui/icons-material/Hub';

// inside :

4.配置 app-config.yaml

devAiHub:
  providers:
    - id: "main-ai-assets"
      type: "github"                                          # github | gitlab | bitbucket | azure-devops | git
      target: "https://github.com/your-org/ai-assets.git"
      branch: "main"
      schedule:
        frequency:
          minutes: 30
        timeout:
          minutes: 5

# Required: Git integration for reading repositories
integrations:
  github:
    - host: github.com
      token: ${GITHUB_TOKEN}

看 app-config.example.yaml 更多提供者示例（GitLab、Bitbucket、过滤器）。

______________________________________________________________________

资产格式

每个AI资产都是存储库中具有相同基本名称的两个文件：

agents/
  product-manager.yaml   ← metadata envelope
  product-manager.md     ← pure markdown content (never modified by the plugin)
instructions/
  security-guidelines.yaml
  security-guidelines.md
skills/
  code-review/
    code-review.yaml
    SKILL.md
workflows/
  pr-review.yaml
  pr-review.md

YAML信封(.yaml)

name: product-manager-agent
label: Product Manager Agent
description: AI agent specialized in product management tasks
type: agent                          # instruction | agent | skill | workflow
tools:
  - github-copilot
tags:
  - product
  - planning
author: Your Name
version: 1.0.0

# Optional: override install path per tool
# installPath: ".claude/agents/product-manager.md"
# installPaths:
#   claude-code: ".claude/agents/product-manager.md"
#   github-copilot: ".github/agents/product-manager.agent.md"

如果 content 如果省略，解析器将查找 .md 在同一个目录中。对于技能，默认为 SKILL.md.

使用 tools: [all] 对于每个工具都应该出现的工具无关资产。

有关YAML信封字段的更多信息，请参见 YAML信封引用.

您可以使用示例文件夹中的资产来了解如何在项目中使用资产，或将其作为您自己资产的基础。

默认安装路径（按工具自动解析）

______________________________________________________________________

MCP服务器

MCP服务器运行 嵌入式 在Backstage后端——不需要单独的进程。它使用StreamableHTTP传输。

网址： http://:7007/api/dev-ai-hub/mcp

这 ?tool= 查询参数过滤AI工具接收的资产。忽略它以接收所有资产。 这 ?provider= 查询参数过滤AI工具接收的资产。忽略它以接收所有资产。 这 ?proactive=true 查询参数启用主动模式。此模式用于在需要时自动向AI工具提供资产。

克劳德代码

在 .mcp.json 或 ~/.claude/mcp.json:

{
  "mcpServers": {
    "dev-ai-hub": {
      "type": "http",
      "url": "http://:7007/api/dev-ai-hub/mcp?tool=claude-code"
    }
  }
}

GitHub副本（VS代码）

在 .vscode/settings.json 或VS Code用户设置：

{
  "github.copilot.chat.mcp.servers": {
    "dev-ai-hub": {
      "type": "http",
      "url": "http://:7007/api/dev-ai-hub/mcp?tool=github-copilot"
    }
  }
}

谷歌Gemini CLI

在 ~/.gemini/settings.json:

{
  "mcpServers": {
    "dev-ai-hub": {
      "type": "http",
      "url": "http://:7007/api/dev-ai-hub/mcp?tool=google-gemini"
    }
  }
}

光标

在 .cursor/mcp.json:

{
  "mcpServers": {
    "dev-ai-hub": {
      "type": "http",
      "url": "http://:7007/api/dev-ai-hub/mcp?tool=cursor"
    }
  }
}

可用的MCP工具

可用的MCP提示

⚡ 仅主动-仅在MCP URL包含时注册？主动=真。

聊天中的使用示例：

“列出Dev AI Hub中可用的代理” “在中心搜索代码审查资产” “在此项目中安装Product Manager代理”

______________________________________________________________________

REST API

GET  /api/dev-ai-hub/assets                   List assets (filters: type, tool, tags, search, provider, page, pageSize)
GET  /api/dev-ai-hub/assets/:id               Asset detail
GET  /api/dev-ai-hub/assets/:id/raw           Pure markdown content
GET  /api/dev-ai-hub/assets/:id/download      Download as .md or .zip (skills)
POST /api/dev-ai-hub/assets/:id/track-install Increment install counter
GET  /api/dev-ai-hub/providers                List configured providers with sync status
POST /api/dev-ai-hub/providers/:id/sync       Trigger manual sync
GET  /api/dev-ai-hub/stats                    Totals by type, tool, and provider

POST   /api/dev-ai-hub/mcp                    Initialize MCP session or handle existing
GET    /api/dev-ai-hub/mcp                    SSE stream for server-to-client notifications
DELETE /api/dev-ai-hub/mcp                    Terminate MCP session

______________________________________________________________________

包结构

______________________________________________________________________

许可证

阿帕奇-2.0