Skip to content

Commit 60fbd07

Browse files
author
huzijie.sea
committed
docs(guides): 更新 slash-commands 和 skills 文档
- 在 slash-commands.md 中添加 /skills 和 /skill-creator 命令说明 - 更新 skills.md 文档结构,添加官方 Skills 使用说明和刷新机制 - 优化优先级表格显示方式,增加覆盖关系提示
1 parent 0c8c7b1 commit 60fbd07

2 files changed

Lines changed: 40 additions & 6 deletions

File tree

guides/skills.md

Lines changed: 37 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -87,11 +87,13 @@ Blade 会自动扫描以下目录中的 Skills。如果存在同名 Skill,优
8787

8888
| 优先级 | 范围 | 路径 | 说明 |
8989
|--------|------|------|------|
90-
| 1 (最高) | 项目级 | `.blade/skills/` | 当前项目的专用 Skills,可随 Git 共享给团队。 |
91-
| 2 | 项目级 (兼容) | `.claude/skills/` | 兼容 Claude Code 的项目级 Skills。 |
92-
| 3 | 用户级 | `~/.blade/skills/` | 你的个人全局 Skills,在任何项目中均可用。 |
93-
| 4 | 用户级 (兼容) | `~/.claude/skills/` | 兼容 Claude Code 的用户级 Skills。 |
94-
| 5 (最低) | 内置 | (Built-in) | Blade 内置的基础 Skills(如 `skill-creator`)。 |
90+
| **最高** | 项目级 | `.blade/skills/` | 当前项目的专用 Skills,可随 Git 共享给团队。 |
91+
|| 项目级 (兼容) | `.claude/skills/` | 兼容 Claude Code 的项目级 Skills。 |
92+
|| 用户级 | `~/.blade/skills/` | 你的个人全局 Skills,在任何项目中均可用。 |
93+
|| 用户级 (兼容) | `~/.claude/skills/` | 兼容 Claude Code 的用户级 Skills。 |
94+
| **最低** | 内置 | (Built-in) | Blade 内置的基础 Skills(如 `skill-creator`)。 |
95+
96+
> **提示**:项目级 Skills 会覆盖同名的用户级 Skills,Blade 目录会覆盖 Claude Code 目录。
9597
9698
## 最佳实践
9799

@@ -102,6 +104,35 @@ Blade 会自动扫描以下目录中的 Skills。如果存在同名 Skill,优
102104
3. **提供示例**:在 Markdown 内容中提供 Examples,帮助 AI 理解如何更好地执行任务。
103105
4. **共享给团队**:将通用的团队规范(如代码审查标准、部署流程)封装为项目级 Skills,提交到 Git 仓库,确保团队成员拥有一致的 AI 辅助能力。
104106

107+
## 使用官方 Skills
108+
109+
Blade 完全兼容 Claude Code 的 Skills 格式。你可以直接使用 [Anthropic 官方 Skills 仓库](https://github.com/anthropics/skills) 中的 Skills:
110+
111+
```bash
112+
# 克隆官方 Skills 仓库
113+
git clone https://github.com/anthropics/skills.git /tmp/skills-repo
114+
115+
# 复制到用户目录(全局可用)
116+
cp -r /tmp/skills-repo/skills/pdf ~/.claude/skills/
117+
cp -r /tmp/skills-repo/skills/docx ~/.claude/skills/
118+
cp -r /tmp/skills-repo/skills/xlsx ~/.claude/skills/
119+
120+
# 或复制到项目目录(仅当前项目可用)
121+
cp -r /tmp/skills-repo/skills/pdf .blade/skills/
122+
```
123+
124+
官方提供的 Skills 包括:
125+
- **pdf** - PDF 处理(提取文本、合并、拆分、表单填写)
126+
- **docx** - Word 文档处理
127+
- **xlsx** - Excel 电子表格处理
128+
- **pptx** - PowerPoint 演示文稿
129+
- **mcp-builder** - MCP 服务器开发指南
130+
- **webapp-testing** - Web 应用测试(Playwright)
131+
132+
## 刷新 Skills 列表
133+
134+
当你创建了新的 Skill 后,执行 `/skills` 命令会自动重新扫描所有目录,发现新增的 Skills。
135+
105136
## 兼容性
106137

107-
Blade 的 Skills 系统设计为兼容 Claude Code。你可以直接复用现有的 Claude Code Skills,只需将它们放在标准的 `.claude/skills` 目录下,或者迁移到 `.blade/skills` 目录
138+
Blade 的 Skills 系统设计为兼容 Claude Code。你可以直接复用现有的 Claude Code Skills,只需将它们放在标准的 `.claude/skills` 目录下,Blade 会自动发现并加载

guides/slash-commands.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,13 +20,16 @@ Slash 命令由 `src/slash-commands` 提供,输入 `/` 触发建议,`Tab`
2020
| `/agents [list|create|help]` | 管理子代理配置 | 读取 `.blade/agents` / `~/.blade/agents``list` 文本列出,`create` 打开创建向导。 |
2121
| `/resume` | 打开会话选择器 | 可恢复历史对话。 |
2222
| `/compact` | 手动触发上下文压缩 | 调用 UI 压缩逻辑。 |
23+
| `/skills` | 打开 Skills 管理面板 | 查看和管理所有可用 Skills。 |
24+
| `/skill-creator` | 交互式创建新 Skill | 引导用户生成 SKILL.md。 |
2325
| `/git [status|log|diff|review|commit]` | Git 状态/日志/差异,`review/commit` 会调用 Agent 协助生成描述 | 需在 Git 仓库中使用。 |
2426

2527
## 补全与导航
2628

2729
- 输入 `/` 自动展示建议;继续输入可模糊匹配(Fuse.js)。
2830
- `Tab` 选中当前高亮项;`↑/↓` 在建议列表中移动。
2931
- 输入包含空格后不再展示命令建议,避免干扰子参数输入。
32+
- **Skills 支持**:如果某个 Skill 配置了 `user-invocable: true`,它也会出现在命令列表中(如 `/code-review`)。
3033

3134
## 典型用法
3235

0 commit comments

Comments
 (0)