dependency-upgrade
Prepara inventario y spec de actualización desde manifiestos, lockfiles y outdated oficial; revisa saltos major. No actualiza dependencias ni busca CVE. Úsala cuando el usuario diga "actualiza las dependencias", "qué dependencias están desactualizadas", "prepara el upgrade de <paquete>", "inventario de dependencias", "qué breaking changes tiene subir a la versión X", "plan para subir de major".
- License 许可
- Apache-2.0
- 最近更新
- 2026-11-15
- Stars
- ★ 1
- Forks
- 0
01 前言 Front Matter
- name
- dependency-upgrade
- description
- Prepara inventario y spec de actualización desde manifiestos, lockfiles y outdated oficial; revisa saltos major. No actualiza dependencias ni busca CVE. Úsala cuando el usuario diga "actualiza las dependencias", "qué dependencias están desactualizadas", "prepara el upgrade de <paquete>", "inventario de dependencias", "qué breaking changes tiene subir a la versión X", "plan para subir de major".
02 资源文件 3
- 参考文档references/upgrade-notes.md3.3 KB
- 脚本scripts/deps-inventory.py20.2 KB
- 脚本scripts/test_deps_inventory.py14.6 KB
03 SKILL.md 正文
dependency-upgrade — inventariar, clasificar y especificar el upgrade (no ejecutarlo)
Alcance y activación
Prepara la ACTUALIZACIÓN de dependencias de un proyecto sin tocarlas: inventario DETERMINISTA con deps-inventory.py (manifiestos package.json · composer.json · requirements*.txt · pyproject.toml · go.mod · Gemfile · *.csproj y sus lockfiles; versión declarada y bloqueada; «latest» SOLO del outdated oficial (npm/composer/pip/go) si está en PATH — nunca inventado), clasifica cada salto en patch/minor/major («major = breaking probable»), lee el changelog/UPGRADING de los major y redacta la spec.md de una iniciativa «upgrade-<paquete|lote>» con la plantilla del evaluator, para que evaluator la presupueste y planner la planifique. NO actualiza nada por su cuenta y NO busca vulnerabilidades/CVE (eso es nemesis con la skill cybersecurity).
Subir dependencias «a ojo» es la forma más cara de romper un proyecto. Esta skill separa tres cosas
que suelen mezclarse: qué hay (inventario determinista), qué se rompe (changelog upstream de
cada major) y qué se decide (una spec.md que evaluator presupuesta y planner planifica).
El upgrade en sí lo hace implementer dentro de la iniciativa, con suites y smoke.
Regla. Ninguna versión sale de la cabeza del modelo.
latestviene deloutdatedoficial de la herramienta; si no está o no hay red, el informe dice—y lo avisa. Esta skill no ejecutanpm update,composer update,pip install -Unigo get -u.
Resolución de rutas (regla 5 de CONVENTIONS — nunca rutas fijas):
R="${CLAUDE_PLUGIN_ROOT}"; M=agent-kits/shared/ledger-lint.py; [ -f "$PWD/$M" ] && R="$PWD"; [ -f "$R/$M" ] || R="$(for r in "$PWD"/.{claude,codex,opencode} ~/.{claude,codex}/plugins/cache/daycry ~/.{claude,codex,config/opencode}; do find "$r" -maxdepth 5 -path "*/$M" ! -path "$r/jobs/*" ! -path "$r/worktrees/*" 2>/dev/null | sort -V | tail -1 | grep . && break; done)"; R="${R%/$M}"; DUSKILL="${R:+$R/skills/dependency-upgrade}"
R="${CLAUDE_PLUGIN_ROOT}"; M=agent-kits/shared/ledger-lint.py; [ -f "$PWD/$M" ] && R="$PWD"; [ -f "$R/$M" ] || R="$(for r in "$PWD"/.{claude,codex,opencode} ~/.{claude,codex}/plugins/cache/daycry ~/.{claude,codex,config/opencode}; do find "$r" -maxdepth 5 -path "*/$M" ! -path "$r/jobs/*" ! -path "$r/worktrees/*" 2>/dev/null | sort -V | tail -1 | grep . && break; done)"; R="${R%/$M}"; EVALKIT="${R:+$R/agent-kits/evaluator}"
python3 "$DUSKILL/scripts/deps-inventory.py" <ruta> [--json] [--no-outdated] [--timeout 60]
Cuándo NO usarla
| Parece esto, pero es… | Pieza correcta |
|---|---|
| «Busca vulnerabilidades / CVE / supply chain en las dependencias» | nemesis (skill cybersecurity, dimensión dependencias) — aquí se miran versiones y breaking changes, no exposición |
| «Sube ya la versión de X y arregla lo que rompa» (ejecutar) | /dev-cycle o quick-implement sobre la spec que produce esta skill |
| «Este paquete falla al arrancar» | debug-root-cause |
| «Mide la salud del código» (duplicados, hotspots) | code-health |
Proceso (3 pasos)
- Inventario.
python3 "$DUSKILL/scripts/deps-inventory.py" .(añade--jsonpara guardarlo en la iniciativa). Lee la cabecera: nº demajor/minor/patch/ sinlatest. Si hay avisos «npmno está en PATH» o «superó N s», ellatestde ese ecosistema no existe: dilo y, si el usuario lo quiere, pídele que ejecute la herramienta él (o instale/conecte red) — no lo rellenes. Exit 0 siempre; 2 solo por ruta inexistente. - Breaking changes por
major. Para cada dependencia marcadamajor ⚠️ breaking probable(y lasminorde frameworks que el usuario señale), localiza su changelog/UPGRADING/notas de release upstream: con WebFetch si está disponible (GitHub releases,CHANGELOG.mddel repo, guía oficial de migración); si no, anótalo como pendiente de leer con la URL probable — nunca resumas un changelog que no has leído. Registra por paquete: versión actual → destino, breaking changes que afectan a ESTE proyecto (grep de los símbolos/APIs citados en el código), y esfuerzo relativo (bajo/medio/alto). Leereferences/upgrade-notes.mdsolo al llegar aquí si dudas de qué buscar en un changelog. - Spec de la iniciativa. Crea
docs/roadmap/<AAAA-MM-DD>-upgrade-<paquete|lote>/spec.mdcon la plantilla"$EVALKIT/templates/spec.md"(estado: borrador; misma cadena spec → evaluación → plan de la regla 7 de CONVENTIONS) y regístrala endocs/roadmap/README.md:- Alcance: la tabla del inventario (declarada · bloqueada · latest · salto) de lo que entra; fuera de alcance explícito (lo que se deja para otro lote, y por qué).
- Riesgos: los breaking changes del paso 2 con su fichero afectado; dependencias transitivas que arrastra un major (p. ej. subir un framework fuerza a subir sus plugins).
- Criterios de aceptación:
[GWT]mínimos — suites del proyecto en verde con las versiones nuevas; smoke de arranque/build; lockfile regenerado y comiteado; cero versiones «flotantes» nuevas;deps-inventory.pytras el cambio → esos paquetes enigual. - Cierra con el handoff: «presupuesta con
evaluator; si es go, planifica conplanner». Un lote razonable: todos los patch/minor en una iniciativa y un major por iniciativa (o por familia: framework + plugins).
Guardrails
- Solo lectura del proyecto. Escribes únicamente
spec.md(y su fila en el índice del roadmap). Nada depackage.json, lockfiles nivendor/. - Herramientas con timeout (
--timeout, 60 s):npm outdatedpuede colgarse sin red; el script lo convierte en aviso, no en bloqueo. - Monorepos: el script recorre el árbol y agrupa por manifiesto (cada
outdatedcorre en la carpeta de SU manifiesto); si es enorme, pásale la subcarpeta. pip list --outdatedmira el entorno activo, norequirements.txt: si el venv no está activado o no coincide, ellatestpuede referirse a otro entorno — dilo en la spec.- Degradación: sin
python3no hay skill; sin herramientas, inventario sinlatest; sin WebFetch, breaking changes «pendientes de leer». El ciclo sigue en los tres casos.
Qué NO hace
No actualiza dependencias, no regenera lockfiles, no ejecuta tests, no busca CVE ni secretos
(nemesis/cybersecurity), no estima horas (evaluator) ni descompone en tareas (planner), y
no promete un latest que ninguna herramienta ha devuelto.
Scripts y referencias
| Fichero | Qué es |
|---|---|
scripts/deps-inventory.py |
Inventario MD/JSON: 7 manifiestos + lockfiles, declarada/bloqueada/latest, salto semver, avisos; exit 0 · 2 uso |
| Tests (junto al script; no viajan en el paquete portable) | 11 casos con fixtures de los 7 manifiestos y outdated mockeado (ejecutor inyectable): python3 -m pytest -q skills/dependency-upgrade/scripts |
references/upgrade-notes.md |
Qué buscar en un changelog/UPGRADING y cómo anotar un breaking change (léelo solo en el paso 2) |
04 同仓库更多 Skills
tax
Guía fiscal duplicada
tax
Guía fiscal
demo-skill
Skill de ejemplo <script>alert(1)</script>.
voice-profile
Extrae un perfil de voz a partir de muestras autorizadas, con procedencia, rasgos observables y diferencias por canal. Úsala cuando el usuario diga "extrae mi estilo", "crea mi perfil de voz" o "analiza cómo escribo".
unit-tests
Pirámide de pruebas y gate de cobertura oficial, global o sobre ficheros cambiados. Sin herramienta avisa, no inventa porcentajes. No sustituye a TDD ni a E2E. Úsala cuando el usuario diga "sube la cobertura de tests", "qué % de cobertura tenemos", "pon un gate de cobertura", "pirámide de pruebas", "cuántos tests unitarios faltan", o cuando `dev.json` traiga `tests.coberturaMinima`.
training-data-services
Captura casos fuera de Git con esquema validado y ensambla datasets solo con Gold aprobado por humanos. Opt-in; el plugin no decide métricas, no marca Gold ni entrena. Úsala cuando el usuario diga "guarda este intento como caso", "captura casos para entrenar un modelo local", "valida el esquema del caso", "prepara un dataset con los casos aprobados", "activa training-data-services", o al activar la capacidad `training` desde `/setup`.