AGENT SKILL

kdd-dependency-eol-scan

Guia a cualquier agente (no depende de ningun modelo puntual) para producir un scan de vigencia de dependencias (End-Of-Life / abandono de mantenimiento) en el formato de contrato de Capa 3 de KDD -- findings.json -- que despues gatea scripts/validate_dependency_eol_findings.py. Usala cuando se pida auditar si las dependencias de un proyecto siguen soportadas, correr endoflife.date/npm outdated/pip list --outdated, o se mencione "EOL", "end of life", "dependencias desactualizadas" o "Capa 3" en el contexto de este template. NO confundir con kdd-compliance-scan (audita LICENCIA, no vigencia).

License 许可
MIT
最近更新
2026-09-01
Stars
★ 4
Forks
0

01 前言 Front Matter

name
kdd-dependency-eol-scan
description
Guia a cualquier agente (no depende de ningun modelo puntual) para producir un scan de vigencia de dependencias (End-Of-Life / abandono de mantenimiento) en el formato de contrato de Capa 3 de KDD -- findings.json -- que despues gatea scripts/validate_dependency_eol_findings.py. Usala cuando se pida auditar si las dependencias de un proyecto siguen soportadas, correr endoflife.date/npm outdated/pip list --outdated, o se mencione "EOL", "end of life", "dependencias desactualizadas" o "Capa 3" en el contexto de este template. NO confundir con kdd-compliance-scan (audita LICENCIA, no vigencia).

03 SKILL.md 正文

Dependency EOL Scan (Capa 3 de KDD -- vigencia de dependencias)

Produce hallazgos de vigencia de dependencias (fuera de soporte, abandonadas, o proximas a su fecha de fin de vida) en el formato de contrato que audita la Capa 3 de KDD. Esta skill NO es el gate -- es la parte creativa/no determinista (consultar el estado de vigencia real de cada dependencia y decidir su eolStatus) que el gate despues valida. Distincion central: el scanner/agente decide el estado de vigencia; el gate solo audita que el artefacto sellado cumpla forma y politica de calidad de datos.

Como kdd-compliance-scan y kdd-privacy-scan, este dominio NO vendoriza ningun sellador externo -- vos mismo escribis findings.json ya en forma final.

No es lo mismo que kdd-compliance-scan

kdd-compliance-scan audita si la LICENCIA de una dependencia es compatible con la del proyecto. Esta skill audita si la dependencia sigue VIGENTE (mantenida, con soporte activo) independientemente de su licencia. Una dependencia puede estar perfectamente licenciada (MIT) y a la vez estar sin mantenimiento hace anios. Corre las dos skills si queres cobertura completa de riesgo de dependencias -- son hallazgos independientes, en dominios (y findings.json) separados.

Cuando usarla

El usuario pide auditar si las dependencias directas de un proyecto siguen soportadas/mantenidas, y quiere el resultado gobernado por KDD (versionable, gateado en CI, con politica declarativa), no un reporte suelto en prosa.

Insumos que necesitas antes de empezar

  • repo_root: raiz del repositorio a escanear.
  • scan_dir: donde vas a escribir findings.json. Por defecto dependency-eol/scan dentro del repo KDD (coincide con el default de validate_dependency_eol_findings.py); si estas gobernando un repo EXTERNO, cualquier directorio disponible sirve, con tal de pasarselo explicito al gate.
  • El schema completo vive en knowledge/data_models/dependency-eol/findings.schema.json -- consultalo si dudas de un campo, no adivines la forma.

Flujo

1. Lista las dependencias directas

Lee el manifiesto del ecosistema del repo (package.json, requirements.txt/pyproject.toml, Cargo.toml, go.mod, pom.xml, etc.) y queda con la lista de dependencias DIRECTAS (no transitivas -- el volumen de transitivas suele ser enorme y el riesgo real esta en lo que el proyecto declara explicitamente).

2. Consulta el estado de vigencia de cada una

No reimplementes rastreo de fechas de EOL: usa fuentes estandar.

Fuente Cubre Uso tipico
endoflife.date API Runtimes, frameworks, DBs con ciclo de vida formal declarado GET https://endoflife.date/api/<producto>.json
npm outdated / npm view <pkg> time Paquetes npm, fecha del ultimo publish CLI
pip list --outdated / PyPI API Paquetes Python CLI / https://pypi.org/pypi/<pkg>/json
cargo outdated Crates de Rust CLI (requiere cargo-outdated)
go list -u -m all Modulos Go CLI
Revision manual del repo upstream Cualquier ecosistema, cuando no hay fecha de EOL formal Ultimo commit/release en GitHub/GitLab del paquete

Para cada dependencia, decidi eolStatus:

  • supported: version reciente, mantenedor activo, sin fecha de EOL cercana.
  • approaching-eol: el publisher declaro una fecha de fin de soporte que esta a menos de ~6 meses (ajusta segun el contexto del proyecto).
  • eol: la fecha de fin de vida/soporte DECLARADA por el publisher ya paso.
  • unmaintained: SIN fecha de EOL formal, pero sin actividad real (commits, releases, respuestas a issues) en mucho tiempo -- juicio del agente, no mecanizable de forma universal.
  • unknown: no encontraste informacion confiable -- no lo declares supported por default, eso oculta el riesgo.

No inventes un finding para llenar un cupo: un scan donde todo esta supported es un resultado valido.

Para cada finding eol/unmaintained, junta ANTES de escribir el JSON:

  • dependencyName/dependencyVersion exactos, latestVersion si la encontraste;
  • eolDate si el publisher la declaro formalmente;
  • severidad honesta -- eol/unmaintained normalmente son high/critical (mas alto si la dependencia maneja datos sensibles o esta expuesta a red);
  • una remediacion CONCRETA y accionable (no "actualizar la dependencia" a secas -- nombra la alternativa concreta si la conoces, o el plan de migracion; eso no pasa el gate de politica, que exige remediaciones sustantivas de >=20 caracteres para eol/unmaintained).

3. Escribir el artefacto

En <scan_dir>/findings.json:

{
  "documentType": "kdd-dependency-eol.findings",
  "schemaVersion": "1.0",
  "scanId": "<identificador estable, p.ej. hash corto del commit + '_kdd-dependency-eol-scan'>",
  "findings": [
    {
      "findingId": "eol_<dependencyName>-<dependencyVersion>",
      "dependencyName": "...",
      "dependencyVersion": "...",
      "latestVersion": "...",
      "eolStatus": "...",
      "eolDate": "...",
      "severity": "...",
      "remediation": "...",
      "source": "endoflife.date | npm outdated | pip list --outdated | manual review | ..."
    }
  ]
}

findingId es responsabilidad tuya (no hay finalizer que lo derive): usa dependencyName+dependencyVersion para que sea estable entre corridas del mismo scan.

4. Gatear

python scripts/validate_dependency_eol_findings.py <scan_dir>

FAIL con violaciones reales (estado fuera de enum, remediacion tipo placeholder en un eol/unmaintained, severidad insuficiente) significa que el HALLAZGO esta mal capturado, no que el gate este mal -- volve al paso 2 para ese finding especifico, no debilites la regla en examples/rules/dependency-eol-findings.rules.json para que pase.

5. Reportar

Devolve al usuario la ruta de findings.json y un resumen: cuantas dependencias directas se revisaron, cuantos findings eol/unmaintained se sellaron.

Que NO hace esta skill

  • No decide automaticamente la migracion (reemplazar la dependencia, hacer un fork interno, negociar soporte extendido pagado) -- produce el artefacto gobernable; la decision sigue siendo humana. Acuerdos de soporte extendido documentados viven fuera del artefacto sellado (ver el code_only de dependency-eol-findings.rules.json).
  • No audita licencias ni vulnerabilidades de seguridad -- esos son kdd-compliance-scan y kdd-security-scan, dominios de politica distintos.

04 同仓库更多 Skills

MauricioPerera
MauricioPerera/mcpwasm

pm-sonnet-opus-haiku

Convierte a Claude Code en un equipo de desarrollo por capas con roles fijos por modelo. PM = Sonnet 5 (sesion principal): planifica, descompone, redacta specs, autora contrato + tests congelados, delega, verifica e integra; no escribe codigo de produccion. Implementador = subagent Opus 4.8 por tarea, en worktree si hay paralelo, implementa contra los tests sin editarlos. QA por defecto = subagent Haiku 4.5 read-only, revisa el diff vs spec + confirma tests congelados, veredicto APROBADO/RECHAZADO; si el repo tiene gate CCDD/KDD determinista (KDD Nivel 1 sin MCP, o el MCP ccdd-complexity, o ambos), el PM puede usarlo en vez de o junto a Haiku, sin GLM ni Ollama. Verificador adversarial opcional = 2-3 subagents Haiku en paralelo, independientes entre si, buscan/refutan bugs y hallazgos de seguridad; sobrevive solo por mayoria. Usala para ejecutar un proyecto/feature/fix con este equipo, o si mencionan equipo sonnet/opus/haiku, gate CCDD, verificacion adversarial. No depende de Ollama ni cuentas externas.

★ 4
MauricioPerera
MauricioPerera/mcpwasm

pm-native-ccdd

Variante NATIVA del PM/orquestador CCDD que usa sub-agentes de la app de Claude (tool Agent con model override) en vez de GLM/Ollama externo. Claude autora contrato + tests congelados (oráculo), delega la IMPLEMENTACIÓN a un sub-agente barato (Haiku 4.5), y verifica por el gate CCDD determinista. Úsala cuando quieras el flujo PM+CCDD sin la fragilidad de ollama, con aislamiento por worktree para paralelismo y reintentos con contexto vía SendMessage. Hermana de pm-glm-ccdd (misma metodología; cambia SOLO el mecanismo de delegación). Deslinde con pm-sonnet-opus-haiku: mismo gate CCDD/KDD como verificador si el repo lo trae, pero tiering de implementador distinto — esta usa Haiku barato con escalado a Sonnet; pm-sonnet-opus-haiku usa Opus fijo (más caro) más QA/verificación adversarial opcional en capas. Elegí ESTA para el flujo 100% CCDD con implementador barato; usá pm-sonnet-opus-haiku si preferís implementador Opus + QA por capas.

★ 4
MauricioPerera
MauricioPerera/mcpwasm

pm-glm-ccdd

Pone a Claude como PM/orquestador de un proyecto donde los desarrolladores son instancias EFÍMERAS de glm-5.2:cloud que implementan usando el CCDD gate. Úsala cuando el usuario quiera ejecutar un proyecto, feature, refactor o conjunto de tareas delegando TODA la implementación a GLM — Claude planifica, descompone en tareas, reparte a devs GLM (en paralelo si conviene), verifica por el veredicto del gate e integra. Claude NO escribe código de producción; dirige.

★ 4
MauricioPerera
MauricioPerera/mcpwasm

pkb-agent-first

暂无简介

★ 4
MauricioPerera
MauricioPerera/mcpwasm

delegar-pool

Cómo lanzar y verificar un dev efímero vía `pool exec` (poolside.ai) en modo headless, agnóstico a la tarea. Cubre el flag no documentado `--unsafe-auto-allow` (obligatorio en no-interactivo), formato de log NLJSON, dónde viven los logs/trayectorias reales para auditar, el riesgo real (bloques de razonamiento largos antes de fallar, no un cuelgue de aprobación) y la doctrina de verificación independiente. Úsala como capa base de mecánica de delegación, análoga a `delegar-ollama` pero para `pool` en vez de Ollama/GLM.

★ 4
MauricioPerera
MauricioPerera/mcpwasm

delegar-pool-ccdd

Delega la IMPLEMENTACIÓN de UNA función/tarea puntual a un dev efímero vía `pool exec` (poolside.ai), verificada por el CCDD gate. Úsala cuando el usuario pida implementar/arreglar/extender algo puntual y quiera que lo haga `pool` — "delega a pool" / "usa el ccdd gate con pool". Para proyectos con VARIAS tareas y devs en paralelo, adaptá `pm-glm-ccdd` con `pool` como mecanismo en vez de esta (esta es la capa de UNA tarea suelta).

★ 4