1. 三个技能包到底解决什么问题android-native-dev、ios-application-dev、pptx-gen 分别适合谁如果你最近在折腾 AI 编程 Agent大概率会遇到一个尴尬模型本身很聪明但让它写一个完整的 Android 页面、跑通一个 iOS 的 SwiftUI 列表或者生成一份能直接用的 PPTX它经常给你一堆看起来对、跑起来报错的代码。原因不是模型不行而是缺少“领域知识的结构化封装”。MiniMax-AI/skills 这个仓库干的就是这件事——把 Android 原生开发、iOS 原生开发、PPTX 生成这些高频任务拆成一个个可被 Agent 自动发现的 Skill 包。先把这个仓库的定位说清楚。MiniMax-AI/skills 是 MiniMax AI 开源的一套面向 AI 编程工具的开发技能库采用 MIT 协议目前处于 Beta 阶段。它不是一个框架也不是一个 SDK而是一堆按目录组织的 Markdown 脚本 配置每个目录就是一个 Skill。Claude Code、Cursor、Codex、OpenCode 这些工具能自动扫描这些目录在合适的任务里把对应 Skill 的内容注入到上下文让模型按既定流程干活。这次重点看三个技能包android-native-dev 面向 Android 原生应用开发。它内部封装了从需求理解、架构设计、Kotlin/Java 编码、UI 与业务逻辑实现到调试优化的完整链路。适合谁适合你手上有 Android 项目想让 Agent 帮你补页面、改逻辑、排查编译错误而不是每次都要你手动贴一堆 Gradle 配置和 Activity 生命周期说明。ios-application-dev 面向 iOS 原生开发核心是 Swift 项目。流程是分析需求、设计应用结构、实现 Swift 代码、构建 UI、测试优化。适合做 iOS App 开发、维护和升级的人。它的价值在于把 SwiftUI 和 UIKit 的常见模式固化下来减少 Agent 在 iOS 上“自由发挥”导致的 API 误用。pptx-gen 是 Office 文档方向里最实用的一个。它负责规划演示结构、生成幻灯片、排版设计、输出 PPTX。适合需要批量出汇报材料、课程课件、产品介绍的人。你给它一个主题和大纲它按 Skill 里的流程生成可打开的 pptx 文件而不是只给你一段 Markdown 让你自己复制到 PowerPoint。这三个技能包能协作吗能。典型场景是你用 android-native-dev 或 ios-application-dev 做完一个功能模块需要给团队做技术分享直接切到 pptx-gen 生成一份演示文稿。它们共享同一套 Agent 调用机制只要安装方式正确Agent 会根据任务关键词自动选择对应 Skill。下面从安装开始一步步把环境搭起来并且把模型 endpoint 和 API Key 统一改到 TaoToken方便你集中管理调用。2. 前置准备把 MiniMax-AI/skills 装进 Claude Code、Cursor、Codex 与 TaoToken 接入配置安装 MiniMax-AI/skills 之前先确认两件事你的 AI 编程工具版本支持 Skill 自动发现你有一个可用的模型 endpoint 和 API Key。这里我把模型调用统一走 TaoToken官网是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 。这样做的原因是Skill 本身只负责“怎么干活”真正执行代码生成和推理的还是模型把 endpoint 统一后换工具不用反复改 Key。先看 Claude Code 的安装。Claude Code 支持 Plugin Marketplace两条命令搞定claude plugin marketplace add https://github.com/MiniMax-AI/skills claude plugin install minimax-skills执行完第一条Claude Code 会拉取仓库的 marketplace 元数据第二条把 minimax-skills 插件装到本地。装完后可以用claude plugin list确认插件在列表里。这一步不需要手动 clone适合不想折腾目录的人。Cursor 的安装方式是本地 clone 加路径配置git clone https://github.com/MiniMax-AI/skills.git ~/.cursor/minimax-skills然后在 Cursor Settings 里找到 Skills Path填~/.cursor/minimax-skills/skills/注意路径末尾的skills/不能少Cursor 扫描的是这个子目录不是仓库根目录。填错的话 Cursor 会提示找不到 Skill。Codex 稍微绕一点需要建符号链接git clone https://github.com/MiniMax-AI/skills.git ~/.codex/minimax-skills mkdir -p ~/.agents/skills ln -s ~/.codex/minimax-skills/skills ~/.agents/skills/minimax-skills完成后重启 Codex它会自动发现~/.agents/skills下的新 Skill。符号链接的好处是仓库更新后git pull一次链接指向的内容同步更新不用重新配置。OpenCode 的步骤类似git clone https://github.com/MiniMax-AI/skills.git ~/.minimax-skills mkdir -p ~/.config/opencode/skills ln -s ~/.minimax-skills/skills/* ~/.config/opencode/skills/重启 OpenCode 后自动加载。接下来是 TaoToken 接入。以 Claude Code 为例它的配置文件通常在~/.claude/settings.json你需要把模型请求指向 TaoToken 的 API 地址。一个可复制的 settings 片段如下{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的TaoToken密钥 } }如果你用的是 Codex配置文件在~/.codex/auth.json需要写全三件套Base URL、Key、Model ID。示例{ base_url: https://taotoken.net/api, api_key: sk-你的TaoToken密钥, model: claude-sonnet-4-20250514 }Model ID 按你实际在 TaoToken 控制台看到的模型名填不要照抄。API Key 在 https://taotoken.net/api-keys 生成生成后立刻复制页面刷新就看不到了。接入文档在 https://taotoken.net/doc 里面有各工具的详细字段说明。这里有个容易踩的坑Claude Code 的 settings.json 里如果同时存在旧的ANTHROPIC_API_KEY和环境变量里的同名 Key优先级可能不一致。建议只保留配置文件里的一份避免 401。配置完成后Skill 负责流程TaoToken 负责模型调用两者解耦换模型只改 endpoint 就行。3. 可复制配置android-native-dev、ios-application-dev、pptx-gen 的目录结构与调用参数装好之后先看目录结构知道每个 Skill 长什么样。clone 下来的仓库根目录下有一个skills/文件夹里面按技能名分子目录skills/ ├── android-native-dev/ │ ├── SKILL.md │ ├── references/ │ └── scripts/ ├── ios-application-dev/ │ ├── SKILL.md │ ├── references/ │ └── scripts/ ├── pptx-gen/ │ ├── SKILL.md │ ├── references/ │ └── scripts/ └── ...其他技能每个 Skill 的核心是SKILL.md里面写了这个技能的触发条件、执行步骤、注意事项。Agent 在任务匹配时会读取这个文件。references/放领域参考资料比如 Android 的 Gradle 模板、iOS 的 SwiftUI 组件示例scripts/放可执行脚本比如 pptx-gen 里可能有生成幻灯片的 Python 脚本。调用这三个技能不需要你手动写函数名。Agent 根据你的自然语言任务自动匹配。但你可以通过任务描述提高命中率。比如Android 任务你可以这样描述“用 android-native-dev 技能帮我创建一个带 RecyclerView 列表和详情页跳转的 Kotlin Activity包名 com.example.demominSdk 24。” 关键词 android-native-dev 会强化匹配。iOS 任务“用 ios-application-dev 技能写一个 SwiftUI 的登录页包含邮箱密码输入框和登录按钮用 State 管理状态。”PPTX 任务“用 pptx-gen 技能根据以下大纲生成一份 10 页的产品介绍 PPT封面、痛点、方案、架构、案例、数据、团队、路线图、报价、联系方式。”如果你想让 Agent 更稳定地调用可以在项目根目录放一个AGENTS.md或类似约定文件写明“涉及 Android 原生开发时优先使用 android-native-dev 技能”。不同工具对这个文件的识别名不一样Claude Code 认CLAUDE.mdCursor 认.cursorrulesCodex 认AGENTS.md。内容可以复用。pptx-gen 的调用通常需要指定输出路径。你可以在任务里加一句“输出到 ./output/demo.pptx”。它内部的脚本会调用 Python 的 python-pptx 库所以本地需要装好依赖pip install python-pptx如果报ModuleNotFoundError: No module named pptx就是这个依赖没装。android-native-dev 和 ios-application-dev 一般不强制本地装 Android SDK 或 Xcode它们主要生成代码和配置编译还是在你自己的 IDE 里做。但如果你让 Agent 跑 Gradle 构建那本地要有 JDK 和 Android SDK。关于模型参数TaoToken 的 API 兼容主流格式你可以在请求里指定temperature和max_tokens。写代码任务建议temperature设 0.2 到 0.4PPT 文案生成可以设 0.7。这些参数在工具的配置文件里加比如 Claude Code 的 settings.json 里可以加temperature: 0.3。不是所有工具都支持在配置文件里写具体看接入文档。4. 验证请求一次真实任务跑通 android-native-dev 与 pptx-gen 的完整流程配置对不对跑一次就知道。我设计一个真实任务用 android-native-dev 生成一个简单的 Android 登录页代码然后用 pptx-gen 把这个登录页的技术方案做成一份 5 页 PPT。这个任务同时验证两个技能包和 TaoToken 的模型调用。第一步在 Claude Code 里输入任务用 android-native-dev 技能生成一个 Android 登录页的完整代码。 要求 - Kotlin ViewBinding - 包名 com.example.login - 包含 LoginActivity.kt、activity_login.xml、build.gradle.kts 片段 - 邮箱和密码输入框登录按钮点击后校验非空 - 输出到 ./android-login/ 目录如果 Skill 匹配成功Claude Code 会读取skills/android-native-dev/SKILL.md按里面的流程生成文件。你会在./android-login/下看到生成的文件。检查LoginActivity.kt应该包含 ViewBinding 的初始化、输入校验逻辑。如果生成的是 Java 而不是 Kotlin说明任务描述里的 Kotlin 关键词没被重视可以在任务开头加“必须使用 Kotlin”。第二步验证模型调用是否走了 TaoToken。在 Claude Code 里执行一个简单请求比如“用一句话解释什么是 ViewBinding”。如果返回正常说明 endpoint 和 Key 配置生效。如果报 401检查~/.claude/settings.json里的ANTHROPIC_API_KEY是否和 TaoToken 控制台生成的一致。如果报local proxy failed说明 Base URL 写错了确认是https://taotoken.net/api不要多加路径。第三步用 pptx-gen 生成 PPT用 pptx-gen 技能根据以下内容生成一份 5 页 PPT输出到 ./output/login-tech.pptx 第1页封面标题“Android 登录页技术方案” 第2页技术选型Kotlin ViewBinding Material Design 第3页页面结构Activity XML 布局 第4页校验逻辑非空判断 错误提示 第5页后续优化接入网络请求和 Token 存储执行后检查./output/login-tech.pptx是否存在。用 PowerPoint 或 WPS 打开确认 5 页内容都在排版没有乱。如果文件生成了但打不开可能是 python-pptx 版本问题升级到最新版pip install --upgrade python-pptx如果报reading choices相关错误通常是模型返回的 JSON 结构不符合 Skill 脚本预期。这时候检查skills/pptx-gen/scripts/下的脚本看它期望的输入格式。你可以在任务里明确“按 SKILL.md 里的 JSON schema 输出”减少格式偏差。第四步验证 ios-application-dev。任务用 ios-application-dev 技能生成一个 SwiftUI 的登录页包含邮箱密码输入框和登录按钮用 State 管理输入状态输出到 ./ios-login/。检查生成的 Swift 文件确认用了State而不是ObservedObject误用。如果 Agent 没调用这个技能在任务里把技能名放在最前面。整个流程跑通后你就有了一套可复用的工作流Android/iOS 代码生成走对应技能包文档输出走 pptx-gen模型调用统一走 TaoToken。换项目时只需要改任务描述不用重新配置环境。5. 本篇常见错排查401、local proxy failed、reading choices、OAuth 与 Skill 未加载这一节把实际会遇到的报错列出来对照解决。401 Unauthorized。最常见的原因是 API Key 不对或没生效。检查顺序TaoToken 控制台生成的 Key 是否复制完整配置文件里的字段名是否正确Claude Code 用ANTHROPIC_API_KEYCodex 用api_key环境变量里是否有同名的旧 Key 覆盖了配置文件。解决方法是只保留一处配置重启工具。local proxy failed。这个报错通常出现在 Base URL 配置错误时。确认写的是https://taotoken.net/api不要写成https://taotoken.net/api/v1或带其他路径。有些工具会自动拼接/v1/messages你多写一层就 404 或 proxy failed。改完重启工具。reading choices。这个报错多出现在模型返回格式和 Skill 脚本预期不一致时。比如 pptx-gen 的脚本期望模型返回一个包含slides数组的 JSON但模型返回了 Markdown。解决方法是在任务描述里明确“按 SKILL.md 里的输出格式返回 JSON”或者在 Skill 的 SKILL.md 里检查是否有格式约束把它复制到任务里。OAuth 相关报错。如果你用的是 Claude Code 的 OAuth 登录模式同时又在 settings.json 里配了 API Key可能冲突。解决方法是二选一要么用 OAuth 登录要么用 API Key 模式。用 TaoToken 的话走 API Key 模式把 OAuth 相关配置清掉。Skill 未加载。表现是 Agent 完全不提技能名按普通对话回答。排查Claude Code 用claude plugin list看插件在不在Cursor 检查 Skills Path 是否指向skills/子目录Codex 检查~/.agents/skills/minimax-skills符号链接是否有效用ls -la ~/.agents/skills/看链接指向OpenCode 检查~/.config/opencode/skills/下是否有文件。符号链接失效的话重新建。模型名不对。TaoToken 控制台里模型列表是动态的你填的 Model ID 如果不存在会报模型未找到。解决方法是去 https://taotoken.net/api-keys 旁边的模型列表页确认当前可用的模型名复制准确的 ID。不要凭记忆写。pptx 生成后空白。检查 python-pptx 是否安装以及脚本是否有写入权限。输出目录如果不存在脚本可能静默失败。先mkdir -p ./output再跑任务。Android 代码生成后编译报错。常见原因是 Gradle 版本和 AGP 版本不匹配。Skill 生成的build.gradle.kts片段是模板你需要根据自己项目的实际版本调整。把项目里的gradle-wrapper.properties和生成的配置对照一下版本号对齐。iOS 代码生成后 Xcode 报错。检查 Swift 版本Skill 默认可能用较新的 SwiftUI API如果你的 Xcode 版本较旧需要把NavigationStack换成NavigationView之类的兼容写法。在任务里注明你的 Xcode 版本可以减少这类问题。6. 把模型 endpoint 统一到 TaoToken长期编码与 Agent 任务的稳定调用方案三个技能包装好之后真正决定体验的是模型调用的稳定性。Skill 只负责流程模型负责生成如果 endpoint 经常超时或 Key 管理混乱再好的 Skill 也跑不顺。把 endpoint 统一到 TaoToken 的好处是一个 Key 管所有工具Claude Code、Cursor、Codex、OpenCode 都指向同一个地址换工具不用重新申请。具体操作上每个工具的配置文件里只改两处Base URL 填https://taotoken.net/apiAPI Key 填 TaoToken 生成的 Key。Model ID 按需选择写代码用推理能力强的模型生成 PPT 文案可以用速度快的模型。如果你经常跑 Agent 任务比如让 Agent 连续调用 android-native-dev 和 pptx-gen建议用 Coding Plan地址是 https://taotoken.net/coding-plan 它针对长任务做了优化减少中途断连。验证模型是否正常可以用模型对话页面发一条测试消息https://taotoken.net/models 。如果返回正常说明 Key 和 endpoint 都没问题。接入文档在 https://taotoken.net/doc 里面有各工具的完整配置示例包括 Claude Code、Cursor、Codex 的字段对照。API Key 管理页面在 https://taotoken.net/api-keys 建议给不同工具生成不同的 Key方便排查问题时定位是哪个工具调用异常。Key 泄露了直接在那个页面删除不影响其他工具。最后说一个实际经验Skill 的更新频率比模型高MiniMax-AI/skills 仓库还在 BetaSKILL.md 和脚本可能变。建议定期git pull更新本地 cloneClaude Code 的插件用claude plugin update minimax-skills更新。更新后如果某个技能行为变了先看仓库的 commit 记录确认是不是 SKILL.md 改了流程。把模型 endpoint 固定到 TaoToken 后Skill 更新不会影响模型调用两边解耦排查问题更清晰。