行为说明
插件查找由 projectRootMarkers 指定的项目根目录,默认值为 [".git"]。读取路径包括 .claude/skills/**/SKILL.md、.claude/commands/*.md、.claude/rules/*.md,以及 userClaudeDir 下的对应目录。嵌套 skill 目录会展平,例如 gitnexus/gitnexus-guide 变为 gitnexus-gitnexus-guide;不合规的 frontmatter 名称回退为目录名。DSH 要求 skill 名称使用 kebab-case。
rules 文件会合并后原样注入 <system-reminder>,作为 user-role 消息放在消息数组开头,每个会话一次。项目规则与 ~/.claude/rules 中同名的 basename 会保留项目版本。规则按会话工作目录缓存,修改后在下一个会话生效。CLAUDE.md 和 AGENTS.md 不会被读取。
配置
| Key |
Default |
enableSkills |
true |
enableRules |
true |
rulesMaxBytes |
65536 |
userRulesMaxBytes |
65536 |
projectRootMarkers |
[".git"] |
skillRank |
50 |
skillSource |
project-claude |
userSkillRank |
700 |
userSkillSource |
user-claude |
userClaudeDir |
~/.claude |
enableSkills 控制 skills 和 commands provider,enableRules 控制规则注入;两个 rulesMaxBytes 配置分别限制项目和用户规则文本总量。项目、DSH bundled skills、用户 entries 的 rank 分别为 50、600、700,数值较低者优先。
环境要求
需要带 profile 的 DSH,例如 web,并使用 Claude Code 目录约定的项目。.claude/skills/、.claude/commands/、.claude/rules/ 都可以不存在;~/.claude/ 下的对应目录也会被读取。README 标示 Node 版本要求为 >=20。
命令
commands/*.md 会注册为可由用户调用的 slash command,例如 /command-name;skill 内容由 skill tool 按需加载。重启 DSH 后,skills 会出现在 / 菜单中;rules 在新会话开始时注入。