glossary-alignment-check

v2026.09.24

For each technical term in a substacker draft's claims, checks shared-context/glossary.md for a writer-specific definition and compares to field-standard. Emits a note for terms where the two diverge (aligned / diverged-safe / diverged-risky). Feeds into classify-claim (which definition governs) and write-review-artifact's Glossary Alignment section. Use on every claim. Trigger keywords — glossary alignment, term definition, writer vs field, load-bearing term.

GitHub
安装命令
npx skhub add lyndonkl/glossary-alignment-check
Markdown
SKILL.md

Glossary Alignment Check

Workflow

Per claim:
- [ ] Step 1: Tokenize claim for candidate terms (named concepts, TLAs, math)
- [ ] Step 2: Grep shared-context/glossary.md for each term
- [ ] Step 3: If found, pull writer's definition
- [ ] Step 4: Compare to field-standard (prior knowledge + optional WebSearch)
- [ ] Step 5: Emit: aligned | diverged-safe | diverged-risky

Three outcomes

  • aligned: writer's definition matches field-standard. No note.
  • diverged-safe: definitions differ but the post's argument doesn't depend on the difference. Note but don't block.
  • diverged-risky: definitions differ AND the post's argument hinges on which definition is in force. Tier-2 note for the writer.

Worked example

Term: "attention" Writer's glossary: "the mechanism that lets tokens exchange information, including the residual bypass." Field-standard: "the weighted sum softmax(QK^T/√d)V, excluding the residual."

Status: diverged-risky if post asserts "attention is O(n²)" — true under field definition, false-or-unclear under the writer's.

Output note: "Writer's glossary includes residual in 'attention'; field-standard excludes. Post's claim 'attention is O(n²) in memory' is true under field but misleading under writer's glossary. Consider disambiguating in-post or tightening the glossary."

Guardrails

  1. Never rewrite the glossary. Only flag.
  2. Never mark aligned without actually checking the glossary file this run.
  3. If glossary is missing or empty, emit no-glossary and treat field definition as governing.
  4. When disagreement is strictly semantic (not functional), prefer diverged-safe over diverged-risky — err toward non-blocking.
  5. Diverged-risky notes appear in the Glossary Alignment section of the review artifact; don't bury in claim table.
发现
标签

此技能尚未发布标签。

版本
最新版本元数据

版本

v2026.09.24

发布时间

2026年9月24日

分类

未分类

许可证

未指定

源路径

skills/glossary-alignment-check

默认分支

main

最新提交

4acc337

Tree SHA

4f0a83e