返回 Skill 列表
extension
分类: 数据与分析无需 API Key

液相转移率考察(双样双针法)数据分析与药审报告生成技能

液相转移率考察(双样双针法)数据分析与药审报告生成技能。当用户提供两种样品处理方法(方法A/方法B)下各2个平行样品、每样连续进样2针的液相色谱数据(峰面积或浓度),要求计算液相转移率、评估方法间响应转移效率与精密度(双样RSD、进样精密度、整体8针RSD),并生成可直接提交药审专家审阅的HTML考察报告(含规范数据表格与Chart.js图表)时触发。适用于方法替代/变更验证、分析方法可比性研究等场景。触发词:双样双针、液相转移率、转移率考察、方法A方法B对比、转移率报告。

person作者: user_c160f2b7hubcommunity

液相转移率考察(双样双针法)分析助手

Overview

本技能根据用户提供的双样双针液相色谱数据(方法A/方法B × 样1/样2 × 针1/针2,共 8 个原始值), 完成数据核验、统计计算(样品双针均值、方法总平均、双样 SD/RSD、方法内 4 值 RSD、整体 8 针 RSD、 液相转移率),并生成一份可直接提交药审专家审阅的 HTML 报告(含原始数据表、统计结果表、 3 个 Chart.js 图表与结论评价)。

核心原则:

  • 计算必须由 scripts/transfer_rate_calc.py 完成(全精度、可审计),禁止手工心算或杜撰数值。
  • 始终使用用户提供的数据;缺失/不一致必须澄清,不得自行补全或换算。
  • 报告以独立 .html 文件交付,同时给出关键数值的文本摘要。

Workflow(交互流程)

Step 1: 引导用户提供数据

按以下格式引导用户输入(峰面积或浓度均可,但两种方法必须统一):

方法A:
样1-针1: 数值, 样1-针2: 数值
样2-针1: 数值, 样2-针2: 数值
方法B:
样1-针1: 数值, 样1-针2: 数值
样2-针1: 数值, 样2-针2: 数值

同时询问(按 references/acceptance-criteria.md 第 5 节澄清清单):

  1. 数值是峰面积还是浓度?单位是什么?
  2. 两种方法单位是否一致?(不一致 → 必须澄清后再计算)
  3. 转移率可接受范围?(默认 95%~105%)
  4. RSD 阈值?(默认 优良≤2%、可接受≤5%)
  5. 方法A/方法B简要描述、报告编号、操作人、审核人(可选)

若用户仅给响应值,默认按峰面积直接计算,并在报告中注明。

Step 2: 数据核验

  • 检查 8 个值是否齐全:任一样品任一次进样缺失 → 中止计算,列出缺失位置,请用户补全。
  • 检查是否非数值或负值 → 中止并说明。
  • 方法内 4 值 RSD > 5% → 在报告中加警示框提示"可能存在进样或系统问题,建议核查后确认 数据有效性",但继续计算(脚本自动处理)。

Step 3: 调用计算引擎生成报告

构造 --data JSON 并执行:

python3 ~/.workbuddy/skills/lc-transfer-rate-assay/scripts/transfer_rate_calc.py \
  --data '{"method_a":{"desc":"...","sample1":[v,v],"sample2":[v,v]},
           "method_b":{"desc":"...","sample1":[v,v],"sample2":[v,v]},
           "value_type":"峰面积","unit":"mAU·s","report_date":"2026-08-03",
           "accept_min":95,"accept_max":105,"rsd_good":2,"rsd_acceptable":5}' \
  --template ~/.workbuddy/skills/lc-transfer-rate-assay/references/report-template.html \
  --output 转移率考察报告.html

参数说明:

  • --data:JSON 字符串(必需)。sample1/sample2 各为 [针1, 针2] 两值;缺失用 nullvalue_type"峰面积""浓度"unit 浓度示例 "µg/mL",峰面积可留空; accept_min/accept_max(默认 95/105)、rsd_good(默认 2)、rsd_acceptable(默认 5)、 sig_figs(默认 4,有效数字位数)、report_no/operator/auditor(可选)。
  • --template:模板路径(省略时自动定位脚本同级的 ../references/report-template.html)。
  • --output:输出 HTML 路径。

脚本退出码:0=成功;1=JSON解析失败;2=数据核验未通过;3=模板缺失。

Step 4: 交付报告

  • present_files 交付生成的 .html 文件(会打开实时预览)。
  • 在回复中给出关键数值摘要:转移率、方法A/B总平均、双样RSD、整体8针RSD、结论。
  • 若用户仅要文本结果:先给文本摘要,并询问是否需要生成 HTML 报告。

计算规则(由脚本执行,此处供人工复核)

  1. 样品平均值 =(针1 + 针2)/ 2(每个样品)
  2. 方法总平均 =(样1均值 + 样2均值)/ 2;双样 SD = 两样品均值的样本标准差(n-1), RSD = SD / 总平均 × 100%
  3. 液相转移率 = 方法B总平均 / 方法A总平均 × 100%(全精度计算,显示 2 位小数)
  4. 方法内 4 值 RSD:该法 2样×2针 共 4 个原始值的 RSD(进样精密度)
  5. 整体 8 针 RSD:全部 8 个原始值的 RSD(方法整体波动)
  6. 显示格式:峰面积保留整数;浓度保留 4 位有效数字;RSD/转移率保留 2 位小数

判读与报告要求

  • 判定标准默认值(可用 --data 覆盖并在报告中申明):转移率 95%~105% 可接受; 双样 RSD ≤2% 优良、≤5% 可接受。参考 references/acceptance-criteria.md 第 2 节表格。
  • 结论措辞:使用"符合/不符合本报告设定的可接受标准",不直接断言"符合药典要求"。
  • 异常结果的可能原因与建议(基质效应、转移损失、进样漂移等)按 references/acceptance-criteria.md 第 3 节写入"结论与评价"。
  • 报告须含:标题与基本信息、原始数据表、统计结果表、3 个图表(柱状对比+误差线、 转移率指示图含 100% 虚线与可接受范围背景、进样精密度图)、结论与评价、 数据来源与计算方法简述、HTML 末尾审计注释(脚本自动追加,勿删除)。

约束与禁忌

  • 禁止杜撰/修改用户数据;禁止擅自剔除异常值(由用户决定)。
  • 单位不一致时禁止自行换算,必须先澄清。
  • 不跳过核验步骤直接计算;脚本报错时如实转达错误信息,不得掩盖。
  • 数值显示规则由 value_type/sig_figs 控制,不得自行决定显示位数。

Resources

scripts/

  • transfer_rate_calc.py — 计算引擎(零第三方依赖):数据核验 → 全精度统计 → 判读文字 → HTML 渲染 → 审计注释追加。运行后打印 JSON 摘要(含转移率、RSD、警告、审计文本)。

references/

  • report-template.html — HTML 报告模板(Chart.js 3.9.1 CDN、表格、图表、样式), 占位符 __REPORT_DATA_JSON__ 由脚本注入。
  • acceptance-criteria.md — 判读标准、异常原因分析、澄清清单、报告撰写注意事项。