科研 Skill
术语与数据输出保真锁定
output-fidelity-lock
当代理的任何输出(翻译、转写、改写、报告、表格、图注、JSON 或传给下游脚本的参数)需要复述输入中的基因、编号、样本名、数值、单位、日期、金额、序列或表格时使用;用户反映“名字被翻译了”“版本号没了”“两个基因的数值换了”“译文把数据删了”“NA 被填成 0”时也适用。提供按实体—字段—值绑定的事实提取、翻译前的不变量保护、模板填充与交付前校验。
SKILL.md
术语与数据输出保真锁定
这是一条底线,不是一个可选步骤
代理写出来的每一个基因名、编号、数值和表格单元都是重新生成的,不是复制的。上下文越长、输出越长,变形越多:Ensembl 编号丢版本号、Lgals1 和 Lgals3 的 FC 互换、FDR 从 6.84e-9 变成 6.84e-8、译文里整段数据消失、NA 被填成 0、凭空出现一个看起来合理的编号。用户不会说“请帮我保真”,他们只会在拿到结果后发现对不上。所以只要输出里出现来自输入的具体内容,本 Skill 就生效;来源可以是用户消息,也可以是当前任务里代理从附件读取并登记的内容。
完整规则、四层结构、数值等价规则和两种模式见输出保真契约;需要判断某个写法是否本来就规范时读命名规范速查。识别规则集中在 references/不变量模式.json,由 scripts/fidelity_lock.py 读取,代理不需要把模式或任何词表读进上下文。
校验的是绑定关系
清单不是值的集合,而是“实体 → 字段 → 值 → 定位”的事实:Lgals1 → fc → 43.69。所以两个基因数值互换、译文删掉全部数据、保护标记位置互换,都会被抓出来;正式问题只包含数据错误,大小写、连字符、希腊字母、氨基酸记法这类形式差异只作警告。
两档处理
- 少量事实(几个基因名、几个数值、一句结论)可以直接写,但交付前必须通过校验。
- 批量数据(表格、列表、超过 10 个数据点)不允许手写。在 Markdown 中写插槽
{{table:文件:行数:列名,列名}}、{{rows:文件:键列:值1,值2}}、{{value:文件:键列=键值:目标列}}或{{file:文件}},由脚本从源文件原样填充;代理只写叙述。
工作流
所有命令只依赖 Python 3.12 标准库,只处理可解码文本,输入只读,输出写到用户工作区,已存在的文件默认不覆盖。
-
登记来源并提取事实清单。用户消息、上传文件、上游结果表都是来源。PDF、DOCX、XLSX 先由代理读取生成带页码、段落号、表格行列号的文本投影,再登记;读不出来的页面或图片表格必须登记为不可校验:
python scripts/fidelity_lock.py extract 用户消息.txt deg_results.tsv --output 工作区/manifest.json python scripts/fidelity_lock.py extract 论文投影.md --projection-of paper.pdf --unverifiable "第3页表2为图片,无法投影" --output 工作区/manifest.jsonCSV/TSV 按行提取主键实体、别名列和每个数值列的绑定;纯文本按句提取实体与最近的字段标签和值。清单是唯一真值,登记后不得替换;之后引用任何事实都从清单或源文件取。
-
生成输出。叙述部分自己写;数据部分写插槽后运行:
python scripts/fidelity_lock.py render --template 工作区/report.template.md --output 工作区/report.md插槽引用的文件不存在、列名不对、键值不唯一时脚本拒绝写出,不会静默留空。
-
翻译、转写或改写时不变量不进入被重写的文本。先保护,完成后回填:
python scripts/fidelity_lock.py protect --input 原文.md --output 原文.protected.md --mapping 原文.map.json python scripts/fidelity_lock.py restore --input 译文.protected.md --mapping 原文.map.json --output 译文.md⟦INV0001⟧形式的保护标记必须原样保留且不得互换位置;回填会核对每个标记的次数和实体—值绑定,缺一个、多一个或换了位置都不通过。语序调整而绑定不变可以通过。 -
交付前重新读取最终产物形成候选文本再校验,不校验生成前的草稿。翻译、转写、改写用默认的
translate模式;分析报告用analysis:python scripts/fidelity_lock.py verify 工作区/译文.md --manifest 工作区/manifest.json --report 工作区/fidelity.json python scripts/fidelity_lock.py verify 工作区/report.md --manifest 工作区/manifest.json --mode analysis --allow-novel 工作区/新结果.txt报告项包括数值绑定到错误实体、绑定值改变、精度被改动、来源数据丢失、来源实体丢失、候选稿未包含任何来源数据、来源中不存在的数值或编号、版本号丢失或改动。输出本身是表格时加
--table-source 源表.tsv --key-column gene_id,会逐格对比并报告丢行、新增行、重排、单元格改动和缺失值填补。退出码 1 必须修改后重新校验;退出码 3 表示已校验范围无错误但存在不可校验范围,交付说明必须明示。
代理的专业判断
translate模式禁止--allow-novel:译文不得引入来源里没有的数据,来源数据丢失也是错误。分析任务里校验器报“来源中不存在的数值或编号”时,先分辨是本次分析真实产生的新结果还是凭印象写的:前者要能指向产生它的文件再登记,后者删除或重新读源文件。不能为了让校验通过而登记自己说不清来源的值。- 独立的纯整数允许阿拉伯数字、中文数字、英文数字词互换(36 只小鼠与 thirty-six mice);科学小数、精度、正负号、指数、比较符、百分号、单位和绑定不放宽。
- 图表、章节、方法编号(表 2、Fig. 3B、方法 4.8)不是数据,校验器只记录不比较;
itself、Methods、Total一类普通词不作为实体。 - 用户明确要求四舍五入、换单位、统一命名时可以做,但输出要写明变换方式,原值仍应在附表或说明中可查。
- 遇到看似普通单词的符号(CAT、MET、SHH、WAS、REST、SET),看它在来源中的位置:在基因列、“基因 X”句式或与其他基因并列时按标识符处理,不翻译。拿不准时保留原样并标注。
- 记不清的值写
[UNVERIFIED]或回去读文件,永远不用一个看起来合理的数填上。
边界
本 Skill 不判断科学结论是否正确,只保证输出与来源一致。它不解析 PDF、DOCX、XLSX 二进制文件,投影质量由代理负责并如实登记覆盖范围。模式文件按格式识别编号,不能识别全部物种的所有基因符号;漏识别意味着少一层保护,不意味着可以改写。运行时若已有独立的数据校验工具,本 Skill 的 protect、restore、render 作为生成保护层放在它之前,verify 的结果与它并列,不替代它。
所属插件
安装该插件会一并获得同领域的 68 个 Skill / MCP。
同插件的其他科研 Skill
- API与外部系统集成设计或调用API、处理认证、限流、分页、重试和外部平台集成时使用;已有Claude Science数据访问应优先使用MCP。
- 生信分析代理可靠性评测当用户明确要比较生信助手、检查自动分析是否编造、评估升级回归或建立失败基准(BioAgent Failure Atlas),且有案例或记录时使用;组织冻结判据及产物审计,普通分析失败先回原流程,不要求科研新手设计测试。
- 生物医学知识图谱与RAG构建或查询基因-疾病、药物-靶点、文献和调控关系,进行证据子图聚合或生物医学RAG时使用;富集分析使用独立Skill。
- 数据库版本与分析结论漂移审计当用户说更新数据库后结果变了、以前显著现在没有、注释或排名不一致,或需比较两版资源影响(BioDataDrift)时使用;核验运行条件,已有结果比较漂移、有两版映射可固定背景重算,不要求用户理解哈希或参数。
- 临床研究报告整理适应症、患者人群、疾病生物学、标准治疗、监管先例或生成临床科研报告时使用;不替代临床诊断。
- 临床统计与生存分析开展生存分析、时间结局建模、删失数据处理或临床预测评估时使用。
- 临床试验检索与方案设计检索临床试验、比较试验设计或生成药物和器械临床试验方案时使用;不替代法规或医学专业审查。
- 探索性数据分析与统计检验当用户需要检查科研表格的数据质量、分布、关联和异常值,或为连续、分类、配对及多组数据选择并执行通用统计检验时使用;生存结局和专门组学模型使用对应领域 Skill。
- 生物信息文件格式转换与完整性校验当用户需要在 FASTA、FASTQ、SAM、BAM、CRAM、BIOM、TSV 或常见丰度表布局之间转换,并核对转换前后记录、配对关系和校验值时使用;分子结构格式转换不使用本 Skill。
- 科研数据隐私与脱敏当用户需要识别、移除或降低科研数据中的个人身份、基因组再识别和敏感元数据风险时使用。
- 科研表格数据处理清洗、校验、转换、筛选、聚合或序列化表格与DataFrame数据时使用;不用于领域统计模型或数据库在线检索。
- Word 公式处理器安全处理 Word 论文公式
- Word 文档处理读写编辑复杂 Word 文档
- 科研证据评估进行证据分级、矛盾搜索、来源回溯、模型评估或置信度校准时使用;不用于首次数据库检索。
- 生物医学实验设计设计生物医学实验、对照、重复、样本量、随机化或实验协议时使用;临床试验使用临床试验工作流Skill。
- 图像生成助手调用图像接口生成位图素材
- 科研计算环境与工作流配置Docker、HPC、Slurm、Nextflow、Snakemake、并行任务或科研流水线执行环境时使用;不用于解释生物学结果。
- 实验仪器数据标准化把实验室仪器输出转换为Allotrope ASM、规范JSON或二维表格并校验字段时使用;不用于生物统计分析。
- 文献检索与科学写作检索和核验科学文献、管理引文、撰写综述或形成有来源支撑的科学文本时使用。
- 机器学习训练与评估训练、推理、解释、交叉验证、基准评测或调优通用机器学习模型时使用;领域专用基础模型优先使用对应生物任务Skill。
- MCP工具发现与故障处理检查Claude Science MCP服务、发现工具、判断连接状态或排查工具调用失败时使用;不用于修改现有MCP源码。
- Markdown 转 Word 工具将 Markdown 转换为 Word 文档
- nf-core流程选择与比较当用户只有测序公司或科研平台交付的文件、仅知道样本来源,不清楚数据类型、能研究什么或如何分析时使用;先识别数据与处理阶段,再根据研究问题自主匹配分析流程、输入与参数,也支持已有明确方法的请求。
- nf-core-datasync流程当科研数据需要在存储位置间复制、同步或整理,且能核对源文件与目标位置时使用。根据文件、实验背景与研究问题判断适配性,选择方法及参数并解释限制;无需用户知道 nf-core/datasync。
常见问题
术语与数据输出保真锁定能做什么?
当代理的任何输出(翻译、转写、改写、报告、表格、图注、JSON 或传给下游脚本的参数)需要复述输入中的基因、编号、样本名、数值、单位、日期、金额、序列或表格时使用;用户反映“名字被翻译了”“版本号没了”“两个基因的数值换了”“译文把数据删了”“NA 被填成 0”时也适用。提供按实体—字段—值绑定的事实提取、翻译前的不变量保护、模板填充与交付前校验。
如何安装术语与数据输出保真锁定?
在科搭 Codar 左侧点击「插件」,在「组件」页签搜索「术语与数据输出保真锁定」并安装;在 Claude Code 或 Codex 中可以发送本页的安装提示词,或下载 Skill 包后解压到 ~/.claude/skills 或 ~/.codex/skills。
术语与数据输出保真锁定需要哪些权限?
该科研 Skill没有声明额外权限;执行具体操作时仍由 Agent 按自身规则请求确认。
术语与数据输出保真锁定经过官方审核吗?
是。SpeedSkills 收录的每个版本都会记录内容摘要与权限声明,当前版本已通过安全审核。