Rapports de travail SDD

VérifiéSûr

Rédige issues, messages de commit, descriptions de PR et rapports d'implémentation, de revue et de release pour un projet SDD, en séparant strictement le prévu, le réalisé et le vérifié.

Spar Skills Guide Bot
DocumentationIntermédiaire
01/11/2026
Claude Code
#reporting#git-workflow#pull-requests#release-notes#sdd

Recommandé pour

Synthèse automatique

Rédige des rapports SDD et des artefacts Git/hébergés fondés sur des preuves, comme les tickets de tâche, les messages de commit, les descriptions de pull request et les notes de version.

Points forts

  • Distingue clairement les éléments planifiés, réalisés, vérifiés et bloqués, et interdit de présenter une intention comme un résultat acquis.
  • Route chaque type de livrable vers une référence dédiée : brouillons Git, rapports d’achèvement, versions, contrôle qualité documentaire et campagnes de revue.
  • Exige des preuves et des références de tickets réellement résolues, et demande d’indiquer les faits manquants avant publication.
  • Impose une mise en forme Markdown cohérente et des règles précises pour les sujets de commit liés à une tâche.

Limites

  • Se limite à la rédaction : le skill ne crée ni commit, ni PR, ni ticket, et ne met pas à jour le statut des tâches.
  • S’appuie sur l’organisation SDD et sur des références internes (sdd-manage, sdd-forge), ce qui le rend moins autonome hors de ce cadre.
  • Ne valide pas automatiquement les preuves ; une vérification manuelle reste nécessaire.
Quand l'utiliser

À utiliser lorsqu’il faut rédiger un ticket de tâche SDD, un commit, une description de PR, un rapport d’avancement ou de version, ou des artefacts de campagne de revue à partir de preuves réelles.

Quand l'éviter

À ne pas utiliser pour effectuer des opérations Git ou hébergées, modifier le statut d’une tâche, ou produire une documentation générale sans lien avec les preuves et le cadre SDD.

Analyse de sécurité

Sûr
Score qualité80/100

The skill contains only prose guidance for drafting reports, commit messages, PR descriptions, and release notes. It declares no tools and performs no execution, network access, secret handling, or filesystem mutation. Its references to sibling reference files and bundled dependencies are ordinary documentation routing, not commands, and the text contains no attempt to override or influence this assessment.

Aucun point d'attention détecté

Comment cette analyse est faite

Exemples

Draft a task issue
Draft a task issue for [task-id] that adds OAuth login to the admin console. Base it on the TASKS entry, SPEC, and current changes; separate the acceptance plan from verified results.
Prepare a pull request description
Prepare a pull request description for the feature branch implementing [feature]. Summarize What, Why, Verification, and Result using the actual test output and Git diff, and flag any missing evidence.
Write release notes
Draft curated Git release highlights and release notes for version 1.4.0 from the merged tasks and verification evidence, without claiming unverified results.

name: sdd-report description: Use when drafting a task issue, Git commit message, pull request description, or evidence-backed task, milestone, phase or final implementation report, review/revision campaign plan or report, package preparation result, curated Git release highlights, release notes or release outcome for an SDD project. Adapt the summary to feature, bug, code health, performance, security, testing, documentation, integration, or compatibility work without inventing results.

Report SDD work

For Markdown output or document work within this skill's scope, apply the shared Markdown style: blank lines after headings and around top-level lists and code blocks, plus four-space structural indentation, including nested lists, with exactly one space after each list marker. This applies to direct calls as well as coordinated work; it does not expand editing or review authority.

Choose the requested output and load only its reference:

| Output | Load | | --- | --- | | First SDD commit disclosure/usage evidence (drafting only) | sdd-manage: skills/sdd-manage/references/repository-bootstrap.md (bundled dependency) | | Planned task issue title and body, task/amendment or merge commit message, or pull request draft | drafts for hosted and Git objects | | Task, milestone, phase, final implementation, branch boundary, or interrupted-work status report | completion reports | | Package/workflow preparation, Git release highlights, release notes or release outcomes | package and release reporting | | Adjacent SPEC/PLAN/TASKS preparation QC reports and appended correction/recheck sections | document QC reports | | Review plan/report or revision plan/report, including focused prompt-driven review | campaign artifacts | | Kind-specific emphasis and reusable What, Why, Verification, Result patterns | change kinds |

Use the owning TASKS or active FEATURE-TASKS entry, applicable design, SPEC, PLAN, and layout, actual changes, verification output, and Git evidence appropriate to the requested output. Obtain hosted issue references from sdd-forge when available; a guessed issue number is never acceptable. Separate planned, performed, verified, and blocked statements. State missing or limited evidence plainly; do not turn an example, unchecked task, or intended benchmark into a completed result. Follow project-specific title and reporting conventions where they exist.

Compose only the requested text or structured draft. Keep a concise shared core of What, Why, Verification, and Result, varying the labels and optional sections to suit the actual change. For a planned issue, Verification is an acceptance or check plan and Result is an intended outcome, not a completed claim. Emoji labels are optional presentation, not required metadata.

Task-associated subjects must begin with exactly one owning [<task-id>] marker and an imperative description; use the task subject rules and return composition conflicts to the commit owner. Do not invent IDs for non-task campaign, preparation or merge work.

This skill drafts reports and messages. The active implementation or steering workflow owns its work commits and task status; sdd-manage coordinates other persistence and explicit boundary merges, sdd-forge owns hosted issue/milestone mutations, and any future PR workflow owns PR creation or merge. A draft does not grant authorization for those actions or establish task completion. Return the draft, source task IDs and issue references actually resolved, evidence used, and any facts still needed before publication.

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/sdd-work-reporting-mvda896p/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/sdd-work-reporting-mvda896p' && curl --fail --show-error --location 'https://skills-guides.com/api/skills/sdd-work-reporting-mvda896p/download' --output '.skill-downloads/sdd-work-reporting-mvda896p/SKILL.md.part' && mv '.skill-downloads/sdd-work-reporting-mvda896p/SKILL.md.part' '.skill-downloads/sdd-work-reporting-mvda896p/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.

Aucune section de prérequis reconnue dans ce fichier. Cela ne signifie pas qu’il est autonome : les bibliothèques, outils et accès peuvent être cités ailleurs dans le contenu ou dans le dépôt source.

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/sdd-work-reporting-mvda896p/SKILL.md' && test -s '.skill-downloads/sdd-work-reporting-mvda896p/SKILL.md' && mkdir -p '.claude/skills' && test ! -e '.claude/skills/sdd-report' && cp -R '.skill-downloads/sdd-work-reporting-mvda896p' '.claude/skills/sdd-report'

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/sdd-work-reporting-mvda896p'

openskills read 'sdd-work-reporting-mvda896p'

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/sdd-work-reporting-mvda896p/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