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
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.
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é
PrudenceThe 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.
- •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
Exemples
/sync-status/sync-status --verboseCheck 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
- Progress check: Consistency between implementation and Plans.md
- Difference update: Update Plans.md markers to match reality
- 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 annexesCe 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.mdDepuis 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’OpenSkillsopenskills 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 syncMode 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.
Lecteur PDF
Productivite
Lit et extrait le texte de fichiers PDF (rapports, contrats, tableurs). Gère les fichiers locaux, les URL et les pièces jointes WhatsApp. Utilisez-le dès qu'un contenu PDF est nécessaire, même sans demande explicite.
Workflows de messagerie Discord
Productivite
Utilisez l'outil message pour envoyer, modifier et modérer des messages Discord avec des composants interactifs.
Aperçu interactif des verdicts
Productivite
Générer un aperçu HTML interactif des verdicts (garder/supprimer) pour la revue par le mainteneur, puis traiter le JSON de retour.