Communitygithub.com

generate-tech-stack

扫描当前项目并生成一份完整的技术栈可视化页面。

generate-tech-stack 是什么?

这个技能能够自动检测当前软件项目所使用的所有技术工具和框架,并生成一个精美的、可交互的HTML技术栈展示页面。它通过运行一个Python分析脚本来扫描项目根目录,自动识别编程语言、Web框架、AI SDK、数据库、CI/CD工具等类别,并输出一个包含统计数字、架构图、柱状图和技术卡片网格的页面。该技能支持Python、Node.js、Go、Rust、Java等多种语言的项目,并完全适应检测到的内容——如果某个类别为空,相应的架构图层会被自动省略。如果分析脚本不可用,它还能通过读取常见的项目配置文件(如package.json、go.mod、pyproject.toml等)来手动推断技术栈,确保始终能够生成有意义的输出。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add askuma/generate-tech-stack

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

生成技术栈(generate-tech-stack)

扫描当前项目并生成一份完整的技术栈可视化页面。

步骤

  1. 定位项目根目录 —— 使用当前工作目录,除非用户指定了路径。

  2. 运行分析器:

    python3 ~/.claude/skills/generate-tech-stack/scripts/analyze.py <project_root> <project_root>/TECH_STACK.html
    
  3. 打开输出文件:

    xdg-open <project_root>/TECH_STACK.html 2>/dev/null || open <project_root>/TECH_STACK.html 2>/dev/null || true
    
  4. 向用户报告结果 —— 包含:

    • 检测到的工具数量和找到的类别数
    • 输出文件的可点击链接
    • 从脚本的标准输出中提取的每个类别的单行概要

输出格式

生成的HTML必须包含以下所有部分(脚本会自动生成它们):

  1. 统计行(Stat row) —— 大数字磁贴:总工具数 · 类别数 · AI后端(如果有) · 数据存储
  2. 架构图(Architecture diagram) —— 分层流程图:
    • 第1行:你的应用 / LLM应用(紫色框)
    • 第2行:Web/API框架(绿色框,带有auth/middleware副标题)
    • 第3行:AI SDK框并排显示(蓝色,每个后端一个 —— 仅在检测到AI SDK时显示)
    • 第4行:数据库框 + 可观测性 + 前端(深色行)
  3. 柱状图摘要(Bar chart summary) —— 水平柱状图,每个类别一根,颜色匹配
  4. 工具卡片网格(Tool cards grid) —— 每个类别一张卡片,包含:
    • 彩色图标框 + 类别标题 + 头部中的工具计数
    • 每个工具:颜色点 · 名称 · 描述 · 徽章药丸状标签
  5. 页脚(Footer) —— 项目名称 · 工具计数 · 生成日期

设计令牌(深色模式)

CSS变量值用途
--bg#0f172a页面背景
--bg2#111827次要背景
--bg3#161e2e卡片/图表背景
--bg4#1a2535凸起表面
--border#1e293b卡片/区块边框
--border2#263347悬停边框
--text#f1f5f9主要文本
--muted#64748b次要/标签文本
--dim#334155页脚/分隔文本
--green#22c55e强调色(徽章点、统计高亮)
--mono'JetBrains Mono', monospace代码/徽章字体
--sans'IBM Plex Sans', system-ui, sans-serif正文字体

字体从 Google Fonts 加载:

IBM Plex Sans:wght@300;400;500;600;700
JetBrains Mono:wght@400;500;600

标题 h1:color:#f8fafc,无渐变。柱状图轨道:background:#0a0f1a。

备用方案(脚本未找到)

如果无法找到 ~/.claude/skills/generate-tech-stack/scripts/analyze.py:

  • 读取 requirements.txt、package.json、go.mod、Cargo.toml、pyproject.toml
  • 检查 Dockerfile、docker-compose.yml、.github/workflows/、alembic.ini
  • 识别每个工具的分类和用途
  • 使用上述设计令牌和区块结构编写 TECH_STACK.html

注意事项

  • 始终覆盖现有的 TECH_STACK.html —— 永不要求确认
  • 适用于 Python、Node.js、Go、Rust、Java、Ruby、PHP 项目
  • 架构图会根据检测到的内容自适应:如果某个类别为空,其对应的层将被省略

相关技能