Notre avis
Crée des fichiers de spécification Markdown dans un dossier specs/ pour documenter le travail récent effectué lors d'une session.
Points forts
- Automatise la documentation post-développement
- Structure claire avec sections standardisées
- Support pour des types variés (features, architecture, immersif)
- Mise à jour automatique des README associés
Limites
- Nécessite une conversation précédente significative pour fonctionner
- Ne couvre pas la documentation de code déjà existant en dehors de la session
À la fin d'une session de développement pour capturer les décisions et les détails d'implémentation.
Si aucun travail significatif n'a été effectué ou si la documentation doit être maintenue dans un outil externe.
Analyse de sécurité
SûrThe skill only provides instructions for the AI to generate documentation files; it does not execute commands, manipulate sensitive data, or interact with external systems.
Aucun point d'attention détecté
Exemples
/spec/spec user-authentication/spec immersivename: spec description: Document recently completed work by creating spec .md files in specs/ directory
/spec - Document Recently Completed Work
Create specification documentation for recently completed work in this session.
Instructions
When the user invokes /spec, you should:
-
Review the conversation to identify what was recently built, fixed, or modified
-
Determine the appropriate spec type based on the work:
- Immersive experience → Create in
specs/immersive/ - New feature/flow → Create in
specs/features/ - Architecture change → Update
specs/architecture.md - General spec → Create in
specs/
- Immersive experience → Create in
-
Create the spec file with this structure:
# [Feature Name] **File(s):** `path/to/file.swift` **Type:** [View | Manager | Component | Flow] **Purpose:** One-line description --- ## Overview Brief description of what this does and why it exists. ## Implementation Key code patterns, setup, and usage. ## Integration Points How this connects to other parts of the codebase. ## Usage Example Code snippets showing how to use this feature. -
For immersive/RealityView specs, include:
- RealityView structure (content, update, attachments)
- 3D entities created/modified
- ARKit integration (hand tracking, image tracking)
- Collision detection setup
- Attachment positions and sizes
-
Update the relevant README.md if adding to a subdirectory
Arguments
/spec [name]- Create spec with specific name/spec immersive- Force creation in specs/immersive//spec update- Update existing spec files based on recent changes
Generateur de Documentation API
Documentation
Genere automatiquement de la documentation API OpenAPI/Swagger.
Rédacteur Technique
Documentation
Rédige de la documentation technique claire selon les meilleurs style guides.
Maintenance de la documentation
Documentation
Cette compétence propose un workflow structuré pour mettre à jour la documentation du projet, notamment CLAUDE.md, README et CHANGELOG. Elle guide à travers des phases comme l'inventaire des documents existants, l'analyse de l'historique Git pour identifier les changements nécessaires, l'optimisation pour la lisibilité par l'IA et la cohérence entre les documents. À utiliser lors de la synchronisation de la documentation avec les modifications de code ou pour améliorer l'efficacité de la documentation pour les agents de codage IA.