AgentSkillsCN

exit-consistency-audit

运行并解释退出图一致性扫描（悬空退出、孤儿位置、缺失互惠退出）。适用于退出/导航看起来不对，或更改位置图数据时使用。

SKILL.md
--- frontmatter
name: exit-consistency-audit
description: Runs and interprets exit graph consistency scans (dangling exits, orphan locations, missing reciprocal exits). Use when exits/navigation look wrong or when changing location graph data.

Exit consistency audit

Use this skill when you are asked to:

  • •Debug traversal anomalies (players can’t return, one-way exits, broken navigation).
  • •Validate exit graph integrity after seeding or migration.
  • •Produce a JSON report of exit consistency.

What this skill uses

Primary scanner:

  • •Repo script: scripts/scan-exits-consistency.mjs

Convenience wrapper (recommended):

  • •scripts/run.mjs

Preconditions

The exit scan runs against Gremlin/Cosmos and relies on built artifacts:

  • •backend/dist/** (for Gremlin client + persistence config)
  • •shared/dist/** (for direction utilities)

If those outputs are missing, either:

  • •run npm run build:backend and npm run build:shared, or
  • •run the wrapper with --build.

Workflow

  1. •Ensure build artifacts exist (or use --build).
  2. •Run the scan.
  3. •Interpret results:
    • •Dangling exits: must be fixed (exit points to non-existent location)
    • •Missing reciprocal exits: must be fixed (A→B without B→A in the opposite direction)
    • •Orphan locations: warning only (may be intentional; verify design intent)
  4. •If needed, generate a JSON report via --output=<file>.

Examples

  • •Scan and print JSON to stdout.
  • •Scan and write report to a file.
  • •Scan with extra seed locations using --seed-locations=loc1,loc2.

Output contract

The scanner prints:

  • •JSON results on stdout
  • •A human-readable summary on stderr

Exit codes:

  • •0: pass (no dangling exits / missing reciprocals)
  • •1: fail (dangling exits or missing reciprocals present)

Last reviewed: 2026-01-15