project-stack-advisor

project-stack-advisor 是一个给 Codex / Claude Code 使用的项目技术栈顾问 Skill。

它的作用不是强行让所有项目都用同一套技术栈，而是先判断项目类型，再给出更合适的技术栈、目录结构和工程规范。

它能做什么

• 判断项目属于哪一类：官网、后台、SaaS、App、API、AI/RAG、电商、脚本、桌面软件等。
• 推荐一个最适合的默认技术栈。
• 告诉你一开始不建议用什么，避免过度架构。
• 给出起步目录结构。
• 给 AI 开发时加规则：小模块、清边界、早分文件、API/类型/权限/文案分层。
• 避免把项目写成一个巨大的 App.tsx、page.tsx 或单文件大杂烩。

覆盖的项目类型

项目类型	默认倾向
官网 / 博客 / 文档 / 落地页	Astro / Next.js
SaaS / 会员 / 订阅 / 多租户	Next.js + PostgreSQL + Prisma/Drizzle
后台管理 / CRM / ERP / 商户后台	Vite + React + TypeScript
后端 API / Webhook / 中台	NestJS / FastAPI / Go
AI 应用 / RAG / 文档问答 / Agent	Next/Vite + FastAPI/Node + PostgreSQL/pgvector
移动 App	Expo + React Native
桌面软件	Tauri / Electron
电商	Shopify 优先，复杂定制再考虑 Medusa
数据看板	Metabase / Superset / Streamlit / Dash
浏览器插件	WXT / Plasmo
微信小程序	原生小程序 / Taro / uni-app
游戏	Phaser / Godot / Unity / Unreal
自动化脚本	Python
CLI 工具	Go / Node.js / Python

仓库结构

project-stack-advisor/
  SKILL.md
  agents/
    openai.yaml
  references/
    tech-stack-matrix.md
    project-structures.md
  assets/
    example-prompts.md

安装到 Codex

Windows PowerShell

git clone https://github.com/txk996/project-stack-advisor.git
Copy-Item ".\project-stack-advisor\project-stack-advisor" "$env:USERPROFILE\.codex\skills\" -Recurse -Force

macOS / Linux

git clone https://github.com/txk996/project-stack-advisor.git
mkdir -p ~/.codex/skills
cp -R project-stack-advisor/project-stack-advisor ~/.codex/skills/

安装后新开一个 Codex 对话，然后这样用：

使用 project-stack-advisor，帮我判断这个项目该用什么技术栈。

我要做一个商户后台，包含客户、钱包、卡池、广告账户管理。
请给我技术栈、目录结构、开发规范和不建议一开始使用的方案。

安装到 Claude Code

Claude Code 的个人级 Skill 通常放在：

~/.claude/skills/

Windows PowerShell

git clone https://github.com/txk996/project-stack-advisor.git
New-Item -ItemType Directory -Force "$env:USERPROFILE\.claude\skills" | Out-Null
Copy-Item ".\project-stack-advisor\project-stack-advisor" "$env:USERPROFILE\.claude\skills\" -Recurse -Force

macOS / Linux

git clone https://github.com/txk996/project-stack-advisor.git
mkdir -p ~/.claude/skills
cp -R project-stack-advisor/project-stack-advisor ~/.claude/skills/

安装后新开 Claude Code 对话，然后这样用：

使用 project-stack-advisor skill。
我要做一个 AI 文档问答系统，用户上传 PDF 后可以聊天提问。
请帮我选择技术栈、目录结构和工程规范。

项目级安装

如果你只想让这个 Skill 对某一个项目生效，可以放到项目目录下：

你的项目/
  .claude/
    skills/
      project-stack-advisor/
        SKILL.md

Codex 也可以按同样思路放到对应项目的 Skill 目录；如果你想全局都能用，优先放到用户目录的 .codex/skills。

常用提示词

使用 project-stack-advisor。

我要做：<描述你的项目>
目标用户：<谁来用>
核心功能：<功能列表>
重要约束：<快速上线 / 低成本 / SEO / 移动端 / 支付 / AI / 中国网络 / 团队人数 / 部署方式>

请帮我：
1. 判断项目类型
2. 推荐最适合的默认技术栈
3. 说明为什么这样选
4. 说明一开始不建议用什么
5. 给出起步目录结构
6. 给出 AI 开发时必须遵守的工程规范
7. 告诉我什么时候才需要升级架构

核心原则

一句话：别等项目变大了才重构，从第一天就守住小模块、清边界、早分文件、少过度抽象。

默认工程红线：

• 入口文件只做入口、路由、布局、全局状态。
• 一个页面或功能一个目录。
• API、类型、权限、校验、文案转换分开。
• 通用组件早抽，业务组件不要过早抽象。
• 单文件超过 800 行就要主动拆。
• 不要一开始就上微服务、Kubernetes、事件总线、复杂队列。
• 优先选择资料多、社区大、AI 支持好的稳定技术栈。