diff --git a/docs/00-product-direction.md b/docs/00-product-direction.md index 295e46fc..36b1bb38 100644 --- a/docs/00-product-direction.md +++ b/docs/00-product-direction.md @@ -74,7 +74,7 @@ ClawHub CLI 使用单一 slug 模型,slug 校验规则为 `[a-z0-9]([a-z0-9-]* - `SKILL.md` 格式兼容(frontmatter + markdown body) - 技能包目录结构约定(SKILL.md + references/ + scripts/ + assets/) -- 四级目录优先级(`.agent/skills` → `~/.agent/skills` → `.claude/skills` → `~/.claude/skills`) +- 四级目录优先级(`.agents/skills` → `~/.agents/skills` → `.claude/skills` → `~/.claude/skills`) - 目录名作为 lookup key(安装后目录名 = skill slug) - AGENTS.md `` 描述块格式兼容 - 目标:skillhub CLI 安装的技能可被 OpenSkills/Claude 兼容客户端发现和使用 diff --git a/docs/07-skill-protocol.md b/docs/07-skill-protocol.md index 3a4fc611..6e9db3cc 100644 --- a/docs/07-skill-protocol.md +++ b/docs/07-skill-protocol.md @@ -8,7 +8,7 @@ skillhub 的目标是客户端可互操作:skillhub CLI 安装的技能可以 - SKILL.md 格式(frontmatter + markdown body) - 技能包目录结构约定(SKILL.md + references/ + scripts/ + assets/) -- 四级目录优先级:协议层定义为 `.agent/skills` → `~/.agent/skills` → `.claude/skills` → `~/.claude/skills`(与 OpenSkills/Claude 一致)。**注:当前 skillhub CLI 实现的 universal fallback 实际使用 `.agents/skills`(带 s),属于历史命名漂移,统一工作另行排期。** 详见 §8.4。 +- 四级目录优先级:`.agents/skills` → `~/.agents/skills` → `.claude/skills` → `~/.claude/skills`(与 OpenSkills/Claude 一致)。详见 §8.4。 - 目录名作为 lookup key:安装后的目录名等于 `skill.slug`(即 SKILL.md 的 `name` 字段),客户端通过目录名发现技能 - AGENTS.md `` 描述块格式:skillhub CLI 生成的 AGENTS.md 索引区块与 OpenSkills 格式兼容 @@ -78,15 +78,13 @@ skillhub CLI 遵循以下目录优先级,与 OpenSkills/Claude 保持互操作 | 优先级 | 路径 | 说明 | |--------|------|------| -| 1 | `./.agent/skills/` | 项目级,universal 模式 | -| 2 | `~/.agent/skills/` | 全局级,universal 模式 | +| 1 | `./.agents/skills/` | 项目级,universal 模式 | +| 2 | `~/.agents/skills/` | 全局级,universal 模式 | | 3 | `./.claude/skills/` | 项目级,Claude 默认 | | 4 | `~/.claude/skills/` | 全局级,Claude 默认 | 安装后目录名等于 `skill.slug`(SKILL.md 的 `name` 字段),确保其他兼容客户端可通过目录名发现。 -> **当前 CLI 实现状态:** skillhub CLI 当前 fallback 实现使用 `.agents/skills`(带 s),与本节列出的协议层 `.agent/skills` 存在历史命名漂移。这只是对现状的记录,不构成对最终协议目录约定的判定。CLI 实际行为以 `cli/src/agents/profiles/generic-fallback.ts` 为准;协议层目录约定的统一是独立工作项,不在本次 scope 设计范围。 - ## 8.5 与 AGENTS.md 的关系 - skillhub CLI 安装技能后,通过 `sync` 命令在 AGENTS.md 中生成 `` 描述块