full-stack-skills/PLATFORM_GUIDE.md

跨平台使用指南

full-stack-skills 不仅可以在 Claude Code 中使用，还可以在其他 AI 平台使用，如 Cursor、Trae、Qoder、CodeBuddy、Windsurf 等。

支持的平台

• Claude Code - 原生支持，通过 Marketplace 安装（推荐）
• Claude.ai - 通过 Skills API 使用（付费套餐中部分技能已默认可用）
• Cursor - 转换为 Cursor 自定义指令格式
• Trae - 转换为 Trae 插件格式
• Qoder - 转换为 Qoder Agent 格式
• CodeBuddy - 转换为 CodeBuddy Workflow 格式
• Windsurf - 转换为 Windsurf Cascade Skills 格式

在 Claude Code 中使用

1. 注册 Marketplace

在 Claude Code 中运行以下命令，将本仓库注册为插件市场：

/plugin marketplace add https://github.com/teachingai/full-stack-skills.git

或者使用简写形式：

/plugin marketplace add teachingai/full-stack-skills

2. 安装插件

# 按技能种类安装（推荐）
/plugin install development-skills@full-stack-skills
/plugin install design-skills@full-stack-skills
/plugin install testing-skills@full-stack-skills
/plugin install devops-skills@full-stack-skills
# ... 更多插件请参考 README.md

注意： 本仓库按技能种类组织插件，而非按岗位划分。如需按岗位使用，请参考 AGENTS_PROMPT.md 中的角色定义。

详细说明请参考 README.md。

在其他平台使用

使用适配器工具转换

本仓库提供了自动转换工具，可以将 Agent Skills 转换为不同平台的格式。

快速转换所有平台

cd adapters
python convert_all.py ../skills ../adapters-output

转换单个平台

Cursor:

cd adapters/cursor
python convert_to_cursor.py --all ../../skills ../../adapters-output/cursor

Trae:

cd adapters/trae
python convert_to_trae.py --all ../../skills ../../adapters-output/trae

Qoder:

cd adapters/qoder
python convert_to_qoder.py --all ../../skills ../../adapters-output/qoder

CodeBuddy:

cd adapters/codebuddy
python convert_to_codebuddy.py --all ../../skills ../../adapters-output/codebuddy

Windsurf:

cd adapters/windsurf
python convert_to_windsurf.py --all ../../skills ../../adapters-output/windsurf

注意： 所有转换脚本都需要从对应的子目录运行，或者使用 convert_all.py 一次性转换所有平台。

输出目录结构

转换后的文件将保存在 adapters-output/ 目录下，按平台分类：

adapters-output/
├── cursor/
│   └── .cursor/
│       └── rules/
│           ├── vue3.md
│           ├── react.md
│           └── ...
├── trae/
│   ├── vue3/
│   │   ├── trae-plugin.json
│   │   └── SKILL.md
│   └── ...
├── qoder/
│   ├── vue3-agent/
│   │   ├── qoder-agent-config.json
│   │   ├── SKILL.md
│   │   └── vue3_agent.py
│   └── ...
├── codebuddy/
│   ├── vue3/
│   │   ├── manifest.json
│   │   ├── workflows/
│   │   └── skills/
│   └── ...
└── windsurf/
    ├── vue3/
    │   ├── SKILL.md
    │   └── ...
    └── ...

平台特定说明

Cursor

Cursor 使用自定义指令（Custom Rules）来扩展 AI 能力。

使用步骤：

1. 运行转换脚本生成 .cursor/rules/ 目录下的规则文件
2. 将生成的规则文件复制到你的项目 .cursor/rules/ 目录
3. Cursor 会自动加载这些规则

参考文档：

• Cursor 文档
• 适配器说明

Trae

Trae 使用插件系统来扩展 AI 能力。

使用步骤：

1. 运行转换脚本生成 Trae 插件格式文件
2. 在 Trae 中导入插件配置
3. 激活插件使用

参考文档：

• Trae 官网
• 适配器说明

Qoder

Qoder 使用 Agent 系统来扩展 AI 能力。

使用步骤：

1. 运行转换脚本生成 Qoder Agent 配置
2. 在 Qoder 中创建新的 Agent
3. 导入生成的配置文件
4. 激活 Agent 使用

参考文档：

• Qoder 官网
• 适配器说明

CodeBuddy

CodeBuddy 使用 Workflow 系统来扩展 AI 能力。

使用步骤：

1. 运行转换脚本生成 CodeBuddy Workflow 配置
2. 在 CodeBuddy 中导入 Workflow
3. 配置 Workflow 参数
4. 运行 Workflow

参考文档：

• CodeBuddy 官网
• 适配器说明

Windsurf

Windsurf 使用 Cascade Skills 系统来扩展 AI 能力。

使用步骤：

1. 运行转换脚本生成 Windsurf Skills 配置
2. 在 Windsurf 中导入 Skills
3. 激活 Skills 使用

参考文档：

• Windsurf 官网
• 适配器说明

依赖要求

转换脚本需要以下 Python 包：

pip install pyyaml

安装依赖：

cd adapters
pip install -r requirements.txt

验证状态

平台	转换脚本	格式验证	平台验证
Cursor	✅ 完成	⚠️ 需要验证	⚠️ 需要验证
Trae	✅ 完成	⚠️ 需要验证	⚠️ 需要验证
Qoder	✅ 完成	⚠️ 需要验证	⚠️ 需要验证
CodeBuddy	✅ 完成	⚠️ 需要验证	⚠️ 需要验证
Windsurf	✅ 完成	⚠️ 需要验证	⚠️ 需要验证

注意事项

⚠️ 重要说明：这些适配器工具为理论性实现，尚未经过实际平台验证。

• 转换脚本基于平台的一般特性和常见适配模式
• 生成的配置文件格式可能需要根据实际平台 API 调整
• 建议在实际使用前查阅目标平台的官方文档并进行测试
• 转换脚本会自动提取 SKILL.md 中的 frontmatter 和内容
• 脚本会尝试提取工作流步骤，但可能需要手动调整

贡献

如果你验证了某个平台的适配方案，欢迎贡献：

1. 测试转换脚本生成的输出
2. 在实际平台上验证功能
3. 报告问题和改进建议
4. 提交 Pull Request

相关资源

• 适配器工具文档 - 详细的适配器使用说明
• 适配器示例 - 转换后的示例文件
• Agent Skills 规范 - Agent Skills 官方规范（如链接不可访问，请参考 Anthropic 官方文档）
• 项目主文档 - full-stack-skills 完整文档

常见问题

Q: 转换后的文件可以直接使用吗？

A: 转换脚本生成的配置文件格式可能需要根据实际平台 API 调整。建议在实际使用前查阅目标平台的官方文档并进行测试。

Q: 如何验证转换是否正确？

A: 可以查看 adapters-output/ 目录下生成的文件，检查格式是否符合目标平台的要求。建议在实际平台上进行功能验证。

Q: 转换后的技能功能是否完整？

A: 转换脚本会尽可能保留原始技能的功能，但某些平台特定的功能可能需要手动调整。建议根据实际需求进行定制。

Q: 如何贡献新的平台适配器？

A: 欢迎创建新的适配器脚本。可以参考现有适配器的实现方式，并遵循 Agent Skills 规范。完成后请提交 Pull Request。