Skills Rules 脚手架工具

• npm 安装执行命令

npx -y kl-ai-cli@latest

• npm 安装到指定目录下

npx -y kl-ai-cli@latest -d .cursor

• pnpm 安装执行命令

pnpm dlx kl-ai-cli@latest

• pnpm 安装到指定目录下

pnpm dlx kl-ai-cli@latest -d .cursor

Skill 及 Rules 托管在 GitLab 仓库中，可在仓库维护。

终端配色

默认 auto：优先读 COLORFGBG 判断终端背景；macOS 未设置时读取系统浅色/深色模式；其余环境默认 dark。

| 方式 | 示例 | |------|------| | 命令行 | kl-ai-cli --theme light | | 环境变量 | KL_AI_CLI_THEME=dark | | 禁用颜色 | --theme plain，或 auto 模式下设置 NO_COLOR=1 |

可选值：dark（深色终端）、light（浅色终端）、auto（自动检测）、plain（纯文本）

Cursor / VS Code 集成终端常默认设置 NO_COLOR=1。此时 auto 为纯文本；若需配色请显式指定 --theme light 或 --theme dark。

Windows CMD：经典 CMD 不支持 Unicode 块字符，会自动切换 ASCII 版 KAI Logo。也可手动设置 KL_AI_CLI_ASCII=1 强制 ASCII，或 KL_AI_CLI_UNICODE=1 强制 Unicode（需 Windows Terminal 等现代终端）。

文件更新规则

CLI 只会处理本次勾选的安装项，不会扫描或清理未选中的本地文件。

路径映射

仓库中的根前缀（如 backend、frontend）会替换为本地目标目录（默认 .cursor，可通过 -d 指定）。

示例：backend/skills/andrej-karpathy/SKILL.md → .cursor/skills/andrej-karpathy/SKILL.md

目录类安装项（先删后写）

适用于所有多文件目录安装项，不限于 skills，rules、commands 若以后以文件夹形式维护，同样适用。

判断方式：选中项下存在子路径文件（如 xxx/foo/bar.md），即视为目录安装。

示例：

• skills/andrej-karpathy/
• rules/team-standards/（若以后改为目录）
• commands/git-workflow/（若以后改为目录）

处理流程：

1. 下载前，删除本地对应整个目录（如 .cursor/skills/andrej-karpathy）
2. 再从 GitLab 重新下载该目录下的全部文件

这样远程仓库中已删除的文件，本地 reinstall 后也会同步移除，不会残留旧文件。

单文件安装项（直接覆盖）

适用于单个文件安装项（如 rules/xxx.mdc、commands/foo.md），与分类无关。

• 不删除父目录
• 直接覆盖同名文件

未选中项

本次未勾选的 skill / rule / command 不会被修改或删除。若需清理某个旧条目，请在交互中勾选该项后重新安装。