用途:管理全局术语表 ~/.claude/docs/GLOSSARY.md 及其 Vale 集成。该术语表是所有项目术语的单一事实来源(SSoT),本技能用于手动同步术语到 Vale 词表、校验术语表格式与结构、检查跨项目重复或冲突术语、以程序化方式添加新术语,以及排查 Vale 术语警告。
主要能力:术语表采用 5 列表格格式,列为 Term(加粗)、Acronym、Definition、Unit/Range、Projects。同步会生成 Vale 词表文件 accept.txt(已接受术语)与 Terminology.yml(替换规则)。两个 PostToolUse 钩子负责自动同步:编辑 GLOSSARY.md 时触发 posttooluse-glossary-sync 同步到 Vale 词表;编辑项目 CLAUDE.md 时触发 posttooluse-terminology-sync 合并术语并检测冲突。冲突类型包括定义冲突、缩写冲突与缩写碰撞。
使用方式:手动同步执行 bun ~/.claude/tools/bin/glossary-sync.ts。检查重复或冲突可运行 bun ~/eon/cc-skills/plugins/itp-hooks/hooks/posttooluse-terminology-sync.ts 并传入工具事件 JSON。校验格式可用 grep 检查加粗术语行,或查看文件头部表格结构。添加术语直接编辑 GLOSSARY.md 表格行,同步由钩子自动触发,再用 echo "The NT is important" | vale --config=~/.claude/.vale.ini 验证。运行 Vale 时需先进入文件所在目录,否则 glob 可能匹配不到文件而显示 0 files。
适用场景:需要统一多项目术语、维护 Vale 词表、排查术语未被识别或钩子未触发等问题时使用。
限制:SCAN_PATHS 通过 GLOSSARY.md 中的 HTML 注释配置,支持 glob 且路径相对主目录;未指定时使用默认路径。若出现 Vale 不一致,需检查并删除多余的 Vocab 目录。资料未提供收费、价格与平台信息。