docs: align lifecycle and suite illustrations

Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>
This commit is contained in:
XiaoSeS 2026-10-28 15:22:44 +08:00
parent 8265491de8
commit b490383eda
10 changed files with 182 additions and 4 deletions

View file

@ -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

View file

@ -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**

View file

@ -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.

View file

@ -77,7 +77,9 @@ SkillHub 提供了完整的审核工作流,确保发布到注册中心的技
- 在“审核记录”查看提交历史和已完成的审核意见;该页签打开时才请求历史
- 套件审核在内容区核对待审快照。快照加载失败时可重试,加载成功前“通过”按钮不可用
![流程图](/diagrams/review-flow.png)
![普通发布路径中的扫描与审核](/diagrams/skill-publish-lifecycle-zh.svg)
本页的审核部分对应 PUBLIC / NAMESPACE_ONLY 分支:扫描完成后,版本等待审核决定。
4. 在页面底部固定的审核栏填写意见并做出决策;切换页签保留意见,切换到另一个审核对象时清空意见、驳回表单和未确认弹窗:
- **批准**:技能包正式发布,开发者收到通知

View file

@ -132,7 +132,9 @@ file: skill-package.zip
visibility: PUBLIC
```
![流程图](/diagrams/skill-publish-flow.png)
![公开与私有技能的普通发布路径](/diagrams/skill-publish-lifecycle-zh.svg)
图示覆盖普通上传;扫描失败、审核拒绝及特权发布的区别见下文。
5. **安全扫描**

View file

@ -12,6 +12,10 @@ Skill Suite(技能套装)把一组已发布 Skill 的精确版本组织成
Bundle 是[创作与导入格式](./suite-bundle),不是安装后需要执行的程序。套装也不是工作流引擎:是否串联成员、如何分派任务,由入口及成员的 `SKILL.md` 决定。普通技能可以独立安装,不必安装它关联的所有套装。
![套装安装与入口技能使用流程](/diagrams/skill-suite-usage-zh.svg)
安装交付的是独立成员文件;在 Agent 中提出任务后才开始使用。
## 找到并安装套装
在技能详情中查看关联套装,进入套装详情,确认入口、成员版本和可安装状态。卡片上的关联标识只表示收录关系。普通 `skillhub search` 搜索 Skill;安装同名 Suite 必须显式使用 `suite` 子命令。

View file

@ -0,0 +1,49 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1080 510" role="img" aria-labelledby="title desc">
<title id="title">Skill publication: ordinary upload paths</title><desc id="desc">Public submissions require scan and review; private submissions require publication confirmation.</desc>
<defs><marker id="arrow" markerWidth="8" markerHeight="8" refX="7" refY="4" orient="auto"><path d="M1 1 L7 4 L1 7" fill="none" stroke="#222" stroke-width="1.5"/></marker></defs>
<rect width="1080" height="510" fill="#fff"/>
<style>text{font-family:Arial,"Noto Sans CJK SC","Microsoft YaHei",sans-serif;fill:#202124}.title{font-size:25px;font-weight:600}.head{font-size:18px;font-weight:600}.body{font-size:16px}.note{font-size:15px;fill:#4b5563}.card{fill:#fff;stroke:#222;stroke-width:1.7}.line{fill:none;stroke:#222;stroke-width:1.6;marker-end:url(#arrow)}</style>
<text x="36" y="42" class="title">Skill publication: ordinary upload paths</text>
<text x="36" y="80" class="note">Submission accepted ≠ published. Follow the version status.</text>
<text x="36" y="122" class="head">PUBLIC / NAMESPACE_ONLY</text>
<rect x="36" y="151" width="229" height="112" rx="15" class="card"/><rect x="48" y="138" width="205" height="33" rx="10" fill="#5c83ef"/>
<text x="59" y="161" class="head">Upload</text>
<text x="52" y="204" class="body">SKILL.md + files</text>
<text x="52" y="229" class="body">Validate package</text>
<rect x="295" y="151" width="229" height="112" rx="15" class="card"/><rect x="307" y="138" width="205" height="33" rx="10" fill="#5c83ef"/>
<text x="318" y="161" class="head">Scan</text>
<text x="311" y="204" class="body">SCANNING</text>
<text x="311" y="229" class="body">Scanning required</text>
<rect x="554" y="151" width="229" height="112" rx="15" class="card"/><rect x="566" y="138" width="205" height="33" rx="10" fill="#5c83ef"/>
<text x="577" y="161" class="head">Review</text>
<text x="570" y="204" class="body">PENDING_REVIEW</text>
<text x="570" y="229" class="body">Approval required</text>
<rect x="813" y="151" width="229" height="112" rx="15" class="card"/><rect x="825" y="138" width="205" height="33" rx="10" fill="#5c83ef"/>
<text x="836" y="161" class="head">Published</text>
<text x="829" y="204" class="body">PUBLISHED</text>
<text x="829" y="229" class="body">Audience rules apply</text>
<path d="M265 206 L295 206" class="line"/>
<path d="M524 206 L554 206" class="line"/>
<path d="M783 206 L813 206" class="line"/>
<text x="36" y="307" class="head">PRIVATE</text>
<rect x="36" y="336" width="229" height="112" rx="15" class="card"/><rect x="48" y="323" width="205" height="33" rx="10" fill="#5c83ef"/>
<text x="59" y="346" class="head">Upload</text>
<text x="52" y="389" class="body">SKILL.md + files</text>
<text x="52" y="414" class="body">Validate package</text>
<rect x="295" y="336" width="229" height="112" rx="15" class="card"/><rect x="307" y="323" width="205" height="33" rx="10" fill="#5c83ef"/>
<text x="318" y="346" class="head">Configured scan</text>
<text x="311" y="389" class="body">SCANNING if enabled</text>
<text x="311" y="414" class="body">Otherwise skip</text>
<rect x="554" y="336" width="229" height="112" rx="15" class="card"/><rect x="566" y="323" width="205" height="33" rx="10" fill="#5c83ef"/>
<text x="577" y="346" class="head">Confirm publish</text>
<text x="570" y="389" class="body">UPLOADED</text>
<text x="570" y="414" class="body">Explicit confirmation</text>
<rect x="813" y="336" width="229" height="112" rx="15" class="card"/><rect x="825" y="323" width="205" height="33" rx="10" fill="#5c83ef"/>
<text x="836" y="346" class="head">Published</text>
<text x="829" y="389" class="body">PUBLISHED</text>
<text x="829" y="414" class="body">Private access only</text>
<path d="M265 391 L295 391" class="line"/>
<path d="M524 391 L554 391" class="line"/>
<path d="M783 391 L813 391" class="line"/>
<text x="36" y="480" class="note">Scan failure or rejection stops these paths. Privileged auto-publish is a separate path.</text>
</svg>

After

Width:  |  Height:  |  Size: 3.9 KiB

View file

@ -0,0 +1,49 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1080 510" role="img" aria-labelledby="title desc">
<title id="title">技能发布:普通上传路径</title><desc id="desc">公开及命名空间上传经过扫描与审核;私有上传需要确认发布。</desc>
<defs><marker id="arrow" markerWidth="8" markerHeight="8" refX="7" refY="4" orient="auto"><path d="M1 1 L7 4 L1 7" fill="none" stroke="#222" stroke-width="1.5"/></marker></defs>
<rect width="1080" height="510" fill="#fff"/>
<style>text{font-family:Arial,"Noto Sans CJK SC","Microsoft YaHei",sans-serif;fill:#202124}.title{font-size:25px;font-weight:600}.head{font-size:18px;font-weight:600}.body{font-size:16px}.note{font-size:15px;fill:#4b5563}.card{fill:#fff;stroke:#222;stroke-width:1.7}.line{fill:none;stroke:#222;stroke-width:1.6;marker-end:url(#arrow)}</style>
<text x="36" y="42" class="title">技能发布:普通上传路径</text>
<text x="36" y="80" class="note">提交成功 ≠ 发布成功;以本次版本状态为准。</text>
<text x="36" y="122" class="head">PUBLIC / NAMESPACE_ONLY</text>
<rect x="36" y="151" width="229" height="112" rx="15" class="card"/><rect x="48" y="138" width="205" height="33" rx="10" fill="#5c83ef"/>
<text x="59" y="161" class="head">上传</text>
<text x="52" y="204" class="body">SKILL.md 与文件</text>
<text x="52" y="229" class="body">校验包结构与权限</text>
<rect x="295" y="151" width="229" height="112" rx="15" class="card"/><rect x="307" y="138" width="205" height="33" rx="10" fill="#5c83ef"/>
<text x="318" y="161" class="head">扫描</text>
<text x="311" y="204" class="body">SCANNING</text>
<text x="311" y="229" class="body">要求启用扫描</text>
<rect x="554" y="151" width="229" height="112" rx="15" class="card"/><rect x="566" y="138" width="205" height="33" rx="10" fill="#5c83ef"/>
<text x="577" y="161" class="head">审核</text>
<text x="570" y="204" class="body">PENDING_REVIEW</text>
<text x="570" y="229" class="body">等待审核批准</text>
<rect x="813" y="151" width="229" height="112" rx="15" class="card"/><rect x="825" y="138" width="205" height="33" rx="10" fill="#5c83ef"/>
<text x="836" y="161" class="head">已发布</text>
<text x="829" y="204" class="body">PUBLISHED</text>
<text x="829" y="229" class="body">按可见范围分发</text>
<path d="M265 206 L295 206" class="line"/>
<path d="M524 206 L554 206" class="line"/>
<path d="M783 206 L813 206" class="line"/>
<text x="36" y="307" class="head">PRIVATE</text>
<rect x="36" y="336" width="229" height="112" rx="15" class="card"/><rect x="48" y="323" width="205" height="33" rx="10" fill="#5c83ef"/>
<text x="59" y="346" class="head">上传</text>
<text x="52" y="389" class="body">SKILL.md 与文件</text>
<text x="52" y="414" class="body">校验包结构与权限</text>
<rect x="295" y="336" width="229" height="112" rx="15" class="card"/><rect x="307" y="323" width="205" height="33" rx="10" fill="#5c83ef"/>
<text x="318" y="346" class="head">按配置扫描</text>
<text x="311" y="389" class="body">启用时进入 SCANNING</text>
<text x="311" y="414" class="body">未启用则跳过</text>
<rect x="554" y="336" width="229" height="112" rx="15" class="card"/><rect x="566" y="323" width="205" height="33" rx="10" fill="#5c83ef"/>
<text x="577" y="346" class="head">确认发布</text>
<text x="570" y="389" class="body">UPLOADED</text>
<text x="570" y="414" class="body">显式确认后发布</text>
<rect x="813" y="336" width="229" height="112" rx="15" class="card"/><rect x="825" y="323" width="205" height="33" rx="10" fill="#5c83ef"/>
<text x="836" y="346" class="head">已发布</text>
<text x="829" y="389" class="body">PUBLISHED</text>
<text x="829" y="414" class="body">仍受私有权限约束</text>
<path d="M265 391 L295 391" class="line"/>
<path d="M524 391 L554 391" class="line"/>
<path d="M783 391 L813 391" class="line"/>
<text x="36" y="480" class="note">扫描执行失败或审核拒绝会中断上述路径。特权自动发布属于另一条路径。</text>
</svg>

After

Width:  |  Height:  |  Size: 3.9 KiB

View file

@ -0,0 +1,32 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1080 480" role="img" aria-labelledby="title desc">
<title id="title">Skill Suite: install, then use the entry skill</title><desc id="desc">A pinned Suite installs separate Skill directories. The user asks an Agent to use the entry skill.</desc>
<defs><marker id="arrow" markerWidth="8" markerHeight="8" refX="7" refY="4" orient="auto"><path d="M1 1 L7 4 L1 7" fill="none" stroke="#222" stroke-width="1.5"/></marker></defs>
<rect width="1080" height="480" fill="#fff"/>
<style>text{font-family:Arial,"Noto Sans CJK SC","Microsoft YaHei",sans-serif;fill:#202124}.title{font-size:25px;font-weight:600}.head{font-size:18px;font-weight:600}.body{font-size:16px}.note{font-size:15px;fill:#4b5563}.card{fill:#fff;stroke:#222;stroke-width:1.7}.line{fill:none;stroke:#222;stroke-width:1.6;marker-end:url(#arrow)}</style>
<text x="36" y="42" class="title">Skill Suite: install, then use the entry skill</text>
<text x="36" y="80" class="note">Registry and CLI manage delivery; the Agent follows the installed instructions.</text>
<rect x="36" y="135" width="229" height="112" rx="15" class="card"/><rect x="48" y="122" width="205" height="33" rx="10" fill="#5c83ef"/>
<text x="59" y="145" class="head">1. Choose Suite</text>
<text x="52" y="188" class="body">Exact member versions</text>
<text x="52" y="213" class="body">One entry member</text>
<rect x="295" y="135" width="229" height="112" rx="15" class="card"/><rect x="307" y="122" width="205" height="33" rx="10" fill="#5c83ef"/>
<text x="318" y="145" class="head">2. Install</text>
<text x="311" y="188" class="body">skillhub suite install</text>
<text x="311" y="213" class="body">Download and verify</text>
<rect x="554" y="135" width="229" height="112" rx="15" class="card"/><rect x="566" y="122" width="205" height="33" rx="10" fill="#5c83ef"/>
<text x="577" y="145" class="head">3. Separate skills</text>
<text x="570" y="188" class="body">entry-skill/SKILL.md</text>
<text x="570" y="213" class="body">member-a/SKILL.md</text>
<rect x="813" y="135" width="229" height="112" rx="15" class="card"/><rect x="825" y="122" width="205" height="33" rx="10" fill="#5c83ef"/>
<text x="836" y="145" class="head">4. Ask the Agent</text>
<text x="829" y="188" class="body">Discover entry skill</text>
<text x="829" y="213" class="body">Provide a task</text>
<path d="M265 190 L295 190" class="line"/>
<path d="M524 190 L554 190" class="line"/>
<path d="M783 190 L813 190" class="line"/>
<rect x="36" y="298" width="1006" height="132" rx="15" fill="#f4f7ff" stroke="#222" stroke-width="1.5"/>
<text x="56" y="329" class="head">Usage boundaries</text>
<text x="56" y="359" class="body">The entry remains an ordinary Skill. Other members can also be used directly.</text>
<text x="56" y="385" class="body">Member coordination depends on SKILL.md; installation does not execute a workflow.</text>
<text x="56" y="411" class="body">Configure required tools and credentials separately. There is no generic suite run command.</text>
</svg>

After

Width:  |  Height:  |  Size: 3 KiB

View file

@ -0,0 +1,32 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1080 480" role="img" aria-labelledby="title desc">
<title id="title">技能套装:安装成员,再使用入口技能</title><desc id="desc">固定版本套装安装为独立成员目录,用户再请求 Agent 使用入口技能。</desc>
<defs><marker id="arrow" markerWidth="8" markerHeight="8" refX="7" refY="4" orient="auto"><path d="M1 1 L7 4 L1 7" fill="none" stroke="#222" stroke-width="1.5"/></marker></defs>
<rect width="1080" height="480" fill="#fff"/>
<style>text{font-family:Arial,"Noto Sans CJK SC","Microsoft YaHei",sans-serif;fill:#202124}.title{font-size:25px;font-weight:600}.head{font-size:18px;font-weight:600}.body{font-size:16px}.note{font-size:15px;fill:#4b5563}.card{fill:#fff;stroke:#222;stroke-width:1.7}.line{fill:none;stroke:#222;stroke-width:1.6;marker-end:url(#arrow)}</style>
<text x="36" y="42" class="title">技能套装:安装成员,再使用入口技能</text>
<text x="36" y="80" class="note">注册中心与 CLI 管理分发,Agent 根据已安装的技能说明处理任务。</text>
<rect x="36" y="135" width="229" height="112" rx="15" class="card"/><rect x="48" y="122" width="205" height="33" rx="10" fill="#5c83ef"/>
<text x="59" y="145" class="head">1. 选择套装</text>
<text x="52" y="188" class="body">固定成员版本</text>
<text x="52" y="213" class="body">指定一个入口成员</text>
<rect x="295" y="135" width="229" height="112" rx="15" class="card"/><rect x="307" y="122" width="205" height="33" rx="10" fill="#5c83ef"/>
<text x="318" y="145" class="head">2. 安装成员</text>
<text x="311" y="188" class="body">skillhub suite install</text>
<text x="311" y="213" class="body">下载并校验成员</text>
<rect x="554" y="135" width="229" height="112" rx="15" class="card"/><rect x="566" y="122" width="205" height="33" rx="10" fill="#5c83ef"/>
<text x="577" y="145" class="head">3. 独立技能目录</text>
<text x="570" y="188" class="body">entry-skill/SKILL.md</text>
<text x="570" y="213" class="body">member-a/SKILL.md</text>
<rect x="813" y="135" width="229" height="112" rx="15" class="card"/><rect x="825" y="122" width="205" height="33" rx="10" fill="#5c83ef"/>
<text x="836" y="145" class="head">4. 请求 Agent 使用</text>
<text x="829" y="188" class="body">确认入口可被发现</text>
<text x="829" y="213" class="body">提供具体任务</text>
<path d="M265 190 L295 190" class="line"/>
<path d="M524 190 L554 190" class="line"/>
<path d="M783 190 L813 190" class="line"/>
<rect x="36" y="298" width="1006" height="132" rx="15" fill="#f4f7ff" stroke="#222" stroke-width="1.5"/>
<text x="56" y="329" class="head">使用边界</text>
<text x="56" y="359" class="body">入口仍是普通 Skill,其他成员也可以独立使用。</text>
<text x="56" y="385" class="body">成员如何协作由 SKILL.md 决定;安装不会自动执行工作流。</text>
<text x="56" y="411" class="body">工具和凭据按技能说明配置;SkillHub 没有通用的 suite run 命令。</text>
</svg>

After

Width:  |  Height:  |  Size: 3 KiB