From b490383eda1e8b4f9e4c786167d7c5c873cc314a Mon Sep 17 00:00:00 2001 From: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com> Date: Wed, 28 Oct 2026 15:22:44 +0800 Subject: [PATCH] docs: align lifecycle and suite illustrations Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com> --- docs/skillhub/en/guide/review.md | 4 +- docs/skillhub/en/guide/skill-publish.md | 4 +- docs/skillhub/en/guide/skill-suites.md | 4 ++ docs/skillhub/guide/review.md | 4 +- docs/skillhub/guide/skill-publish.md | 4 +- docs/skillhub/guide/skill-suites.md | 4 ++ .../diagrams/skill-publish-lifecycle-en.svg | 49 +++++++++++++++++++ .../diagrams/skill-publish-lifecycle-zh.svg | 49 +++++++++++++++++++ .../public/diagrams/skill-suite-usage-en.svg | 32 ++++++++++++ .../public/diagrams/skill-suite-usage-zh.svg | 32 ++++++++++++ 10 files changed, 182 insertions(+), 4 deletions(-) create mode 100644 docs/skillhub/public/diagrams/skill-publish-lifecycle-en.svg create mode 100644 docs/skillhub/public/diagrams/skill-publish-lifecycle-zh.svg create mode 100644 docs/skillhub/public/diagrams/skill-suite-usage-en.svg create mode 100644 docs/skillhub/public/diagrams/skill-suite-usage-zh.svg diff --git a/docs/skillhub/en/guide/review.md b/docs/skillhub/en/guide/review.md index 56b5f18b0..09600d161 100644 --- a/docs/skillhub/en/guide/review.md +++ b/docs/skillhub/en/guide/review.md @@ -74,7 +74,9 @@ A user reports an inappropriate skill package, and an administrator investigates - Download the full package for local testing - Review the compliance snapshot and the diff from the previous published version -![Flow Diagram](/diagrams/review-flow.png) +![Scan and review in the ordinary publication path](/diagrams/skill-publish-lifecycle-en.svg) + +The review section follows the PUBLIC / NAMESPACE_ONLY branch: scanning completes before the version waits for a review decision. 4. Make a decision: - **Approve**: The skill package is officially published and the developer is notified diff --git a/docs/skillhub/en/guide/skill-publish.md b/docs/skillhub/en/guide/skill-publish.md index 9ccc2fb45..1577a36ed 100644 --- a/docs/skillhub/en/guide/skill-publish.md +++ b/docs/skillhub/en/guide/skill-publish.md @@ -128,7 +128,9 @@ file: skill-package.zip visibility: PUBLIC ``` -![Flow Diagram](/diagrams/skill-publish-flow.png) +![Ordinary public and private publication paths](/diagrams/skill-publish-lifecycle-en.svg) + +The diagram covers ordinary uploads; scan failures, review rejection and privileged publishing are described below. 5. **Security Scan** diff --git a/docs/skillhub/en/guide/skill-suites.md b/docs/skillhub/en/guide/skill-suites.md index 7b0e4f416..37125edc6 100644 --- a/docs/skillhub/en/guide/skill-suites.md +++ b/docs/skillhub/en/guide/skill-suites.md @@ -12,6 +12,10 @@ A Skill Suite is a separately versioned collection of exact published Skill vers A [Bundle](./suite-bundle) is an authoring format. A Suite is not a workflow runtime: coordination depends on the entry and member instructions. A Skill can still be installed independently. +![Suite installation and entry-skill usage](/diagrams/skill-suite-usage-en.svg) + +Installation ends at separate member files. Agent usage starts with an explicit task. + ## Install a Suite Follow the related Suites on a Skill detail page to inspect the entry, pinned members and installability. A related-Suite badge denotes membership, not a mandatory dependency. Ordinary `skillhub search` searches Skills, and same-named Suites require the explicit `suite` command. diff --git a/docs/skillhub/guide/review.md b/docs/skillhub/guide/review.md index c65928c7d..30194cd6d 100644 --- a/docs/skillhub/guide/review.md +++ b/docs/skillhub/guide/review.md @@ -77,7 +77,9 @@ SkillHub 提供了完整的审核工作流,确保发布到注册中心的技 - 在“审核记录”查看提交历史和已完成的审核意见;该页签打开时才请求历史 - 套件审核在内容区核对待审快照。快照加载失败时可重试,加载成功前“通过”按钮不可用 -![流程图](/diagrams/review-flow.png) +![普通发布路径中的扫描与审核](/diagrams/skill-publish-lifecycle-zh.svg) + +本页的审核部分对应 PUBLIC / NAMESPACE_ONLY 分支:扫描完成后,版本等待审核决定。 4. 在页面底部固定的审核栏填写意见并做出决策;切换页签保留意见,切换到另一个审核对象时清空意见、驳回表单和未确认弹窗: - **批准**:技能包正式发布,开发者收到通知 diff --git a/docs/skillhub/guide/skill-publish.md b/docs/skillhub/guide/skill-publish.md index 917920bbe..9fbd6b096 100644 --- a/docs/skillhub/guide/skill-publish.md +++ b/docs/skillhub/guide/skill-publish.md @@ -132,7 +132,9 @@ file: skill-package.zip visibility: PUBLIC ``` -![流程图](/diagrams/skill-publish-flow.png) +![公开与私有技能的普通发布路径](/diagrams/skill-publish-lifecycle-zh.svg) + +图示覆盖普通上传;扫描失败、审核拒绝及特权发布的区别见下文。 5. **安全扫描** diff --git a/docs/skillhub/guide/skill-suites.md b/docs/skillhub/guide/skill-suites.md index 3515cb65e..1a699dab1 100644 --- a/docs/skillhub/guide/skill-suites.md +++ b/docs/skillhub/guide/skill-suites.md @@ -12,6 +12,10 @@ Skill Suite(技能套装)把一组已发布 Skill 的精确版本组织成 Bundle 是[创作与导入格式](./suite-bundle),不是安装后需要执行的程序。套装也不是工作流引擎:是否串联成员、如何分派任务,由入口及成员的 `SKILL.md` 决定。普通技能可以独立安装,不必安装它关联的所有套装。 +![套装安装与入口技能使用流程](/diagrams/skill-suite-usage-zh.svg) + +安装交付的是独立成员文件;在 Agent 中提出任务后才开始使用。 + ## 找到并安装套装 在技能详情中查看关联套装,进入套装详情,确认入口、成员版本和可安装状态。卡片上的关联标识只表示收录关系。普通 `skillhub search` 搜索 Skill;安装同名 Suite 必须显式使用 `suite` 子命令。 diff --git a/docs/skillhub/public/diagrams/skill-publish-lifecycle-en.svg b/docs/skillhub/public/diagrams/skill-publish-lifecycle-en.svg new file mode 100644 index 000000000..df4f2c608 --- /dev/null +++ b/docs/skillhub/public/diagrams/skill-publish-lifecycle-en.svg @@ -0,0 +1,49 @@ + +Skill publication: ordinary upload pathsPublic submissions require scan and review; private submissions require publication confirmation. + + + +Skill publication: ordinary upload paths +Submission accepted ≠ published. Follow the version status. +PUBLIC / NAMESPACE_ONLY + +Upload +SKILL.md + files +Validate package + +Scan +SCANNING +Scanning required + +Review +PENDING_REVIEW +Approval required + +Published +PUBLISHED +Audience rules apply + + + +PRIVATE + +Upload +SKILL.md + files +Validate package + +Configured scan +SCANNING if enabled +Otherwise skip + +Confirm publish +UPLOADED +Explicit confirmation + +Published +PUBLISHED +Private access only + + + +Scan failure or rejection stops these paths. Privileged auto-publish is a separate path. + diff --git a/docs/skillhub/public/diagrams/skill-publish-lifecycle-zh.svg b/docs/skillhub/public/diagrams/skill-publish-lifecycle-zh.svg new file mode 100644 index 000000000..0ce350ce7 --- /dev/null +++ b/docs/skillhub/public/diagrams/skill-publish-lifecycle-zh.svg @@ -0,0 +1,49 @@ + +技能发布:普通上传路径公开及命名空间上传经过扫描与审核;私有上传需要确认发布。 + + + +技能发布:普通上传路径 +提交成功 ≠ 发布成功;以本次版本状态为准。 +PUBLIC / NAMESPACE_ONLY + +上传 +SKILL.md 与文件 +校验包结构与权限 + +扫描 +SCANNING +要求启用扫描 + +审核 +PENDING_REVIEW +等待审核批准 + +已发布 +PUBLISHED +按可见范围分发 + + + +PRIVATE + +上传 +SKILL.md 与文件 +校验包结构与权限 + +按配置扫描 +启用时进入 SCANNING +未启用则跳过 + +确认发布 +UPLOADED +显式确认后发布 + +已发布 +PUBLISHED +仍受私有权限约束 + + + +扫描执行失败或审核拒绝会中断上述路径。特权自动发布属于另一条路径。 + diff --git a/docs/skillhub/public/diagrams/skill-suite-usage-en.svg b/docs/skillhub/public/diagrams/skill-suite-usage-en.svg new file mode 100644 index 000000000..520109d89 --- /dev/null +++ b/docs/skillhub/public/diagrams/skill-suite-usage-en.svg @@ -0,0 +1,32 @@ + +Skill Suite: install, then use the entry skillA pinned Suite installs separate Skill directories. The user asks an Agent to use the entry skill. + + + +Skill Suite: install, then use the entry skill +Registry and CLI manage delivery; the Agent follows the installed instructions. + +1. Choose Suite +Exact member versions +One entry member + +2. Install +skillhub suite install +Download and verify + +3. Separate skills +entry-skill/SKILL.md +member-a/SKILL.md + +4. Ask the Agent +Discover entry skill +Provide a task + + + + +Usage boundaries +The entry remains an ordinary Skill. Other members can also be used directly. +Member coordination depends on SKILL.md; installation does not execute a workflow. +Configure required tools and credentials separately. There is no generic suite run command. + diff --git a/docs/skillhub/public/diagrams/skill-suite-usage-zh.svg b/docs/skillhub/public/diagrams/skill-suite-usage-zh.svg new file mode 100644 index 000000000..7702db6ed --- /dev/null +++ b/docs/skillhub/public/diagrams/skill-suite-usage-zh.svg @@ -0,0 +1,32 @@ + +技能套装:安装成员,再使用入口技能固定版本套装安装为独立成员目录,用户再请求 Agent 使用入口技能。 + + + +技能套装:安装成员,再使用入口技能 +注册中心与 CLI 管理分发,Agent 根据已安装的技能说明处理任务。 + +1. 选择套装 +固定成员版本 +指定一个入口成员 + +2. 安装成员 +skillhub suite install +下载并校验成员 + +3. 独立技能目录 +entry-skill/SKILL.md +member-a/SKILL.md + +4. 请求 Agent 使用 +确认入口可被发现 +提供具体任务 + + + + +使用边界 +入口仍是普通 Skill,其他成员也可以独立使用。 +成员如何协作由 SKILL.md 决定;安装不会自动执行工作流。 +工具和凭据按技能说明配置;SkillHub 没有通用的 suite run 命令。 +