各领域的问题目录技能与编排器问题频率预防性解决方案SKILL.md 中的 YAML 无效高python -c import yaml; yaml.safe_load(open(SKILL.md).read())YAML 中name或description重复中在文件中 Grep^name:— 应只有 1 处出现skill-installer 静默失败中使用--force并读取完整输出scan_registry.py 对 sets/dicts 的 bug低通过 JSON 手动更新注册表技能在 .claude 中但不在 skills/ 中中始终通过 skill-installer 安装不要手动复制API 与集成问题频率预防性解决方案Token/API 密钥过期高执行前检查有效性达到速率限制中实现带指数退避的重试端点变更破坏性更改低固定 API 版本先检查变更日志webhook 中 HMAC-SHA256 无效中上线前用示例 payload 测试硬编码凭据被提交低但关键强制.env 配置.gitignore文件与路径问题频率预防性解决方案路径不存在高任何操作前使用os.path.exists()权限被拒中使用os.access(path, os.W_OK)检查编码错误带重音的 pt-BR高始终显式使用open(f, encodingutf-8)ZIP 损坏低生成后使用zipfile.is_zipfile()验证文件被其他进程占用低使用with显式关闭句柄生态系统的 ZIP 与构建问题频率预防性解决方案ecosystem-completo.zip 过期高每新增一个技能后运行 build_ecosystem.py技能编号乱序中分配编号前检查总数ZIP 过大50MB低排除pycache、.pyc、node_modulesGit问题频率预防性解决方案提交到错误的分支高提交前执行git branch --show-current未提交的更改丢失中破坏性操作前执行git status合并冲突中push 前执行git pull --rebase推送机密低但关键commit 前执行git diff --stagedPython / 脚本问题频率预防性解决方案ModuleNotFoundError高先执行pip install -r requirements.txtPython 2 与 3低显式使用python3子进程无超时中始终使用subprocess.run(..., timeout30)JSON 解码错误中显式处理json.JSONDecodeErrorUnicodeDecodeError高在文件中使用encodingutf-8, errorsreplace