mattpocock-skills-zh-cn

Esta es la versión en chino simplificado de mattpocock/skills, que proporciona un conjunto de habilidades de agente utilizadas en el trabajo de ingeniería real del autor para agentes de codificación como Claude Code y Codex. Se enfatiza que las habilidades son pequeñas, modificables y componibles, en lugar de un marco metodológico que se apodere de todo el flujo de desarrollo. Motivación y estrategia de localización: - Las explicaciones en chino reducen el costo de conversión conceptual para desarrolladores nativos de chino; para modelos que interactúan en chino o están optimizados con corpus chino, los prompts en chino se adaptan mejor al contexto chino, reduciendo la ambigüedad causada por la mezcla de chino e inglés. - La traducción adopta una localización de contenido guiada por habilidades: solo se traducen las explicaciones en lenguaje natural, conservando nombres de directorios, nombres de habilidades, claves de frontmatter, comandos, bloques de código, rutas, URL, identificadores de paquetes/herramientas/API, etc., para no dañar el comportamiento de instalación y ejecución. - El repositorio se sincroniza con el upstream según el método de actualización de contenido, sin sincronizar el historial de Git ni el estado de gestión del repositorio upstream; la última sincronización de traducción fue realizada por Claude (Anthropic) y fusionada en main por el mantenedor a través de PR. Las reglas de mantenimiento se registran en .skills/translate-skill/SKILL.md. Métodos de instalación (elegir uno, no repetir): 1. Instalador skills.sh: ejecute npx skills@latest add vinvcn/mattpocock-skills-zh-CN, seleccione las habilidades y los agentes de codificación de destino. Este método copia las habilidades en el proyecto, lo que facilita la modificación y personalización. 2. Complemento de Claude Code: ejecute /plugin marketplace add vinvcn/mattpocock-skills-zh-CN y /plugin install mattpocock-skills@mattpocock para instalar como un paquete de solo lectura gestionado, que se actualiza de manera uniforme con las nuevas versiones. Es adecuado para usuarios que solo desean usar directamente y mantenerse al día con las actualizaciones. 3. DeepSeek Harness (dsh): instale como complemento con dsh plugin --profile web add @vinvcn/dsh-mattpocock-skills-zh. Después de la instalación, se invoca con /zh- más el nombre de la habilidad, por ejemplo, /zh-grilling. En la primera instalación, debe seleccionar /setup-matt-pocock-skills y ejecutarlo una vez en el agente para configurar el rastreador de issues (GitHub, Linear o archivo local), las etiquetas utilizadas para triaje y la ubicación de almacenamiento de documentos. Filosofía de diseño: el autor diseñó habilidades correspondientes para los modos de falla comunes de los agentes de codificación: - Desalineación de requisitos: a través de sesiones de interrogatorio (/grill-me, /grill-with-docs), el agente pregunta en detalle antes de actuar para alinear la intención. - Expresión verbosa: a través del documento de lenguaje compartido (CONTEXT.md), el agente decodifica la terminología del proyecto, haciendo que los nombres sean más consistentes, la navegación del código más fácil y el pensamiento más eficiente en tokens. - Código que no se ejecuta: se enfatizan los bucles de retroalimentación (tipos estáticos, acceso al navegador, pruebas automatizadas). /tdd impulsa el ciclo rojo-verde-refactor, y /diagnosing-bugs proporciona un bucle de depuración disciplinado y por fases. - Degradación de la arquitectura: /to-spec pregunta qué módulos se van a modificar antes de escribir la especificación; /improve-codebase-architecture escanea el codebase en busca de oportunidades de profundización y genera un informe HTML visualizable, posicionado como una encuesta periódica en lugar de un rescate. Las habilidades se dividen en dos categorías según "quién puede invocarlas": invocadas por el usuario (requieren que el usuario ingrese el nombre para activarlas, se encargan de la orquestación, pueden invocar habilidades invocadas por el modelo pero no pueden invocar otra habilidad invocada por el usuario) e invocadas por el modelo (pueden ser invocadas por el usuario o activadas automáticamente por el agente cuando la tarea coincide, y contienen disciplinas reutilizables). Ingeniería: - Invocadas por el usuario: ask-matt (enrutamiento de habilidades de este repositorio), grill-with-docs (entrevista de interrogatorio y mantenimiento de CONTEXT.md y ADR), triage (impulsa issues con una máquina de estados de roles de triaje), improve-codebase-architecture, setup-matt-pocock-skills, to-spec (organiza la conversación en una especificación y la publica en el rastreador de issues), to-tickets (divide el plan en tickets trazadores con relaciones de bloqueo), wayfinder (planifica el trabajo grande en tickets de decisión en el rastreador de issues como un mapa compartido), implement (implementa según la especificación/ticket, impulsa /tdd en las costuras acordadas y finaliza con /code-review). - Invocadas por el modelo: prototype (construye prototipos desechables, puede producir HTML de un solo archivo o múltiples variantes de UI), diagnosing-bugs, research (investiga contra fuentes primarias de alta credibilidad y guarda Markdown con referencias), tdd, domain-modeling, codebase-design (disciplina de diseño de módulos profundos y vocabulario), code-review (doble eje de Estándares y Especificación, revisión con subagentes paralelos), resolving-merge-conflicts (resuelve conflictos por hunk y rastrea las intenciones de cada parte, sin usar --abort), wizard (genera un asistente bash interactivo para guiar a los humanos en la configuración de infraestructura, credenciales, secretos de CI, migraciones únicas, etc.). Productividad (flujos de trabajo generales, no limitados al código): - Invocadas por el usuario: grill-me, handoff (comprime la conversación en un documento de transferencia), teach (usa el directorio actual como un espacio de trabajo de enseñanza con estado para enseñar entre sesiones), to-questionnaire (convierte decisiones en un cuestionario Markdown para que lo completen quienes puedan responder), wait-what (completa el contexto faltante y reformula el mensaje en lenguaje sencillo). - Invocadas por el modelo: grilling (primitiva de entrevista reutilizable que respalda grill-me, grill-with-docs, triage, wayfinder, improve-codebase-architecture), writing-for-agents (escribe documentación para agentes, como AGENTS.md/CLAUDE.md). Misceláneos (conservados localmente pero poco usados): git-guardrails-claude-code (intercepta comandos git peligrosos como push, reset --hard, clean antes de ejecutarlos con hooks), migrate-to-shoehorn (migra aserciones de tipo as en archivos de prueba a @total-typescript/shoehorn), scaffold-exercises (genera directorios de ejercicios con secciones, problemas, soluciones y explicaciones), setup-pre-commit (configura hooks de Husky pre-commit, integrando lint-staged, Prettier, verificación de tipos y pruebas).