TWIE — Technical Writing Integrity & Quality Engine

English | 简体中文

Better writing. Zero fact drift. 面向高完整性、高质量的技术 / 专利 / 法规 / 科学写作的反 AI 腔引擎。

检测并修复 AI 腔、过度总结、过度肯定、虚假权威、证据不足的结论、重复表达、模板化论证（首先/其次/最后、机械三段论）、不必要的免责声明、中文翻译腔，并对专利/法规文本强制事实零漂移。

设计文档见 DESIGN.md（分层模型、评分、质量门、领域配置的完整论证；英文版 DESIGN.en.md）。

当前版本 v2.0.0 · V2 路线图: docs/ROADMAP_V2.md

TWIE 不做"这是不是 AI 写的"判定，也不是洗稿或检测绕过工具。它只负责一件事：证明这段 AI 辅助生成的文字写得好、讲得通、有依据，而且没有改变原来的事实。

V2.0 新增

• 四项核心修复：万/亿数值归一化不再误报漂移（FIX#1）；中英混排句证据检测（FIX#2）；重复短语跨标点精确定位（FIX#3）；数字计入评分分母，密度不再虚高（FIX#4）
• 证据对齐引擎：认知强度阶梯 L1-L5（或然/提示/结论/证明/确定性断言），断言强度超过证据强度即标记 EVIDENCE_MISMATCH
• 多维 Quality Profile：Slop Index 之外输出 Writing Quality / Structure / Epistemic Integrity / Evidence Alignment / Repetition Control 五维分数
• 结构化漂移编码：质量门输出 NUMBER_DRIFT / MODALITY_DRIFT / SCOPE_DRIFT / HEDGE_DRIFT / DEFINITION_DRIFT + 严重级（LOW→CRITICAL），可直接进 CI 告警
• twie diff：fact-diff 语义化命令（gate 别名）

v2.1.0 新增：twie graph 论证/事实图谱（ROADMAP §8/§10 确定性骨架）——断言/证据/事实/术语节点，supported_by / mentions_fact / mentions_term / defines_term 边，输出断言支撑率与孤立断言清单；--json / --dot（Graphviz）/ --mermaid（GitHub 原生渲染）三种导出。边为结构/位置关系，语义关系抽取见路线图 Phase 2。

快速上手

# 1. 扫描评分 (领域: general/technical/medical/patent/legal/investment)
python3 engine/twie.py scan 报告.md --domain technical

# 2. Tier-1 机械修复 (只删填充语/消动词名词化, 不碰事实; --write 写回)
python3 engine/twie.py fix 报告.md --domain technical

# 3. 质量门: 改写稿 vs 原文 事实对账 (CI 可用, 漂移时退出码 1)
python3 engine/twie.py gate 原文.md 改写稿.md --domain patent

纯 Python 标准库，无依赖。回归测试：python3 tests/test_engine.py。

接入 ZCode / Codex

把 skill/ 目录复制为个人技能即可在对话中触发（"去AI味"、"润色"、"查翻译腔"、交付前检查）：

# ZCode
mkdir -p ~/.zcode/skills/twie && cp skill/SKILL.md ~/.zcode/skills/twie/
# Codex (如使用 ~/.agents/skills)
mkdir -p ~/.agents/skills/twie && cp skill/SKILL.md ~/.agents/skills/twie/

Skill 负责指挥 LLM 做 B/C 层语义改写（含"补证据或降级，禁止编造引用"的裁决规则），脚本负责检测、打分和事实对账。英文工作流变体：用 skill/SKILL.en.md 替代 SKILL.md 安装即可。

核心概念：A/B/C/D 四层 = 四种处置授权

层	内容	谁来改
A 表层	填充语、翻译腔、免责声明、重复	引擎 Tier-1 机械修复
B 结构	模板开头、意义公式、过度总结、枚举链、三段论	LLM 重写（规则给方向）
C 认知	过度肯定、虚假权威、无证据结论	只能补证据或降级断言，禁止编造
D 完整性	数值模糊化、模态变动、范围变动	只标记，质量门对账兜底，人工裁决

领域配置（domains/）决定规则的生死：医学文本的谨慎对冲受保护、合规免责声明不标记、专利中"所述"是法定用语而任何数值模糊化直接 FAIL。

调参

• 误报 → 在检测器里加 exempt（同句正则豁免）或降 severity；
• 漏报 → 加 patterns 或升 severity；领域特殊要求 → domains/*.json 的 suppressed_detectors / escalate / integrity；
• 任何规则改动跑 python3 tests/test_engine.py 确认 28 项回归全过。

目录

DESIGN.md            设计文档（先读这个；英文版 DESIGN.en.md）
skill/SKILL.md       可安装的 ZCode/Codex Skill（英文版 SKILL.en.md）
detectors/zh|en/     四层检测规则 (JSON)
domains/             六个领域配置
engine/twie.py       引擎: scan / fix / gate / diff / graph
docs/ROADMAP_V2.md   V2 全量路线图 (Phase 1-7)
tests/               36 项回归 + 校准金样本(含专利漂移对照对)
LICENSE              MIT