@tianacloud/agent-skills 1.0.14 → 1.0.16
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +4 -5
- package/package.json +1 -1
- package/plugin.json +1 -1
- package/skills/tiana/SKILL.md +3 -3
- package/skills/tiana-function/SKILL.md +8 -4
- package/skills/tiana-function/references/commands.md +1 -1
- package/skills/{tiana-secrets/SKILL.md → tiana-function/references/secrets.md} +4 -15
- package/skills/tiana-git/SKILL.md +1 -1
- package/skills/tiana-sqlite/SKILL.md +1 -1
- package/skills/tiana-web/SKILL.md +1 -1
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Tiana Agent Skills
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
五个基础技能覆盖 Tiana 账号与实例、SQLite、Git、后端服务、密钥和 Web 应用。应用模板由在线目录提供，用户描述需求后，Agent 根据实时目录决定使用模板还是直接开发。
|
|
4
4
|
|
|
5
5
|
## 从 npm 安装
|
|
6
6
|
|
|
@@ -24,17 +24,16 @@ npx --yes @tianacloud/agent-skills@latest install --dir /path/to/client/skills
|
|
|
24
24
|
|
|
25
25
|
Windows PowerShell 使用 `npx.cmd`。目录可以含空格，用引号包住。重复安装会更新包内全部技能并补齐新版新增技能，其他技能保留。安装完成后让客户端重载技能或开始新会话。
|
|
26
26
|
|
|
27
|
-
WorkBuddy、豆包按所用版本的目录／ZIP
|
|
27
|
+
WorkBuddy、豆包按所用版本的目录／ZIP 导入方式加载这五个目录，保留 SKILL.md 和 references。若要求 ZIP，可将每个技能目录的内容打包，SKILL.md 位于包根部。WorkBuddy 专用本地化 ZIP 由维护者构建流程提供；本仓验证 ZIP 格式和内容，不声称已验收这些客户端的运行行为。
|
|
28
28
|
|
|
29
|
-
##
|
|
29
|
+
## 五个入口
|
|
30
30
|
|
|
31
31
|
| 技能 | 职责 |
|
|
32
32
|
| --- | --- |
|
|
33
33
|
| [tiana](skills/tiana/SKILL.md) | CLI 安装、登录、账号额度和通用实例管理 |
|
|
34
34
|
| [tiana-sqlite](skills/tiana-sqlite/SKILL.md) | SQL、表结构、SDK 连接和数据库分支 |
|
|
35
35
|
| [tiana-git](skills/tiana-git/SKILL.md) | Git 实例、原生仓库操作和源码版本同步 |
|
|
36
|
-
| [tiana-function](skills/tiana-function/SKILL.md) | Go 后端服务源码、构建发布、参数/CORS
|
|
37
|
-
| [tiana-secrets](skills/tiana-secrets/SKILL.md) | 用户密钥库初始化、名称与版本列表、写入和删除 |
|
|
36
|
+
| [tiana-function](skills/tiana-function/SKILL.md) | Go 后端服务源码、构建发布、参数/CORS、数据库后端与用户密钥管理 |
|
|
38
37
|
| [tiana-web](skills/tiana-web/SKILL.md) | 实时模板选择、工程与数据初始化、通用开发、构建发布 |
|
|
39
38
|
|
|
40
39
|
Web 技能每次任务都实际执行 `tiana web list-template --json`，使用当前 name/description 判断需求。模板 ZIP 原样下载解压到独立项目目录；Agent 按根部 metadata.json 替换变量、先 schema 后 seeds。模板源码和制作规范见 [template-apps](https://github.com/tianacloud/template-apps)，客户安装模板由 CLI 和 MGR 目录完成。
|
package/package.json
CHANGED
package/plugin.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
|
|
3
3
|
"name": "tiana",
|
|
4
|
-
"version": "1.0.
|
|
4
|
+
"version": "1.0.16",
|
|
5
5
|
"description": "Tiana Cloud account, SQLite, Git, Functions and Web application workflows",
|
|
6
6
|
"author": {
|
|
7
7
|
"name": "Tiana Cloud",
|
package/skills/tiana/SKILL.md
CHANGED
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: tiana
|
|
3
|
-
description: 使用 Tiana Cloud 管理实例、安装 CLI、登录和恢复账号会话。通用 Tiana 任务从此技能开始；Web 应用创建发布使用 tiana-web，数据库和分支使用 tiana-sqlite，Git 仓库和源码同步使用 tiana-git
|
|
3
|
+
description: 使用 Tiana Cloud 管理实例、安装 CLI、登录和恢复账号会话。通用 Tiana 任务从此技能开始；Web 应用创建发布使用 tiana-web，数据库和分支使用 tiana-sqlite，Git 仓库和源码同步使用 tiana-git，后端服务、数据库后端和用户密钥管理使用 tiana-function。
|
|
4
4
|
license: Apache-2.0
|
|
5
5
|
metadata:
|
|
6
6
|
author: Tiana Cloud
|
|
7
|
-
version: "1.0.
|
|
7
|
+
version: "1.0.16"
|
|
8
8
|
source: https://github.com/tianacloud/agent-skills/tree/main/skills/tiana
|
|
9
9
|
---
|
|
10
10
|
|
|
@@ -35,7 +35,7 @@ CLI 仍管理检查缓存和共同的 24 小时提醒额度；该额度不限制
|
|
|
35
35
|
| Go 后端服务、源码、参数及编译发布 | `tiana-function` 技能 |
|
|
36
36
|
| SQLite 查询、连接、建表及数据库分支 | `tiana-sqlite` 技能 |
|
|
37
37
|
| Git 实例、仓库、源码版本同步 | `tiana-git` 技能 |
|
|
38
|
-
| 用户密钥库初始化、名称列表、写入与删除 | `tiana-
|
|
38
|
+
| 用户密钥库初始化、名称列表、写入与删除 | `tiana-function` 技能 |
|
|
39
39
|
| 登录、账号、额度、通用实例管理 | 本技能 |
|
|
40
40
|
|
|
41
41
|
组合请求中，安装完成后继续用户要求的任务。需要其他技能时，按技能名加载对应技能，携带当前任务、已确认的资源 ID 和已完成结果；完成所需步骤后，带回操作结果继续当前任务。技能内部的参考资料按该技能提供的链接读取。
|
|
@@ -1,17 +1,17 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: tiana-function
|
|
3
|
-
description: 使用 Tiana 创建和管理 Go 后端服务，读取及保存 Git 源码、编译发布、修改参数与 CORS；为 Web 应用开发访问 SQLite
|
|
3
|
+
description: 使用 Tiana 创建和管理 Go 后端服务，读取及保存 Git 源码、编译发布、修改参数与 CORS；为 Web 应用开发访问 SQLite 的后端服务，或初始化用户密钥库、列出密钥名称与版本、写入和删除密钥时使用。前端页面开发配合 tiana-web。
|
|
4
4
|
license: Apache-2.0
|
|
5
5
|
metadata:
|
|
6
6
|
author: Tiana Cloud
|
|
7
|
-
version: "1.0.
|
|
7
|
+
version: "1.0.16"
|
|
8
8
|
parent: tiana
|
|
9
9
|
source: https://github.com/tianacloud/agent-skills/tree/main/skills/tiana-function
|
|
10
10
|
---
|
|
11
11
|
|
|
12
12
|
# Tiana Function
|
|
13
13
|
|
|
14
|
-
本 skill
|
|
14
|
+
本 skill 负责后端服务的创建与管理、源码、运行参数、用户密钥库、Go 接口及数据库访问、编译发布。为 Web 开发后端时，接收 `tiana-web` 技能确定的 Git ID、接口需求和数据依赖；完成后返回服务 ID、source_dir、发布回执、接口契约和参数生效结果，由 Web skill 继续前端接入、绑定、发布及分享验收。
|
|
15
15
|
|
|
16
16
|
安装、账号与环境选择按 `tiana` 技能。共享各 Tiana 技能本会话的实际更新检查记录；尚未检查时先完成该入口的检查，包括从本会话实际加载的 SKILL.md 的 `metadata.version` 取得 `SKILLS_VERSION`，在同一次 shell 调用中赋值并实际执行 `tiana version check --skills-version "$SKILLS_VERSION" --json` 并按结果自动更新 CLI 和整套 Skills、补齐新增技能并核验，在对话中报告结果与重载要求；`should_notify=false` 也执行。两个包各自比较自身 npm 最新版，检查与安装无需 Tiana 登录；暂不登录或不操作云端资源时仍完成此流程。执行前确认 `tiana function --help` 可用；当前最新正式 CLI 仍缺少命令时，报告配套能力尚未可用及两个包的实际版本，等待已验证的配套发布。
|
|
17
17
|
|
|
@@ -27,12 +27,16 @@ metadata:
|
|
|
27
27
|
|
|
28
28
|
涉及数据库 Token、第三方 API Key 等敏感配置时，必须先按[参数配置与生效](references/commands.md#参数配置与生效)配置，再按 [Go 后端服务开发](references/go-backend.md)读取与使用。参数更新无需重新编译，但要核对保存回执的应用状态和实际请求结果。
|
|
29
29
|
|
|
30
|
-
数据库 Endpoint 使用明文参数；Token
|
|
30
|
+
数据库 Endpoint 使用明文参数；Token 和第三方密钥先按[用户密钥库](references/secrets.md)写入密钥，再保存为后端服务的密钥引用参数，不写入 Git、前端源码、业务响应或日志。缺少实际凭据时说明待配置项，不使用占位值宣称联调成功。Web 的数据访问方式、资源绑定与模板制作由 Tiana Web 负责。
|
|
31
31
|
|
|
32
32
|
调用方身份通过 SDK 从请求上下文读取，业务需要区分用户数据时使用该身份，不能相信请求体中自报的用户 ID。完成接口核验后，将所需调用身份与数据范围一并交给 Web skill 验证。
|
|
33
33
|
|
|
34
34
|
App 作者专属的初始化和权限管理接口，按 [App 作者与初始权限](references/go-backend.md#app-作者与初始权限)使用 `caller.IsAppOwner()` 校验；作者指本次来源 Web 的创建者，与租户角色分开。前端的 `is_app_owner` 展示由 Tiana Web 负责。
|
|
35
35
|
|
|
36
|
+
## 用户密钥库
|
|
37
|
+
|
|
38
|
+
初始化密钥库、查询名称与版本、写入或删除密钥时，阅读[密钥管理](references/secrets.md)。按操作回执报告 key、版本和结果；需要供函数使用时，继续配置密钥引用参数并核验生效。
|
|
39
|
+
|
|
36
40
|
## 结果与恢复
|
|
37
41
|
|
|
38
42
|
`accepted` 表示已受理，`publish --wait` 成功才表示发布完成。构建失败后读取 `builds` 和 `logs`，修正源码、额度或配置后重试。响应不确定时沿用原 request ID 和 commit 查询或恢复；不要把再次发起构建当作状态查询。删除后端服务会删除其制品，CLI 保留关联 Git。
|
|
@@ -64,7 +64,7 @@ set 替换整个参数对象。get 的 JSON 回执从 `data.parameters` 取出
|
|
|
64
64
|
}
|
|
65
65
|
```
|
|
66
66
|
|
|
67
|
-
|
|
67
|
+
先按[密钥管理](secrets.md)写入敏感值，再将其 key 配为 secret；plain 保存明文，secret 只保存引用名称。
|
|
68
68
|
|
|
69
69
|
含凭据的文件放在 Git 和前端构建目录之外，使用仅当前用户可读写的临时文件，用完删除。get 和 set 回执都可能包含参数值，同样写入受限临时文件处理，不打印到对话或交付日志。仅报告参数名称与生效状态。
|
|
70
70
|
|
|
@@ -1,17 +1,6 @@
|
|
|
1
|
-
|
|
2
|
-
name: tiana-secrets
|
|
3
|
-
description: 管理 Tiana 用户密钥库：初始化、列出密钥名称和当前版本号、写入与删除密钥。函数参数引用密钥时配合 tiana-function；不提供密钥明文读取或导出。
|
|
4
|
-
license: Apache-2.0
|
|
5
|
-
metadata:
|
|
6
|
-
author: Tiana Cloud
|
|
7
|
-
version: "1.0.14"
|
|
8
|
-
parent: tiana
|
|
9
|
-
source: https://github.com/tianacloud/agent-skills/tree/main/skills/tiana-secrets
|
|
10
|
-
---
|
|
1
|
+
# 用户密钥库
|
|
11
2
|
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
安装、登录、环境选择和本会话的 CLI／Skills 更新检查复用 `tiana` 技能。执行前核实 `tiana secrets --help` 包含 init、list、set、remove；若正式 CLI 尚未提供，说明配套能力未发布，使用用户已指定的候选版本或等待配套发布，不猜造其他访问方式。
|
|
3
|
+
执行前核实 `tiana secrets --help` 包含 init、list、set、remove；若正式 CLI 尚未提供，说明配套能力未发布，使用用户已指定的候选版本或等待配套发布，不猜造其他访问方式。
|
|
15
4
|
|
|
16
5
|
## 初始化与列表
|
|
17
6
|
|
|
@@ -39,6 +28,6 @@ Set 直接写入，不先读取密钥。新 key 从 v1 开始，值变化则版
|
|
|
39
28
|
|
|
40
29
|
## 函数引用
|
|
41
30
|
|
|
42
|
-
|
|
31
|
+
写入后，需要供函数使用时，按[参数配置与生效](commands.md#参数配置与生效)将 key 保存为函数参数。函数参数使用 `{"kind":"secret","value":"production/database/password"}`，value 是引用名称，不是密钥明文；函数执行首次读取成功后缓存，下次冷启动读取当前值。
|
|
43
32
|
|
|
44
|
-
|
|
33
|
+
密钥管理不提供 Get、明文回显或导出，也不通过 curl、SDK 或函数接口绕过 CLI 读取明文。需要人工查看时，引导用户到 Console 输入安全口令自行操作。平台 HashiCorp Vault 运维不属于本密钥管理流程。
|