mcpField
T
terminology-normalizer

terminology-normalizer

github.com/willoscar文档处理51753 次安装3 周前更新
代码仓库

关于 terminology-normalizer

terminology-normalizer 是用于统一技术综述草稿术语的 Skill,不改变原意或引文。它确定规范术语,并在正文、标题和表格中保持一致。

主要功能

  1. 01整理候选术语表
  2. 02确定规范术语和同义词规则
  3. 03统一标题与表格中的术语
  4. 04保留引文及有意义的概念差异
  5. 05可选生成术语表附录

适用场景

  1. 01解决草稿中的术语叫法不一
  2. 02使章节标题与分类体系一致
  3. 03统一正文和表格中的术语

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/willoscar/research-units-pipeline-skills --skill terminology-normalizer

安装后在 Claude Code 中输入/terminology-normalizer确认已加载。

详细介绍

术语规范化

触发条件与路由

  • 触发条件:术语、术语表、术语一致、术语统一、统一叫法、术语表。
  • 适用场景:草稿中的概念表述不一致(同一事物有 2–3 种叫法),或全局审查指出术语不一致。

目的:通过统一命名(规范术语 + 同义词策略),让草稿读起来像出自同一位作者之手,同时不改变引文或含义。

角色卡(明确使用)

分类学家(规范术语)

使命:为每个概念确定一个规范术语,并制定简单的同义词策略。

应做:

  • 有可用的分类节点名称时(outline/taxonomy.yml),优先将其用作规范标签。
  • 仅在读者有所预期时制定简短的同义词策略(谨慎使用)。
  • 确保标题和表格与规范术语一致。

避免:

  • 重命名专有名词(论文标题、基准名称、模型名称)。
  • 过度规范化,以致抹去有意义的区别(例如,将两种不同机制合并为一个词)。
整合者(应用时避免偏差)

使命:一致地应用替换,同时不改变含义或引文。

应做:

  • 局部、保守地替换;对替换后可能产生歧义的句子重新审读。
  • 保留引文位置和小节边界。

避免:

  • 为统一术语而改写时引入新主张。
  • 将引文移至其他小节。

角色提示词:术语编辑(统一风格)

You are normalizing terminology in a technical survey draft.

Your job is to make the draft read like one author wrote it by enforcing consistent naming.

Constraints:
- do not add/remove citation keys
- do not move citations across ### subsections
- do not introduce new claims while renaming

Method:
- pick a canonical term per concept
- define allowed synonyms (optional, minimal)
- apply consistently across headings, prose, and tables

输入

  • output/DRAFT.md
  • 可选(只读上下文):
    • outline/outline.yml(标题一致性)
    • outline/taxonomy.yml(规范标签)

输出

  • output/DRAFT.md(原地修改)
  • 可选:output/GLOSSARY.md(如有用,可添加简短附录/术语表)

工作流

使用上述角色卡。

步骤:

  1. 从草稿中整理候选术语表(10–30 个关键术语):
  • 核心对象(Agent、工具、环境、协议)
  • 关键组件(规划器/执行器、记忆、验证器)
  • 评估术语(基准、指标、预算)
  1. 选择规范名称和同义词策略:
  • 一个概念 = 一个规范术语
  • 仅在读者有所预期时定义允许使用的同义词(并谨慎使用)
  • 如果存在 outline/taxonomy.yml:优先将分类节点名称用作规范标签(避免创造新名称)
  • 如果存在 outline/outline.yml:确保章节标题与相同的规范术语一致
  1. 保守地应用替换:
  • 不要修改论文名称、模型名称、基准名称
  • 确保标题、正文和表格标题中的术语一致
  1. 可选:编写简短的 output/GLOSSARY.md:
  • 术语 | 规范术语 | 允许的同义词 | 备注

简短示例(应做与避免)

  • 不佳(术语漂移):将 tool API、tool interface、action schema 当作同义词使用,却没有明确规则。

  • 更佳(规范术语 + 简单的同义词策略):选定一个规范术语(例如 tool interface),并仅在首次引入时允许使用一个同义词(例如 tool interface (API contract)),之后统一使用规范术语。

  • 不佳(过度规范化):替换不同术语,导致对比关系消失。

  • 更佳:不同术语体现不同机制时,应保留其区别;仅统一拼写和命名。

防护规则(不得违反)

  • 不要添加或删除引文键。
  • 不要将引文移至其他 ### 小节。
  • 不要在重命名时引入新主张。

故障排除

问题:规范化修改了引文键或移动了引文

解决方法:

  • 撤销修改;此技能不得添加或删除引文键,也不得将引文移至其他小节。
问题:同义词策略不明确

解决方法:

  • 为每个概念定义一个规范术语,并列出允许使用的同义词;在标题、表格和正文中一致应用。

评论

支持 Markdown