pendings-review
Skill1 starsChanged 5 months agoMITView on GitHub
Cargar SIEMPRE que el dev consulte, revise, priorice, cure o "pase lista" a sus pendientes — incluyendo preguntas de lectura simple como "cuáles son mis pendientes", "qué tengo pendiente", "mis pendientes activos", o filtradas por cliente/tópico ("qué tengo de alpha", "pendientes de seguridad"). También: marcar obsoletos, curar cliente/tópico/slug/banda de un pendiente, agrupar relacionados (candidatos a REQ conjunto), sugerir soluciones, "deja esta sesión en mis pendientes" o "rankéame los pendientes según <criterio/roadmap>". Es la ÚNICA vía de consulta del dev: opera neb.db y aplica la capa de valor (banda curada > brújula compas.md por tópico + bonus por cliente), no el volcado plano. El CLI pendings.py list/show es acceso de bajo nivel/debug y NO sustituye al skill. NO cargar solo para implementación normal ajena a los pendientes.
In this repository4 other files it gives its agents.
- general/agents.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- logbookSkill
- wakeupSkill
The file
We split this skill into the rules it gives an agent
1 rule. About 0 are common, 0 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈0
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 54
No edites neb.db a mano: usa los subcomandos (preservan estados reversibles y la bitácora append-only pending_note).
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Skill: pendings-review (revisión, curaduría y priorización de pendientes)
Opera el pase unificado de pendientes sobre neb.db. El modelo de datos vive en el change MD
2026-06-14-neb-pendings-sqlite-nucleo.md y en 2026-09-22-pendings-taxonomia-cliente-topico.md;
la mecánica del backend (ejes curados, curated, columna slug, compas.md v2, jerarquía de
prioridad) en ../../tooling/pendings.md. Este skill ejecuta — no
repite esos lineamientos. Traduce los enums de la DB (inglés) al español al mostrar.
Resolver el módulo
NEB_SRC="${NEB_HOME:-}"
case "$NEB_SRC" in ""|*/plugins/cache/*|*\\plugins\\cache\\*) NEB_SRC="${CLAUDE_PLUGIN_ROOT}" ;; esac
[ -f "$NEB_SRC/VERSION" ] || echo "Neb: no hay VERSION en '$NEB_SRC'. Si la ruta es la de NEB_HOME, corrígela; si quedó vacía, actualiza Claude Code (sustitución de CLAUDE_PLUGIN_ROOT en skills)" >&2
PD() { py "$NEB_SRC/hooks/lib/pendings.py" "$@" 2>/dev/null || python "$NEB_SRC/hooks/lib/pendings.py" "$@"; }Operaciones
Pase unificado (default, /pendings-review)
PD triage [--cliente <slug>] [--topico <slug>]→ JSON:items(cada uno conslug,cliente,topico,curated,suggestions,band,source,rationale),groups(componentes depending_linkentre abiertos),suggested(sin curar, con sugerencia del matching),unclassified(sin curar, sin sugerencia) ycatalog(los valores válidos de cada eje:{"cliente": [...], "topico": [...]}). Los filtros por eje acotan todo el JSON — úsalos cuando el dev pregunta por un cliente o un tópico; un valor fuera del catálogo devuelve{"ok": false, "error", "catalog"}.- Triage inline (sin subagente): por cada pending, muestra su cita canónica
[slug](PD-<id>) —sislugesnull, citaPD-<id>— · cliente · tópico · banda · origen (curated→"curada",compas,intrinsic→"intrínseca",prompt,unclassified→"sin clasificar") · una línea de rationale. Nunca#NNN(ver../../tooling/pendings.md§ "Cómo citar un pendiente"). Traduce los enums:open→"abierto",obsolete→"obsoleto",no-longer-applies→"ya no aplica",resolved-otherwise→"resuelto de otra forma";related→"relacionado",depends→"depende",blocks→"bloquea";high/medium/low→alta/media/baja. - Curar los que faltan =
suggested∪unclassified∪ lositemsconcuratedperoclienteotopicoennull(curados a medias). Muestra la propuesta inline como tablaPD-id · slug propuesto (si es null) · cliente · tópico—parte desuggested_cliente/suggested_topico(la mejor sugerencia del matching por eje;suggestionstrae hasta 3 por eje, por score) y corrígela con tu lectura delcontext_origin, siempre con valores delcatalog— y luego una solaAskUserQuestioncon tres opciones: «Aplicar todo» · «Aplicar con mis ajustes» · «Curar después» (el pase no se bloquea). Si son más de ~20, propone los más recientes y deja el resto para el siguiente pase. Con el OK,PD curate <id> --cliente <c> --topico <t> [--band alta|media|baja] [--slug <slug>]por cada uno (la salida es JSON{"ok": true|false, ...}; siokesfalse, muestraerrory no insistas a ciegas). Un pendiente curado en ambos ejes no vuelve a la lista: el matching no lo toca. - Obsolescencia:
- señal dura (work ligado cerrado) → ya viene auto-archivado con causa por el gancho de A (
on_work_archived); solo infórmalo. - "al recuperarlo" / juicio → SUGERENCIA CON CONFIRMACIÓN: propón marcar obsoleto + causa; pide OK antes de
PD archive <id> <causa>(el verbo CLI esarchive, que establecestatus='obsolete'con la causa). Nunca auto-archives por juicio en el MVP.
- señal dura (work ligado cerrado) → ya viene auto-archivado con causa por el gancho de A (
- Agrupación:
groupsson los vínculos explícitos (pending_link, cualquier relación) entre abiertos — candidatos a REQ conjunto. Para meter un pendiente a un grupo:PD curate <id> --relacionado <id|slug>(repetible; la cita debe ser exacta:PD-<id>o slug completo). Por qué no agrupa el tema compartido:../../tooling/pendings.md§ "Ejes curados". - Soluciones profundas (fan-out top-K): solo bajo demanda y solo para los top-K (por defecto K=3) pendings de mayor banda, despacha el subagente
pendings-recommender(Task) pasándole[slug] (PD-id) · cliente · tópico · banda + origen · grupoy elcontext_origin. El triage liviano queda inline; el fan-out es opcional.
Priorizar por criterio externo — priorizar <criterio o roadmap>
PD rank "<criterio>" (texto libre) o PD rank --roadmap <proyecto>; el JSON trae order, scores y slugs (id → slug, para citar). Jerarquía de fuentes y su porqué: ../../tooling/pendings.md § "Jerarquía de fuentes de priorización" — en corto, prompt > banda curada > compas.md > intrínsecas; el criterio del prompt es efímero y ningún pase recalcula una banda curada.
Brújula insuficiente → aprender
Si compas.md no existe o la cobertura es baja, NO inventes pesos: PD infer-objectives propone objetivos sobre el eje tópico; preséntalos con AskUserQuestion (opciones seleccionables, no prosa) y con el OK del dev PD write-compas '[["nombre", peso, ["topico", ...], "roadmap|null", {"cliente": bonus}], ...]' escribe ~/.claude/compas.md (v2; el 5º elemento —bonus por cliente— es opcional). La brújula se aprende, no se queda muda.
Dejar la sesión en pendientes — recordar-sesion
Crea un pending tipo session que referencia el work exploratorio + transcript del logbook (PD remember-session). Al recuperarlo, el contexto = el .jsonl local (lectura), sobrevive a archivar la sesión.
Notas
- No edites
neb.dba mano: usa los subcomandos (preservan estados reversibles y la bitácora append-onlypending_note). revive <id>reactiva un obsoleto (limpia la causa + agrega nota de reactivación). Todo es reversible y auditado.- La única vía para persistir una banda es
PD curate <id> --band <alta|media|baja>(la DB guarda el enum inglés; el CLI traduce). Sobre un pendiente sin curar hay que dar--cliente/--topicoen la misma llamada (si no,ok: false). No escribaspending_topicpor SQL. PD backfill-slugsrellenapending.slugdesde el tag[slug]de pendientes viejos (solo tags únicos); las citas históricas resuelven igual sin correrlo.- En local-only la prioridad es informativa para el propio dev; no hay sync cross-dev de pendings en el núcleo.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

