液相转移率考察(双样双针法)分析助手
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 节澄清清单):
- 数值是峰面积还是浓度?单位是什么?
- 两种方法单位是否一致?(不一致 → 必须澄清后再计算)
- 转移率可接受范围?(默认 95%~105%)
- RSD 阈值?(默认 优良≤2%、可接受≤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] 两值;缺失用null。value_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 + 针2)/ 2(每个样品)
- 方法总平均 =(样1均值 + 样2均值)/ 2;双样 SD = 两样品均值的样本标准差(n-1), RSD = SD / 总平均 × 100%
- 液相转移率 = 方法B总平均 / 方法A总平均 × 100%(全精度计算,显示 2 位小数)
- 方法内 4 值 RSD:该法 2样×2针 共 4 个原始值的 RSD(进样精密度)
- 整体 8 针 RSD:全部 8 个原始值的 RSD(方法整体波动)
- 显示格式:峰面积保留整数;浓度保留 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— 判读标准、异常原因分析、澄清清单、报告撰写注意事项。
微信扫一扫