Table of Contents

AI 智能体技能

  • 2026-09-04
  • Morten Lønskov
Applies to:
  • ❌ Tabular Editor 2
  • ❌ Tabular Editor 3
  • ✔ Tabular Editor CLI
Important

Tabular Editor CLI 目前为 有限公开预览版。 可使用 Tabular Editor 账户进行评估；预览期间无需许可证。 在正式发布之前，命令、标志位和输出都可能会发生变化。 预览版本将在 2026-10-31 之后停止工作。 在预览阶段，我们不建议在生产环境的 CI/CD 流水线中使用 CLI。

Tabular Editor CLI 自带一个开箱即用的智能体技能，让 AI 编码智能体学会如何驱动 te 命令行界面。 这是一个技能文件夹——包含作为入口的 SKILL.md，以及 references/ 中一组按需查阅的深入资料——里面整理了 CLI 的约定、命令参考、工作流和常见坑点。 安装后，如果你说“部署这个模型”或“添加一个计算利润率的度量值”，智能体会给出符合 te 用法的命令，而不是靠猜测或臆造选项。

该技能在公开的 TabularEditor/CLI repository 中维护，并会随着 CLI 预览功能的演进同步更新。

什么是技能

技能就是一个文件夹，里面有一个作为入口的 SKILL.md，代理会根据你的提示按需加载它。 它的 YAML frontmatter（name、description、version）会告诉智能体何时加载它，以及它涵盖哪些内容。 Markdown 正文会教代理如何完成这项工作；而更大的技能——比如这个——会在 references/ 下附带额外的参考文件，代理只会在需要时读取。

技能涵盖的内容

该技能会向智能体讲解 te 的完整功能：

  • 所有系列的 te 命令——涵盖 save-as、init、deploy、refresh、bpa、validate、query、script、util 等等
  • 身份验证模式——交互式、使用机密或证书的服务主体、环境变量、托管标识
  • 对象路径语法——斜杠形式、DAX 形式和通配符
  • 保存模型——默认执行 dry run；使用 --save 才会持久化保存；交互式 shell 还支持 --stage/--revert
  • TE2 到 CLI 的迁移映射
  • 适用于 GitHub Actions 和 Azure DevOps 的 CI/CD 实践方案
  • 输出格式、退出代码、环境变量和配置键
  • 用于 -p Name=Value 的常用属性名速查表
  • 实践中容易让智能体出错的常见坑点

这些内容与本节其余部分面向人类读者的说明是同一套内容。 命令参考请参见 @te-cli-commands，身份验证请参见 @te-cli-auth，流水线模式请参见 @te-cli-cicd。

下载技能

该技能位于 CLI repository 的 skills/te-cli 文件夹中：包含 SKILL.md 以及其 references/ 子文件夹。

  1. 克隆 TabularEditor/CLI repository，或下载该 repository 的 ZIP（Code > Download ZIP）并解压。
  2. 将整个 skills/te-cli/ 文件夹复制到一个方便的位置，并确保 references/ 子文件夹与 SKILL.md 放在一起。

在下面的安装步骤中，你会把这个文件夹移到工具指定的位置。 在下载较新版本之前，如果你想先看看版本之间有哪些变更，可以查看 CHANGELOG。

选择安装范围

每个代理都支持两种安装范围：

  • 项目范围 - 技能仅在某个项目或 repository 中可用。 如果不是每个项目都会涉及语义模型，就用这个选项。
  • 用户范围 - 技能在你这台机器上的所有项目中都可用。 如果你会在多个仓库中处理语义模型，就用这个选项。

为 Claude Code 安装

Claude Code 会从 .claude/skills/ 下的命名文件夹中加载技能。 description 字段会和你的提示词匹配，所以技能只会在相关时才加载；当你处理无关代码时，它不会消耗任何 token。

项目范围 - 技能只会在这个项目中加载：

  1. 在项目根目录中，创建文件夹 .claude/skills/te-cli/。
  2. 将下载的 te-cli 文件夹中的内容（SKILL.md 和 references/）复制到该文件夹中。

最终路径为 <your-project>/.claude/skills/te-cli/SKILL.md，并让 references/ 与其位于同一级目录。

用户范围 - 技能会在当前用户的所有项目中加载：

  1. 在你的用户级 Claude 技能目录中创建 te-cli 文件夹：
    • macOS / Linux： ~/.claude/skills/te-cli/
    • Windows： %USERPROFILE%\\.claude\\skills\\te-cli\\（通常为 C:\\Users\\<you>\\.claude\\skills\\te-cli\\）
  2. 将下载的 te-cli 文件夹中的内容（SKILL.md 和 references/）复制到该文件夹中。
Note

Claude Code 会监视技能目录，并在当前会话中识别新增或已编辑的技能，无需重启。 例外情况是：如果 .claude/skills/ 目录在会话开始时并不存在，而你后来才创建它，则需要重启一次 Claude Code，让它开始监视这个新目录。

验证技能是否已加载

在 Claude Code 会话中，运行：

/skills

你应该能在列表中看到 te-cli。 如果没有，请确认文件路径无误，并且文件以 --- 开头、第二行包含 name: te-cli，然后重启 Claude Code。

要进行功能性冒烟测试，可以这样提问：

what does `te deploy` do without `--execute`?

Claude 会按文档所述的行为作答——这是一次 dry run：它会将 TMSL 部署脚本打印到 stdout，而不会部署任何内容——这就表明该技能已加载并正在使用。

在 Claude.ai 和 Claude Desktop 中安装

Claude.ai（网页和桌面版）内置了 Skills 功能。 Skills 需要启用代码执行，并且上传时应使用技能文件夹打包成的 ZIP，而不是单独的 SKILL.md 文件。

  1. 启用代码执行：前往 Settings > Capabilities，并开启 Code execution and file creation。 在 Team 和 Enterprise 计划中，所有者需要在组织设置里启用这个功能。
  2. 将整个下载的 te-cli 文件夹（包括 references/）压缩为 te-cli.zip。
  3. 前往 Settings > Capabilities > Skills（也可通过 Customize > Skills 进入）。
  4. 点击 +，选择 Upload skill，然后选中 te-cli.zip。 Claude 会读取里面的 SKILL.md，并显示这个技能的摘要。
  5. 开启这个技能。 当你提到 te 或相关概念时，它会自动加载。

你上传的自定义技能默认只有你的账户能看到，除非 Team 或 Enterprise 的所有者启用了组织范围共享。

如果界面文案有变化，可以查看 Anthropic 的 Skills 帮助文章，了解当前的 UI 流程。

在 GitHub Copilot 中安装

VS Code 中的 GitHub Copilot 原生支持 Agent Skills 开放标准——也就是 Claude Code 和 Codex 使用的同一种 SKILL.md 格式。 这是推荐的方式，因为技能只会在相关时加载。 如果你的 Copilot 配置早于 Agent Skills，就改用下面通用的 AGENTS.md 安装方式。

Agent Skills（VS Code）

将技能文件夹中的内容（SKILL.md 和 references/）放到 skills 目录下一个单独命名的文件夹中。 文件夹名称必须与 frontmatter 中的 name 字段一致，因此请使用 te-cli，并保持 YAML frontmatter 完整不变。

  • Workspace 作用域： .github/skills/te-cli/SKILL.md（Copilot 也会读取 .claude/skills/ 和 .agents/skills/）。
  • 用户范围： ~/.copilot/skills/te-cli/SKILL.md（Copilot 也会读取 ~/.claude/skills/ 和 ~/.agents/skills/）。

在 Copilot Chat 中输入 /，确认 te-cli 显示为斜杠命令；或者使用命令面板中的 Chat: Open Customizations 打开 Agent 自定义编辑器。

在 OpenAI Codex CLI 中安装

Codex CLI 会直接从 .agents/skills/ 下的命名文件夹中加载技能，和 Claude Code 一样采用基于目录的模式。 请保留 YAML frontmatter——Codex 要求包含 name 和 description 字段，并会根据 description 来决定何时加载该技能。

项目范围——该技能只会在这个项目中加载：

  1. 在项目根目录中创建文件夹 .agents/skills/te-cli/。
  2. 将下载的 te-cli 文件夹中的内容（SKILL.md 和 references/）复制到该文件夹中。

Codex 会从你的工作目录向上扫描，因此提交在 repository 根目录（$REPO_ROOT/.agents/skills/te-cli/）的技能，会在该 repository 中的所有协作者之间共享。

个人范围——该技能会在你的每个项目中加载：

  1. 在你的个人 Codex 技能目录中创建 te-cli 文件夹：~/.agents/skills/te-cli/。
  2. 将下载的 te-cli 文件夹中的内容（SKILL.md 和 references/）复制到该文件夹中。

在 Codex CLI 或 IDE 中运行 /skills，确认列表中有 te-cli，并输入 te-cli 以显式指定该技能。

为通用 Agent 安装

对于遵循 AGENTS.md convention 或支持使用任意说明文件的工具——Aider、Continue、自定义内部 Agent：

  1. 下载技能文件夹。
  2. 在 SKILL.md 的一个副本中，删除顶部的 YAML frontmatter 区块（即第一处和第二处 --- 之间的所有内容，包括这两行本身）。
  3. 将该文件重命名为 AGENTS.md，并放到项目根目录，或该工具预期的说明文件位置。
  4. 将 references/ 文件夹复制到 AGENTS.md 旁边，以便其中的相对链接继续正常工作。
  5. 这个项目中下一次运行 Agent 时，就会读取这些说明。

更新技能

要获取更新版本：

  1. 从 GitHub 获取最新的 skills/te-cli 文件夹（重新克隆、拉取更新，或重新下载 repository 的 ZIP 包）。
  2. 替换之前安装的内容：
    • 原生技能（Claude Code、Codex、Copilot Agent Skills）： 替换整个技能文件夹的全部内容（SKILL.md 和 references/）。
    • Claude.ai / Desktop： 重新将 te-cli 文件夹打包成 ZIP 文件，再通过 Skills UI 重新上传。
    • 基于说明文件的安装（AGENTS.md）： 将正文重新粘贴到 AGENTS.md 中，并更新已复制的 references/ 文件夹。

查看 CHANGELOG 了解各版本之间的变更。

后续步骤