生成技术栈(generate-tech-stack)
扫描当前项目并生成一份完整的技术栈可视化页面。
步骤
-
定位项目根目录 —— 使用当前工作目录,除非用户指定了路径。
-
运行分析器:
python3 ~/.claude/skills/generate-tech-stack/scripts/analyze.py <project_root> <project_root>/TECH_STACK.html -
打开输出文件:
xdg-open <project_root>/TECH_STACK.html 2>/dev/null || open <project_root>/TECH_STACK.html 2>/dev/null || true -
向用户报告结果 —— 包含:
- 检测到的工具数量和找到的类别数
- 输出文件的可点击链接
- 从脚本的标准输出中提取的每个类别的单行概要
输出格式
生成的HTML必须包含以下所有部分(脚本会自动生成它们):
- 统计行(Stat row) —— 大数字磁贴:总工具数 · 类别数 · AI后端(如果有) · 数据存储
- 架构图(Architecture diagram) —— 分层流程图:
- 第1行:你的应用 / LLM应用(紫色框)
- 第2行:Web/API框架(绿色框,带有auth/middleware副标题)
- 第3行:AI SDK框并排显示(蓝色,每个后端一个 —— 仅在检测到AI SDK时显示)
- 第4行:数据库框 + 可观测性 + 前端(深色行)
- 柱状图摘要(Bar chart summary) —— 水平柱状图,每个类别一根,颜色匹配
- 工具卡片网格(Tool cards grid) —— 每个类别一张卡片,包含:
- 彩色图标框 + 类别标题 + 头部中的工具计数
- 每个工具:颜色点 · 名称 · 描述 · 徽章药丸状标签
- 页脚(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 项目
- 架构图会根据检测到的内容自适应:如果某个类别为空,其对应的层将被省略