插件 Plugins

Skills、子代理、MCP、Hooks 各自强大却零散。这一章把它们打包成可分发的完整方案，从个人配置走向团队/社区生态。

能力零散

技能、钩子、MCP 各配各的，换个项目又得重来

什么是插件

定义、白话、和零散配置的区别

Plugin 是 Qoder CLI 中把多种扩展能力打包成可安装单元的机制。一个插件可以同时包含命令、技能、子代理、钩子、MCP 服务配置，通过一个清单文件（plugin.json）声明自己的内容。

说白了，插件就像手机上的一个 App——你不用关心它内部用了哪些技术，点一下安装，就获得了一整套功能。卸载也干净利落。

插件包含什么

一个插件可以装下五种能力

目录结构

一个典型插件的文件组织

my-code-quality-plugin/
├── plugin.json              # 必需：插件清单
├── commands/                # 命令
│   ├── lint.md
│   └── review.md
├── skills/                  # 技能
│   └── code-reviewer/
│       └── SKILL.md
├── agents/                  # 子代理
│   └── security-auditor.md
├── hooks/                   # 钩子
│   └── pre-commit-check.sh
└── mcp-config.json          # MCP 服务配置

每个子目录对应一种能力，放对应类型的文件。plugin.json 是入口，声明插件元信息和包含的内容。

plugin.json

插件清单——声明"我是谁、包含什么"

{
  "name": "code-quality-suite",
  "version": "1.2.0",
  "description": "一套代码质量工具：审查技能、安全审计代理、提交前检查钩子",
  "author": "your-name",
  "homepage": "https://github.com/you/code-quality-suite",
  "capabilities": ["commands", "skills", "agents", "hooks"]
}

四类来源

插件从哪里来

市场

插件分发的中心——marketplace

Marketplace（市场）是插件的集中分发渠道。你可以把插件发布到市场，别人从市场一键安装。

qodercli plugin marketplace add \
  https://github.com/org/my-marketplace

qodercli plugin install code-quality-suite

qodercli plugin list          # 已装插件
qodercli plugin update code-quality-suite
qodercli plugin remove code-quality-suite

创建插件

把你的零散配置升级成可分发插件

如果你已经在项目里配好了技能、钩子，把它们升级成插件的步骤：

1. 建目录：创建插件根目录，如 my-workflow/
2. 迁移能力：把现有的技能移到 skills/、钩子移到 hooks/，以此类推
3. 写清单：创建 plugin.json，声明 name/version/description/capabilities
4. 本地测试：用本地路径安装 qodercli plugin install ./my-workflow
5. 发布（可选）：推到 Git 仓库，注册到市场供他人使用

排错指南

插件相关的高频问题

动手练习

把前面的成果打包成一个插件

本章回顾

带走的三个核心认知

延伸阅读