---

name: faf-expert description: "高级 .faf（Foundational AI-context Format）专家。IANA 注册格式、MCP 服务器配置、锦标赛评分、双向同步。" category: coding risk: safe source: community source_repo: Wolfe-Jam/faf-skills source_type: community date_added: "2026-04-07" author: wolfejam tags: [faf, ai-context, project-management, mcp, iana] tools: [claude, cursor, gemini, windsurf]

FAF 专家 - 高级 AI 上下文架构

掌握让 AI 理解你项目的 IANA 注册格式。

将任何代码库转化为 AI 智能项目，具有跨会话、跨工具和跨 AI 平台持久化的上下文。对驱动现代 AI 开发工作流的基础层进行专家级控制。

何时使用此技能

当你需要以下场景时使用 FAF 专家：

| 场景 | FAF 专家提供的能力 | |----------|---------------------------| | 复杂项目设置 | .faf 文件和 MCP 服务器的专家配置 | | 锦标赛评分 | 为生产项目达到 85%+ 的 AI 就绪分数 | | 多 AI 工作流 | 跨 Claude、Cursor、Gemini、Windsurf 的通用上下文 | | 遗留代码库复活 | 将代码考古转化为 AI 可读的项目 DNA | | 团队协作 | 标准化上下文格式，确保一致的 AI 辅助 | | 企业部署 | 专业的 MCP 服务器配置和管理 |

实际示例

示例 1：遗留企业 Java 系统

# Achieved: 92% Gold tier with FAF Expert
project:
  name: enterprise-payment-api
  goal: Mission-critical payment processing system
  
stack:
  backend: java-spring
  database: oracle
  runtime: java-11
  deployment: kubernetes
  
human_context:
  where: AWS EKS production cluster
  when: Legacy system from 2018, modernizing 2026
  how: Spring Boot 2.7, Oracle 19c, Docker containerization

示例 2：现代 React 仪表板

# Achieved: 97% Gold tier performance
project:
  name: analytics-dashboard
  goal: Real-time analytics for SaaS platform
  
stack:
  frontend: react-18
  css_framework: tailwind
  state: zustand
  build: vite
  testing: vitest
  deployment: vercel

核心能力

锦标赛评分系统

• 金牌（95%+）：生产就绪的 AI 上下文
• 银牌（85%+）：专业开发标准
• 铜牌（70%+）：AI 辅助的坚实基础

MCP 服务器配置

claude-faf-mcp 的专家设置，包含 33 个工具：

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

双向同步

跨平台保持上下文同步：

• .faf ↔ CLAUDE.md
• .faf ↔ .cursorrules
• .faf ↔ GEMINI.md
• .faf ↔ AGENTS.md

Mk4 架构框架

33 槽位 IANA 格式，用于全面的项目上下文：

• 项目身份和目标
• 技术栈检测
• 人类上下文（谁/什么/为什么/哪里/何时/如何）
• 架构模式
• 部署配置

快速入门

快速安装

# Install FAF CLI
npm install -g faf-cli

# Initialize your project
faf init

# Score AI-readiness
faf score --details

# Set up MCP server
faf mcp install

专家命令

# Advanced scoring with breakdown
faf score --championship --verbose

# Multi-platform sync
faf bi-sync --target all

# Validate format compliance
faf validate --strict

# Enhanced AI optimization
faf enhance --model claude --focus completeness

成功指标

真实性能数据：

• 52k+ 下载量，覆盖 FAF 生态系统
• 800+ 全面测试（CLI + MCP）
• IANA 注册格式（application/vnd.faf+yaml）
• 153+ 已验证格式支持
• 锦标赛级性能（<50ms 执行）

平台兼容性

支持的 AI 工具

• ✅ Claude Code - 原生 MCP 集成
• ✅ Cursor - .cursorrules 同步
• ✅ Gemini CLI - GEMINI.md 同步
• ✅ Windsurf - .windsurfrules 支持
• ✅ 通用 - 适用于任何读取 YAML 的 AI

可用的 MCP 服务器

• claude-faf-mcp - 33 个工具，391 个测试
• grok-faf-mcp - xAI/Grok 优化
• rust-faf-mcp - 原生性能（4.3MB 二进制）
• gemini-faf-mcp - Google Gemini 集成

高级模式

企业配置

faf_version: "3.0"
project:
  name: enterprise-platform
  tier: production
  
human_context:
  team_size: 50+
  compliance: SOC2, HIPAA
  deployment: multi-region
  
stack:
  architecture: microservices
  orchestration: kubernetes
  monitoring: datadog
  security: vault

遗留系统复活

# Transform 10-year-old codebase to AI-ready
project:
  archaeology: true
  modernization_target: 2026
  
stack:
  legacy: php-5.6
  migration_path: laravel-11
  database_upgrade: mysql-8

专家资源

• 文档：https://faf.one
• MCP 注册表：官方 Anthropic 管理
• CLI 参考：完整命令文档