Skip to content

安装脚本安装后 skill 硬编码路径不可用 #30

@alpha-86

Description

@alpha-86

问题描述

安装脚本(scripts/install.sh)将项目安装到 ~/.claude/skills/ 后,skill 文件中大量硬编码的文件路径指向开发目录(如 prompts/002_develop_pipeline.mdskills/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 中的文档路径应能正确指向实际安装位置对应的文件,或通过统一的路径解析机制(如环境变量、安装时路径替换等)动态适配。

关联

  • 安装脚本bug问题 #19(安装脚本文档路径映射)相关但不完全相同:安装脚本bug问题 #19 聚焦文档路径,本 issue 聚焦 skill 内硬编码路径的全量修复
  • 与 bootstrap-sync 机制相关:bootstrap-sync 已做路径前缀替换,但仅覆盖部分场景

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't working

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions