---

name: faf-wizard description: "一键式 .faf 生成器。为任何项目提供一键 AI 上下文 - 新项目、遗留项目或知名项目。自动检测技术栈，评估就绪度，适用于所有场景。" category: productivity risk: safe source: community source_repo: Wolfe-Jam/faf-skills source_type: community date_added: "2026-04-07" author: wolfejam tags: [faf, automation, project-setup, ai-context, productivity] tools: [claude, cursor, gemini, windsurf, any-ai]

FAF Wizard - 一键 AI 智能化

项目的专属维修团队。 将它指向任何代码库，60秒内获得评分和 AI 就绪的上下文。

将任何项目 - 新项目、遗留项目、知名开源项目或被遗忘的副项目 - 转变为具有持久上下文的 AI 智能工作空间，适用于所有 AI 工具。

它解决的问题

即使是 React.js 的 AI 就绪度也是 0%。 知名仓库没有 AI 上下文。

| 现有内容 | 它告诉 AI 什么 | |-------------|------------------| | README.md | "这个做什么"（给人看的） | | docs/ | "怎么使用"（给人看的） | | project.faf | "如何帮助构建这个"（给 AI 看的） |

文档告诉人类如何使用你的代码。AI 上下文告诉 AI 如何帮助你构建它。这是完全不同的两件事。

适用于任何项目

| 项目类型 | FAF Wizard 做什么 | |-------------|----------------------| | 全新项目 | 从第一行代码就有完美的 AI 上下文 | | 遗留噩梦 | AI 终于能理解这些"考古"代码 | | 知名开源 | 连 React 都没有这个 | | 副项目 | 不用每次会话都重新解释 | | 客户交接 | 适用于任何 AI 工具的可移植上下文 | | 团队项目 | 所有人都能使用的共享上下文 |

真实成功案例

前后对比：遗留电商平台

之前："这个2015年的5万行PHP代码库..."
AI："我不理解这个架构"

之后：使用 FAF Wizard 60秒
AI："我看到这是一个基于 Laravel 的电商系统，包含
支付处理、库存管理和多租户架构。
以下是我可以帮助的方面..."

前后对比：现代 React 应用

之前：每次 AI 会话都从解释上下文开始
浪费时间：每次会话 5-10 分钟

之后：project.faf 存在
AI：即时理解，从第一条消息就高效工作
节省时间：每天 2+ 小时

60秒工作流

步骤 1：检测（10秒）

faf auto
# Scans manifest files, directory structure, dependencies
# Detects: React + TypeScript + Tailwind + Vercel

步骤 2：生成（30秒）

# Auto-generated project.faf
project:
  name: my-saas-dashboard
  goal: Customer analytics platform

stack:
  frontend: react-18
  css: tailwind
  deployment: vercel

human_context:
  who: Solo founder
  what: SaaS analytics dashboard
  why: Customer insights for small businesses

步骤 3：评分与报告（20秒）

✅ 已生成：project.faf
🏆 AI 就绪度：87% 铜牌 - 生产就绪

已填充：9/11 个活跃槽位
已忽略：22 个槽位（不适用）

达到银牌（95%）：
  + 添加 API 文档（+5%）
  + 定义部署详情（+3%）

性能数据（真实数字）

分析了 8,400+ 个项目：

• ✅ 99.2% 检测准确率，覆盖 153+ 种格式
• ✅ 平均生成时间：12.3 秒
• ✅ 铜牌或更高：94% 的项目
• ✅ 零手动配置：开箱即用

格式支持

自动检测和配置：

• JavaScript：React、Vue、Angular、Svelte、Next.js、Nuxt
• Python：Django、Flask、FastAPI、Jupyter、Poetry
• TypeScript：所有 JS 框架 + 原生 TS 项目
• Rust：Cargo 项目、CLI 工具、Web 服务器
• Go：Modules、Docker、微服务
• Java：Maven、Gradle、Spring Boot
• +147 种更多格式

通用兼容性

适用于所有 AI 工具

• ✅ Claude Code - 原生读取 .faf
• ✅ Cursor - 自动同步到 .cursorrules
• ✅ Gemini CLI - 转换为 GEMINI.md
• ✅ Windsurf - 同步到 .windsurfrules
• ✅ ChatGPT - 可读的 YAML 格式
• ✅ 任何 AI - 通用格式支持

迁移支持

已有 AI 上下文文件？

# Migrates existing context
faf migrate --from .cursorrules
faf migrate --from CLAUDE.md
faf migrate --from README.md

# One format, works everywhere
faf sync --target all

安装选项

选项 1：CLI（推荐）

npm install -g faf-cli
cd your-project
faf auto

选项 2：MCP 服务器（Claude Code）

{
  "mcpServers": {
    "faf": {
      "command": "npx",
      "args": ["-y", "claude-faf-mcp@latest"]
    }
  }
}

选项 3：浏览器扩展

从 Chrome 网上应用店安装 - 适用于任何 Git 仓库。

三阶段智能

阶段 1：技术栈检测

• 扫描 package.json、Cargo.toml、pyproject.toml 等
• 分析目录结构和文件模式
• 识别框架、部署目标、测试设置

阶段 2：上下文挖掘

• 从 README 提取项目描述