Awesome Copilot 中文教程：搜索、审查并安装 Copilot 插件
Awesome Copilot 是 GitHub 组织维护的社区资源库。这里的 agent、instruction、skill、hook、workflow 和 plugin 用来定制 GitHub Copilot，但它们不是同一种东西。第一次使用时，先找对资源类型，再审查具体内容，最后才安装。
1. 先分清资源类型
instructions 适合放团队编码规则，并可按文件模式生效；agents 面向特定任务，可能连接 MCP；skills 把说明和配套资产放在一个目录；plugins 则把一组 agent、skill、hook 或其他扩展打包。只缺一个编码规则时，没有必要安装包含更多权限的整套插件。
官网 awesome-copilot.github.com 支持全文搜索和筛选，还有 Learning Hub。机器需要读取目录时可用站点提供的 llms.txt，但它只是索引，不能代替对目标文件的审查。
2. 用新版默认市场安装
# 查看已注册市场 copilot plugin marketplace list # 浏览社区市场 copilot plugin marketplace browse awesome-copilot # 安装一个已经确认名称的插件 copilot plugin install <plugin-name>@awesome-copilot
官方 Learning Hub 说明，Copilot CLI 和 VS Code 现在默认注册 awesome-copilot。旧版或自定义环境如果报告市场未知，再执行：
copilot plugin marketplace add github/awesome-copilot copilot plugin install <plugin-name>@awesome-copilot
不要继续照抄“直接从 GitHub 仓库 URL、raw URL 或本地路径安装插件”的旧教程，这条路径已经被官方标为弃用。只取单项资源时仍可按文档复制：agent 放到 .github/agents/，skill 放到 .github/skills/，hook 放到 .github/hooks/。
3. 安装前要看哪些文件
先打开目标插件自己的 README 和清单，确认它会放入哪些 agents、skills 与 hooks，是否声明 MCP server、Docker 镜像、外部网址或本机命令。例如仓库中的 Awesome Copilot Plugin 会启动一个 Docker 容器提供 MCP 服务，所以“安装一个提示词”与“允许容器和 MCP 运行”不是同一权限范围。
在临时仓库里安装后，用一个只读问题或容易回滚的小任务观察行为。团队采用时记录插件名、来源和提交，审查更新后再提升权限。官方 README 也明确说明资源来自第三方开发者，并要求安装前自行检查。
4. 与官方 copilot-plugins 市场怎么选
github/copilot-plugins 的定位是 GitHub 第一方插件集合；Awesome Copilot 则明确收录社区贡献。GitHub 文档把两者都列为默认市场。需要 GitHub 自己发布的插件时先查 copilot-plugins；需要更多技术栈、范例和社区工作流时再查 Awesome Copilot，并对目标内容做一次权限审查。
这里仅补原教程没有展开的事实和边界。安装命令与操作步骤仍以前文为准。
先判断这个项目是否适合你
采用建议
这是查找 Copilot 定制范例和社区插件的实用目录，但“GitHub 组织下的仓库”不等于其中每项资源都由 GitHub 编写或逐项背书。先搜索、再看目标目录、最后决定整包安装还是复制单项资源，最稳妥。
原教程未展开的系统信息
核心功能
按类型组织 Copilot 定制资源
agents 负责专门任务和 MCP 集成，instructions 按文件范围提供编码规则，skills 把说明与资产放在独立目录，plugins 再把相关能力打包分发。
网站搜索和机器可读目录
官网对资源做全文搜索与筛选，并提供 Learning Hub 和 llms.txt，便于人工查找或让工具读取结构化目录。
插件以外的单项使用方式
只需要一个资源时，可以把 agent 文件、skill 目录或 hook 配置复制到仓库对应的 .github 目录，不必安装整套插件。
架构与数据流
仓库主体是可移植的 Markdown、配置与捆绑资产。agents、instructions、skills、hooks 和 workflows 按资源类型分目录；plugins 用市场清单把相关资源组成可安装包；website 建立搜索、目录和 Learning Hub。Copilot 客户端读取插件包或仓库中的 .github 定制目录，资源本身可能继续调用外部 MCP、容器或其他工具。
核验与使用边界
优势与限制
优势
- GitHub 组织维护，覆盖多种 Copilot 定制资源
- 可在官网搜索，也可通过默认市场安装插件
- 允许整包安装或只复制一个 agent、skill、hook
限制
- 内容由第三方开发者贡献，官方 README 要求安装前自行检查
- 插件可能启动 MCP、Docker 或执行命令，风险取决于具体插件
- 仓库没有传统 GitHub Release，main 是持续变化的滚动版本
排错时先核对版本、运行环境和未覆盖范围。这里没有执行过的步骤不会写成实测结论。
常见问题
新版 Copilot CLI 还要手动添加 awesome-copilot 市场吗？
通常不用。官方 Learning Hub 说明 Copilot CLI 与 VS Code 已默认注册该市场；旧版或自定义环境报错时再手动添加。
可以只使用一个 skill，不安装整个插件吗？
可以。把 skill 目录放进 .github/skills；agent 与 hook 也可按官方目录单独复制。
awesome-copilot 的社区资源都经过安全审计吗？
不能这样理解。README 要求安装前检查第三方贡献的资源、文档、命令、MCP 和容器依赖。
为什么找不到 awesome-copilot 的最新版本号？
仓库当前没有正式 GitHub Release，main 持续更新。需要复现时应记录具体提交和资源路径。