maintainer review treats SKILL.md files in hidden agent directories as library skills
Nadie ha tomado este issue todavía.
Evaluación
- Dificultad
- 2/5
- Tiempo estimado
- 1-3 horas
- Aptitud para principiantes
- 75/100
- Tipo de issue
- Error
- Claridad
- Bien especificado
- Estado de actividad
- Activo
- Stack tecnológico
- nodejs, typescript
Línea de trabajo
El problema está en packages/intent/src/review/review.ts líneas 565-572. Compara con la lógica en packages/intent/src/maintainer/existing.ts líneas 74-83. La solución es agregar un filtro para segmentos ocultos (partes que comienzan con '.') y 'node_modules' al descubrimiento de habilidades de la revisión. Comienza ejecutando los pasos de reproducción para ver el fallo, luego modifica la prueba de ruta en review.ts para que coincida con la lógica de configuración. Verifica ejecutando maintainer review y maintainer check en un espacio de trabajo de prueba con un directorio oculto .claude/skills/.
Escrito por el modelo de indexación a partir del texto del issue.
Descripción
Problem
intent maintainer review treats every SKILL.md under a skills/ directory as a library skill, including skills in hidden agent directories such as .claude/skills/. These are repository-local agent skills: they are not published and declare no sources. Review reports each one as pending, and recording fails, so maintainer check cannot pass in a repository that has project-level agent skills.
maintainer setup already excludes these paths when it registers existing skills, so the two commands disagree on what a library skill is.
Reproduction
In a pnpm workspace with one package skill and one project-level Claude Code skill:
.claude/skills/add-a-package/SKILL.md # repository-local agent skill, no sources
packages/client/skills/client-core/SKILL.md
_artifacts/{domain_map.yaml,skill_spec.md,skill_tree.yaml}
pnpm exec intent maintainer setup
pnpm exec intent maintainer review --updated "Initial review."
pnpm exec intent maintainer check
maintainer setup registers only packages/client/skills/client-core/SKILL.md, as expected.
maintainer review --updated fails:
Review skill:.claude/skills/add-a-package/SKILL.md has unresolved source evidence. Fix the source mapping before recording it.
maintainer check reports:
Review skill .claude/skills/add-a-package/SKILL.md: No source paths declared. Add the evidence used to author this skill.
Adding .claude/** to review.ignore in skill_tree.yaml does not help: that list filters unmapped changes, not skill discovery.
Cause
Review selects skill files with a path test only (review.ts#L565-L572):
basename(path) === 'SKILL.md' &&
(/(^|\/)skills\//.test(path) || /* ... */)
Setup applies the same test and also skips hidden segments and node_modules (existing.ts#L74-L83):
basename(path) === 'SKILL.md' &&
/(^|\/)skills\//.test(path) &&
!path
.split('/')
.some((part) => part.startsWith('.') || part === 'node_modules')
Expected
Review discovers the same default set as setup: hidden agent directories (.claude/, .cursor/, .agents/, …) stay out unless the skill tree declares the path explicitly, or review state already records it.
Suggested fix
Apply the hidden-segment filter of existing.ts to the /(^|\/)skills\// branch in review.ts, and keep the customRoots, declaredSkills and review-state branches as they are. A shared helper would keep the two rules from drifting again.
Environment
@tanstack/intentpreviewhttps://pkg.pr.new/@tanstack/intent@292(commit80ed89d), source checked againstmainat305ca7f- Node.js 24.21, pnpm 12.3.4, macOS arm64
- Lenguaje dominante
- TypeScript
- Estrellas
- 331
- Forks
- 22
- Merge medio
- 12 h 17 min
- PR fusionados (30 d)
- 51
Guía de contribución
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Más de TanStack/intent
-
Dificultad 5/5 Más de una semana Aptitud para principiantes 45/100
-
Dificultad 4/5 3-5 días Aptitud para principiantes 48/100
-
Dificultad 5/5 Más de una semana Aptitud para principiantes 35/100
-
Dificultad 5/5 Más de una semana Aptitud para principiantes 45/100
-
enhancement
Dificultad 5/5 Más de una semana Aptitud para principiantes 35/100
Todos los issues de TanStack/intent
Issues similares
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 65/100
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 75/100
-
bug v2
Dificultad 2/5 1-3 horas Aptitud para principiantes 75/100
modelcontextprotocol/inspector#2458 · 1 comentario ·
-
Dificultad 1/5 Menos de una hora Aptitud para principiantes 75/100
railmapgen/rmp-gallery#4068 ·
-
Mend: dependency security vulnerability status: needs triage 🕵️♀️
Dificultad 2/5 1-3 horas Aptitud para principiantes 70/100
carbon-design-system/ibm-products#9907 ·