docs(protocol): adopt .agents/skills (plural) as canonical universal fallback

Resolve historical naming drift between protocol spec and CLI by adopting the
plural form across both docs:

- docs/07-skill-protocol.md: drop the drift caveat; the four-tier priority is
  now stated as .agents/skills / ~/.agents/skills / .claude/skills /
  ~/.claude/skills directly.
- docs/00-product-direction.md: align with the same plural form.

The CLI already uses .agents/skills (cli/src/agents/profiles/generic-fallback.ts
and cli/src/agents/resolver.ts). No code change required.
This commit is contained in:
dongmucat 2026-05-19 10:49:31 +08:00
parent c6fa37bb78
commit 8c8b047cbb
2 changed files with 4 additions and 6 deletions

View file

@ -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 `<skill>` 描述块格式兼容
- 目标skillhub CLI 安装的技能可被 OpenSkills/Claude 兼容客户端发现和使用

View file

@ -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 `<skill>` 描述块格式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 中生成 `<skill>` 描述块