1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | technology-stack-blueprint-generator-github-awesome-copilot |
| 作者/维护者 | GitHub 官方组织仓库 github/awesome-copilot(社区贡献者提交,经官方合并收录) |
| 来源链接 | https://github.com/github/awesome-copilot/tree/main/skills/technology-stack-blueprint-generator |
| 许可证 | MIT(GitHub API 数据) |
| GitHub Stars | 39,092(合集仓库整体数据;由 400 余个子技能共享,不代表本技能个体热度) |
| Forks | 4,959(同上,合集整体数据) |
| 最新版本 | 无独立版本号;该文件最近一次改动于 2026-02-19(GitHub API 数据) |
| 安装方式 | 复制 skills/technology-stack-blueprint-generator/SKILL.md 到对应 agent 的 skills 目录;或 npx skills add https://github.com/github/awesome-copilot --skill technology-stack-blueprint-generator |
2. 功能介绍与亮点
技术栈无关的技术栈清单与文档生成提示词。给定代码库后:
- 自动检测主技术栈(.NET/Java/JavaScript/React.js/React Native/Angular/Python 等),也支持手动指定
- 逐技术栈梳理框架版本、依赖清单(NuGet/Maven/Gradle/npm 等)及其用途、构建工具与配置、认证机制、API 设计模式、数据访问方式、依赖注入方式等实现细节
- 可选记录版本信息与License 信息,覆盖全部依赖,便于合规盘点
- 可选提取具代表性的代码用法示例(API 实现、数据访问、服务层、UI 组件)与编码规范(命名约定、代码组织、错误处理、日志、校验等通用模式)
- 分析深度(基础/标准/全面/实施就绪级)与输出格式(Markdown/JSON/YAML/HTML)均可配置,深度较高时额外产出技术地图(核心框架、集成点、开发工具链、基础设施)
纯 Markdown 提示词驱动,无需安装依赖或配置环境变量。
3. 适用场景
所属分类:工程效率与代码质量(判定依据见下方评分表后的分类说明)。
- 技术负责人需要为团队固化当前项目的技术栈版本、依赖 License 清单与编码规范,作为新功能开发的参照基线
- 合规或安全评审前,快速盘点代码库全部依赖及其版本、License 状态
- 新成员加入陌生代码库前,先了解项目用了哪些框架、按什么规范写代码
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. 推荐理由
技术栈清单是团队里最容易“人走了就没人说得清”的信息——用了哪些依赖、License 状态如何、编码规范是什么,往往只存在于个别人的记忆里。本技能把“识别技术栈 → 逐栈梳理依赖与版本 → 记录 License → 提取用法示例 → 总结编码规范 → 生成技术地图”固定成一套可配置分析清单,覆盖 .NET/Java/JavaScript/React/Python 等主流栈,产出物可直接作为团队参照基线或合规盘点底稿。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 发布方为 GitHub 官方组织仓库,属该技能市场的官方收录背书;该子技能本身未见独立于合集之外的第三方讨论或采用数据,合集整体星数由 400 余个子技能共享,不能计入本技能个体热度 |
| 可用性 | 8 | 纯 Markdown 提示词,无需安装任何依赖,复制进对应 agent 的 skills 目录即可使用;内置的技术栈类型/分析深度/输出格式/是否含版本与 License 等配置项均支持自定义;文档系统覆盖技术识别、核心技术分析、实现规范、用法示例、技术地图五大部分;最近一次更新为 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) | 关注宏观架构分层与组件边界,不逐一列出依赖版本与 License |
| folder-structure-blueprint-generator | 目录组织与命名规范文档 | 落到具体文件该放哪一层、怎么命名,不涉及依赖清单或版本信息 |
| project-workflow-analysis-blueprint-generator | 端到端工作流实现文档 | 追踪具体工作流的调用链路,不做技术栈层面的版本与合规盘点 |
| readme-blueprint-generator | 项目 README.md | 面向仓库门面文档,概览性质,不含逐依赖的版本/License 明细 |
差异化在于逐技术栈梳理依赖版本、License 状态与编码规范,产出物面向合规盘点与新成员参照基线,而非宏观架构图示或工作流调用链。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价;GitHub 仓库内未见针对该技能的专门 issue 讨论。
9. 其他补充
同仓库的 architecture-blueprint-generator、folder-structure-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/technology-stack-blueprint-generator/SKILL.md 复制到对应 agent 的 skills 目录即可自动加载。
脚手架工具:
npx skills add https://github.com/github/awesome-copilot --skill technology-stack-blueprint-generator
Codex:下载 SKILL.md 后通过 -f 参数或标准输入显式传入。
安装后无需重启,对话中要求 agent 分析当前代码库技术栈即可触发;建议先用默认的“自动检测”配置跑一遍,再按需开启版本/License/用法示例等可选章节。
11. 注意事项
- 内置配置变量(如
DEPTH_LEVEL、INCLUDE_VERSIONS、INCLUDE_LICENSES)需理解其含义才能精确控制输出,多数场景保留默认“自动检测”即可 - 分析深度选到“实施就绪级”且开启全部可选章节时,超大型代码库单次生成的篇幅可能较长,建议按子系统分批调用
- 不修改代码库任何文件,仅在对话中输出文档内容,需自行保存
- 最近更新距今约 7 个月,若目标技术栈的官方版本或依赖生态发生较大变化,文档中的具体技术栈章节可能需人工校对