MiniMax Skills 深度技术解析：AI 编程代理的 11 大开发技能全面剖析

MiniMax-AI/skills/
├── .claude/ .claude-plugin/        # Claude Code 集成
├── .cursor-plugin/                  # Cursor 集成
├── .codex/  .opencode/              # Codex / OpenCode 集成
├── skills/                          # 核心技能定义
│   ├── frontend-dev/                # 前端开发工作室
│   ├── fullstack-dev/               # 全栈后端架构
│   ├── android-native-dev/          # Android 原生
│   ├── ios-application-dev/         # iOS 原生
│   ├── shader-dev/                  # GLSL 着色器
│   ├── gif-sticker-maker/           # GIF 贴纸
│   ├── minimax-pdf/                 # PDF 设计系统
│   ├── pptx-generator/              # PPT 生成
│   ├── minimax-xlsx/                # Excel XML 编辑
│   ├── minimax-docx/                # Word OpenXML
│   └── minimax-multimodal-toolkit/  # 多模态 API 入口
├── plugins/
└── assets/

# 图片生成
python scripts/minimax_image.py \
  --prompt "A minimalist SaaS dashboard with dark theme" \
  --output public/assets/images/hero-dashboard-1710xxx.webp

# TTS 语音合成
python scripts/minimax_tts.py \
  --text "Welcome to our platform" \
  --voice "english-male" \
  --output public/assets/audio/tts-intro-1710xxx.mp3

/* Liquid Glass：液态玻璃效果 */
.glass-card {
  backdrop-filter: blur(16px);
  border: 1px solid rgba(255, 255, 255, 0.1);
  box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.1);
}

// 磁性按钮：鼠标接近时按钮向鼠标方向"吸附"
function MagneticButton({ children }) {
  const x = useMotionValue(0);
  const y = useMotionValue(0);
  return (
    <motion.button
      style={{ x, y }}
      onMouseMove={(e) => {
        const rect = e.currentTarget.getBoundingClientRect();
        x.set((e.clientX - rect.left - rect.width / 2) * 0.3);
        y.set((e.clientY - rect.top - rect.height / 2) * 0.3);
      }}
      onMouseLeave={() => { x.set(0); y.set(0); }}
    >
      {children}
    </motion.button>
  );
}

src/
├── orders/
│   ├── orders.controller.ts    # HTTP 处理
│   ├── orders.service.ts       # 业务逻辑
│   ├── orders.repository.ts    # 数据访问
│   ├── orders.types.ts         # 类型定义
│   └── orders.test.ts          # 测试
├── users/
│   └── ...
└── shared/
    ├── config.ts               # 集中配置
    ├── errors.ts               # 错误类型体系
    └── logger.ts               # 结构化日志

// ✅ 正确：IO 操作使用 IO 调度器
suspend fun fetchUser(): User = withContext(Dispatchers.IO) {
    api.getUser()
}

// ❌ 错误：在主线程执行网络请求（导致 ANR）
fun fetchUser(): User {
    return api.getUser()  // 阻塞主线程!
}

// ShaderToy 风格（原始）
void mainImage(out vec4 fragColor, in vec2 fragCoord) {
    vec2 uv = (2.0 * fragCoord - iResolution.xy) / iResolution.y;
    // ... shader logic ...
    fragColor = vec4(col, 1.0);
}

// WebGL2 适配（必须添加 main() 包装）
#version 300 es
precision highp float;
out vec4 fragColor;
uniform vec2 iResolution;
uniform float iTime;

void mainImage(out vec4 fragColor, in vec2 fragCoord) {
    vec2 uv = (2.0 * fragCoord - iResolution.xy) / iResolution.y;
    // ... shader logic ...
    fragColor = vec4(col, 1.0);
}

void main() {
    mainImage(fragColor, gl_FragCoord.xy);  // 注意：gl_FragCoord
}

# Step 1: 生成静态贴纸
python scripts/minimax_image.py \
  --prompt "Funko Pop blind box style, C4D rendering, white studio lighting..." \
  --subject-ref user_photo.jpg \
  --output sticker-hi.png

# Step 2: 图片生成动画视频
python scripts/minimax_video.py \
  --image sticker-hi.png \
  --prompt "Character waves hand, slight head tilt, smooth loop" \
  --output sticker-hi.mp4

# Step 3: 视频转 GIF
python scripts/convert_mp4_to_gif.py \
  --input sticker-hi.mp4 \
  --output sticker-hi.gif

[
  {"type": "h1", "text": "执行摘要"},
  {"type": "body", "text": "本季度营收同比增长 <b>23%</b>..."},
  {"type": "callout", "text": "关键洞察：用户留存率是增长的核心驱动力"},
  {"type": "chart", "chart_type": "bar",
   "labels": ["Q1","Q2","Q3","Q4"],
   "datasets": [{"label": "营收", "values": [120,145,132,178]}]},
  {"type": "flowchart",
   "nodes": [
     {"id": "s", "label": "开始", "shape": "oval"},
     {"id": "p", "label": "处理", "shape": "rect"},
     {"id": "d", "label": "验证?", "shape": "diamond"},
     {"id": "e", "label": "结束", "shape": "oval"}
   ],
   "edges": [
     {"from": "s", "to": "p"},
     {"from": "p", "to": "d"},
     {"from": "d", "to": "e", "label": "是"},
     {"from": "d", "to": "p", "label": "否"}
   ]}
]

// slides/slide-01.js — 每张幻灯片一个独立模块
function createSlide(pres, theme) {
  const slide = pres.addSlide();
  slide.background = { fill: theme.bg };

  // 标题
  slide.addText("Q3 Strategy Review", {
    x: 0.8, y: 1.5, w: 8.4, h: 1.2,
    fontSize: 36, fontFace: "Arial",
    color: theme.primary, bold: true
  });

  // 页码徽章（封面页之外所有页必须有）
  slide.addShape(pres.ShapeType.oval, {
    x: 9.1, y: 5.0, w: 0.5, h: 0.5,
    fill: { color: theme.accent }
  });
  slide.addText("1", {
    x: 9.1, y: 5.0, w: 0.5, h: 0.5,
    fontSize: 10, color: "FFFFFF", align: "center"
  });
}

module.exports = { createSlide };

# 解压
python scripts/xlsx_unpack.py --input report.xlsx --output-dir ./tmp/

# 添加列（带公式和格式）
python scripts/xlsx_add_column.py \
  --dir ./tmp/ \
  --sheet sheet1 \
  --col F \
  --header "合计" \
  --formula "SUM(B{row}:E{row})" \
  --number-format "#,##0.00" \
  --border thin

# 重新打包
python scripts/xlsx_pack.py --input-dir ./tmp/ --output report_edited.xlsx

<!-- ✅ 正确：属性必须在内容之前 -->
<w:p>
  <w:pPr>                <!-- 段落属性在前 -->
    <w:pStyle w:val="Heading1"/>
  </w:pPr>
  <w:r>                  <!-- 运行在后 -->
    <w:rPr>              <!-- 运行属性在前 -->
      <w:b/>
    </w:rPr>
    <w:t>标题文本</w:t>   <!-- 文本内容在后 -->
  </w:r>
</w:p>

<!-- ❌ 错误：属性在内容之后会导致文档损坏 -->
<w:p>
  <w:r>
    <w:t>标题文本</w:t>
    <w:rPr><w:b/></w:rPr>  <!-- 运行属性不应在文本之后 -->
  </w:r>
  <w:pPr>...</w:pPr>       <!-- 段落属性不应在运行之后 -->
</w:p>

# 环境配置
export MINIMAX_API_HOST="https://api.minimax.io"
export MINIMAX_API_KEY="sk-api-..."

# TTS - 文本转语音
bash scripts/tts/generate_voice.sh tts "Hello world" \
  -o minimax-output/hello.mp3

# 音乐 - 纯音乐背景
bash scripts/music/generate_music.sh \
  --instrumental \
  --prompt "ambient electronic, calm, lo-fi beats" \
  --output minimax-output/bgm.mp3 --download

# 图像 - 文生图
bash scripts/image/generate_image.sh \
  --prompt "A cat sitting on a rooftop at sunset, warm colors" \
  --aspect-ratio 16:9 \
  -o minimax-output/cat.png

# 视频 - 文生视频
bash scripts/video/generate_video.sh --mode t2v \
  --prompt "A golden retriever runs through autumn leaves, [跟随] tracking shot" \
  -o minimax-output/puppy.mp4

# 媒体工具 - 拼接视频
bash scripts/media_tools.sh concat-video \
  -i "clip1.mp4,clip2.mp4,clip3.mp4" \
  --crossfade 500 \
  -o minimax-output/merged.mp4

# 一键安装（推荐）
claude plugin marketplace add https://github.com/MiniMax-AI/skills
claude plugin install minimax-skills

# 克隆到本地
git clone https://github.com/MiniMax-AI/skills ~/.cursor/minimax-skills

# 在 Cursor Settings 中配置 skills 路径指向：
# ~/.cursor/minimax-skills/skills/

# Codex
git clone https://github.com/MiniMax-AI/skills ~/.codex/minimax-skills
ln -s ~/.codex/minimax-skills/skills ~/.agents/skills

# OpenCode
git clone https://github.com/MiniMax-AI/skills ~/.config/opencode/minimax-skills
ln -s ~/.config/opencode/minimax-skills/skills ~/.config/opencode/skills