chaterm.cn

Appearance

Skills 使用指南 ​

什么是 Skills？ ​

Skills 它允许你将常用的操作流程、最佳实践和专业知识转化为可复用的指令集合。每个 Skill 都是一个独立的、可执行的"技能包"，会被自动注入到 AI 的系统提示中，让 AI 能够按照你定义的方式执行任务。

从"通用助手"到"专属专家" ​

想象一下，你是一名 Kubernetes 运维工程师。每次遇到 Pod 异常，你都需要：

  1. 查看 Pod 状态
  2. 检查日志
  3. 分析资源使用情况
  4. 执行修复操作

以前，你需要在 Chaterm 中反复输入这些命令，或者依赖 AI 的通用知识。现在，你可以导入或者创建一个 Kubernetes 故障排查 Skill，AI 就会自动按照你的 Skill 流程执行，就像你手把手教过它一样。

核心特性 ​

可复用指令集 ​

每个 Skill 都是一个独立的、可复用的指令集合。一旦创建，就可以在多个场景中重复使用，无需重复编写相同的操作步骤。

自动注入上下文 ​

启用的 Skills 会自动成为 AI 的系统提示，无需手动调用。当你在对话中提到相关场景时，AI 会自动识别并使用对应的 Skill。

支持资源文件 ​

Skill 可以包含脚本、模板、配置文件等资源文件，让 Skill 不仅仅是文本指令，还能包含实际可执行的代码和配置。

团队共享 ​

创建好的 Skill 可以在团队内共享，统一操作规范，确保团队成员都按照最佳实践执行任务。

快速开始 ​

在哪里找到 Skills ​

  • Terminal Skills 官方仓库：
  • 社区贡献：
    • 在 GitHub 上搜索 terminal-skills 找到更多社区贡献的 Skills

在 Chaterm 中创建 Skill ​

  1. 在 Chaterm 中打开"设置"页面
  2. 找到左侧 Skills Tab，点击 创建技能 或 导入
  3. 填写 Skill 的基本信息：
    • 名称：Skill 的显示名称
    • 描述：简要说明 Skill 的用途和适用场景
    • 内容：详细的操作流程和指令
    • 资源文件（可选）：关联的脚本、模板等文件
  4. 保存后，Skill 会自动启用并注入到 AI 上下文中

Skill 格式示例 ​

以下是一个 Kubernetes Pod 故障排查 Skill 的示例：

markdown
# Kubernetes Pod 故障排查

## 描述
当用户遇到 Pod 异常时，自动执行完整的排查流程

## 操作步骤
1. 检查 Pod 状态和事件
   - 执行 `kubectl get pod <pod-name> -n <namespace> -o yaml`
   - 查看 `kubectl describe pod <pod-name> -n <namespace>` 输出的事件信息

2. 查看最近 100 行日志
   - 执行 `kubectl logs <pod-name> -n <namespace> --tail=100`

3. 分析资源使用情况
   - 检查 CPU 和内存使用：`kubectl top pod <pod-name> -n <namespace>`
   - 查看资源限制配置：`kubectl get pod <pod-name> -n <namespace> -o jsonpath='{.spec.containers[*].resources}'`

4. 提供修复建议
   - 根据检查结果，提供针对性的修复建议
   - 如果资源不足，建议调整资源限制
   - 如果配置错误，提供正确的配置示例

Skill 结构说明 ​

基本结构 ​

一个完整的 Skill 通常包含以下部分：

  1. 标题：Skill 的名称
  2. 描述：说明 Skill 的用途、适用场景和预期效果
  3. 操作步骤：详细的操作流程，可以包含：
    • 命令示例
    • 检查点
    • 判断条件
    • 错误处理

高级特性 ​

条件判断 ​

Skill 可以包含条件逻辑：

markdown
## 操作步骤
1. 检查服务状态
2. 如果状态为 failed：
   - 查看错误日志
   - 尝试重启服务
3. 如果状态为 active：
   - 验证服务功能正常

资源文件引用 ​

Skill 可以关联外部资源文件：

markdown
## 资源文件
- scripts/deploy.sh
- templates/config.yaml

使用 Skills ​

启用/禁用 Skill ​

在 Skills 管理页面，你可以：

  • 启用 Skill：点击开关启用，Skill 会立即注入到 AI 上下文
  • 禁用 Skill：点击开关禁用，AI 将不再使用该 Skill
  • 编辑 Skill：修改 Skill 的内容和配置
  • 删除 Skill：移除不需要的 Skill

在对话中使用 ​

启用 Skill 后，在对话中只需描述你的需求，AI 会自动识别并使用对应的 Skill：

示例对话：

你：这个 Pod 有问题，帮我排查一下

AI：[自动使用 Kubernetes Pod 故障排查 Skill]
    - 正在检查 Pod 状态...
    - 正在查看日志...
    - 正在分析资源使用情况...
    - [提供修复建议]

多个 Skills 的协同 ​

你可以同时启用多个 Skills，AI 会根据对话上下文智能选择最合适的 Skill：

  • 如果多个 Skills 都匹配当前场景，AI 会综合使用
  • Skills 之间可以相互补充，形成更完整的解决方案

实际应用场景 ​

企业标准化操作 ​

对于企业用户来说，Skills 提供了以下价值：

标准化操作流程 ​

将最佳实践固化为 Skills，确保团队操作一致性。例如：

  • 部署流程 Skill：标准化的应用部署步骤
  • 回滚流程 Skill：统一的回滚操作规范
  • 安全检查 Skill：标准的安全审计流程

降低学习成本 ​

新员工可以直接使用团队积累的 Skills，快速上手：

  • 无需记忆复杂的命令和参数
  • 无需了解底层实现细节
  • 只需描述需求，AI 自动执行

知识沉淀 ​

将资深工程师的经验转化为可执行的 Skills：

  • 故障排查经验 → 故障排查 Skill
  • 性能优化技巧 → 性能优化 Skill
  • 安全加固方案 → 安全加固 Skill

个人效率提升 ​

对于个人用户，Skills 可以：

  • 自动化重复操作：将常用的操作流程固化为 Skill
  • 扩展 AI 能力：让 AI 掌握你的专业领域知识
  • 提升响应速度：AI 可以快速执行复杂的多步骤操作

导入和导出 ​

导入 Skill ​

你可以从以下来源导入 Skill：

  1. 从文件导入：

    • 支持 Markdown 格式的 Skill 文件
    • 支持包含资源文件的 Skill 包（ZIP 格式）

  2. 从 Terminal Skills 仓库导入：

相关资源 ​

Terminal Skills 官方仓库 ​

  • GitHub：chaterm/terminal-skills
  • 说明：专为终端工作流设计的 Skills 综合集合，包含各种运维、开发场景的 Skills

后续阅读 ​