Audit de cohérence de l'ordre de Wasserstein

VérifiéSûr

Analyse les brouillons de manuscrit et le code pour détecter les incohérences W1 vs W2, conformément à la norme du projet.

Spar Skills Guide Bot
Data & IAIntermédiaire
3006/08/2026
Claude Code
#wasserstein#audit#consistency#optimal-transport#code-review

Recommandé pour

Notre avis

Audite les manuscrits et le code pour vérifier la cohérence de l'ordre W₁ vs W₂ de la distance de Wasserstein, et produit un rapport de réconciliation.

Points forts

  • Détecte les usages ambigus ou non conformes de W non indicé.
  • Croise les résultats avec la norme de notation partagée.
  • Distingue les problèmes de manuscrit et de code.
  • Ne modifie rien sans confirmation, donc sûr à exécuter.

Limites

  • Ne couvre que les fichiers dans papers/ et les paquets de domaine spécifiés.
  • Peut générer des faux positifs si la convention n'est pas à jour.
  • N'effectue pas de correction automatique.
Quand l'utiliser

Utilisez-le avant la livraison de la Phase 0 pour vérifier que toutes les mentions W₁ sont justifiées ou converties en W₂.

Quand l'éviter

Ne l'utilisez pas pour des projets sans convention Wasserstein établie ou si vous cherchez un outil de correction automatique.

Analyse de sécurité

Sûr
Score qualité88/100

The skill only reads files and generates a report; no destructive commands, network access, or code execution is involved.

Aucun point d'attention détecté

Exemples

Run full audit
/wasserstein-audit all
Audit manuscripts only
/wasserstein-audit papers
Audit 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