问题描述：

Skill 开发踩坑：相对路径解析问题

在这里分享一下我在 Skill 开发过程中遇到的问题以及解决方案。

我经验有限，这个方案也远非完美，只是希望能为佬友们提供一点参考方向。若有更好的方法，也请佬友不吝赐教，一起交流进步。

问题描述

Claude Code 和 Qoder Cli 中，Skill 无法感知自身目录，导致 Skill 脚本的第一次调用都会出错，然后才会搜索正确目录，影响 scripts/ 和 reference/ 的使用。

image420×135 6.86 KB

测试环境为：

1. Claude Code + Qwen3.5-Plus
2. Qoder Cli + Auto / Lite 模式

不管 Skill 在用户级目录 (~/.agents/skills/xxx/scripts) 还是项目目录都会出现问题。

[!NOTE] GitHub Issue
直到 2026-04-04 仍未解决：[Bug] Skill plugin scripts fail on first execution with relative path resolution · Issue #11011 · anthropics/claude-code · GitHub

解决思路

在 Skill 调用时，注入 Skill 目录的绝对路径，如 “Base directory for this skill: /xxx/xxx/”。

注入方法通过 PreToolUse Hook 实现。