前言¶
病理切片分析往往要对接登录鉴权、对象存储上传、分析任务创建和结果查询等多段 HTTP 接口。若把这些步骤写在业务脚本里,Agent 很难在对话里按上下文自动编排;若只给模型一段口头说明,又容易漏步骤或搞错顺序。下面介绍 SkillHub 上的社区 Skill「病理切片分析」,它把官方描述的六步 API 工作流写进 SKILL.md,供 Cursor、Claude Code、Codex 等支持 Skills 的客户端在需要时按流程执行。
这是什么¶
「病理切片分析」是 SkillHub 坐标 @user_ef14ddb2/analysis-pathology-slice 下的专业类(professional)Skill,当前版本 1.0.0,来源为 community,由发布者 user_ef14ddb2 维护。
一句话定位:提交病理切片、发起分析请求,并通过六步 API 工作流取回 AI 诊断结果。官方说明写明适用场景包括登录/鉴权、获取 COS 凭证、文件上传、创建记录与结果轮询;Skill 标签 requires_api_key=true,使用前需准备可用的 API Key(具体字段名以 Skill 包内文档为准)。
SkillHub 页面统计(以页面展示为准):评分 100000,下载 787,安装 6。
核心功能¶
已核实的能力均来自 SkillHub 简介,不展开未公开的接口细节:
- 登录与鉴权:工作流第一步,为后续调用建立合法会话或令牌。
- 获取 COS 凭证:为切片文件上传准备对象存储(COS)访问凭证。
- 文件上传:将病理切片提交到后端可识别的存储位置。
- 创建分析记录:在业务侧登记本次分析任务。
- 发起分析请求:触发 AI 病理分析。
- 结果轮询:在分析未完成时按流程查询,直至拿到 AI 诊断结果。
当用户在对话中提出「要做病理切片分析」「上传切片并看诊断结果」等需求时,Agent 应加载本 Skill,按上述顺序组织调用,而不是零散猜测接口。
安装与启用¶
安装方式遵循 SkillHub 统一说明 skillhub.cn/install/skillhub.md。先确认本机是否已有 skillhub CLI:
command -v skillhub && skillhub --version
若未安装,可使用官方推荐的一键脚本(完整安装含 CLI 与默认 Skill):
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI 时:
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安装本 Skill 时,必须用 --dir 指向当前 Agent 的 skills 目录,否则默认落在 ./skills/,客户端可能无法识别。示例:
skillhub install user_ef14ddb2/analysis-pathology-slice --dir <skills 目录>
各客户端常用 skills 目录(摘自官方安装文档):
- Claude Code:
~/.claude/skills/ - Cursor:
~/.cursor/skills/ - Codex:
~/.codex/skills/或项目下的.agents/skills/
SkillHub 页面也提供自然语言安装提示,可直接发给 Agent:
请根据 https://skillhub.cn/install/skillhub.md,安装 `@user_ef14ddb2/analysis-pathology-slice`。
安装完成后,按所用客户端要求重启或刷新 Skills 列表。因 requires_api_key=true,请在环境或 Skill 约定位置配置 API Key,否则鉴权相关步骤无法完成。
典型用法¶
官方未在公开页面给出可复制粘贴的 HTTP 示例;可复现的用法是「安装 Skill + 在对话中描述业务目标」,由 Agent 读取 SKILL.md 内的六步流程。
- 按上一节将
@user_ef14ddb2/analysis-pathology-slice安装到当前 Agent 的 skills 目录。 - 配置 API Key(具体变量名以 Skill 包内说明为准)。
- 在对话中说明本地切片路径或待分析文件,并明确要求走病理切片分析全流程直至返回 AI 诊断结果。
示例提示(示意,非官方固定文案):
我有一份病理切片需要分析。请使用已安装的病理切片分析 Skill,按六步 API 流程完成鉴权、COS 上传、创建记录、发起分析和结果轮询,最后把 AI 诊断结论整理给我。
经过上面的步骤,Agent 应依次处理登录/鉴权、COS 凭证、上传、建单、分析与轮询,而不是跳过中间环节直接猜测结论。
适用场景与注意¶
适合谁
- 已在 SkillHub 或合作方侧开通病理分析 API、并持有 API Key 的开发者或集成人员。
- 希望在 Cursor / Claude Code / Codex 等环境中,用自然语言驱动完整切片分析流水线,而不是每次手写脚本的用户。
限制与注意
- 本 Skill 为 community 来源,行为与后端 SLA 以实际服务方为准;本文不描述未公开的域名、路径或响应格式。
- 诊断结果来自 AI 与上游服务,不能替代临床病理医生的最终判读;上线或面向患者的产品需自行合规与免责。
- 六步流程含对象存储与轮询,大文件上传或队列繁忙时耗时会变长,需在业务侧设置合理超时与重试策略(具体以 Skill 内指引为准)。
- 若
skillhub在沙箱或受限网络中不可用,需在允许访问外网的环境下执行安装命令。
结尾¶
「病理切片分析」把提交切片、触发分析与取回 AI 诊断结果收敛为 Agent 可执行的六步 API 工作流,适合在已具备 API Key 的前提下接入对话式开发环境。详情与安装入口见 SkillHub 页面与 API 坐标页:
- https://www.skillhub.cn/skills/user_ef14ddb2/analysis-pathology-slice
- https://api.skillhub.cn/user_ef14ddb2/analysis-pathology-slice