SuperAPI AI Directory

consistency-checker

Writing & research

View repository

Updated 10-16 10:16

About this skill

Story Consistency Monitoring

Automatic Check System

This skill runs automatically in the background and does not require the user to actively invoke it.

Monitoring Scope

Character Consistency

  • Physical Traits: eye color, height, age, scars, etc.
  • Personality Traits: behavior matches the established character personality
  • Knowledge State: characters only know information they should know
  • Character Arc: changes are consistent with the logic of character development

World Rules

  • Power System: magic/technology/martial arts and other powers are used consistently
  • Geographical Setting: distances and locations remain stable
  • Social Rules: culture and customs do not contradict each other
  • Physical Laws: established rules do not change randomly

Timeline Logic

  • Event Order: A logically occurs before B
  • Passage of Time: characters age/grow appropriately
  • Simultaneous Events: multi-perspective timelines align
  • Historical Consistency: references to the past remain consistent

How It Works

Passive Monitoring: when you write or discuss the story, I automatically cross-reference:

  1. spec/knowledge/characters/ character profiles in the directory
  2. spec/knowledge/worldbuilding/ worldbuilding documents in the directory
  3. spec/tracking/timeline.json timeline data in
  4. Content of previous chapters

No extra action needed - monitoring happens automatically in the background.

When an Issue Is Detected

Alert Format

When a potential inconsistency is detected, you will be alerted like this:

⚠️ Consistency Check Alert

问题类型:角色特征不匹配
位置:当前章节,第3段
参考:characters/mary-chen.md,第15行

当前文本:"玛丽的绿色眼睛眯起..."
已建立特征:"眼睛颜色:蓝色"(在第3章中设定)

可能的解决方案:
1. 将当前文本改为"蓝色眼睛"
2. 如果要修改设定,同时更新角色档案
3. 这是一个同名的不同角色?

你想让我自动修复这个,还是你自己处理?

Severity Levels

Level Icon Response Example
Critical 🔴 Stop immediately and fix A character suddenly knows a secret they should not know
Warning ⚠️ Fix as soon as possible The character's speech pattern has changed
Note 📝 Consider checking The timeline feels slightly compressed

Integration with Commands

During /write Period

  • Real-time consistency check
  • Instant alerts for serious issues
  • Automatically reference specification documents

During /analyze Period

  • Comprehensive consistency report
  • All accumulated warnings and notes
  • Fix suggestions sorted by severity

Configure Strictness

Strict Mode (default for non-fantasy works)

  • Flag all contradictions
  • Enforce real-world physical rules
  • The timeline must be completely plausible

Flexible Mode (recommended for fantasy/science fiction)

  • Allow "rule of cool" exceptions
  • Magic/technology can bend reality
  • Allow artistic license, but will notify

Minimal Mode

  • Flag only serious contradictions
  • Focus on character and major plot points
  • Let small inconsistencies pass

Common false positive handling

Sometimes content that is actually correct gets flagged:

Intentional contradictions

Example: A character lies about their eye color

Fix: Add a note in the character profile:

// 眼睛实际上是蓝色的,但告诉别人是绿色的

Unreliable narrator

Example: A first-person narrator misremembers an event

Fix: Note in the constitution:

不可靠叙述者 - 记忆不一致是有意的

Time jump

Example: A character's age suddenly increases

Fix: State it clearly in the chapter:

"三年后..."

Best practices

Keep reference documents up to date

Consistency checks are only as good as your documents:

  • Update character profiles when traits change
  • Document world rules clearly
  • Maintain a timeline file

Handle alerts promptly

Don't let consistency issues accumulate:

  • Fix serious alerts immediately
  • Review warnings at the end of a writing session
  • Batch cautions during the revision phase

Check category details

Character consistency checks

Physical description:

✓ 检查:身高、体重、年龄、发色、眼色
✓ 检查:疤痕、纹身、独特标记
✓ 检查:服装风格、配饰

Behavior patterns:

✓ 检查:言语模式是否一致
✓ 检查:反应是否符合性格
✓ 检查:决策是否符合价值观
✓ 检查:技能/能力是否一致

Knowledge state:

✓ 检查:角色知道什么时候知道的
✓ 检查:他们不知道不应该知道的秘密
✓ 检查:记忆与已建立事实一致

World rule checks

Ability system:

✓ 检查:力量在已建立限制内使用
✓ 检查:代价/成本一致应用
✓ 检查:规则不为情节便利而改变
✓ 检查:例外有前期铺垫

Geography and distance:

✓ 检查:地点保持一致
✓ 检查:旅行时间合理
✓ 检查:气候与地理匹配
✓ 检查:地标不移动

Timeline checks

Event sequence:

✓ 检查:原因发生在结果之前
✓ 检查:角色不在不可能的地方
✓ 检查:事件在合理时间内发生

Time passage:

✓ 检查:角色适当地老化
✓ 检查:季节按顺序改变
✓ 检查:怀孕/康复需要适当时间
✓ 检查:技能习得需要练习时间

Auto-fix features

For some simple issues, I can provide auto-fixes:

Auto-fix types

Spelling variations:

检测:角色名字拼写不一致
建议:标准化为最常见的拼写
行动:全局查找并替换(经你批准)

Number inconsistencies:

检测:角色年龄在章节间不匹配
建议:基于时间线计算正确年龄
行动:更新到正确数字

Timeline conflicts:

检测:事件日期与已建立时间线冲突
建议:调整日期以适应已知序列
行动:更新时间线参考

Reporting and tracking

Consistency report example

## 一致性报告 - 2024-01-15

### 章节范围:第1-15章

### 检测到的问题

#### 严重(必须修复)
1. 第12章:角色知道只在第14章揭示的信息
   - 修复:重写第12章场景或移动第14章揭示更早

#### 警告(应该修复)
1. 第8章:角色的眼睛颜色从蓝色变为绿色
   - 修复建议:将第8章更新为蓝色或更新角色档案
   
2. 第10章:从首都到边境的旅行只用了1天(之前建立为3天)
   - 修复建议:添加时间跳跃或调整天数

#### 注意事项(考虑检查)
1. 第5章:角色反应似乎不符合特征
   - 审查:这是有意的成长还是不一致?

### 统计
- 总检查:456
- 问题发现:8
- 自动修复:3
- 需要审查:5

### 一致性得分:94%

Remember: Consistency isn't about perfection - it's about reader trust. When world rules are reliable, readers become immersed. When rules seem to change arbitrarily, they get pulled out of the experience. I'm here to help maintain that trust.

You always have the final say - if an inconsistency is an artistic choice, tell me, and I'll stop flagging it.