Vérifier la synchronisation du statut

VérifiéPrudence

Vérifie la progression du projet, synchronise Plans.md avec la réalité et suggère la prochaine action. Détecte les divergences entre les marqueurs de tâche et l'implémentation réelle.

Spar Skills Guide Bot
ProductiviteIntermédiaire
09/03/2026
Claude Code
#progress-tracking#plans-md#git-status#agent-trace#workflow

Recommandé pour

Synthèse automatique

Vérifie l'avancement de l'implémentation, détecte les écarts avec Plans.md, met à jour les marqueurs de tâches et suggère la prochaine action prioritaire.

Points forts

  • Compare l'état réel du dépôt (git status, commits, Agent Trace) aux marqueurs cc:TODO/cc:WIP/cc:done de Plans.md
  • Met à jour Plans.md avec confirmation avant modification et explique la raison de chaque changement
  • Détecte les anomalies comme plusieurs tâches en cours ou des demandes PM non traitées
  • Fournit un résumé de progression chiffré et une recommandation de prochaine étape

Limites

  • Dépend fortement de l'existence et du format de Plans.md ainsi que du fichier .claude/state/agent-trace.jsonl
  • Suppose des conventions de marqueurs (cc:TODO, cc:WIP, cc:done, pm:requested) propres à un workflow particulier
  • N'est pas destiné aux questions informelles sur l'avancement selon sa description
Quand l'utiliser

Utilisez-le lorsqu'il faut faire le point sur l'avancement réel d'un projet et aligner Plans.md sur l'état effectif du code avant de choisir la prochaine tâche.

Quand l'éviter

Ne le chargez pas pour une simple question conversationnelle du type « comment ça va ? » sans intention de synchroniser ou d'évaluer le plan.

Analyse de sécurité

Prudence
Score qualité74/100

The skill uses Bash, Write, and Edit, but all shell commands shown are local, read-only inspections (cat, git status/diff/log, jq on a trace log) with no network calls, no secret handling, and no destructive operations. File modification is limited to Plans.md and gated behind an explicit yes/no confirmation. Powerful tools used for a legitimate workflow, hence caution rather than safe or risky.

Points d'attention
  • •Invokes Bash for local git/file inspection and jq pipelines (read-only, but shell access)
  • •Writes/edits Plans.md markers automatically after a confirmation prompt
  • •Reads agent trace state file (.claude/state/agent-trace.jsonl) which may contain local project metadata
Comment cette analyse est faite

Exemples

Progress check
/sync-status
Verbose sync
/sync-status --verbose
Natural request
Check where I'm at and sync Plans.md with what's actually been done, then tell me what to do next.

name: sync-status description: "Checks progress, updates Plans.md to match reality, and suggests next action. Use when user mentions '/sync-status', progress check, where am I at, or sync Plans.md. Do NOT load for: casual 'how is it going' chat, informal progress questions." allowed-tools: ["Read", "Write", "Edit", "Bash", "Grep", "Glob"] argument-hint: "[--verbose]"

Sync Status Skill

Checks current implementation status, detects differences with Plans.md, and suggests next action.

Quick Reference

  • "How far have we progressed?" → this skill
  • "What should I do next?" → organize and suggest
  • "Check if Plans.md matches actual progress" → detect and update

Deliverables

  1. Progress check: Consistency between implementation and Plans.md
  2. Difference update: Update Plans.md markers to match reality
  3. Next action suggestion: What to do next with priority

Execution Flow

Step 1: Gather Current Status (Parallel)

# Plans.md state
cat Plans.md

# Git change status
git status
git diff --stat HEAD~3

# Recent commit history
git log --oneline -10

# Agent Trace (直近の編集ファイル)
tail -20 .claude/state/agent-trace.jsonl 2>/dev/null | jq -r '.files[].path' | sort -u

Step 1.5: Agent Trace Analysis

Agent Trace から直近の編集履歴を取得し、Plans.md のタスクと照合:

# 直近の編集ファイル一覧
RECENT_FILES=$(tail -20 .claude/state/agent-trace.jsonl 2>/dev/null | jq -r '.files[].path' | sort -u)

# プロジェクト情報
PROJECT=$(tail -1 .claude/state/agent-trace.jsonl 2>/dev/null | jq -r '.metadata.project')
PROJECT_TYPE=$(tail -1 .claude/state/agent-trace.jsonl 2>/dev/null | jq -r '.metadata.projectType')

照合ポイント: | チェック項目 | 検出方法 | |------------|---------| | Plans.md にないファイル編集 | Agent Trace vs タスク記述 | | タスク記述と異なるファイル | 想定ファイル vs 実際の編集 | | 長時間編集がないタスク | Agent Trace 時系列 vs WIP期間 |

Step 2: Detect Differences

| Check Item | Detection Method | |------------|------------------| | Done but still cc:WIP | Commit history vs marker | | Started but still cc:TODO | Changed files vs marker | | cc:done but not committed | git status vs marker |

Step 3: Update Plans.md

If differences detected, suggest and execute:

📝 Plans.md update needed

| Task | Current | After | Reason |
|------|---------|-------|--------|
| XX | cc:WIP | cc:done | Committed |

Update? (yes / no)

Step 4: Output Progress Summary

## 📊 Progress Summary

**Project**: {{project_name}} ({{project_type}})

| Status | Count |
|--------|-------|
| 🔴 Not started (cc:TODO) | {{count}} |
| 🟡 In progress (cc:WIP) | {{count}} |
| 🟢 Done (cc:done) | {{count}} |

**Progress rate**: {{percent}}%

### 📄 直近の編集ファイル (Agent Trace)
- {{file1}}
- {{file2}}
- ...

Step 5: Suggest Next Action

🎯 What to do next

**Priority 1**: {{task}}
- Reason: {{requested / unblock}}

**Recommended**: /work, /harness-review

Anomaly Detection

| Situation | Warning | |-----------|---------| | Multiple cc:WIP | ⚠️ Multiple tasks in progress | | pm:requested not processed | ⚠️ Process PM's request first | | Large gap | ⚠️ Task management not keeping up |

Du fichier au premier essai

Le téléchargement contient exactement le contenu affiché sur cette fiche. Cette copie peut différer de la dernière version du dépôt source.

Consulter la source et ses fichiers annexes

Ce téléchargement contient uniquement SKILL.md. Les scripts, références, modèles et dépendances éventuels ne sont pas inclus. Récupérez les fichiers nécessaires depuis la source en conservant leur arborescence avant de poursuivre.

1. Télécharger le fichier

Télécharger SKILL.md

Depuis la racine d’un projet de test, enregistrez le fichier sous .skill-downloads/sync-status-check-mmio717z/SKILL.md, ou utilisez la commande suivante. Ce dossier sert à examiner la skill avant son installation.

Commande pour macOS/Linux ou WSL : un shell POSIX et curl sont nécessaires. Sous Windows sans WSL, utilisez le bouton de téléchargement et créez le dossier manuellement.

mkdir -p '.skill-downloads/sync-status-check-mmio717z' && curl --fail --show-error --location 'https://skills-guides.com/api/skills/sync-status-check-mmio717z/download' --output '.skill-downloads/sync-status-check-mmio717z/SKILL.md.part' && mv '.skill-downloads/sync-status-check-mmio717z/SKILL.md.part' '.skill-downloads/sync-status-check-mmio717z/SKILL.md'

2. Vérifier les prérequis

Lisez SKILL.md avant de l’utiliser. Si le fichier cite des scripts ou services externes, examinez-les et préparez les accès nécessaires dans votre environnement de test.

Extrait original : Quick Reference
  • "How far have we progressed?" → this skill
  • "What should I do next?" → organize and suggest
  • "Check if Plans.md matches actual progress" → detect and update

Les plateformes de la fiche sont des indications du catalogue. Les chemins ci-dessous suivent la documentation des outils ; ils ne prouvent pas que cette skill y a été exécutée. Aucune version minimale de ces outils n’est attestée pour cette fiche.

3. Charger la skill

Après vérification, copiez le dossier complet dans le projet avec l’une des commandes ci-dessous, puis ouvrez une nouvelle session de l’outil. La commande s’arrête si un dossier du même nom existe déjà : comparez les fichiers avant de le remplacer.

Claude Code
test -f '.skill-downloads/sync-status-check-mmio717z/SKILL.md' && test -s '.skill-downloads/sync-status-check-mmio717z/SKILL.md' && mkdir -p '.claude/skills' && test ! -e '.claude/skills/sync-status' && cp -R '.skill-downloads/sync-status-check-mmio717z' '.claude/skills/sync-status'

OpenSkills

OpenSkills doit déjà être installé. La procédure locale install/read est contrôlée avec OpenSkills 1.5.0, qui exige Node.js ≥ 20.6.0. Aucun slug du catalogue n’est résolu automatiquement.

Installation officielle d’OpenSkills
openskills install './.skill-downloads/sync-status-check-mmio717z'

openskills read 'sync-status-check-mmio717z'

La lecture doit afficher le contenu du fichier installé et son dossier de base. Elle ne lance ni la skill ni ses dépendances.

Pour un agent qui lit AGENTS.md, synchronisez ensuite l’index. Cette commande modifie AGENTS.md : relisez le diff avant de l’utiliser.

openskills sync

Mode manuel ou autre outil : joignez SKILL.md à une conversation, ou ouvrez-le dans un agent capable de lire les fichiers. Ajoutez les ressources annexes nécessaires. Il n’existe pas de dossier universel reconnu par tous les outils.

4. Faire un premier essai

Utilisez une entrée courte et fictive : un endpoint d’API, un petit document ou un brief d’interface. Dans une nouvelle conversation, joignez le fichier ou donnez son chemin à l’agent, puis adaptez cette demande :

Lis .skill-downloads/sync-status-check-mmio717z/SKILL.md et applique ses instructions à cet exemple : [décrire une entrée de test]. Indique les fichiers, dépendances ou accès qui manquent. Produis le résultat demandé par la skill sans inventer de données ni exécuter de script non examiné.

Résultat attendu : une sortie correspondant aux instructions de la skill, ou une liste précise des prérequis manquants. Une simple confirmation de lecture ne valide pas le premier usage. Si une ressource externe est indisponible, ce parcours reste à tester.

Skills similaires