Kimi CLI 文档

简体中文

English

简体中文

English

Appearance

Agent Skills ​

Agent Skills 是一个开放格式，用于为 AI Agent 添加专业知识和工作流程。Kimi CLI 支持加载 Agent Skills，扩展 AI 的能力。

Agent Skills 是什么 ​

一个 Skill 就是一个包含 SKILL.md 文件的目录。Kimi CLI 启动时会发现所有 Skills，并将它们的名称、路径和描述注入到系统提示词中。AI 会根据当前任务的需要，自行决定是否读取具体的 SKILL.md 文件来获取详细指引。

例如，你可以创建一个「代码风格」Skill，告诉 AI 你项目的命名规范、注释风格等；或者创建一个「安全审计」Skill，让 AI 在审查代码时关注特定的安全问题。

Skill 发现 ​

Kimi CLI 会从以下目录发现 Skills：

  1. 内置 Skills（随软件包安装）
  2. ~/.kimi/skills（用户目录）
  3. ~/.claude/skills（兼容 Claude 的 Skills）

如果同名 Skill 存在于多个目录中，后发现的会覆盖先前的。你也可以通过 --skills-dir 参数指定其他目录：

sh
kimi --skills-dir /path/to/my-skills

内置 Skills ​

Kimi CLI 内置了以下 Skills：

  • kimi-cli-help：Kimi CLI 帮助。解答关于 Kimi CLI 安装、配置、斜杠命令、键盘快捷键、MCP 集成、供应商、环境变量等问题。
  • skill-creator：Skill 创建指南。当你需要创建新的 Skill（或更新现有 Skill）来扩展 Kimi 的能力时，可以使用此 Skill 获取详细的创建指导和最佳实践。

创建 Skill ​

创建一个 Skill 只需要两步：

  1. 在 skills 目录下创建一个子目录
  2. 在子目录中创建 SKILL.md 文件

目录结构

一个 Skill 目录至少需要包含 SKILL.md 文件，也可以包含辅助目录来组织更复杂的内容：

~/.kimi/skills/
└── my-skill/
    ├── SKILL.md          # 必需：主文件
    ├── scripts/          # 可选：脚本文件
    ├── references/       # 可选：参考文档
    └── assets/           # 可选：其他资源

SKILL.md 格式

SKILL.md 使用 YAML Frontmatter 定义元数据，后面是 Markdown 格式的提示词内容：

markdown
---
name: code-style
description: 我的项目代码风格规范
---

## 代码风格

在这个项目中，请遵循以下规范：

- 使用 4 空格缩进
- 变量名使用 camelCase
- 函数名使用 snake_case
- 每个函数都需要 docstring
- 单行不超过 100 字符

Frontmatter 字段

字段说明是否必填
nameSkill 名称，1-64 字符，只能使用小写字母、数字和连字符；省略时默认使用目录名否
descriptionSkill 描述，1-1024 字符，说明 Skill 的用途和使用场景；省略时显示 "No description provided."否
license许可证名称或文件引用否
compatibility环境要求说明，最多 500 字符否
metadata额外的键值对属性否

最佳实践

  • 保持 SKILL.md 在 500 行以内，将详细内容移到 scripts/、references/ 或 assets/ 目录
  • 在 SKILL.md 中使用相对路径引用其他文件
  • 提供清晰的步骤指引、输入输出示例和边界情况说明

示例 Skill ​

PPT 制作

markdown
---
name: pptx
description: 创建和编辑 PowerPoint 演示文稿
---

## PPT 制作流程

创建演示文稿时，遵循以下步骤：

1. 分析内容结构，规划幻灯片大纲
2. 选择合适的配色方案和字体
3. 使用 python-pptx 库生成 .pptx 文件

## 设计原则

- 每页幻灯片聚焦一个主题
- 文字简洁，使用要点而非长段落
- 保持视觉层次清晰，标题、正文、注释有明确区分
- 配色统一，避免超过 3 种主色

Python 项目规范

markdown
---
name: python-project
description: Python 项目开发规范，包括代码风格、测试和依赖管理
---

## Python 开发规范

- 使用 Python 3.14+
- 使用 ruff 进行代码格式化和 lint
- 使用 pyright 进行类型检查
- 测试使用 pytest
- 依赖管理使用 uv

代码风格：
- 行长度限制 100 字符
- 使用类型注解
- 公开函数需要 docstring

Git 提交规范

markdown
---
name: git-commits
description: Git 提交信息规范，使用 Conventional Commits 格式
---

## Git 提交规范

使用 Conventional Commits 格式：

类型(范围): 描述

允许的类型：feat, fix, docs, style, refactor, test, chore

示例：
- feat(auth): 添加 OAuth 登录支持
- fix(api): 修复用户查询返回空值的问题
- docs(readme): 更新安装说明

使用斜杠命令加载 Skill ​

/skill:<name> 斜杠命令让你可以将常用的提示词模板保存为 Skill，需要时快速调用。输入命令后，Kimi CLI 会读取对应的 SKILL.md 文件内容，并将其作为提示词发送给 Agent。

例如：

  • /skill:code-style：加载代码风格规范
  • /skill:pptx：加载 PPT 制作流程
  • /skill:git-commits 修复用户登录问题：加载 Git 提交规范，同时附带额外的任务描述

斜杠命令后面可以附带额外的文本，这些内容会追加到 Skill 提示词之后，作为用户的具体请求。

提示

如果只是普通对话，Agent 会根据上下文自动判断是否需要读取 Skill 内容，不需要手动调用。

Skills 让你可以将团队的最佳实践和项目规范固化下来，确保 AI 始终遵循一致的标准。