常见问题
本章节收集了 OpenSkills 使用过程中的常见问题、故障排除方案和设计理念解释，帮助你快速定位和解决问题。
本章内容
常见问题解答
解答安装、配置、使用等方面的常见疑问。包括 OpenSkills 与 Claude Code 的区别、技能安装位置、AGENTS.md 同步问题、多项目共享技能等。
故障排除
提供常见错误的诊断和修复方法。涵盖 Git clone 失败、找不到 SKILL.md、技能未找到、权限错误、更新跳过等问题的详细解决步骤。
为什么是 CLI？
解释 OpenSkills 选择 CLI 而非 MCP 的设计理由。深入对比两者的定位差异，理解技能系统为什么更适合静态文件模式。
学习路径
遇到问题？
│
├─ 不知道怎么用 ──────────→ 常见问题解答
│ （概念、配置、使用技巧）
│
├─ 报错了 ────────────────→ 故障排除
│ （错误诊断、修复步骤）
│
└─ 想了解设计理念 ────────→ 为什么是 CLI？
（技术选型、架构决策）推荐顺序：
- 先看常见问题 → 快速了解核心概念和使用技巧
- 遇到报错看故障排除 → 按错误信息查找解决方案
- 想深入了解看设计理念 → 理解 CLI vs MCP 的技术考量
前置条件
建议先完成
- 快速开始 - 了解基本使用流程
- 安装 OpenSkills - 确保环境配置正确
下一步
完成本章节后，你可以：
- 探索进阶功能 → 进阶教程 学习 Universal 模式、自定义技能等
- 查阅命令参考 → CLI API 参考 获取完整命令文档
- 了解版本更新 → 更新日志 查看新功能和变更
快速导航
| 问题类型 | 去哪里找答案 |
|---|---|
| "OpenSkills 是什么？" | 常见问题解答 |
| "技能装在哪？" | 常见问题解答 |
| "Git clone 失败" | 故障排除 |
| "找不到 SKILL.md" | 故障排除 |
| "为什么不用 MCP？" | 为什么是 CLI？ |