## 问题描述 安装脚本(scripts/install.sh)将项目安装到 `~/.claude/skills/` 后,skill 文件中大量硬编码的文件路径指向开发目录(如 `prompts/002_develop_pipeline.md`、`skills/workflows/prd-review.md` 等),导致安装后引用路径全部失效,skill 不可用。 ## 根因 - skill 文件(SKILL.md / workflow / playbook 等)内的文档引用路径均按开发期项目根目录相对路径编写 - 安装脚本将 skill 复制到 `~/.claude/skills/adf-*/` 后,相对路径指向的位置不再包含原始项目文件 - 导致安装后所有必读文档引用、workflow 引用、template 引用等均 404 ## 影响范围 - 所有 `skills/*/SKILL.md` 中的必读文档引用 - 所有 `skills/workflows/*.md` 中的交叉引用 - 所有 `skills/shared/` 下的相对路径引用 - 安装后用户无法正常使用任何 skill ## 预期行为 安装后 skill 中的文档路径应能正确指向实际安装位置对应的文件,或通过统一的路径解析机制(如环境变量、安装时路径替换等)动态适配。 ## 关联 - 与 #19(安装脚本文档路径映射)相关但不完全相同:#19 聚焦文档路径,本 issue 聚焦 skill 内硬编码路径的全量修复 - 与 bootstrap-sync 机制相关:bootstrap-sync 已做路径前缀替换,但仅覆盖部分场景
问题描述
安装脚本(scripts/install.sh)将项目安装到
~/.claude/skills/后,skill 文件中大量硬编码的文件路径指向开发目录(如prompts/002_develop_pipeline.md、skills/workflows/prd-review.md等),导致安装后引用路径全部失效,skill 不可用。根因
~/.claude/skills/adf-*/后,相对路径指向的位置不再包含原始项目文件影响范围
skills/*/SKILL.md中的必读文档引用skills/workflows/*.md中的交叉引用skills/shared/下的相对路径引用预期行为
安装后 skill 中的文档路径应能正确指向实际安装位置对应的文件,或通过统一的路径解析机制(如环境变量、安装时路径替换等)动态适配。
关联