1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | code-exemplars-blueprint-generator-github-awesome-copilot |
| 作者/维护者 | GitHub 官方组织仓库 github/awesome-copilot（社区贡献者提交，经官方合并收录） |
| 来源链接 | https://github.com/github/awesome-copilot/tree/main/skills/code-exemplars-blueprint-generator |
| 许可证 | MIT（GitHub API 数据） |
| GitHub Stars | 39,110（合集仓库整体数据；由 400 余个子技能共享，不代表本技能个体热度） |
| Forks | 4,964（同上，合集整体数据） |
| 最新版本 | 无独立版本号；该文件最近一次改动于 2026-02-19（GitHub API 数据） |
| 安装方式 | 复制 skills/code-exemplars-blueprint-generator/SKILL.md 到对应 agent 的 skills 目录；或 npx skills add https://github.com/github/awesome-copilot --skill code-exemplars-blueprint-generator |
2. 功能介绍与亮点
技术栈无关的代码范例提炼提示词。给定代码库后：
- 自动检测主技术栈（.NET/Java/JavaScript/TypeScript/React/Angular/Python 等），也支持手动指定
- 扫描代码库，识别命名规范清晰、注释完整、错误处理得当、遵循设计模式与单一职责原则的代表性实现
- 按技术栈分类（.NET 领域模型/仓储/服务层/控制器/依赖注入/中间件/单元测试，Java Spring 组件，JavaScript/TypeScript 组件与 Hook，Python 模块与装饰器等）逐类给出范例
- 支持三档分析深度（基础/标准/全面）、多种归类方式（按模式类型/架构分层/文件类型）、每类最多范例数、是否附代码片段与讲解注释等配置项
- 仅引用代码库中真实存在的文件作为范例，不生成假设性示例；产出
exemplars.md文档，可直接作为团队编码标准的活教材
纯 Markdown 提示词驱动，无需安装依赖或配置环境变量。
3. 适用场景
所属分类：工程效率与代码质量（判定依据见下方评分表后的分类说明）。
- 技术负责人希望把“什么是好代码”从口口相传变成可指向的具体文件，用于新人培训与代码评审基线
- 团队引入新技术栈或框架后，需要快速沉淀一批本地化的最佳实践范例，而非照搬通用教程
- 代码库存在风格不统一问题时，先找出内部已有的优秀实现作为统一标准，比空谈规范更有说服力
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 标准 SKILL.md（YAML front matter + Markdown 正文），符合开放 Agent Skills 规范，复制进 skills 目录即可加载 |
| Codex | 需适配 | Codex CLI 不会自动扫描 ~/.codex/skills 目录下的 SKILL.md，需要通过 -f 参数或标准输入显式引用文件内容后才能使用 |
| OpenClaw | 原生支持 | 采用同一开放 Agent Skills 规范，本技能不含平台专属 metadata，可直接放入对应目录加载 |
| Hermes Agent | 原生支持 | Hermes 在其 skills 目录下按同一目录结构自动发现 SKILL.md；本技能零依赖、零环境变量，不构成兼容障碍 |
5. 推荐理由
代码评审时最常见的争论是“什么算好代码”——每个人心里都有一套标准，但很少落成具体、可指向的例子。本技能把“扫描代码库 → 按技术栈识别代表性实现 → 按模式/分层/文件类型归类 → 附讲解注释”固定成一套可配置流水线，只引用代码库中真实存在的文件，产出的 exemplars.md 能直接当作新成员上手材料或代码评审时的具体参照物，比一份通用风格指南更贴合团队自己的代码习惯。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 发布方为 GitHub 官方组织仓库，属该技能市场的官方收录背书；该子技能本身未见独立于合集之外的第三方讨论或采用数据，合集整体星数由 400 余个子技能共享，不能计入本技能个体热度 |
| 可用性 | 8 | 纯 Markdown 提示词，无需安装任何依赖，复制进对应 agent 的 skills 目录即可使用；内置的技术栈类型/分析深度/归类方式/范例数量上限/是否含代码片段与注释等配置项均支持自定义；仅引用代码库真实文件，不产生虚构示例；最近一次更新为 2026 年 2 月，距今约 7 个月 |
| 安全性 | 9 | 纯提示词/模板类技能，运行时只读取代码库文件用于分析，不执行任何脚本、不发起网络请求、不要求任何凭据或 API Key |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令及权限范围 | 无 shell 命令执行，纯提示词分析 |
| ② 运行时联网外发 | 无 |
| ③ API Key/凭据要求 | 不需要 |
| ④ 可疑指令（prompt injection 迹象） | 未发现 |
| ⑤ 作者/组织信誉 | GitHub 官方组织仓库收录 |
| ⑥ License | MIT，明确 |
| ⑦ 最近维护时间 | 2026-02-19，约 7 个月前 |
7. 跟同类 Skills 相比的优势
同一合集仓库内还有若干“技术栈无关的蓝图生成器”系列技能，各自聚焦不同的文档产出物：
| 技能 | 产出物定位 | 与本技能的差异 |
|---|---|---|
| architecture-blueprint-generator | 整体架构文档（C4/UML 图、ADR） | 关注宏观架构分层与组件边界，不落到具体代码范例 |
| folder-structure-blueprint-generator | 目录组织与命名规范文档 | 落到文件该放哪一层、怎么命名，不展示具体实现代码 |
| technology-stack-blueprint-generator | 技术栈依赖版本/License 清单 | 盘点用了什么、版本与合规状态，不展示“写得好的代码长什么样” |
| project-workflow-analysis-blueprint-generator | 端到端工作流实现文档 | 追踪具体功能的调用链路，不做跨代码库的范例归类 |
| readme-blueprint-generator | 项目 README.md | 面向仓库门面文档，需先有其余蓝图生成器的产出物作为素材来源 |
差异化在于直接从代码库中挑出真实存在的高质量实现作为范例，产出物是“具体可指向的代码”而非架构图示或依赖清单，更适合新人培训与代码评审时的即时参照。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价；GitHub 仓库内仅有一条自动化 Resource Staleness Report，非真实用户讨论。
9. 其他补充
同仓库的 architecture-blueprint-generator、folder-structure-blueprint-generator、technology-stack-blueprint-generator、readme-blueprint-generator、project-workflow-analysis-blueprint-generator、copilot-instructions-blueprint-generator 属同一批次（2025-07-25 引入，2026-02-19 转换为 SKILL.md 格式）引入的兄弟技能，各自产出物互不重叠，详见第 7 章对比。
10. 安装使用方式
Claude Code / OpenClaw / Hermes Agent：将 skills/code-exemplars-blueprint-generator/SKILL.md 复制到对应 agent 的 skills 目录即可自动加载。
脚手架工具：
npx skills add https://github.com/github/awesome-copilot --skill code-exemplars-blueprint-generatorCodex：下载 SKILL.md 后通过 -f 参数或标准输入显式传入。
安装后无需重启，对话中要求 agent 对当前代码库提炼代码范例即可触发；建议先用默认的“自动检测”配置跑一遍，再按需调整分析深度与归类方式。
11. 注意事项
- 内置配置变量（如
SCAN_DEPTH、CATEGORIZATION、MAX_EXAMPLES_PER_CATEGORY）需理解其含义才能精确控制输出，多数场景保留默认“自动检测”即可 - 分析深度选到“全面”且代码库规模较大时，单次生成的篇幅可能较长，建议按模块分批调用
- 不修改代码库任何文件，仅在对话中输出
exemplars.md内容，需自行保存 - 范例质量取决于代码库本身是否存在真正优秀的实现；若代码库整体质量参差，产出范例可能有限