1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | architecture-blueprint-generator-github-awesome-copilot |
| 作者/维护者 | GitHub 官方组织仓库 github/awesome-copilot（社区贡献者提交，经官方合并收录） |
| 来源链接 | https://github.com/github/awesome-copilot/tree/main/skills/architecture-blueprint-generator |
| 许可证 | MIT（GitHub API 数据） |
| GitHub Stars | 39,089（合集仓库整体数据；由 400 余个子技能共享，不代表本技能个体热度） |
| Forks | 4,958（同上，合集整体数据） |
| 最新版本 | 无独立版本号；该文件最近一次改动于 2026-02-19（GitHub API 数据） |
| 安装方式 | 复制 skills/architecture-blueprint-generator/SKILL.md 到对应 agent 的 skills 目录；或 npx skills add https://github.com/github/awesome-copilot --skill architecture-blueprint-generator |
2. 功能介绍与亮点
技术栈无关的项目架构分析与文档生成提示词。给定代码库后：
- 自动检测技术栈（.NET/Java/React/Angular/Python/Node.js/Flutter 等）与架构模式（Clean Architecture、微服务、分层、MVVM、事件驱动、Serverless 等），也支持手动指定
- 按可配置的图示类型（C4/UML/Flow/Component）生成多层次架构可视化，覆盖高层子系统、组件交互、数据流
- 逐组件说明职责边界、内部结构、交互模式与演进方式，并系统梳理数据架构、跨切面关注点（鉴权、错误处理、日志、校验、配置管理）与服务间通信模式
- 可选生成代码示例、架构决策记录（ADR）与面向新功能开发的落地模板（起点、集成步骤、常见误区）
- 详细程度可配置（高层概览到实施就绪级），产出物为独立的
Project_Architecture_Blueprint.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 参数或 stdin 显式引用文件内容后才能使用 |
| OpenClaw | 原生支持 | 采用同一开放 Agent Skills 规范，本技能不含平台专属 metadata，可直接放入对应目录加载 |
| Hermes Agent | 原生支持 | Hermes 在其 skills 目录下按同一目录结构自动发现 SKILL.md；本技能零依赖、零环境变量，不构成兼容障碍 |
5. 推荐理由
架构文档是最容易“只存在于原作者脑子里”的那类文档——代码会随迭代自然演进，但描述它的文档很少有人愿意主动补。本技能把“扫描现状 → 识别架构模式 → 画多层图示 → 逐组件说明职责与演进方式 → 可选补 ADR 与新功能落地模板”固定成一套可配置分析清单，覆盖十余种主流技术栈与架构模式，产出物可直接作为团队架构评审、新人 onboarding 或外部审计说明的基线文档。
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 相比的优势
同一合集仓库内还有若干“技术栈无关的蓝图生成器”系列技能，各自聚焦不同的文档产出物：
| 技能 | 产出物定位 | 与本技能的差异 |
|---|---|---|
| folder-structure-blueprint-generator | 目录组织与命名规范文档 | 落到具体文件该放哪一层、怎么命名，不涉及宏观架构与设计决策 |
| project-workflow-analysis-blueprint-generator | 端到端工作流实现文档 | 追踪具体工作流从入口点到数据层的调用链路，不描述系统整体架构 |
| readme-blueprint-generator | 项目 README.md | 面向仓库门面文档，扫描 .github/copilot 生成技术栈/开发流程概览，不含分层架构与组件交互细节 |
| code-exemplars-blueprint-generator | 代码范例清单 | 扫描代码库挑选高质量代码样本作为编码标准参考，关注代码本身而非系统架构 |
差异化在于描述系统的宏观架构、组件边界与设计决策（含 C4/UML 图示与可选 ADR），产出物面向架构评审与新功能设计参照，而非目录组织规范或具体工作流调用链。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价；检索结果均为技能市场镜像站点对其描述的转载，未见独立于 GitHub 仓库之外的用户讨论。
9. 其他补充
同仓库的 folder-structure-blueprint-generator、readme-blueprint-generator、code-exemplars-blueprint-generator、project-workflow-analysis-blueprint-generator 属同一批次引入的兄弟技能，各自产出物互不重叠，详见第 7 章对比。
10. 安装使用方式
Claude Code / OpenClaw / Hermes Agent：将 skills/architecture-blueprint-generator/SKILL.md 复制到对应 agent 的 skills 目录即可自动加载。
脚手架工具：
npx skills add https://github.com/github/awesome-copilot --skill architecture-blueprint-generatorCodex：下载 SKILL.md 后通过 -f 参数或标准输入显式传入。
安装后无需重启，对话中要求 agent 分析当前代码库架构即可触发；建议先用默认的“自动检测”配置跑一遍，再按需调整图示类型与详细程度。
11. 注意事项
- 内置配置变量（如
ARCHITECTURE_PATTERN、DIAGRAM_TYPE、DETAIL_LEVEL）需理解其含义才能精确控制输出，多数场景保留默认“自动检测”即可 - 详细程度选到“实施就绪级”且开启全部可选章节（代码示例、ADR）时，超大型代码库单次生成的篇幅可能较长，建议按子系统分批调用
- 不修改代码库任何文件，仅在对话中输出文档内容，需自行保存
- 最近更新距今约 7 个月，若目标技术栈的官方架构范式发生较大变化，文档中的具体技术栈章节可能需人工校对