Skills-Summarize-Audit — Auditoría impulsada por el perfil del repositorio de habilidades y del proyecto (vinculado con summarize)
Realiza un perfil multidimensional, una puntuación en siete dimensiones, un análisis de capacidad y recomendaciones de optimización para el repositorio de habilidades o el proyecto actual, generando finalmente un informe de auditoría ejecutable.
Te ayuda a:
- Conocer la salud del repositorio de habilidades (🟢/🟡/🔴) y las tendencias de cambio (📈 ↑/↓)
- Descubrir habilidades zombi y redundancias superpuestas
- Calcular cuántas habilidades más puede cargar el Agente (alerta temprana de capacidad efectiva multifactorial)
- Obtener una lista de acciones ejecutables (archivar/instalar/actualizar)
- Deshacer operaciones erróneas con un solo clic (
--undo)- Integrarse en pipelines CI/CD (salida JSON + lógica de puerta de enlace)
Palabras de activación / Trigger Words
Esta habilidad utiliza activación por palabra independiente: la palabra de activación debe enviarse de forma independiente (puede incluir subcomandos), no se activa si está dentro de una frase. Está diseñada para vincularse con la habilidad summarize; 技能总结 puede activar directamente la auditoría.
- Auditoría de habilidades:
技能审查,技能审计,技能检查,能力审查,能力审计,工具审查,技能总结,skills-audit,skill-audit,skill-check,capability-audit,tool-audit,skills-summarize-audit - Auditoría de proyectos:
项目审查,项目审计,项目诊断,项目画像,环境审查,环境审计,project-audit,project-check,project-diagnosis,project-profile,env-audit - Operación de deshacer:
回滚,撤销,恢复,undo-snapshot,rollback,revert - Subcomandos:
深度/deep,推荐/recommend,画像/profile,健康/health,轻量/quick,ci/--ci,回滚/undo/--undo
Matriz de palabras de activación
| Modo | Palabras de activación (chino) | Palabras de activación (inglés) |
|---|---|---|
| Auditoría de habilidades | 技能审查, 技能审计, 技能检查, 能力审查, 能力审计, 工具审查, 技能总结 | skills-audit, skill-audit, skill-check, capability-audit, tool-audit, skills-summarize-audit |
| Auditoría de proyectos | 项目审查, 项目审计, 项目诊断, 项目画像, 环境审查, 环境审计 | project-audit, project-check, project-diagnosis, project-profile, env-audit |
| Operación de deshacer | 回滚, 撤销, 恢复 | undo-snapshot, rollback, revert |
Sinónimos: 审查=审计=检查=诊断, 能力=技能=工具, 环境=项目 → se asignan automáticamente al modo correspondiente.
Comportamiento de activación
| Se activa ✅ | No se activa ❌ |
|---|---|
技能审查 (enviado de forma independiente) | 帮我做一次技能审查 (dentro de una frase) |
skills-audit skills-summarize-audit (enviados de forma independiente) | run skills-audit on this (dentro de una frase) |
技能总结 (enviado de forma independiente, vinculado con la marca summarize) | 总结一下技能 (dentro de una frase, no se activa) |
技能审计 深度 (palabra independiente + subcomando) | 这个项目需要能力审查吗 (dentro de una frase) |
Autoajuste de idioma: si el idioma principal del usuario es inglés (>70% de la conversación en inglés), la coincidencia de palabras de activación prioriza el inglés y el idioma del informe de salida cambia a en.
Cuándo usar / When to Use
- Modo auditoría de habilidades: Mantenimiento periódico de la salud del repositorio de habilidades (se recomienda cada 2-4 semanas), o después de cambios importantes en el repositorio. Se puede vincular con
总结: ejecutar summarize → descubrir acumulación de habilidades → sugerir技能总结 - Modo auditoría de proyectos: Para conocer rápidamente el stack tecnológico y las herramientas al hacerse cargo de un nuevo proyecto, o para evaluar la salud del entorno antes de una reestructuración.
- Traducción y refinamiento de palabras de activación: Traduce automáticamente la descripción de la habilidad a palabras de activación en chino + resumen (o viceversa), facilitando a usuarios multilingües la comprensión rápida de la funcionalidad de la habilidad.
Requisitos previos / Prerequisites
Requisitos estrictos (detección automática + guía de instalación si faltan)
- codegraph — Consulta de estructura de código y símbolos, motor de análisis central de la habilidad. Si falta, intenta instalarlo automáticamente.
- git — Comparación de versiones, instantáneas y deshacer. Si falta, intenta instalarlo automáticamente.
- config.yaml — Única fuente de configuración en el directorio de esta habilidad. Si falta, se genera a partir de una plantilla.
Requisitos flexibles (se crean automáticamente si faltan)
- user-profile.md — Perfil de usuario. Si falta, se crea automáticamente mediante preguntas guiadas.
Lista de capacidades / Capabilities
skills-summarize-audit proporciona las siguientes capacidades principales (v6.0.0 añade matriz de capacidades + señales de calidad + feed de comunidad + radar ecológico):
- Perfil del stack tecnológico del proyecto e identificación del tipo de proyecto
- Escaneo completo del repositorio de habilidades y lista incremental
- Construcción de matriz de dimensiones de capacidad (~12 dimensiones, v6.0.0)
- Lectura de señales de calidad (vinculado con el libro de contabilidad de errores de summarize, v6.0.0)
- Análisis de capacidad efectiva multifactorial y alerta temprana de capacidad
- 6 comprobaciones de actividad de habilidades
- Puntuación en siete dimensiones S/A/B/C/D con justificación obligatoria
- Verificación de actividad T3 y control de riesgo de archivado incorrecto
- Búsqueda en el feed de la comunidad (búsqueda en GitHub impulsada por lagunas de capacidad, v6.0.0)
- Recomendación de herramientas basada en complementariedad de capacidades (sustitución/complemento/suplemento/sin relación, v6.0.0)
- Bloque de radar ecológico (salida condicional, solo se muestra si hay problemas, v6.0.0)
- Lectura profunda de cada habilidad y verificación con fuentes externas
- Caché de señales externas y motor de recomendaciones de tres niveles
- Informe resumido de 30 segundos y comparación de tendencias
- Copia de seguridad instantánea y deshacer con
--undo - Modo sin interacción CI/CD y salida JSON con puerta de enlace
- Traducción y refinamiento de palabras de activación y verificación de calidad de descripciones
Tabla detallada de capacidades por fase de ejecución:
| Fase | Capacidad | Descripción |
|---|---|---|
| ⓪ Configuración | Autoajuste multiplataforma | Detección automática de plataforma Codex/Claude/Cursor/Coze |
| ① Perfil | Escaneo del stack tecnológico del proyecto | Identificación automática de 15+ tipos de proyecto (Web/Rust/Python/Go/Java...) |
| ② Lista | Escaneo completo del repositorio de habilidades + mapeo de capacidades | Escanea 4 rutas + mapeo con capability-dimensions.yaml (v6.0.0) |
| ②-bis | Análisis de capacidad | Cálculo de capacidad efectiva multifactorial (tokens + factor de conflicto + capacidad cognitiva) |
| ②-ter | Verificación de actividad | 6 comprobaciones para verificar si la habilidad es utilizable (accesibilidad del agente/MCP/comando/activación/datos/evidencia de uso) |
| ④ Puntuación | Puntuación en 7 dimensiones + señales de calidad | Puntuación en 7 dimensiones + lectura del libro de contabilidad de errores de summarize (v6.0.0) |
| ④-a | Verificación de actividad T3 | Verificación de evidencia de uso/marca de tiempo de modificación/registro de activación antes de archivar, reduciendo la tasa de archivado incorrecto |
| ④-bis | Lectura profunda | Lectura completa para S/A, completa para B (relacionado con el perfil), resumida para B (no relacionado) |
| ⑤a | Señales externas | Recopilación en caché de GitHub⭐/npm📥 |
| ⑤-aa | Feed de la comunidad | Búsqueda en GitHub impulsada por lagunas de capacidad (v6.0.0) |
| ⑤b | Motor de recomendaciones de matriz de capacidades | Recomendación basada en complementariedad de capacidades (sustitución/complemento/suplemento/sin relación, v6.0.0) |
| ⑥ | Generación de informe + radar ecológico | Resumen de 30 segundos + bloque de capacidad + tabla de puntuación + bloque condicional de radar ecológico (v6.0.0) |
| ⑦-a | Copia de seguridad instantánea | Copia de seguridad automática de todas las habilidades editables antes de la ejecución |
| ⑦-d | Deshacer operaciones | --undo para deshacer cualquier operación de ejecución, conserva instantáneas durante 7 días |
| CI | Auditoría sin interacción | Salida JSON + tres puertas de enlace (health/t3/actions), integración con GitHub Actions |
Cuándo NO usar / When NOT to Use
- Edición de archivos única, depuración en tiempo real, proyectos mínimos (sin dependencias de habilidades), solo se necesita instalar una habilidad
- Entornos de bajos recursos (la auditoría consume aproximadamente 5K-15K tokens/ejecución)
Flujo de ejecución
Después de la activación, lee primero
references/execution-flow.mdpara obtener el flujo completo, la tabla de puntuación, el cálculo de capacidad, la plantilla de informe y las reglas CI. El archivo principal solo conserva la entrada y las reglas clave.
⓪Configuración previa → ①Perfil del proyecto → ②Lista de habilidades+Recopilación de capacidad → **②-terVerificación de actividad**
→ ③Cargar datos de referencia → ④Puntuación por capas
→ ④-bisLectura profunda → ⑤Señales externas+Recomendaciones → ⑥Generar informe → ⑥-bisVerificación de auditoría → ⑦Ejecutar → ⑧Persistir
Reglas clave
- Perfil: Solo escanea el directorio actual. Extrae puntos débiles de las fuentes de datos, prohibido adivinar. El resultado se escribe en
{project}/.agents/project-profile.md - Capas: T1 (coincide con la actividad principal) → conservar; T2 (general) → conservar; T3 (especializado) → sugerir archivar
- Puntuación: Siete dimensiones S/A/B/C/D. Cada habilidad va acompañada de 1 frase de justificación; sin justificación = sin puntuación
- Capacidad: Calcula el límite superior que el Agente puede soportar. Se pueden cargar ≤1 → 🔴, 2-4 → 🟡, ≥5 → 🟢
- Señales externas: GitHub⭐ en caché durante 7 días, npm📥 en caché durante 30 días. Si la red no está disponible, se omite y se marca, prohibido falsificar.
- Recomendaciones: Cada una va acompañada de un índice de confianza (0-10) + ROI. <7 se marca como "en evaluación", <5 solo se recomienda con datos de respaldo.
- Ejecución: Solo modifica las habilidades a nivel de usuario (editable=true). Las habilidades del sistema son de solo lectura.
- Regla de oro: Al tratar con desarrollo/modificación/recomendación de habilidades, primero busca y verifica, cita ≥2 fuentes independientes.
- Verificación de actividad: La primera auditoría verifica todo. Las siguientes solo verifican las habilidades recién instaladas. El subcomando
深度fuerza la verificación completa. En caso de anomalías, se activa una biopsia de habilidad individual.
Ejemplo de salida
Al activar 技能审查, se emite primero un bloque de resumen de 30 segundos:
🟢 Salud del repositorio de habilidades: Buena
🛠️ Acciones clave: Actualizar 1 habilidad desactualizada, archivar 2 habilidades T3
💰 Ahorro estimado: ~3200 tokens/ejecución (reduce la inyección de habilidades de bajo valor)
Luego se emite un fragmento de tabla de puntuación (ejemplo):
| Habilidad | General | Fit (Ajuste) | Value (Valor) | Fresh (Actualidad) | Community (Comunidad) | ROI | Novelty (Novedad) | Contamination (Contaminación) | Sugerencia |
|---|---|---|---|---|---|---|---|---|---|
| codegraph | S | 5 | 5 | 4 | 4 | 5 | 5 | 5 | Conservar, herramienta central |
| old-linter | C | 2 | 2 | 2 | 3 | 2 | 2 | 4 | Sugerir archivar |
El formato completo del informe se encuentra en references/report-template.md.
Reglas de identificación de tipos de proyecto
Reglas de inferencia centrales (mapeo completo en references/project-types.yaml):
package.json→ Web/Node/FullstackCargo.toml→ Rust ·pyproject.toml→ Python ·go.mod→ Gopom.xml/build.gradle→ Java ·.csproj→ C# ·pubspec.yaml→ FlutterCMakeLists.txt→ C/C++ ·Gemfile→ Ruby- Múltiples
SKILL.md+MEMORY.md→Desarrollo de habilidades de agente de IA
Reglas de frontera (referencia rápida)
- Activación: Palabra independiente, no se activa dentro de una frase.
- Capas: T1/T2/T3 se basan únicamente en la "actividad principal" del perfil.
- Puntuación: Cinco niveles S/A/B/C/D. Con justificación obligatoria, sin justificación = sin puntuación.
- Análisis profundo: Lee el cuerpo completo del texto. Las lagunas deben verificarse con herramientas.
- Informe: Solo se emite si hay contenido. No hay valores predeterminados para áreas vacías.
- Recomendaciones: Con índice de confianza 0-10 + ROI. <5 no se recomienda, necesita datos de respaldo.
- Confirmación de ejecución: Las operaciones requieren confirmación del usuario. Las habilidades del sistema son de solo lectura.
- Regla de oro: Primero buscar y verificar, ≥2 fuentes.
Configuración de plataformas y CI/CD
Plataformas compatibles: platforms/zcode.yaml · platforms/workbuddy.yaml · platforms/claude.yaml · platforms/codex.yaml · platforms/cursor.yaml · platforms/default.yaml.
Modo CI (技能审查 --ci o skills-summarize-audit --ci o skills-audit --ci): Sin interacción, salida JSON, salta la lectura profunda, limitado por el presupuesto ci.max_tokens en config.yaml. Lógica de puerta de enlace: health=🔴 → exit_code=1 · actions_required>5 → exit_code=2 · t3_ratio>0.35 → exit_code=3. Plantilla de GitHub Actions en references/ci-github-actions.yml.
Escaneo de seguridad SkillSpector (opcional): config.yaml → security_scan habilitado, los resultados del escaneo se integran en la dimensión Value (Critical→D, High→C, Aprobado→+0.5 niveles). SkillSpector es un proceso externo, no consume tokens del agente.
Estructura de archivos
skills-summarize-audit/
├── SKILL.md # Archivo principal de la habilidad
├── VERSION # Número de versión
├── LICENSE # MIT
├── README.md # Resumen e instalación
├── config.yaml # Configuración de auditoría
├── platforms/ # Configuración de adaptación de plataforma
├── references/ # Documentos de referencia
│ ├── execution-flow.md # Índice del flujo de ejecución
│ ├── flow/ # Pasos detallados por fase (19 subarchivos)
│ ├── project-types.yaml # Mapeo de tipos de proyecto
│ ├── skill-registry.yaml # Registro de habilidades
│ ├── deep-analysis-template.md
│ ├── description-quality.md
│ ├── report-template.md
│ ├── ci-output-schema.md
│ ├── ci-github-actions.yml
│ └── recommendation-examples.md
├── tests/ # Suite de pruebas y scripts de validación
├── .data/ # Datos en tiempo de ejecución (registros/caché/estadísticas/perfiles/señales externas)
├── install.ps1 / install.sh # Scripts de instalación
└── CHANGELOG.md # Registro de cambios
Instalación
Para instalación con un solo clic e instalación manual, consulta references/installation.md (si no existe, consulta README.md).
Después de la instalación, ingresa 技能审查 o 技能总结 o skills-summarize-audit para activarlo (skills-audit aún es compatible).
Comentarios
Licencia
MIT — consulta el archivo LICENSE.