@tianacloud/agent-skills 1.0.8 → 1.0.10

package/package.json

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

package/plugin.json

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

package/skills/tiana/SKILL.md

@@ -4,7 +4,7 @@ description: 使用 Tiana Cloud 管理实例、安装 CLI、登录和恢复账
 license: Apache-2.0
 metadata:
   author: Tiana Cloud
-  version: "1.0.8"
+  version: "1.0.10"
   source: https://github.com/tianacloud/agent-skills/tree/main/skills/tiana
 ---
 
@@ -17,7 +17,7 @@ metadata:
 **本会话首次使用任一 Tiana 技能时，先完成以下步骤，再开始登录、查询模板或操作应用：**
 
 1. 执行 `tiana version`，按[开始使用](references/getting-started.md)核验最低版本；缺少 CLI 或版本过低时，先完成安装或经用户确认的升级。
-2. CLI 满足最低版本后，**仍须实际执行** `tiana version check --skills-version 1.0.8 --json`；版本号取实际加载的 metadata.version。这一步检查是否有更新版本。
+2. CLI 满足最低版本后，**仍须实际执行** `tiana version check --skills-version 1.0.10 --json`；版本号取实际加载的 metadata.version。这一步检查是否有更新版本。
 3. 实际发起检查命令后，才在会话中记为已尝试，并保留返回结果或执行错误。仅运行 `tiana version` 只完成第 1 步。
 
 四个技能共享这份实际调用记录；后续轮次、重复加载或切换技能复用记录，失败也不自动重试。上下文压缩或任务交接时保留记录，新会话重新检查。

package/skills/tiana-git/SKILL.md

@@ -4,7 +4,7 @@ description: 使用 Tiana Git 管理 Git 实例和原生仓库，关联项目远
 license: Apache-2.0
 metadata:
   author: Tiana Cloud
-  version: "1.0.8"
+  version: "1.0.10"
   parent: tiana
   source: https://github.com/tianacloud/agent-skills/tree/main/skills/tiana-git
 ---
@@ -18,7 +18,7 @@ metadata:
 **本会话首次使用任一 Tiana 技能时，先完成以下步骤，再开始登录、查询模板或操作应用：**
 
 1. 执行 `tiana version`，按[开始使用](../tiana/references/getting-started.md)核验最低版本；缺少 CLI 或版本过低时，先完成安装或经用户确认的升级。
-2. CLI 满足最低版本后，**仍须实际执行** `tiana version check --skills-version 1.0.8 --json`；版本号取实际加载的 metadata.version。这一步检查是否有更新版本。
+2. CLI 满足最低版本后，**仍须实际执行** `tiana version check --skills-version 1.0.10 --json`；版本号取实际加载的 metadata.version。这一步检查是否有更新版本。
 3. 实际发起检查命令后，才在会话中记为已尝试，并保留返回结果或执行错误。仅运行 `tiana version` 只完成第 1 步。
 
 四个技能共享这份实际调用记录；后续轮次、重复加载或切换技能复用记录，失败也不自动重试。上下文压缩或任务交接时保留记录，新会话重新检查。

package/skills/tiana-sqlite/SKILL.md

@@ -4,7 +4,7 @@ description: 查询 Tiana SQLite 表结构、执行 SQL、选择数据库分支
 license: Apache-2.0
 metadata:
   author: Tiana Cloud
-  version: "1.0.8"
+  version: "1.0.10"
   parent: tiana
   source: https://github.com/tianacloud/agent-skills/tree/main/skills/tiana-sqlite
 ---
@@ -18,7 +18,7 @@ metadata:
 **本会话首次使用任一 Tiana 技能时，先完成以下步骤，再开始登录、查询模板或操作应用：**
 
 1. 执行 `tiana version`，按[开始使用](../tiana/references/getting-started.md)核验最低版本；缺少 CLI 或版本过低时，先完成安装或经用户确认的升级。
-2. CLI 满足最低版本后，**仍须实际执行** `tiana version check --skills-version 1.0.8 --json`；版本号取实际加载的 metadata.version。这一步检查是否有更新版本。
+2. CLI 满足最低版本后，**仍须实际执行** `tiana version check --skills-version 1.0.10 --json`；版本号取实际加载的 metadata.version。这一步检查是否有更新版本。
 3. 实际发起检查命令后，才在会话中记为已尝试，并保留返回结果或执行错误。仅运行 `tiana version` 只完成第 1 步。
 
 四个技能共享这份实际调用记录；后续轮次、重复加载或切换技能复用记录，失败也不自动重试。上下文压缩或任务交接时保留记录，新会话重新检查。

package/skills/tiana-web/SKILL.md

@@ -4,7 +4,7 @@ description: 使用 Tiana 创建、修改、预览和发布 Web 应用。用户
 license: Apache-2.0
 metadata:
   author: Tiana Cloud
-  version: "1.0.8"
+  version: "1.0.10"
   parent: tiana
   source: https://github.com/tianacloud/agent-skills/tree/main/skills/tiana-web
 ---
@@ -18,7 +18,7 @@ metadata:
 **本会话首次使用任一 Tiana 技能时，先完成以下步骤，再开始登录、查询模板或操作应用：**
 
 1. 执行 `tiana version`，按[开始使用](../tiana/references/getting-started.md)核验最低版本；缺少 CLI 或版本过低时，先完成安装或经用户确认的升级。
-2. CLI 满足最低版本后，**仍须实际执行** `tiana version check --skills-version 1.0.8 --json`；版本号取实际加载的 metadata.version。这一步检查是否有更新版本。
+2. CLI 满足最低版本后，**仍须实际执行** `tiana version check --skills-version 1.0.10 --json`；版本号取实际加载的 metadata.version。这一步检查是否有更新版本。
 3. 实际发起检查命令后，才在会话中记为已尝试，并保留返回结果或执行错误。仅运行 `tiana version` 只完成第 1 步。
 
 四个技能共享这份实际调用记录；后续轮次、重复加载或切换技能复用记录，失败也不自动重试。上下文压缩或任务交接时保留记录，新会话重新检查。
@@ -27,7 +27,7 @@ metadata:
 
 ## 将已有应用发布为模板
 
-用户要求“把某个 Web App 发布为模板”或分享可安装链接时，阅读[用户模板分享](references/share-template.md)，在独立副本中整理源码、结构与个人无关 seed，再打包、上传并交付安装链接。默认包含源码，可让用户选择仅安装；必须制作预览和封面。无法判断 seed 是否涉及个人信息时，先让用户选择。用户提供分享链接要求做同款时，也按该文档取得源码并开始新工程。此分支直接处理指定应用。
+用户要求“把某个 Web App 发布为模板”或分享可安装链接时，阅读[用户模板分享](references/share-template.md)，在独立副本中整理源码、结构与个人无关 seed，再打包、上传并交付安装链接。默认包含源码，可让用户选择仅安装；必须制作预览和封面，并按[预览的响应式展示与验收](references/share-template.md#预览的响应式展示与验收)完成 PC 和手机适配。无法判断 seed 是否涉及个人信息时，先让用户选择。用户提供分享链接要求做同款时，也按该文档取得源码并开始新工程。此分支直接处理指定应用。
 
 ## 开发与普通发布：查询当前模板目录
 
@@ -41,7 +41,7 @@ metadata:
 2. 采用模板时，执行 `tiana web init-template NAME --dir PROJECT_DIR --json`。PROJECT_DIR 是用户项目的不存在目录，位于技能安装目录之外。CLI 下载并原样解压；按 [模板初始化](references/template-init.md)读取工程根部 `metadata.json`，由 Agent 完成全部变量替换及 SQLite 数据初始化。
 3. 直接开发时，使用 [固定 index.html](references/index.html)、哈希路由、支持动态账号鉴权的 SDK，按实际数据库结构编写应用及构建清单。
 4. **模板和直接开发都由 Agent 处理数据库初始化。** 模板先执行已配置且存在的 schema，再执行已配置且存在的 seeds；两项独立跳过，SQL 失败先核对结果并停止后续发布。
-5. 构建前准备应用图标：用户明确提供图片时使用它，否则复用源码已有 `icon.png`（包括模板的 `public/icon.png`）；源码缺图时由 Agent 按标题自动生成汉字／字母加固定配色的真实 PNG，保存到源码，并确保产物根目录有 `icon.png`。查看图片并核验干净构建，细节见[应用图标](references/csr-apps.md#应用图标)。
+5. 构建前按[应用图标](references/csr-apps.md#应用图标)准备真实 PNG：使用用户指定图片或已有的合适图标；需要制作时优先调用可用的 AI 生图工具，以应用核心功能设计图形图标。图片保存到源码，查看缩小后的效果，并核验干净构建根目录和发布包中都有该图片。
 6. 按用户需求完成交互和定制，安装依赖并从确定源码提交构建。按 [源码版本流程](../tiana-git/references/source-releases.md)完成源码同步，用 `web publish` 发布当前归档，再用 `web status --publish-id` 核对。除非用户仅要求本地开发，交付实际托管地址、资源 ID 和对应源码提交；未验证的阶段如实说明。
 
 ## 文件上传、预览与下载

package/skills/tiana-web/references/csr-apps.md

@@ -56,11 +56,13 @@ CLI 将目录打包为 ZIP Store/Deflate 的一个 `.tweb`，根目录是零字
 
 ## 应用图标
 
-构建前检查工程根的 `icon.png` 和工程实际采用的静态资源目录，如 `public/icon.png`；依赖包和旧 dist 内的图片不算源码。用户本次明确提供新图片时使用它，否则直接复用源码图片，包括模板自带的图标，不因应用改名或每轮修改重新生成。
+构建前检查工程根的 `icon.png` 和工程实际采用的静态资源目录，如 `public/icon.png`；依赖包和旧 dist 内的图片不算源码。用户明确指定图片或品牌标识时使用它。新建应用可以复用符合本次功能的模板图标；模板只有通用占位、标题首字图片或图形与本次功能不符时，制作适合新应用的图标。修改已有应用时沿用原图，用户要求换图或原来缺图时再制作，不因改名或每轮修改重新生成。将已有应用分享为模板时按[沿用应用图标](share-template.md#沿用应用图标)保留当前原图。
 
-源码没有图标时，由执行任务的 Agent 自动生成真实 PNG：按应用标题取首个汉字或英文首字母，搭配固定配色，建议 256×256 正方形。可用 Canvas／本地图像工具绘制，汉字选择可用的中文字体，查看图片确认文字清晰、没有缺字；不把准备图片转交给用户，也不把文字预览、SVG 改扩展名当作 PNG。
+需要制作时，先从需求提炼核心功能、使用场景和一个主要视觉意象，检查当前环境可用的 AI 生图工具或技能；有可用能力就实际调用，生成后把图片保存到工程。提示词包含应用用途、体现功能的主体、与界面协调的配色、正方形构图和小尺寸辨识要求。图形以核心功能为主，文字仅在用户明确要求时加入。例如记账应用可用账本与收支符号，日程应用可用日历与勾选，植物养护应用可用叶片与水滴；选择少量能表达用途的元素。
 
-图片写入源码静态资源目录，再使用现有构建复制能力将它输出到产物根目录 `icon.png`；工程没有复制能力时补充直接的构建步骤。先准备源图片、提交，再从确定提交干净构建。发布前检查产物图片能解码，确认现有 CLI 打包后为 `data/icon.png`；无需新增 CLI 参数。
+提示词示例：「为家庭植物养护 App 制作应用图标，核心功能是植物记录与浇水提醒。以叶片和水滴构成简洁图形，使用柔和绿色与暖白色，主体居中、轮廓清楚、边缘留白，正方形，缩小到 32px 仍可辨识，纯图形。」按工具支持的尺寸生成后导出真实 PNG，建议 256×256；查看原图和 32／64px 效果，确认主体体现功能、边缘完整。AI 生图不可用或调用失败时，简短说明实际限制，由 Agent 用本地绘图工具制作同样体现功能的简洁图形 PNG。图片制作由 Agent 完成；SVG 等中间产物须真正栅格化为 PNG。
+
+图片写入源码静态资源目录，再使用现有构建复制能力将它输出到产物根目录 `icon.png`；工程没有复制能力时补充直接的构建步骤。先准备源图片、提交，再从确定提交干净构建。发布前检查产物图片能解码且与选定源图一致，确认现有 CLI 打包后为 `data/icon.png`；缺图时补齐源码或构建复制步骤，再重新构建。无需新增 CLI 参数。
 
 配套图标服务部署后，每次发布含图标的包都会覆盖应用的独立管理图标；包里没有图标时保留当前图片。Console 单独上传不改写源码，后续含图标的发布仍以包内图片覆盖；用户要持续更换图标时同步修改源码。独立图标可在应用休眠或停用时读取，本地构建验证与目标环境的展示验收分别记录。
 

package/skills/tiana-web/references/share-template.md

@@ -31,7 +31,18 @@
 
 逐项检查源码、依赖锁文件、构建资源、图片、SQL 和展示文案，移除作者的账号绑定、凭据、环境文件、数据库副本、日志、缓存及 Git 管理文件。源码保留重建必需的工程文件；仅安装模式也要检查 JS bundle 和 source map 是否暴露私有内容。
 
-制作 `showcase/preview.html`：复用应用视觉和代表流程，用合成数据和页面内状态实现可操作演示。自包含、压缩前不超过 500,000 字节，能在 `sandbox="allow-scripts"` 且无外部网络的 iframe 内工作。在桌面和手机尺寸实际操作验证，用同份验收预览截图制作 `showcase/cover.webp`。包含源码时另写 `showcase/prompt.md`，说明功能、适用场景、数据模型和可定制点；安装落地页会补充真实分享链接和 CLI 拉取方式。
+制作 `showcase/preview.html`：复用应用视觉和代表流程，用合成数据和页面内状态实现可操作演示。自包含、压缩前不超过 500,000 字节，能在 `sandbox="allow-scripts"` 且无外部网络的 iframe 内工作。按下节完成响应式展示与验收，再用同份预览截图制作 `showcase/cover.webp`。包含源码时另写 `showcase/prompt.md`，说明功能、适用场景、数据模型和可定制点；安装落地页会补充真实分享链接和 CLI 拉取方式。
+
+### 预览的响应式展示与验收
+
+预览是用户判断是否安装的主要依据。PC 和手机首屏都应清楚展示应用用途、代表性内容和可尝试的核心操作；用有层次的合成数据展示真实使用效果，保持原应用的视觉风格与能力边界。
+
+- **按可用宽度布局**：设置 viewport，使用流式容器和按内容需要选择的断点；iframe 内按自身视口宽度适配。PC 合理利用多列和留白，手机重排为清晰的单列或紧凑布局，保持正文与控件可读，不把整张桌面画布等比缩小。
+- **处理窄屏内容**：侧栏收起或改为紧凑导航，工具栏允许换行；表格、日历等按场景改为卡片、列表或局部横向滚动，并保留关键内容。图片和图表随容器缩放，长标题自然换行；页面整体无横向溢出，不能靠裁切掩盖内容。
+- **保证手机可操作**：主要按钮有足够触控面积和间距，功能可通过点击或触摸使用；弹窗宽高适合当前视口，内容可滚动，关闭和确认按钮可达。固定导航或底部操作区不遮挡正文。
+- **实际查看并操作**：在浏览器中用上述离线 sandbox iframe 检查预览，至少覆盖 PC（如 1440×900）、常见手机（如 390×844）和较窄手机（如 360×800），再拖动宽度检查断点之间的布局。逐一查看首屏与滚动后的内容，完成一条核心演示流程，并检查涉及的导航、弹窗和切换状态；修正重叠、截断、过小文字、失效按钮和失衡留白后再截图。没有浏览器能力时明确列出尚未验证的尺寸与交互，不把静态代码检查称为视觉验收。
+
+封面从已验收预览中选取能看清核心内容的构图，缩小后仍能辨认应用用途；保持实际界面比例，避免裁掉关键内容。
 
 ### 沿用应用图标
 
@@ -39,7 +50,7 @@
 
 只有确认应用和源码都没有图标时，才按[应用图标](csr-apps.md#应用图标)生成真实 PNG。已有图标读取失败时先解决读取问题，保留复用原图的选择。将选定图片原样用于干净构建根目录的 `icon.png`，核对 `site.tweb` 的 `data/icon.png` 和安装包的 `icon.png` 与该图片一致。
 
-完成条件：公开副本可独立构建，预览可操作，封面来自该预览，图标沿用已确认的原图或在确认缺图后生成，所有材料不含私有数据。
+完成条件：公开副本可独立构建，预览通过上述响应式展示与验收，封面来自该预览，图标沿用已确认的原图或在确认缺图后生成，所有材料不含私有数据。
 
 ## 4. 打包和发布
 

package/skills/tiana-web/references/template-init.md

@@ -57,7 +57,7 @@ SQL 返回失败、断线或未知结果时停止后续发布，用独立只读
 
 ## 模板图标
 
-模板的源 `icon.png` 是用户应用的初始图标，保留图片并复用工程的静态资源复制配置。变量替换时不把 PNG 当文本处理。若下载模板没有源图标，按[应用图标](csr-apps.md#应用图标)由 Agent 自动生成并保存。干净构建后确认产物根目录 `icon.png` 可以解码，再发布；以后更新模板本身不会直接改变已有用户应用的图标。
+模板的源 `icon.png` 是用户应用的初始图标，复用工程的静态资源复制配置。变量替换时不把 PNG 当文本处理。新应用缺图、继承的是通用占位／标题首字图片或图形与本次功能不符时，按[应用图标](csr-apps.md#应用图标)优先调用 AI 生图制作并保存体现功能的图标，用户明确指定的图片优先。干净构建后确认产物根目录 `icon.png` 可以解码且与选定源图一致，再发布；以后更新模板本身不会直接改变已有用户应用的图标。
 
 ## 构建和来源