Web UI 的 / 自动补全不支持 ~/.claude/skills/ 目录下的 Skills

[deijing]

问题描述

HAPI Web UI 中输入 / 触发自动补全时，只能识别 ~/.claude/commands/ 目录下的 .md 文件，无法自动发现和补全 ~/.claude/skills/ 目录下的 Skills。

当前行为

• ~/.claude/skills/ 下定义的 Skill（包含 SKILL.md）不会出现在 Web UI 的 / 自动补全列表中
• 需要手动编写同步脚本，将 skills 桥接到 ~/.claude/commands/ 目录才能被识别
• 每次新增、修改或删除 Skill 后，都需要手动运行同步脚本

期望行为

HAPI Web UI 的 / 自动补全应同时扫描以下两个目录：

• ~/.claude/commands/*.md（现有行为）
• ~/.claude/skills/*/SKILL.md（缺失）

或者提供内置的自动同步机制，无需用户手动维护桥接脚本。

当前的 Workaround

编写一个 Python 同步脚本，扫描 ~/.claude/skills/ 并在 ~/.claude/commands/ 中生成桥接 .md 文件，每次 Skill 变动后手动运行：

python3 ~/.claude/skills/hapi/scripts/sync_skill_commands.py

环境信息

• hapi 版本：0.16.1
• 平台：macOS (Darwin 22.6.0)

[github-actions]

从当前代码看，这个现象是符合现有实现的，不是你本地配置遗漏。

HAPI 现在把 / 和 $ 当成两套独立的补全来源处理：/ 走 slash commands，$ 走 skills。当前代码里没有发现把 ~/.claude/skills/*/SKILL.md 合并进 / 自动补全的逻辑，也没有发现内置的自动同步机制。

更具体地说：

• Web 端默认启用了 @、/、$ 三种前缀，skills 不是挂在 / 下，而是单独走 $ 前缀。
• / 查询会调用 slash commands 接口；$ 查询才会调用 skills 接口。
• Claude 的 slash commands 扫描目录是 ~/.claude/commands（或 CLAUDE_CONFIG_DIR/commands）、项目内 .claude/commands，以及 Claude plugin 的 commands 目录；未发现 ~/.claude/skills 扫描逻辑。
• skills 的扫描实现目前读取的是 ~/.agents/skills、项目内 .agents/skills 和 /etc/codex/skills；未发现 ~/.claude/skills 支持。

Relevant code:

• web/src/components/AssistantChat/HappyComposer.tsx:78 - 自动补全前缀为 @、/、$
• web/src/router.tsx:277 - $ 查询走 getSkillSuggestions
• web/src/router.tsx:280 - 非 $ 查询走 getSlashSuggestions
• hub/src/web/routes/sessions.ts:348 - /api/sessions/:id/slash-commands 独立接口
• hub/src/web/routes/sessions.ts:374 - /api/sessions/:id/skills 独立接口
• cli/src/modules/common/slashCommands.ts:89 - Claude 用户命令目录为 ~/.claude/commands
• cli/src/modules/common/slashCommands.ts:109 - 项目命令目录为 .claude/commands
• cli/src/modules/common/skills.ts:25 - 用户 skills 目录为 ~/.agents/skills
• cli/src/modules/common/skills.ts:33 - 项目 skills 目录为 .agents/skills
• cli/src/modules/common/skills.test.ts:45 - 测试明确校验“lists user skills from ~/.agents only”

如果你的目标是让 Claude 风格的 ~/.claude/skills/*/SKILL.md 直接出现在 Web UI 的 / 自动补全里，按当前代码看，这个能力目前还没有实现。

---

HAPI Bot