前言¶
临床试验方案里，样本量与检验效能往往要对照统计假设反复试算：不同终点、组间比例、脱落率、α 与 β 一变，结果就不同。常见做法是本机装 R，再配 pwr、TrialSize 等包，或把公式写进 Excel。对统计同事这没问题；对需要在 IDE 里和 Agent 一起改方案、写文档的人，多一套本地 R 环境与包版本维护，成本不低。
下面介绍 SkillHub 上的 临床试验样本量专家（坐标 @user_ff7413f5/ct-samplesize）：在 Agent 里用自然语言描述试验设计，由 Skill 走云端 R 完成计算，并可回传完整 R 代码与出版级 SVG 图，本地不必安装 R。
这是什么¶
临床试验样本量专家（英文名可理解为 Clinical Trial Sample Size & Power）是面向临床试验从业者的 Agent Skill，由社区发布者 user_ff7413f5 维护（SkillHub 页面标注作者为张文彤）。当前版本 v5.13.28，分类为 professional，来源为 community。
它解决的核心问题是：在对话式工作流里完成 样本量估计 与 检验效能（power） 相关计算，而不依赖本机 R 运行时。官方简介说明：提供 云端 R 计算服务，覆盖 65 种检验，并输出 SVG 出版级别图形；交互为 自然语言驱动，默认回传完整 R 代码；输出语言 默认跟随操作系统语言（中文或英文），也可在提示词中强制切换。
Skill 带有 requires_api_key=true 标签，启用前需按 Skill 说明配置 API 密钥（具体字段以安装后的 SKILL.md 为准）。
核心功能¶
以下能力均来自 SkillHub 官方页面与已抓取元数据，不展开未在资料中出现的检验清单或接口细节。
- 云端 R 计算：本地无需安装 R，计算在云端 R 服务中执行。
- 检验类型覆盖：官方写明覆盖 65 种 与样本量/效能相关的检验场景（具体名录以 Skill 内文档为准）。
- 图形输出：支持 SVG 格式，面向报告或论文插图等出版级展示需求。
- 自然语言交互：用试验设计要素（如组数、效应量、显著性水平、把握度、比例或均值差等）描述问题，由 Agent 调用 Skill 完成计算。
- 可审计的 R 代码：默认返回 完整 R 代码，便于统计师复核或在自有 R 环境中复现。
- 中英输出：默认按系统语言输出中文或英文；需要在提示词中明确要求另一种语言即可切换。
安装与启用¶
方式一：SkillHub CLI（推荐）¶
先确认是否已安装 skillhub：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 官方安装文档执行完整安装（含 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/ 可能不会被识别。Cursor 常用路径为：
skillhub install user_ff7413f5/ct-samplesize --dir ~/.cursor/skills/
坐标在 CLI 中通常写作 user_ff7413f5/ct-samplesize（与页面上的 @user_ff7413f5/ct-samplesize 对应）。安装后按 Agent 要求重启或刷新技能列表，并配置 Skill 所需的 API Key（requires_api_key=true）。
方式二：让 AI 按官方安装说明操作¶
SkillHub 技能页提供的安装提示为：根据 SkillHub 安装与优先源配置，安装 @user_ff7413f5/ct-samplesize。可将该句发给当前 IDE 中的 Agent，由其读取 skillhub.md 并完成安装与目录选择。
其他客户端的 skills 目录¶
官方安装文档列出的路径包括：Claude Code ~/.claude/skills/、Codex ~/.codex/skills/ 或项目下 .agents/skills/ 等。原则相同：skillhub install ... --dir <对应目录>。Cursor 与 Codex、Claude Code 的差异仅在于 skills 目录路径，安装命令本身一致。
典型用法¶
官方资料未给出固定的一行「复制即用」对话模板，但 Skill 的定位清晰：用自然语言描述试验与统计假设，由 Skill 调用云端 R 并返回数值结果、SVG 图与 R 代码。可按下面思路在 Agent 中使用（表述需与你真实方案一致，此处仅为可复现的交互结构，非虚构案例结果）。
- 说明终点与检验：例如两组率比较、生存分析、非劣效/等效、交叉设计等，并给出 α、β（或把握度 1−β）、单侧或双侧（若适用）。
- 给出设计参数：各组预期比例或均值与标准差、组间分配比、预期脱落或可分析样本比例等（你手头方案里有的量尽量写全）。
- 声明输出需求：需要样本量 per group 或总样本量、检验效能曲线、或 出版用 SVG；若需留档，可明确要求 完整 R 代码。
- 语言：默认随系统；若要英文方案表述，在提示词中写明「请用英文输出结论与代码注释」。
安装并配置 API Key 后，在已启用该 Skill 的会话中直接发送上述结构化描述即可；具体支持的 65 种检验名称与参数名以 Skill 内说明为准。
适用场景与注意¶
适合谁
- 临床运营、医学写作、项目经理等需要在 Cursor 等环境里快速试算样本量，但不想维护本机 R 的同事。
- 生物统计师希望 Agent 起草计算草稿，再用返回的 R 代码 在正式环境中复核。
限制与注意
- 联网与密钥：云端 R 与
requires_api_key=true意味着需要有效 API 配置；无密钥或限网环境可能无法计算。 - 监管与合规：注册申报或正式方案定稿仍应以经资质统计师签字的方法与独立统计软件结果为准；Skill 输出适合探索与文档草稿，不替代 SOP 规定的工具链。
- 版本：本文依据 SkillHub 页面 v5.13.28；升级后检验种类或参数以新版本 SKILL 说明为准。
- 元数据：SkillHub 显示该 Skill 评分 100000、下载 2046 次（页面统计，会随时间变化）。
结尾¶
临床试验样本量专家把 65 种检验相关的样本量与效能计算 接到 Agent 对话里，用 云端 R 省去本机环境，并默认给出 R 代码 与 SVG 图，适合在方案迭代阶段做快速试算与沟通。官方技能页与 API 入口：
- SkillHub：https://www.skillhub.cn/skills/user_ff7413f5/ct-samplesize
- API：https://api.skillhub.cn/user_ff7413f5/ct-samplesize
安装坐标：@user_ff7413f5/ct-samplesize，配合 SkillHub 安装文档 与 skillhub install ... --dir 即可装入 Cursor 等客户端的 skills 目录。
