Tiana Agent Skills
五个基础技能覆盖 Tiana 账号与实例、SQLite、Git、后端服务和 Web 应用。应用模板由在线目录提供，用户描述需求后，Agent 根据实时目录决定使用模板还是直接开发。
从 npm 安装
需要 Node.js 22.20+：
npx --yes @tianacloud/agent-skills@latest install --agent codex
安装器调用精确依赖的 skills 工具，把 npm 包中的全部技能复制到客户端的持久目录；Codex 当前工具使用 ~/.agents/skills/。不传目标时选择客户端：
npx --yes @tianacloud/agent-skills@latest install
目录导入型客户端可指定实际技能根目录：
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 | CLI 安装、登录、账号额度和通用实例管理 |
| tiana-sqlite | SQL、表结构、SDK 连接和数据库分支 |
| tiana-git | Git 实例、原生仓库操作和源码版本同步 |
| tiana-function | Go 后端服务源码、构建发布、参数/CORS 与数据库后端 |
| tiana-web | 实时模板选择、工程与数据初始化、通用开发、构建发布 |
Web 技能每次任务都实际执行 tiana web list-template --json，使用当前 name/description 判断需求。模板 ZIP 原样下载解压到独立项目目录；Agent 按根部 metadata.json 替换变量、先 schema 后 seeds。模板源码和制作规范见 template-apps，客户安装模板由 CLI 和 MGR 目录完成。
技能安装器只安装技能。Agent 首次执行 Tiana 任务时检查 CLI，缺少时自动执行下面的安装并继续原任务；CLI 要求 1.0.4 或更新正式版，需要 Node.js 20+。
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。
检查与更新
各 Tiana 技能调用 CLI 检查两个 npm 包的 latest。两个包各自最多每 24 小时尝试检查一次，CLI 普通终端与 Skills 共用每 24 小时一次提醒。Agent 发现 CLI 或 Skills 新正式版后自动安装并核验，无需再次询问；should_notify 不限制自动更新。每个会话首次检查后简短报告检查、两个包的更新结果及新增技能。
CLI 在当前实际使用的安装位置升级并核验版本和所需命令；Skills 安装新版包中的全部技能，覆盖已有技能并补齐新增技能，核验 metadata.version 与宿主加载结果。Connector 只分发初始版本，后续两个包独立更新，无需等待 Connector 发版。已加载的会话不会因磁盘替换而自动更换指令；需要重载时明确提示。具体步骤及失败后的继续条件见 开始使用，各宿主安装位置及加载核验见连接器与宿主中的自动更新。
维护与其他分发格式
skills/ 是所有格式的规范源。Pi 可使用 pi install npm:@tianacloud/agent-skills，支持 Agent Plugins v1 的客户端也可发现 plugin.json。构建、版本对齐、GitHub Actions 自动发布及 npm 初始配置见 Contributing。
Apache-2.0