内容
# 前端科技代理插件
一个工具中立的[代理插件市场](https://code.visualstudio.com/docs/copilot/customization/agent-plugins)，它将精选的代理技能——来自整个代理技能生态系统——打包成基于类别的插件。
支持 **VS Code**、**GitHub Copilot CLI** 和 **Claude Code**，通过双市场清单实现。
## 范围
这是一个**工具中立的插件市场**，而不仅仅是技能捆绑器。今天发布的每个插件都捆绑了[代理技能](https://github.com/devantler-tech/agent-skills)，但插件也可以捆绑**任何代理资源**——技能、[MCP](https://modelcontextprotocol.io)服务器和自定义代理——因此市场可以随着跨工具代理生态系统的成长而发展，而不是局限于一种工具或一种资源类型。随着其他资源类型在支持的工具中得到验证，将会添加更多的资源类型。
## 插件
| 插件 | 资源 | 描述 |
|--------|-----------|-------------|
| [`gitops-kubernetes`](plugins/gitops-kubernetes/) | `gitops-cluster-debug`、`gitops-knowledge`、`gitops-repo-audit`、`gitops-tenant-onboarding`（技能）· `flux-operator-mcp`（MCP服务器）· `flux-troubleshooter`（代理） | Flux CD调试、知识、仓库审计和租户开通——捆绑了Flux MCP服务器和只读Flux故障排查代理，用于实时集群调试 |
| [`github`](plugins/github/) | `gh-cli`、`gh-stack`、`github-actions-docs`、`github-issues` | GitHub CLI、堆叠PR、Actions文档和问题管理 |
| [`agentic-engineering`](plugins/agentic-engineering/) | `agent-instructions`、`copilot-instructions-blueprint-generator`、`copilot-sdk`、`find-skills` | Agentic AI框架SDK、AI助手指令编写和技能发现 |
| [`go`](plugins/go/) | `golang-pro` | Go最佳实践、并发、泛型、接口和测试 |
| [`engineering-practices`](plugins/engineering-practices/) | `conventional-release`、`git-commit`、`refactor`、`test-driven-development`、`ways-of-working` | Git提交、约定发布、重构、TDD和工程方法 |
| [`frontend-design`](plugins/frontend-design/) | `astro`、`frontend-design`、`web-design-guidelines` | Astro、前端设计和网页设计指南 |
| [`vibe-coding`](plugins/vibe-coding/) | `needs-stack-mapping`、`allowed-stack-guardrail`、`jargon-free-voice`（技能）· `vibe-coding-companion`（代理） | 仅通过对话构建产品——纯语言伴侣代理 + 受限需求到堆栈技能，供非技术背景人员使用 |
| [`automated-ai-engineer`](plugins/automated-ai-engineer/) | `portfolio-maintenance`、`product-engineering`、`self-improvement`（技能）· `automated-ai-engineer`、`portfolio-surveyor`（代理） | 整个仓库投资组合的自主工程师角色——运行循环工程师 + 只读调查代理，具备维护、产品工程和自我改进技能；由消费仓库的AGENTS.md合同部分配置 |
## 安装
### VS Code
将市场添加到您的设置中：
```jsonc
// settings.json
"chat.plugins.marketplaces": [
"devantler-tech/agent-plugins"
]
```
然后浏览 **扩展 → 代理插件** (`@agentPlugins`搜索) 以安装单个插件。
### Copilot CLI
```sh
# 浏览可用插件
copilot plugin marketplace browse devantler-tech/agent-plugins
# 安装插件
copilot plugin install gitops-kubernetes@devantler-plugins
```
### Claude Code
添加市场，然后安装插件 - 在Claude Code中运行这些命令：
```text
/plugin marketplace add devantler-tech/agent-plugins
/plugin install gitops-kubernetes@devantler-plugins
```
浏览所有可用插件的 **发现** 标签页，或使用 `/plugin list` 列表。捆绑的 [`.claude-plugin/marketplace.json`](.claude-plugin/marketplace.json) 也会自动在添加此仓库作为插件源时被发现。
### 任意其他代理 - 仅限技能，通过 `npx skills`
[`npx skills`](https://github.com/vercel-labs/skills) 读取此仓库的 [`.claude-plugin/marketplace.json`](.claude-plugin/marketplace.json) 并将捆绑的**技能**安装到其70多个支持的代理中 - 当您的代理不是上述三个时非常有用：
```sh
# 浏览捆绑技能而无需安装
npx skills add devantler-tech/agent-plugins --list
# 为特定代理安装特定技能
npx skills add devantler-tech/agent-plugins --skill gitops-knowledge --agent cursor
```
> [!IMPORTANT]
> 这是**部分**安装路径。它解决了所有**27个捆绑技能**，但**不**包括 [MCP服务器](#mcp-servers) 或 [自定义代理](#custom-agents)。对于这些，请使用上面的 **Claude Code** 或 **Copilot CLI** - 它们是唯一加载插件捆绑的 `.mcp.json` 和 `agents/` 的工具。在 **VS Code** 中，插件安装仅提供技能，而MCP服务器和代理需要手动添加（请参阅 [MCP服务器](#mcp-servers) 和 [自定义代理](#custom-agents) 以获取确切的步骤）。
## MCP 服务器
插件也可以捆绑 [MCP](https://modelcontextprotocol.io) 服务器以及技能。
[`gitops-kubernetes`](plugins/gitops-kubernetes/) 插件捆绑了 **Flux MCP服务器**
([`flux-operator-mcp`](https://github.com/controlplaneio-fluxcd/flux-operator/tree/main/cmd/mcp))
，因此其 `gitops-cluster-debug` 技能 - 需要 `flux-operator-mcp` -开箱即用地适用于实时集群。
服务器一次作为插件的 [`.mcp.json`](plugins/gitops-kubernetes/.mcp.json)
（`mcpServers`映射）编写。每个工具如何使用它有所不同（根据 [ADR 0001](docs/adr/0001-bundling-mcp-servers-and-custom-agents.md)）：
- **Claude Code** 和 **Copilot CLI** - 捆绑的 `.mcp.json` 在安装插件时自动加载；不需要额外的配置。
- **VS Code** 使用MCP但不从插件中捆绑它。在工作区 `.vscode/mcp.json` 中添加等效的条目（注意键是 `servers` 而不是 `mcpServers`）：
```json
{
"servers": {
"flux-operator-mcp": { "command": "flux-operator-mcp", "args": ["serve"] }
}
}
```
所有三个路径都调用相同的 `flux-operator-mcp` 二进制文件，因此请先安装它 - 例如
`brew install controlplaneio-fluxcd/tap/flux-operator-mcp` 或 `go install
github.com/controlplaneio-fluxcd/flux-operator/cmd/mcp@latest` （它从
`KUBECONFIG` / `~/.kube/config` 读取您的 kubeconfig）。参阅
[Flux MCP 文档](https://fluxcd.control-plane.io/operator/mcp/) 以获取只读模式和远程传输。
## 自定义代理
插件也可以捆绑**自定义代理**（子代理）。
[`gitops-kubernetes`](plugins/gitops-kubernetes/) 插件捆绑了
[`flux-troubleshooter`](plugins/gitops-kubernetes/agents/flux-troubleshooter.md) - 一个**只读**
Flux CD故障排查代理，跟踪GitOps依赖链（源→Kustomization/HelmRelease→
工作负载），通过捆绑的 `flux-operator-mcp` 服务器读取状态条件和控制器日志，
并返回根本原因诊断和人为应用的修复程序。它按设计没有应用/协调/暂停/
删除工具，因此永远不会改变集群。
代理一次作为 `agents/<name>.md` （Markdown + YAML frontmatter，具有中立的
`name`/`description`/`tools`/`model`核心）编写。每个工具如何使用它有所不同（根据
[ADR 0001](docs/adr/0001-bundling-mcp-servers-and-custom-agents.md)）：
- **Claude Code** 和 **Copilot CLI** - 捆绑的 `agents/` 目录在安装插件时自动加载；代理命名为 `gitops-kubernetes:flux-troubleshooter`。（Copilot
读取相同的文件作为 `*.agent.md`。）
- **VS Code** 使用代理但不从插件中捆绑它们。将代理复制到您的工作区中，作为 `.github/agents/flux-troubleshooter.agent.md`。
[`vibe-coding`](plugins/vibe-coding/) 插件捆绑了
[`vibe-coding-companion`](plugins/vibe-coding/agents/vibe-coding-companion.md) - 一个面向非技术受众的纯语言构建伴侣（设计：
[ADR 0003](docs/adr/0003-vibe-coding-plugin-design.md)）。相同的交付规则；其VS Code副本为
`.github/agents/vibe-coding-companion.agent.md`，其防护措施要求使用 `## Stack map` 部分在 `AGENTS.md` 中编写（参见
[插件README](plugins/vibe-coding/README.md)）。
[`automated-ai-engineer`](plugins/automated-ai-engineer/) 插件捆绑了两个代理 -
[`automated-ai-engineer`](plugins/automated-ai-engineer/agents/automated-ai-engineer.md) （自主投资组合工程师参与者）和
[`portfolio-surveyor`](plugins/automated-ai-engineer/agents/portfolio-surveyor.md) （其只读调查子代理）- 以及三个工程技能（设计：
[ADR 0002](docs/adr/0002-automated-ai-engineer-plugin-boundary.md)）。相同的交付规则；使用
`AGENTS.md` 中的五个合同部分（投资组合映射、信任门、节奏、
内存、维护者通道）配置消费部署（参见
[插件README](plugins/automated-ai-engineer/README.md)）。
## 工作原理
技能使用 [`gh skill install`](https://github.blog/changelog/2026-04-16-manage-agent-skills-with-github-cli/) 从其上游仓库安装。 [每日更新工作流](.github/workflows/update-agent-skills.yaml) 运行 [`gh skill update --all`](https://github.com/devantler-tech/actions/tree/main/update-agent-skills) 通过 [`update-agent-skills`](https://github.com/devantler-tech/actions/blob/main/.github/workflows/update-agent-skills.yaml) 可重用工作流，并在上游内容漂移时打开PR。
每个插件目录都是自包含的，具有 `plugin.json` 清单和其捆绑资源 - 一个包含已安装 `SKILL.md` 文件（以及任何支持资产）的 `skills/` 子目录，以及可选的声明捆绑MCP服务器的 `.mcp.json` 和包含自定义代理的 `agents/` 目录。每个 `SKILL.md` 包含 `metadata.github-*` frontmatter以获取上游出处 - 不需要锁定文件。
每个捆绑技能都从其自己的上游拉取（记录在其 `SKILL.md` 的 `metadata.github-*` frontmatter中），跨越许多来源 - 包括我们的内部 sibling 库 [`devantler-tech/agent-skills`](https://github.com/devantler-tech/agent-skills)。
## 贡献
参见 [devantler-tech 组织指南](https://github.com/devantler-tech/.github) 以获取PR/问题模板和贡献规则。
## 许可证
Apache 2.0 - 参见 [`LICENSE`](LICENSE)。
