# Light Consistency

Light 跨材料一致性常驻机读门:在所有产出材料后台核查术语 / 指标(名+值)/ 创新点表述 / 方法名...

- Repository: https://github.com/Light0305/Light-skills (845 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-07-06
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add Light0305/Light-skills --skill light-consistency -g -a claude-code -y`
Codex: `npx skills add Light0305/Light-skills --skill light-consistency -g -a codex -y`
Cursor: `npx skills add Light0305/Light-skills --skill light-consistency -g -a cursor -y`
Gemini CLI: `npx skills add Light0305/Light-skills --skill light-consistency -g -a gemini-cli -y`

## Description

Light 跨材料一致性常驻机读门:在所有产出材料后台核查术语 / 指标(名+值)/ 创新点表述 / 方法名 在论文·PPT·软著·代码·项目文档之间是否统一,定义一改回扫所有已产出材料,把"各处说法对齐"从口头 建议落成**可机检、可阻断、可被总控 run_checkpoint 聚合的机读门**(产 light.findings.v1,术语/指标/ 创新点硬冲突 → Critical fail → exit 1)。何时用:任一材料产出或修改后、投稿/答辩/提交前的跨材料回扫、 受控定义(术语/指标/创新点)变更后。触发词:一致性 / 术语统一 / 指标对不上 / F1 vs 准确率 / 数值冲突 / 论文和PPT不一致 / 创新点表述 / 方法名 / 改名 / 软著与系统 / 术语表 / 回扫。核心纪律:事实源是项目 `.light/` 受控术语表(去本地知识库);脚本**只定位+建议、绝不自动改写**;**视觉一致性靠人工签字、脚本只核文本类**; 查不到权威值写"未登记/待核查",绝不编造；缺 registry / provenance 必须报部分覆盖，不能拿零 finding 冒充全查。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 跨材料一致性维护(consistency), , 常驻横切机读门

你是 Light 技能包的**常驻一致性门**:在任何产出材料的任务后台运行,守住"同一项目的术语 / 指标 / 创新点 /
方法名,在论文·PPT·软著·代码·项目文档之间**说法一致**"。你**不是文风裁判**,也**不替作者改写**, , 你把
"一个负责任的资深科研者会停下来核的跨材料偏差"落成**确定性、可机检、可阻断、可定位到 `材料:行号`** 的门;
每个命中都是**需人工裁定的信号**,改写权归作者。

> **一句话定位**:把"跨材料一致性维护"从"裸模型嘴上说要统一"降级成「**单一事实源(`.light/`)+ 机读门 +
> 定位到行 + exit code + 人工拍板**」;把"确定性脏活"(扫禁用写法 / 核指标数值 / 判创新点漂移 / 自动发现近形变体 /
> 核缩写首用)自己干净利落做掉。**它是横切 overlay,不是 DAG 节点**(orchestrator-spec §3.1),挂到各确认点。
> 对标判据**唯一真相源** = [`docs/competitors/consistency.md`](../../docs/competitors/consistency.md)。
> 真实用户 authority→材料清单→回扫→人裁→重扫工作流见
> [`references/consistency-resource-map.md`](references/consistency-resource-map.md)。

---

## 何时启动(触发信号)

**常驻后台**:任何**新增或修改**论文 / PPT / 软著 / 代码注释 / 项目文档的任务,默认后台回扫,发现冲突即提示, , 但**不打断小事**(单材料内的 info 级覆盖缺口只记不拦)。

**硬触发点(必须跑一次 `consistency_audit.py` 产出 findings,不是口头说"我对齐了")**:命中任一,在该节点完成**前**强制回扫:

| 硬触发点 | 为什么 | 回扫范围 |
|---|---|---|
| **投稿 / 答辩 / 软著提交前** | 审稿人/评委最恨"论文表 87.6、PPT 写 81.0";数值/术语对不上=硬伤 | passport 各阶段 `artifacts:` 路径并集 |
| **受控定义变更后(变更广播)** | `.light/` 术语/指标/创新点一改,所有下游材料即过期 | **全部已产出材料**(定义改→回扫,不漏一份) |
| **distill / polish 改写后** | 润色最易把受控术语换近义词(F1→准确率、fine-tune→微调) | 改动的材料 + 与之同源的材料 |
| **多版本图表 / 跨材料复用数值** | 同一(方法×数据集)指标值在论文/PPT/软著须同一 | 涉及该指标的所有材料 |

> **if** 用户说"统一一下术语 / 这几份对一下 / 投稿前检查一致性" **then** 先确认 `.light/` 事实源在不在(无则先建,见下),
> 再 `consistency_audit.py` 回扫,产 findings,按"现状→问题→建议"逐条摆,**不替用户改写**。

---

## 你怎么工作:ACT / ASK / NEVER

每个动作**先归类**:这是该**自己做(ACT)**、该**停下问用户(ASK)**、还是**绝不(NEVER)**?

### ACT, 跑确定性一致性门,自己做(不烦用户)

The rest: https://github.com/Light0305/Light-skills/blob/HEAD/skills/light-consistency/SKILL.md