mattpocock-skills-zh-cn

Ceci est la version localisée en chinois simplifié de mattpocock/skills, destinée aux agents de codage comme Claude Code et Codex. Elle propose un ensemble de compétences d'agent utilisées dans le travail d'ingénierie quotidien de l'auteur, mettant l'accent sur la petite taille, la modifiabilité et la composabilité, plutôt qu'un cadre méthodologique qui prendrait en charge l'ensemble du processus de développement. Motivation et stratégie de localisation : - Les instructions en chinois réduisent le coût de conversion conceptuelle pour les développeurs natifs chinois ; pour les modèles optimisés avec des interactions ou des corpus chinois, les prompts en chinois sont plus adaptés au contexte chinois, réduisant l'ambiguïté due au mélange chinois-anglais. - La traduction adopte une localisation guidée par le contenu des compétences : seules les descriptions en langage naturel sont traduites, tandis que les noms de répertoires, les noms de compétences, les clés de frontmatter, les commandes, les blocs de code, les chemins, les URL, les identifiants de paquets/outils/API, etc., sont conservés pour ne pas perturber l'installation et l'exécution. - Le dépôt se synchronise avec l'amont par rafraîchissement du contenu, sans synchroniser l'historique Git ou l'état de gestion du dépôt amont ; la dernière synchronisation de traduction a été effectuée par Claude (Anthropic) et fusionnée dans main via PR par le mainteneur, les règles de maintenance étant documentées dans .skills/translate-skill/SKILL.md. Méthodes d'installation (choisir une, ne pas répéter) : 1. Installateur skills.sh : exécutez npx skills@latest add vinvcn/mattpocock-skills-zh-CN, sélectionnez les compétences à installer et les agents de codage cibles. Cette méthode copie les compétences dans le projet, facilitant la modification et la personnalisation. 2. Plugin Claude Code : exécutez /plugin marketplace add vinvcn/mattpocock-skills-zh-CN et /plugin install mattpocock-skills@mattpocock, pour une installation en bundle géré en lecture seule, mise à jour unifiée avec les nouvelles versions, idéal pour ceux qui veulent simplement utiliser et suivre les mises à jour. 3. DeepSeek Harness (dsh) : installez comme plugin avec dsh plugin --profile web add @vinvcn/dsh-mattpocock-skills-zh, puis appelez avec /zh- suivi du nom de la compétence, par exemple /zh-grilling. Lors de la première installation, sélectionnez /setup-matt-pocock-skills et exécutez-le une fois dans l'agent pour configurer le suivi des issues (GitHub, Linear ou fichier local), les labels utilisés pour le triage et l'emplacement de sauvegarde des docs. Philosophie de conception : L'auteur a conçu des compétences correspondant aux modes de défaillance courants des agents de codage : - Désalignement des exigences : via des sessions de grillage (/grill-me, /grill-with-docs) pour que l'agent pose des questions détaillées avant d'agir, alignant ainsi les intentions. - Verbiage : via un document de langage partagé (CONTEXT.md) pour aider l'agent à décoder la terminologie du projet, rendant les noms plus cohérents, la navigation dans le code plus facile et la réflexion plus économe en tokens. - Code non fonctionnel : en mettant l'accent sur les boucles de rétroaction (typage statique, accès navigateur, tests automatisés), /tdd pousse le cycle rouge-vert-refactor, /diagnosing-bugs fournit une boucle de débogage disciplinée et progressive. - Dégradation de l'architecture : /to-spec demande quels modules modifier avant d'écrire une spec ; /improve-codebase-architecture scanne le codebase pour les opportunités d'approfondissement et génère un rapport HTML visuel, conçu comme un survey régulier plutôt qu'un sauvetage. Les compétences sont classées en deux types selon "qui peut les invoquer" : user-invoked (nécessite que l'utilisateur tape le nom pour déclencher, responsable de l'orchestration, peut invoquer des compétences model-invoked mais pas une autre compétence user-invoked) et model-invoked (peut être invoqué par l'utilisateur, ou déclenché automatiquement par l'agent lorsque la tâche correspond, portant une discipline réutilisable). Engineering (ingénierie) : - User-invoked : ask-matt (routeur de compétences de ce dépôt), grill-with-docs (interview approfondie avec maintenance de CONTEXT.md et ADR), triage (machine à états de rôles de triage pour faire avancer les issues), improve-codebase-architecture, setup-matt-pocock-skills, to-spec (transforme la conversation en spec et la publie dans le tracker d'issues), to-tickets (découpe le plan en tickets tracer-bullet avec relations de blocage), wayfinder (planifie le gros travail en decision tickets sur le tracker d'issues comme carte partagée), implement (implémente selon spec/ticket, pilote /tdd sur les seams convenus et termine par /code-review). - Model-invoked : prototype (construit un prototype jetable, peut produire un HTML monofichier ou plusieurs variantes UI), diagnosing-bugs, research (recherche contre des sources primaires de haute fiabilité et sauvegarde du Markdown avec références), tdd, domain-modeling, codebase-design (discipline de conception deep modules et vocabulaire), code-review (revue de code sur deux axes Standards et Spec, avec sous-agents parallèles), resolving-merge-conflicts (résout les conflits hunk par hunk en traçant les intentions de chaque côté, sans utiliser --abort), wizard (génère un assistant bash interactif pour guider l'humain dans la configuration d'infrastructure, credentials, secrets CI, migrations ponctuelles, etc.). Productivity (flux de travail généraux, non limités au code) : - User-invoked : grill-me, handoff (compresse la conversation en document de passation), teach (utilise le répertoire courant comme espace de travail pédagogique avec état pour un enseignement transversal), to-questionnaire (transforme une décision en questionnaire Markdown à remplir par une personne compétente), wait-what (complète le contexte manquant et reformule le message en langage simple). - Model-invoked : grilling (primitive d'interview réutilisable, soutenant grill-me, grill-with-docs, triage, wayfinder, improve-codebase-architecture), writing-for-agents (écrit de la documentation pour les agents, comme AGENTS.md/CLAUDE.md). Misc (conservé localement mais peu utilisé) : git-guardrails-claude-code (intercepte les commandes Git dangereuses comme push, reset --hard, clean avant exécution via hooks), migrate-to-shoehorn (migre les assertions de type as dans les fichiers de test vers @total-typescript/shoehorn), scaffold-exercises (génère des répertoires d'exercices avec sections, problèmes, solutions, explicateurs), setup-pre-commit (configure les hooks Husky pre-commit, intégrant lint-staged, Prettier, vérification de type et tests).