# Faf Expert

> 高级 .faf（基础 AI 上下文格式）专家。IANA 注册格式、MCP 服务器配置、冠军评分、双向同步。触发词：faf格式、AI上下文、项目上下文、MCP配置、冠军评分、faf专家、.faf文件、项目DNA、AI可读、跨平台上下文

- Skill: `kscz0000/faf-expert` (Agent Skill)
- Install (CLI): `npx skillmds@latest add kscz0000/faf-expert`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kscz0000/faf-expert/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: kscz0000 (https://skillmd.com/u/kscz0000)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/kscz0000/faf-expert

---


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

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

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

## 何时使用此技能

在以下场景使用 FAF 专家：

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

## 真实世界示例

### 示例 1：遗留企业 Java 系统
```yaml
# 达成：92% 黄金级（使用 FAF 专家）
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 仪表盘
```yaml
# 达成：97% 黄金级性能
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 个工具：
```json
{
  "mcpServers": {
    "faf": {
      "command": "npx",
      "args": ["-y", "claude-faf-mcp@latest"]
    }
  }
}
```

### 🔄 双向同步
跨平台保持上下文同步：
- `.faf` ↔ `CLAUDE.md` 
- `.faf` ↔ `.cursorrules`
- `.faf` ↔ `GEMINI.md`
- `.faf` ↔ `AGENTS.md`

### 📊 Mk4 架构框架
33 槽位 IANA 格式，覆盖全面的项目上下文：
- 项目标识与目标
- 技术栈检测  
- 人类上下文（谁/什么/为什么/哪里/何时/如何）
- 架构模式
- 部署配置

## 快速入门

### 快速安装
```bash
# 安装 FAF CLI
npm install -g faf-cli

# 初始化项目
faf init

# 评估 AI 就绪度
faf score --details

# 设置 MCP 服务器
faf mcp install
```

### 专家命令
```bash
# 高级评分（含详细分解）
faf score --championship --verbose

# 多平台同步
faf bi-sync --target all

# 验证格式合规性
faf validate --strict

# 增强 AI 优化
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 集成

## 高级模式

### 企业配置
```yaml
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
```

### 遗留系统复兴
```yaml
# 将 10 年老旧代码库转化为 AI 就绪状态
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 参考**：`faf --help`
- **社区**：Discord 服务器，1000+ 开发者
- **企业版**：提供专业支持

## 何时改用 faf-wizard

使用 `faf-wizard` 适用于：
- ✅ 快速项目设置
- ✅ 一键生成
- ✅ 新手友好工作流
- ✅ 自动化技术栈检测

使用 `faf-expert` 适用于：
- 🎯 精细调优配置
- 🎯 冠军评分优化
- 🎯 多平台同步管理
- 🎯 企业部署模式
- 🎯 高级 MCP 服务器设置

---

**掌握让 AI 理解项目的格式。FAF 专家——当你需要冠军级 AI 上下文架构时。**

## 限制
- 仅在任务明确匹配上述范围时使用此技能。
- 输出不应替代环境特定的验证、测试或专家审查。
- 若缺少必要输入、权限、安全边界或成功标准，请停止并请求澄清。