doc-coauthoring
Co-créer de la documentation avec l'IA
Également disponible depuis: 7Spade,7Spade,davila7,AstraBit-CPT,Azeem-2,anthropics
Créer une documentation de qualité est un défi. Cette compétence offre un flux de travail structuré en trois étapes qui aide les utilisateurs à gather context, affiner le contenu par itération et tester les documents avec une nouvelle instance d'IA pour assurer la clarté pour les lecteurs.
Télécharger le ZIP du skill
Importer dans Claude
Allez dans Paramètres → Capacités → Skills → Importer un skill
Activez et commencez à utiliser
Tester
Utilisation de "doc-coauthoring". I need to write a technical spec for our new API
Résultat attendu:
Je peux vous aider à créer une spécification technique en utilisant notre flux de travail structuré. Voici ce que nous allons faire :
**Étape 1 : Collecte de contexte** - Je vais vous poser des questions sur votre API, son approche technique et qui l'implémentera.
**Étape 2 : Affinage et structure** - Nous allons construire la spécitation section par section, en brainstormant des options de contenu et en affinant chaque partie.
**Étape 3 : Test par le lecteur** - Nous testerons la spécification avec une nouvelle instance Claude pour nous assurer qu'elle est claire pour les implémenteurs.
Voulez-vous proceed with this workflow, ou préférez-vous travailler en自由形式 ?
Utilisation de "doc-coauthoring". Help me create a decision document for adopting a new database
Résultat attendu:
Je vais vous guider pour créer un document de décision pour votre sélection de base de données. Commençons par la **Collecte de contexte** :
1. Quel type de document est-ce ? (Document de décision, RFC, etc.)
2. Qui est le public principal ?
3. Quel est l'impact souhaité lorsqu'une personne lit ce document ?
4. Y a-t-il un modèle ou un format spécifique à suivre ?
5. D'autres contraintes ou contextes à connaître ?
Veuillez partager ce que vous savez sur vos options de base de données, l'équipe qui les évalue et toute préoccupation spécifique à adresser.
Audit de sécurité
SûrAll 18 static findings are false positives. The skill is a documentation co-authoring workflow that guides users through structured document creation. Tool references like `create_file` and `str_replace` were misidentified as external shell commands. Documentation type keywords (spec, proposal, decision) were incorrectly flagged as cryptographic algorithms. The single network reference to claude.ai is legitimate for reader testing. No actual security risks identified.
Score de qualité
Ce que vous pouvez construire
Créer des spécifications techniques
Rédiger des spécifications techniques complètes avec une structure appropriée, en s'assurant que tous les détails nécessaires sont capturés et que le document est clair pour les équipes d'implémentation.
Rédiger des documents de décision
Développer des documents de décision qui présentent clairement le problème, la solution proposée, les alternatives envisagées et les résultats attendus pour les parties prenantes.
Développer des propositions d'équipe
Créer des propositions convaincantes qui répondent aux préoccupations des parties prenantes, présentent des arguments persuasifs et incluent le contexte nécessaire pour l'approbation.
Essayez ces prompts
I want to create a [document type]. Can you guide me through your documentation co-authoring workflow?
I have a document template at [URL/path]. Can you help me fill it in using your structured documentation workflow?
I have an existing document that needs improvement. Can we use your workflow to refine it and test it with a fresh AI instance?
I need to create a comprehensive [PRD/technical spec/decision doc] for [project name]. The audience is [description]. Can we go through your full three-stage documentation workflow?
Bonnes pratiques
- Fournissez un contexte complet pendant lÉtape 1 - plus vous partagez d'informations, meilleure sera l'orientation que vous recevez
- Utilisez la boucle de retour itératif - indiquez des changements spécifiques plutôt que des préférences vagues pour de meilleurs résultats
- Complétez le test par le lecteur - tester avec une nouvelle instance d'IA détecte les hypothèses et les lacunes invisibles à l'auteur
Éviter
- Sauter la collecte de contexte - passer directement à la rédaction sans partager le contexte conduit à un contenu générique et superficiel
- Fournir un retour minimal - dire 'ça a l'air bien' sans specifics empêche le flux de travail d'apprendre vos préférences
- Sauter le test par le lecteur - publier des documents sans test peut laisser des lacunes critiques qui confondent les lecteurs