Habilidades de Matt Pocock
Diseño interno: límites de invocación y referencias compartidas
Lee Matt Pocock skills como una red de entradas humanas, disciplinas reutilizables y convenciones del proyecto, no como un motor de orquestación oculto.
Qué aprenderás
- El límite de control forma parte del diseño
- Da a cada referencia reutilizable un lugar responsable
- No toda referencia es un requisito imprescindible
Antes de empezar
- Conceptos básicos de repositorios, incidencias y pruebas
- Distinguir instrucciones y permisos
Elige una adopción y sigue sus archivos, límites de autoridad y evidencia.
Conclusiones clave
- Los indicadores expresan alcance previsto, no permisos universales.
- Consultar vocabulario y modificar decisiones son operaciones diferentes.
- La configuración del gestor puede ser obligatoria mientras el glosario es opcional.
El límite de control forma parte del diseño
El repositorio separa entradas humanas y disciplinas descubribles por el modelo. Las habilidades humanas declaran disable-model-invocation en SKILL.md y allow_implicit_invocation: false en sus metadatos OpenAI. La convención exige mantener ambas declaraciones alineadas. Es un contrato de integración previsto, no un aislamiento de seguridad independiente.
Un orientador como ask-matt explica a una persona qué entrada encaja con su situación. Esa descripción no concede autoridad para iniciar otros flujos exclusivamente humanos. En un anfitrión real, comprueba qué metadatos respeta y cómo expone la invocación; la nota de diseño del repositorio no garantiza todos los comportamientos de todas las versiones.
Da a cada referencia reutilizable un lugar responsable
La guía de invocación asigna disciplinas reutilizables a habilidades invocables por el modelo y pide acceder a ellas explícitamente. Sus documentos auxiliares permanecen junto a la habilidad responsable. Así se evitan copias paralelas de una regla de pruebas o dominio que diverjan después de cambios. La dependencia debe aparecer en las instrucciones, no deducirse de un nombre de carpeta.
El contexto del proyecto es otra capa. Consultar un glosario existente es lectura pasiva; cuestionar términos y escribir decisiones es trabajo activo de modelado. Confundirlos convierte una exploración de solo lectura en una modificación inesperada del conocimiento del proyecto. La revisión puede preguntar concretamente si la tarea consultaba contexto o tenía permiso para cambiarlo.
No toda referencia es un requisito imprescindible
El ADR de configuración distingue flujos que necesitan un destino de incidencias o mapa de etiquetas de disciplinas que siguen siendo útiles sin glosario. No se publica correctamente una tarea si se desconoce su destino. Una prueba de comportamiento puede funcionar sin documento de dominio, aunque sus nombres sean menos precisos. La distinción no justifica inventar configuración ausente.
Representa tres capas: entradas deliberadas, disciplinas reutilizables y convenciones del repositorio. No hace falta inventar un servidor de colas o demonio ejecutor. Al adaptar una habilidad, sigue sus dependencias de invocación y los archivos de proyecto esperados para que una pequeña edición no cambie silenciosamente autoridad o requisitos.
Pasos de implementación
- 1
Identifica la entrada humana adecuada.
- 2
Sigue las disciplinas que referencia explícitamente.
- 3
Enumera archivos del proyecto y destinos externos esperados.
- 4
Verifica el comportamiento del anfitrión antes de confiar en el límite.
Ejemplo para copiar
{
"entryPoint": "human-invoked workflow",
"reusableLayer": ["testing discipline", "domain modeling"],
"projectContext": ["issue tracker", "label mapping", "domain documents"],
"metadataIsSecuritySandbox": false
}Preguntas frecuentes
¿Mencionar un comando con barra ejecuta una habilidad?
No necesariamente. El repositorio distingue orientación descriptiva e instrucciones operativas; la ejecución depende del anfitrión.
¿Todas las disciplinas deben rechazar un proyecto sin configuración?
No. La fuente separa dependencias imprescindibles del contexto que mejora el resultado pero puede faltar.
Fuentes
- .agents/invocation.mdFuente verificada 2026-09-08
- .agents/adr/0001-explicit-setup-pointer-only-for-hard-dependencies.mdFuente verificada 2026-09-08
- skills/productivity/writing-for-agents/SKILL-MECHANICS.mdFuente verificada 2026-09-08