@tianacloud/agent-skills 0.3.4 → 1.0.0

package/README.md

@@ -37,7 +37,7 @@ WorkBuddy、豆包按所用版本的目录／ZIP 导入方式加载这四个目
 
 Web 技能每次任务都实际执行 `tiana web list-template --json`，使用当前 name/description 判断需求。模板 ZIP 原样下载解压到独立项目目录；Agent 按根部 metadata.json 替换变量、先 schema 后 seeds。模板源码和制作规范见 [template-apps](https://github.com/tianacloud/template-apps)，客户安装模板由 CLI 和 MGR 目录完成。
 
-技能安装不包含 CLI。需要时单独安装 Node.js 20+ 的原生工具包：
+技能安装器只安装技能。Agent 首次执行 Tiana 任务时检查 CLI，缺少时自动执行下面的安装并继续原任务；CLI 要求 1.0.0 或更新正式版，需要 Node.js 20+。
 
 ```sh
 npm install -g @tianacloud/cli@latest --registry=https://registry.npmjs.org/
@@ -45,9 +45,17 @@ 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](docs/workbuddy-connector.md)。
+
 ## 检查与更新
 
-四个技能调用 CLI 检查 npm latest，CLI 普通终端调用也使用同一本地状态。两个包各自最多每 24 小时尝试检查一次，CLI 与 Skills 共用每 24 小时一次提醒。断网继续任务，升级需要用户确认。
+四个技能调用 CLI 检查 npm latest，CLI 普通终端调用也使用同一本地状态。两个包各自最多每 24 小时尝试检查一次，CLI 与 Skills 共用每 24 小时一次提醒。已满足最低 CLI 版本时，断网不阻断任务；升级需要用户确认。
 
 确认升级后重新安装检查返回的实际版本，并核验 `tiana version`、技能 metadata.version 和宿主重载结果。已加载的会话不会因磁盘替换而自动更换指令。详情见 [开始使用](skills/tiana/references/getting-started.md)。
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tianacloud/agent-skills",
-  "version": "0.3.4",
+  "version": "1.0.0",
   "description": "Tiana Cloud Skills for accounts, SQLite, Git and Web applications",
   "license": "MIT",
   "repository": {

package/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
   "name": "tiana",
-  "version": "0.3.4",
+  "version": "1.0.0",
   "description": "Tiana Cloud account, SQLite, Git and Web application workflows",
   "author": {
     "name": "Tiana Cloud",

package/skills/tiana/SKILL.md

@@ -4,17 +4,17 @@ description: 使用 Tiana Cloud 管理实例、安装 CLI、登录和恢复账
 license: MIT
 metadata:
   author: Tiana Cloud
-  version: "0.3.4"
+  version: "1.0.0"
   source: https://github.com/tianacloud/agent-skills/tree/main/skills/tiana
 ---
 
 # Tiana Cloud
 
-本技能使用 `@tianacloud/cli`，包内提供 `tiana` 和 `git-remote-tiana`。安装与登录阅读[开始使用](references/getting-started.md)；Windows 安装或命令找不到时阅读 [Windows CLI 安装](references/windows-install.md)和 [PATH 与 helper 排查](references/windows-git-helper.md)。在 Agent 实际执行命令的环境中操作。
+本技能使用 `@tianacloud/cli`，包内提供 `tiana` 和 `git-remote-tiana`。安装与登录阅读[开始使用](references/getting-started.md)；Windows 安装或命令找不到时阅读 [Windows CLI 安装](references/windows-install.md)和 [PATH 与 helper 排查](references/windows-git-helper.md)。在 Agent 实际执行命令的环境中操作。默认 online；用户在任务中明确指定环境时，按开始使用中的环境规则传给每次 CLI/Git 调用。
 
 ## 每次调用的更新检查
 
-CLI 可用后，执行 `tiana version check --skills-version 0.3.4 --json`，传入本次实际加载的 metadata.version。只在 `should_notify=true` 时简短提醒可用版本并询问是否升级；用户稍后再升级时继续原任务。检查不可用也继续任务。本地 CLI 统一控制检查缓存和 24 小时一次提醒，无需自行记忆或计时。用户确认后的升级及重载见[开始使用](references/getting-started.md#更新)。
+CLI 已满足最低版本要求后，执行 `tiana version check --skills-version 1.0.0 --json`，传入本次实际加载的 metadata.version。只在 `should_notify=true` 时简短提醒可用版本并询问是否升级；用户稍后再升级时继续原任务。检查不可用也继续任务。本地 CLI 统一控制检查缓存和 24 小时一次提醒，无需自行记忆或计时。用户确认后的升级及重载见[开始使用](references/getting-started.md#更新)。
 
 ## 选择工作流程
 

package/skills/tiana/references/getting-started.md

@@ -1,6 +1,10 @@
 # 开始使用
 
-在 Agent 实际执行命令的环境检查 `tiana version`、`tiana login --help`、`tiana web --help`。CLI 需要具备分步登录、sqlite、git、web、list-template/init-template 和 version check；缺少所需命令时安装匹配的正式发行版本，不猜已经发布了哪个版本。
+在 Agent 实际执行命令的环境检查 `tiana version`。本技能要求 CLI 1.0.0 或更新正式版，具备分步登录、sqlite、git、web、list-template/init-template 和 version check。CLI 不存在时执行下面的 npm 安装并重新核验；已有版本过低时按更新流程取得用户确认后升级，再执行资源操作。不要仅凭同名命令存在跳过版本核验。
+
+最低版本核验独立于更新提醒：0.x、预发行版、dev 或无法核实的版本不满足本技能基线。即使 `should_notify=false` 或更新检查不可用，也不能据此跳过最低版本要求；先完成已获授权的升级，尚未获授权时说明需要升级，暂缓依赖新版 CLI 的资源操作。CLI 与 Skills 独立编号，`--skills-version` 仍传实际加载的 Skills 版本。
+
+最低版本升级已获授权但更新检查不可用时，可安装已发布基线 `npm install -g @tianacloud/cli@1.0.0 --registry=https://registry.npmjs.org/`，随后核验 `tiana version`；下载失败则报告实际错误，不继续资源操作。
 
 ## 安装
 
@@ -20,21 +24,36 @@ npx --yes @tianacloud/agent-skills@latest install --agent codex
 
 其他客户端按自己的安装目录使用 `install --dir PATH`，或不传目标运行客户端选择流程。四个 Skills 来自 npm 包内目录，安装后是持久文件副本。导入 Skill 与安装 CLI 是两步。
 
-核验安装后直接执行 `tiana status`，按实际结果继续任务或恢复登录。安装失败时报告实际阶段；没有执行过的登录、资源创建或发布仍然未知。
+核验安装后直接执行 `tiana status`，按实际结果继续任务或恢复登录。用户同时要求创建应用时，完成安装和登录后继续原始需求。当前会话可以读取新安装的 SKILL.md 及其引用文件；宿主必须重载才可使用时，明确提示重载，并保留应用需求及本次环境选择。安装失败时报告实际阶段；没有执行过的登录、资源创建或发布仍然未知。
 
 ## 更新
 
 四个入口执行 `tiana version check --skills-version VERSION --json`；VERSION 来自本次加载的 Skill metadata.version。结果是直接 JSON，包含 should_notify、check_status 和 updates。
 
-仅在 should_notify 为 true 时简短告诉用户 updates 中当前版本和新版本，并询问是否升级。不要因 updates 非空却 should_notify=false 再次提醒。CLI 保存两个包各自的检查尝试时间和共同的提醒时间，滚动 24 小时最多提醒一次；断网、状态不可写或版本未知时继续任务。
+仅在 should_notify 为 true 时简短告诉用户 updates 中当前版本和新版本，并询问是否升级。不要因 updates 非空却 should_notify=false 再次提醒。CLI 保存两个包各自的检查尝试时间和共同的提醒时间，滚动 24 小时最多提醒一次；已核实 CLI 满足最低版本时，断网、更新状态不可写或待检查包版本未知不阻断任务。
 
-用户选择稍后升级时继续原任务；确认后才安装所选包的实际更新版本：CLI 使用 `npm install -g @tianacloud/cli@VERSION --registry=https://registry.npmjs.org/`；Skills 使用 `npx --yes @tianacloud/agent-skills@VERSION install --agent CLIENT`，或复用原来的 `--dir PATH`。VERSION 从检查结果取得，CLIENT/目录对应当前宿主的实际安装目标。
+当前 CLI 已满足最低版本时，用户选择稍后升级仍继续原任务；确认后才安装所选包的实际更新版本：CLI 使用 `npm install -g @tianacloud/cli@VERSION --registry=https://registry.npmjs.org/`；Skills 使用 `npx --yes @tianacloud/agent-skills@VERSION install --agent CLIENT`，或复用原来的 `--dir PATH`。VERSION 从检查结果取得，CLIENT/目录对应当前宿主的实际安装目标。
 
 CLI 升级后核验 `tiana version` 和所需帮助；Skills 安装后检查四份 SKILL.md 的 metadata.version，并让宿主重载或开始新会话。当前会话已经加载的旧指令仍按旧版本处理，不把磁盘替换当作已重载。升级失败保留实际错误，不中途改动应用资源或凭据来修复。
 
 ## 环境与地址
 
-技能和命令继承外围启动器的 `TIANA_API_ORIGIN`，不在技能内设置或覆盖。CLI 报告入口缺失、歧义或证书问题时按其实际提示处理；唯一已保存入口的发现由 CLI 负责。
+未设置 `TIANA_API_ORIGIN` 时，CLI 默认连接 online：`https://console.tianacloud.com`，使用系统公有 CA；已保存的 staging 账号不会改变默认环境。外围启动器已设置变量时继承其选择。
+
+用户在当前任务明确指定 origin（包括把 `export TIANA_API_ORIGIN=...` 写在请求中）时，将该值传入本任务后续每次 CLI、原生 Git 和相关子进程调用。优先使用执行器的环境参数；执行器只有 shell 时，在同一次调用中设置变量并执行命令。每次工具调用都可能启动新进程，安装时执行一次 export 不会影响后续调用。任务恢复时继续使用用户已选 origin；没有用户的新选择时不要自行切换。环境选择只属于当前任务，不写入技能目录、应用源码或用户启动文件。
+
+例如用户明确选择 staging 后，每次 POSIX shell 调用都携带环境，包括安装后的独立调用：
+
+```sh
+export TIANA_API_ORIGIN=https://console.tianacloud-staging.net
+tiana status
+```
+
+后续 `git push` 也在其所在的工具调用中设置相同变量，让 `git-remote-tiana` 继承。PowerShell 使用 `$env:TIANA_API_ORIGIN`，同样需在每次独立调用中传递。
+
+staging CLI 自动加载内置公共根证书，无需另设 CA 文件；开发者须已接入 staging VPN/DNS，并为浏览器一次性安装 staging CA。证书来源、指纹和安装步骤见 [CLI staging 信任说明](https://github.com/tianacloud/cli/blob/main/docs/staging-ca.md)。证书故障按实际提示处理，不能关闭验证或切到另一个环境。
+
+WorkBuddy Connector 由自身命令环境固定 online，其安装、登录及业务命令沿用该环境。
 
 Console/管理 API、用户 Web 地址、数据库 Endpoint 各有用途：全部取实际 CLI/服务回执，不猜域名或把管理地址作为数据库连接地址。应用地址使用回执中的 application_url，Git URL 使用用户 Git 实例的 Endpoint。
 

package/skills/tiana-git/SKILL.md

@@ -4,7 +4,7 @@ description: 使用 Tiana Git 管理 Git 实例和原生仓库，关联项目远
 license: MIT
 metadata:
   author: Tiana Cloud
-  version: "0.3.4"
+  version: "1.0.0"
   parent: tiana
   source: https://github.com/tianacloud/agent-skills/tree/main/skills/tiana-git
 ---
@@ -15,7 +15,7 @@ metadata:
 
 ## 每次调用的更新检查
 
-CLI 可用后执行 `tiana version check --skills-version 0.3.4 --json`，使用本次加载的 metadata.version。仅在 `should_notify=true` 时提醒并询问是否升级；用户稍后或检查不可用时继续原任务。升级和会话重载见 [开始使用](../tiana/references/getting-started.md#更新)。CLI 控制共同的 24 小时提醒额度。
+CLI 已满足最低版本要求后执行 `tiana version check --skills-version 1.0.0 --json`，使用本次加载的 metadata.version。仅在 `should_notify=true` 时提醒并询问是否升级；用户稍后或检查不可用时继续原任务。升级和会话重载见 [开始使用](../tiana/references/getting-started.md#更新)。CLI 控制共同的 24 小时提醒额度。
 
 ## 实例与仓库
 

package/skills/tiana-sqlite/SKILL.md

@@ -4,7 +4,7 @@ description: 查询 Tiana SQLite 表结构、执行 SQL、选择数据库分支
 license: MIT
 metadata:
   author: Tiana Cloud
-  version: "0.3.4"
+  version: "1.0.0"
   parent: tiana
   source: https://github.com/tianacloud/agent-skills/tree/main/skills/tiana-sqlite
 ---
@@ -15,7 +15,7 @@ metadata:
 
 ## 每次调用的更新检查
 
-CLI 可用后执行 `tiana version check --skills-version 0.3.4 --json`，使用本次加载的 metadata.version。仅在 `should_notify=true` 时提醒并询问是否升级；用户选择稍后或检查不可用时继续原任务。用户确认后的升级和重载见 [开始使用](../tiana/references/getting-started.md#更新)。CLI 管理共同的 24 小时提醒额度。
+CLI 已满足最低版本要求后执行 `tiana version check --skills-version 1.0.0 --json`，使用本次加载的 metadata.version。仅在 `should_notify=true` 时提醒并询问是否升级；用户选择稍后或检查不可用时继续原任务。用户确认后的升级和重载见 [开始使用](../tiana/references/getting-started.md#更新)。CLI 管理共同的 24 小时提醒额度。
 
 ## 查询与命令行
 

package/skills/tiana-sqlite/references/rust-sdk.md

@@ -1,5 +1,52 @@
-# Rust 客户端
+# Rust SQLite 客户端
 
-本技能的公共安装入口为 CLI 和 JavaScript SDK。Rust transport SDK 尚无本技能可核实的公共发行入口；已有获准 SDK 源码或制品时，使用该制品附带的接口与版本说明，不猜 crates.io 版本或仓库地址。
+Rust 1.85+ 可从公开 GitHub 仓库安装已发布的 Git 标签 `v1.0.0`：
 
-连接目标使用 CLI 返回的实际数据库 Endpoint。transport core 提供原生数据库协议的双向字节通道，不是 SQL builder 或 ORM；上层客户端选择与数据库一致的协议。保持目标身份和连接验证，已建立会话的 SQL 不自动重放。SQL 使用与结果不明处理见 [SQL 命令](sql.md)。
+- [sdk-rust-sqlite](https://github.com/tianacloud/sdk-rust-sqlite/tree/v1.0.0) 提供 Hrana v3 SQL 会话、参数和事务。
+- [sdk-rust](https://github.com/tianacloud/sdk-rust/tree/v1.0.0) 提供 TLS/H2 CONNECT transport；原生通道本身不是 SQL 客户端或 ORM。
+
+## 固定依赖
+
+```toml
+[dependencies]
+tiana-sdk-sqlite = { git = "https://github.com/tianacloud/sdk-rust-sqlite.git", tag = "v1.0.0" }
+tiana-sdk = { git = "https://github.com/tianacloud/sdk-rust.git", rev = "c1f5c9872bdea4aaa542d33f613e92e005ea03ff", version = "=0.1.0-dev.5" }
+tokio = { version = "=1.53.1", features = ["macros", "rt-multi-thread"] }
+```
+
+core 的完整 revision 是其 `v1.0.0` 指向的提交，并与 SQLite adapter 的依赖来源保持一致，避免同一 core 的不同 Cargo Git source 导致类型不兼容。Git 标签不是 crates.io 包版本：这次标签下的 crate 版本仍分别为 `0.1.0-dev.1`（SQLite）和 `0.1.0-dev.5`（core）；不要写成来自 crates.io 的 `tiana-sdk = "1.0.0"`。提交 Cargo.toml 和 Cargo.lock，后续构建使用 `cargo build --locked`，不依赖相邻工作副本或本机 path/patch。
+
+## 参数化只读查询
+
+连接目标使用 CLI 返回的实际数据库 Endpoint。应用由自己的凭据提供方注入有效连接 Token；示例从环境读取，不读取 CLI 凭据文件，不把 Token 写入源码或日志，不要求用户粘贴 Token。SDK 不自动复用 CLI 登录态或刷新凭据。
+
+```rust
+use tiana_sdk::{Client, SecretToken};
+use tiana_sdk_sqlite::{Session, Statement, Value};
+
+#[tokio::main]
+async fn main() -> Result<(), Box<dyn std::error::Error>> {
+    let endpoint = std::env::var("TIANA_ENDPOINT")?;
+    let token = std::env::var("TIANA_TOKEN")?;
+    let client = Client::builder(endpoint)
+        .token(SecretToken::parse(token.as_bytes())?)
+        .build()?;
+    let mut session = Session::new(client);
+    let result = session
+        .query(&Statement::new("SELECT ? AS value").args([Value::Integer(42)]))
+        .await;
+    let closed = session.close().await;
+    let result = result?;
+    closed?;
+    let value = match result.rows.first().and_then(|row| row.first()) {
+        Some(Value::Integer(value)) => value,
+        _ => return Err("unexpected result type".into()),
+    };
+    println!("{value}");
+    Ok(())
+}
+```
+
+默认验证 TLS 证书及主机名。自定义 CA 和物理连接地址按该版本仓库 README/example 配置，不关闭验证，不改变逻辑 Endpoint 身份。
+
+同一事务及 savepoint 必须使用同一个 Session，并明确 commit 或 rollback 后 close；close 不会提交，断线或取消不证明回滚。网络中断、响应缺失或 `outcome_unknown()` 为真时，先用独立只读查询核实结果，不自动重放 SQL。新建 Session 不会恢复旧事务、临时表或会话状态。更多类型、大小与超时边界见仓库 README；SQL 使用与结果不明处理见 [SQL 命令](sql.md)。

package/skills/tiana-web/SKILL.md

@@ -4,7 +4,7 @@ description: 使用 Tiana 创建、修改、预览和发布 Web 应用。用户
 license: MIT
 metadata:
   author: Tiana Cloud
-  version: "0.3.4"
+  version: "1.0.0"
   parent: tiana
   source: https://github.com/tianacloud/agent-skills/tree/main/skills/tiana-web
 ---
@@ -15,7 +15,7 @@ metadata:
 
 ## 每次调用的更新检查
 
-CLI 可用后执行 `tiana version check --skills-version 0.3.4 --json`，使用实际加载的 metadata.version。仅在 `should_notify=true` 时提醒并询问是否升级；用户稍后或检查不可用时继续应用任务。升级及重载见 [开始使用](../tiana/references/getting-started.md#更新)。24 小时提醒额度由 CLI 统一管理。
+CLI 已满足最低版本要求后执行 `tiana version check --skills-version 1.0.0 --json`，使用实际加载的 metadata.version。仅在 `should_notify=true` 时提醒并询问是否升级；用户稍后或检查不可用时继续应用任务。升级及重载见 [开始使用](../tiana/references/getting-started.md#更新)。24 小时提醒额度由 CLI 统一管理。
 
 ## 每次任务必须查询当前模板目录