AgentSkillsCN

encyclopedia-builder

构建并维护 Copilot Power User 百科全书指南。适用于用户希望创建全新指南、更新文档，或生成百科全书中的某一章节时使用。可通过“创建指南”、“撰写文档”、“添加章节”、“更新指南”、“百科全书”、“Copilot 文档”等短语触发。

SKILL.md
--- frontmatter
name: "encyclopedia-builder"
description: >
  Construire et maintenir les guides de l'encyclopédie Copilot Power User.
  Utiliser quand l'utilisateur demande de créer un nouveau guide, de mettre à jour
  la documentation, ou de générer une section de l'encyclopédie. Déclenché par :
  "créer un guide", "documenter", "ajouter une section", "mettre à jour le guide",
  "encyclopédie", "documentation Copilot".

Encyclopedia Builder — Skill de construction de guides

Cette skill fournit les templates, conventions et processus pour créer des guides cohérents dans l'encyclopédie Copilot Power User.

Convention de structure d'un guide

Chaque guide dans docs/ doit suivre cette structure :

markdown
# [Numéro] — Titre du guide

> **Résumé** : [1-2 phrases]
> **Prérequis** : [liens vers les guides précédents si applicable]
> **Fichiers de référence** : [liens vers les configs du workspace]

---

## Table des matières
[TOC auto-générée]

---

## Concepts clés
[Explication des concepts fondamentaux]

## Configuration
[Comment configurer, avec exemples copy-paste-ready]

## Exemples opérationnels
[Exemples tirés du workspace lui-même]

## Pièges courants
[Erreurs fréquentes et comment les éviter]

## Références
[Liens vers la doc officielle et les autres guides]

Conventions

  • •Langue : Français pour le narratif, Anglais pour le code et les configs
  • •Liens : relatifs, vers les fichiers du workspace
  • •Exemples : utiliser les fichiers du workspace comme exemples vivants
  • •Longueur : max 500 lignes par guide
  • •Emojis : interdits (sauf README.md)

Templates disponibles

Les templates de base sont dans le dossier templates/ de cette skill :

Processus de création d'un guide

  1. •Choisir le template approprié
  2. •Remplir les sections avec le contenu spécifique
  3. •Ajouter des exemples tirés du workspace (liens relatifs)
  4. •Vérifier les liens croisés avec les autres guides
  5. •Valider la syntaxe Markdown
  6. •Mettre à jour la TOC du guide overview (docs/00-overview.md)