# @tianacloud/agent-skills 中文文档

规范地址：https://npmcn.com/package/%40tianacloud/agent-skills/

版本：1\.0\.12
npm 元数据更新时间：2026-11-02T15:34:09.571Z
中文译文更新时间：2026-11-02T16:45:04.095Z
软件包许可：Apache-2\.0

本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40tianacloud/agent-skills
原文对照：https://npmcn.com/package/%40tianacloud/agent-skills/?lang=original
项目主页：https://github.com/tianacloud/agent-skills#readme
源码仓库：https://github.com/tianacloud/agent-skills

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：198 kB，36 个文件
- TypeScript 类型：未声明
- Node.js 要求：\>=22\.20\.0
- 运行依赖：1 个
- 首次发布：2026-10-04T10:31:35.926Z
- 最新版本发布：2026-11-02T15:34:09.163Z
- 已发布版本数：20（近 12 个月 20 个）

## 中文简介

Tiana云技能的帐户，SQLite, Git，函数和Web应用程序

## 安装

```sh
npm install @tianacloud/agent-skills
```

也可以使用：`pnpm add @tianacloud/agent-skills`、`yarn add @tianacloud/agent-skills`、`bun add @tianacloud/agent-skills`

## README

# Tiana Agent Skills

五个基础技能覆盖 Tiana 账号与实例、SQLite、Git、后端服务和 Web 应用。应用模板由在线目录提供，用户描述需求后，Agent 根据实时目录决定使用模板还是直接开发。

## 从 npm 安装

需要 Node.js 22.20+：

```sh
npx --yes @tianacloud/agent-skills@latest install --agent codex
```

安装器调用精确依赖的 skills 工具，把 npm 包中的全部技能复制到客户端的持久目录；Codex 当前工具使用 `~/.agents/skills/`。不传目标时选择客户端：

```sh
npx --yes @tianacloud/agent-skills@latest install
```

目录导入型客户端可指定实际技能根目录：

```sh
npx --yes @tianacloud/agent-skills@latest install --dir /path/to/client/skills
```

Windows PowerShell 使用 `npx.cmd`。目录可以含空格，用引号包住。重复安装会更新包内全部技能并补齐新版新增技能，其他技能保留。安装完成后让客户端重载技能或开始新会话。

WorkBuddy、豆包按所用版本的目录／ZIP 导入方式加载这五个目录，保留 SKILL.md 和 references。若要求 ZIP，可将每个技能目录的内容打包，SKILL.md 位于包根部。WorkBuddy 专用本地化 ZIP 由维护者构建流程提供；本仓验证 ZIP 格式和内容，不声称已验收这些客户端的运行行为。

## 五个入口

| 技能 | 职责 |
| --- | --- |
| [tiana](https://npmcn.com/package/%40tianacloud/agent-skills/skills/tiana/SKILL.md) | CLI 安装、登录、账号额度和通用实例管理 |
| [tiana-sqlite](https://npmcn.com/package/%40tianacloud/agent-skills/skills/tiana-sqlite/SKILL.md) | SQL、表结构、SDK 连接和数据库分支 |
| [tiana-git](https://npmcn.com/package/%40tianacloud/agent-skills/skills/tiana-git/SKILL.md) | Git 实例、原生仓库操作和源码版本同步 |
| [tiana-function](https://npmcn.com/package/%40tianacloud/agent-skills/skills/tiana-function/SKILL.md) | Go 后端服务源码、构建发布、参数/CORS 与数据库后端 |
| [tiana-web](https://npmcn.com/package/%40tianacloud/agent-skills/skills/tiana-web/SKILL.md) | 实时模板选择、工程与数据初始化、通用开发、构建发布 |

Web 技能每次任务都实际执行 `tiana web list-template --json`，使用当前 name/description 判断需求。模板 ZIP 原样下载解压到独立项目目录；Agent 按根部 metadata.json 替换变量、先 schema 后 seeds。模板源码和制作规范见 [template-apps](https://github.com/tianacloud/template-apps)，客户安装模板由 CLI 和 MGR 目录完成。

技能安装器只安装技能。Agent 首次执行 Tiana 任务时检查 CLI，缺少时自动执行下面的安装并继续原任务；CLI 要求 1.0.4 或更新正式版，需要 Node.js 20+。

```sh
npm install -g @tianacloud/cli@latest --registry=https://registry.npmjs.org/
```

CLI 主包及当前系统的原生平台包全部来自 npm，提供 tiana 和 git-remote-tiana。保持 optional dependencies 启用；`--ignore-scripts` 也可安装。

## 环境选择

普通用户可以直接要求：“执行 `npx -y @tianacloud/agent-skills@latest install` 安装 Tiana skills，然后使用 tiana 创建一个账单应用。”未配置环境时，CLI 使用 online 公有域名与系统 CA；首次登录按 Agent 提供的浏览器链接授权。

开发者也可以向已运行的 Agent 要求：“设置 `TIANA_API_ORIGIN=https://console.tianacloud-staging.net`，安装 Tiana skills，然后创建一个账单应用。”技能会在本任务每次 CLI/Git 调用中传递这一选择。staging CLI 自动加载内置 CA；开发者需已有 VPN/DNS 和浏览器 CA 信任。仅在安装器子进程中 export 一次不会配置后续命令。

WorkBuddy Connector 固定 online，配置和当前使用说明见 [Connector](https://npmcn.com/package/%40tianacloud/agent-skills/docs/workbuddy-connector.md)。

## 检查与更新

各 Tiana 技能调用 CLI 检查两个 npm 包的 latest。两个包各自最多每 24 小时尝试检查一次，CLI 普通终端与 Skills 共用每 24 小时一次提醒。Agent 发现 CLI 或 Skills 新正式版后自动安装并核验，无需再次询问；should\_notify 不限制自动更新。每个会话首次检查后简短报告检查、两个包的更新结果及新增技能。

CLI 在当前实际使用的安装位置升级并核验版本和所需命令；Skills 安装新版包中的全部技能，覆盖已有技能并补齐新增技能，核验 metadata.version 与宿主加载结果。Connector 只分发初始版本，后续两个包独立更新，无需等待 Connector 发版。已加载的会话不会因磁盘替换而自动更换指令；需要重载时明确提示。具体步骤及失败后的继续条件见 [开始使用](https://npmcn.com/package/%40tianacloud/agent-skills/skills/tiana/references/getting-started.md#%E6%9B%B4%E6%96%B0)，各宿主安装位置及加载核验见[连接器与宿主中的自动更新](https://npmcn.com/package/%40tianacloud/agent-skills/skills/tiana/references/connector-updates.md)。

## 维护与其他分发格式

skills/ 是所有格式的规范源。Pi 可使用 `pi install npm:@tianacloud/agent-skills`，支持 Agent Plugins v1 的客户端也可发现 plugin.json。构建、版本对齐、GitHub Actions 自动发布及 npm 初始配置见 [Contributing](https://npmcn.com/package/%40tianacloud/agent-skills/CONTRIBUTING.md)。

Apache-2.0

## 常见问题

### @tianacloud/agent-skills 是什么？

Tiana云技能的帐户，SQLite, Git，函数和Web应用程序

### 如何安装 @tianacloud/agent-skills？

在项目目录运行 npm install @tianacloud/agent-skills，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 tiana-skills，可以用 npx tiana-skills 直接运行。

### @tianacloud/agent-skills 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/tianacloud\_\_agent-skills 是否存在。

### @tianacloud/agent-skills 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22\.20\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @tianacloud/agent-skills 可以商用吗？

@tianacloud/agent-skills 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @tianacloud/agent-skills 还在维护吗？

最新版本 1\.0\.12 发布于 2026/11/02（今天）；至今共发布 20 个版本，其中过去 12 个月发布了 20 个；首次发布于 2026/10/04。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。