Audit de cohérence de l'ordre de Wasserstein

VérifiéSûr

Analyse les manuscrits et le code pour détecter les incohérences W1 vs W2, garantissant la conformité aux normes de notation.

Spar Skills Guide Bot
DeveloppementIntermédiaire
1002/08/2026
Claude Code
#wasserstein#audit#notation#consistency#code-review

Recommandé pour

Notre avis

Audite un codebase et des brouillons de manuscrits pour détecter les incohérences d'ordre de la métrique de Wasserstein (W₁ vs W₂) et génère un rapport de réconciliation.

Points forts

  • Analyse à la fois les fichiers Markdown des manuscrits et le code Python pour repérer les problèmes de notation W₁/W₂.
  • Recoupe les résultats avec la norme de notation canonique du projet.
  • Produit un rapport structuré avec des corrections suggérées, sans modifier les fichiers.

Limites

  • Se concentre uniquement sur la cohérence de l'ordre de Wasserstein, sans détecter d'autres problèmes de notation ou de métrique.
  • Nécessite un fichier papers/shared/notation.md valide comme référence.
  • N'applique pas automatiquement les corrections ; une confirmation manuelle est requise après le rapport.
Quand l'utiliser

À utiliser lors de la préparation d'une publication ou d'une livraison qui doit respecter une convention de projet imposant W₂ comme métrique de Wasserstein principale.

Quand l'éviter

Ne pas utiliser si le projet utilise volontairement W₁ ou ne dispose pas d'une norme de notation canonique à auditer.

Analyse de sécurité

Sûr
Score qualité90/100

The skill only reads project files and produces a markdown report; no destructive actions, no network access, no arbitrary command execution.

Aucun point d'attention détecté

Exemples

Full audit
/wasserstein-audit all
Manuscript only
/wasserstein-audit papers
Code only
/wasserstein-audit code

/wasserstein-audit — Audit Wasserstein Order Consistency

Scan all manuscript drafts and codebase for W₁ vs W₂ inconsistencies. Resolves the blocking Phase 0 deliverable: the legacy P01 manuscript uses W₁ in several places while project convention mandates W₂ as the primary metric.

Usage

/wasserstein-audit
/wasserstein-audit [papers|code|all]

Example: /wasserstein-audit all


What this does

  1. Reads papers/shared/notation.md (canonical notation standard, Wasserstein Audit section)
  2. Scans manuscript .md files under papers/ for W₁, unsubscripted W, ambiguous W_p
  3. Scans Python files under all domain packages for Wasserstein calls without explicit p=2
  4. Cross-references findings against what notation.md already has "verified"
  5. Produces a structured reconciliation report — does not fix anything without confirmation

Manuscript patterns that trigger a flag

| Pattern | Issue | |---|---| | W_1 / $W_1$ / W_{1} | W₁ usage — needs justification or must change to W₂ | | $W$ (unsubscripted) | Always flag — violates notation standard | | bottleneck without alongside Wasserstein | Sole metric violation | | wasserstein without explicit order nearby | Ambiguous |

Code patterns that trigger a flag

| Pattern | Issue | |---|---| | wasserstein_distance(a, b) with no p= arg | Default may not be W₂ in all library versions | | p=1 or order=1 near Wasserstein call | Explicit W₁ usage | | bottleneck_distance(...) | Must not be used as sole metric | | gudhi.wasserstein.wasserstein_distance without order=2 | gudhi default not guaranteed |


Report format

## Wasserstein Audit Report — YYYY-MM-DD

### Manuscript Findings
| File | Line | Found | Issue | Suggested Fix |

### Code Findings
| File | Line | Found | Issue | Suggested Fix |

### Status
- Blocking Phase 0: YES / NO
- Total issues: N (manuscript: N₁, code: N₂)

### Recommended Actions

Library defaults (reference)

  • persim.wasserstein_distance — p=2 by default ✓
  • gudhi.wasserstein.wasserstein_distance — requires explicit order= arg
  • giotto-tda Wasserstein vectorisation — p=2 by default ✓
  • W₁ in theory proofs is acceptable in Methods sections if clearly labelled and distinguished from the computational metric used
Skills similaires