feat: document asynchronous avatars for created agents (#204)

创建和更新智能体的中英文技能现在说明自动异步头像:默认透明真人,显式外貌/风格/背景要求优先;用户图片优先,删除或关闭可取消任务。旧客户端按实际工具
Schema 使用,图像服务条款、额度与费用明确披露。

The bilingual creation/update skills document automatic asynchronous
avatars, user customization, image precedence, cancellation,
older-client schema detection, and image-provider prerequisites and
costs.

验证 / Validation: focused i18n validation and translation freshness
passed; catalog validation has zero errors (existing repository warnings
remain).
This commit is contained in:
2026-10-03 04:19:19 -07:00
committed by GitHub
parent 7ce79c5cc9
commit bdda7aba89
7 changed files with 53 additions and 21 deletions

View File

@@ -3,8 +3,9 @@ license: "MIT"
name: update-agent
description: >-
安全更新现有智能体的配置、人格、原则、技能与记忆,输出可审阅 diff 并在确认后应用与提交。Use when 用户要求修改 Agent
行为、安装/卸载技能、调整配置、回滚变更或修订规则。
version: 3.2.1
行为、安装/卸载技能、调整配置、回滚变更或修订规则。可选头像生成需配置图像服务,适用供应商条款/额度及独立费用。
version: 3.3.0
compatibility: "DesireCore ManageAgent; optional avatar generation requires a configured image provider under its own terms and quota, with separate charges; unavailable generation retains the existing avatar."
type: meta
risk_level: low
status: enabled
@@ -15,7 +16,7 @@ tags:
- meta
metadata:
author: desirecore
updated_at: '2026-08-25'
updated_at: '2026-10-03'
i18n:
default_locale: en-US
source_locale: zh-CN
@@ -26,17 +27,17 @@ metadata:
name: 更新智能体
short_desc: 安全更新智能体配置、人格、规则与技能,支持 diff 预览与版本回滚
description: >-
安全更新现有智能体的配置、人格、原则、技能与记忆,输出可审阅 diff 并在确认后应用与提交。Use when 用户要求修改 Agent 行为、安装/卸载技能、调整配置、回滚变更或修订规则。
安全更新现有智能体的配置、人格、原则、技能与记忆,输出可审阅 diff 并在确认后应用与提交。Use when 用户要求修改 Agent 行为、安装/卸载技能、调整配置、回滚变更或修订规则。可选头像生成需配置图像服务,适用供应商条款/额度及独立费用。
body: ./SKILL.zh-CN.md
source_hash: sha256:6ba1c3ba7a6dd36e
source_hash: sha256:b2c95e40c280b162
translated_by: human
en-US:
name: Update Agent
short_desc: Safely update Agent config, persona, principles, and skills, with diff preview and version rollback
description: >-
Safely update an existing Agent's config, persona, principles, skills, and memory, producing reviewable diffs that are applied and committed only after confirmation. Use when the user asks to modify Agent behavior, install/uninstall skills, adjust config, roll back changes, or revise rules.
Safely update an existing Agent's config, persona, principles, skills, and memory, producing reviewable diffs that are applied and committed only after confirmation. Use when the user asks to modify Agent behavior, install/uninstall skills, adjust config, roll back changes, or revise rules. Optional avatar generation requires a configured image service under provider terms/quota and separate charges.
body: ./SKILL.md
source_hash: sha256:6ba1c3ba7a6dd36e
source_hash: sha256:b2c95e40c280b162
translated_by: human
market:
icon: >-
@@ -168,3 +169,10 @@ Trigger: user says "undo / roll back / restore the previous settings". Flow:
- AgentFS structure and protected paths: see `_agentfs-background.md` and `_protected-paths.yaml`.
- On tool errors: non-whitelisted config field / schema validation failure / core-agent refusal → fix per the tool's hint or inform the user; protected path → block with an owner-permission notice; rollback version not found → list available versions and ask the user to reselect.
### Avatar customization
Check readiness through the current governed tool catalog: use `ManageCompute(action="list")` for enabled/credential status and `InspectModels(action="list", serviceType="image_gen")` for an eligible image model. Neither listing proves upstream quota or call success; follow provider terms/quota and separate charges. Do not read keys or use local HTTP. If these tools are absent, follow the configuring-compute skill's governed GUI observation. If generation is known unavailable, skip regeneration, preserve the current avatar and report the limitation. Unknown readiness is not success; inspect the background task result and do not fabricate completion.
Users may freely change the avatar's appearance, style, background, upload an existing image, or remove it with `avatarImage.remove:true`. On clients exposing `avatarGeneration`, pass a new generation request to `ManageAgent(action="update", avatarGeneration={prompt:"user requirements"})`; `transparentBackground:false` preserves a requested background and `enabled:false` cancels pending generation. Direct image replacement/removal invalidates older asynchronous results. The default automatic style is transparent and photorealistic; explicit user choices take precedence. `avatarImage.requireTransparency:true` opts into strict transparency checks; do not impose that check on a user who requested a background. Inspect `ManageAgent(get)` for task failures, and do not automatically retry paid requests. Older clients must use only fields in their actual tool schema.

View File

@@ -107,3 +107,10 @@ ManageAgent(action='update', id='<agent-id>', avatarImage={ source: "dc-media://
- AgentFS 结构、受保护路径详见 `_agentfs-background.md` 与 `_protected-paths.yaml`。
- 工具报错时:config 非白名单字段 / schema 校验失败 / 核心体拒绝 → 按工具提示修正或告知用户;受保护路径 → 阻断并提示需 owner;回滚版本不存在 → 列出可用版本请用户重选。
### 头像自由定制
通过当前受治理工具目录检查就绪状态:用 `ManageCompute(action="list")` 查看启用/凭据状态,用 `InspectModels(action="list", serviceType="image_gen")` 查看可用图像模型。列表不证明上游额度或调用成功,遵守供应商条款/额度及独立费用;不读取密钥,不用本机 HTTP 旁路。缺少这些工具时,遵循 configuring-compute 技能的受治理 GUI 观察流程。已知生成不可用时,跳过重新生成,保留当前头像并报告限制。就绪状态未知不代表成功,检查后台任务结果,不伪造完成。
用户可自由改变头像外貌、风格、背景、上传已有图片或通过 `avatarImage.remove:true` 移除。提供 `avatarGeneration` 的新客户端可用 `ManageAgent(action="update", avatarGeneration={prompt:"用户要求"})` 重新生成;明确要求背景用 `transparentBackground:false`,`enabled:false` 取消未完成生成。后续设图/移除优先,旧异步结果不会覆盖用户新选择。透明真人风格只作为默认;明确用户要求优先。`avatarImage.requireTransparency:true` 可显式启用透明度检查,不对需要背景的用户强制该检查。用 `ManageAgent(get)` 查看失败,不自动重复付费请求;旧客户端只用实际 Schema 声明的字段。

View File

@@ -11,12 +11,12 @@
"zh-CN": {
"name": "更新智能体",
"summary": "安全更新智能体配置、人格、规则与技能,支持 diff 预览与版本回滚",
"description": "安全更新现有智能体的配置、人格、原则、技能与记忆,输出可审阅 diff 并在确认后应用与提交。Use when 用户要求修改 Agent 行为、安装/卸载技能、调整配置、回滚变更或修订规则。"
"description": "安全更新现有智能体的配置、人格、原则、技能与记忆,输出可审阅 diff 并在确认后应用与提交。Use when 用户要求修改 Agent 行为、安装/卸载技能、调整配置、回滚变更或修订规则。可选头像生成需配置图像服务,适用供应商条款/额度及独立费用。"
},
"en-US": {
"name": "Update Agent",
"summary": "Safely update Agent config, persona, principles, and skills, with diff preview and version rollback",
"description": "Safely update an existing Agent's config, persona, principles, skills, and memory, producing reviewable diffs that are applied and committed only after confirmation. Use when the user asks to modify Agent behavior, install/uninstall skills, adjust config, roll back changes, or revise rules."
"description": "Safely update an existing Agent's config, persona, principles, skills, and memory, producing reviewable diffs that are applied and committed only after confirmation. Use when the user asks to modify Agent behavior, install/uninstall skills, adjust config, roll back changes, or revise rules. Optional avatar generation requires a configured image service under provider terms/quota and separate charges."
}
},
"category": "productivity",
@@ -28,7 +28,7 @@
},
"release": {
"state": "known",
"version": "3.2.1",
"version": "3.3.0",
"versionScheme": "semver"
},
"timestamps": {