AgentSkillsCN

project-evolution-triage

在项目近期进展的基础上，以结构化的方式判断：是应当创建一项长期可用的技能，还是开发一款确定性的内部工具，亦或是暂时无需采取任何行动。当需要开展审查、审计、架构验证、标准制定、自动化准备，或定义可复用的技术文档时使用，同时支持generic、coolify、k8s与production等环境配置。

SKILL.md
--- frontmatter
name: project-evolution-triage
description: Analiza el estado reciente de un proyecto y decide de forma estructurada si conviene crear una skill permanente, una herramienta interna determinística o no crear nada todavía. Úsala cuando se pidan acciones de revisión, auditoría, validación arquitectónica, generación de estándares, preparación de automatizaciones o definición de memoria técnica reusable por meses, con soporte de perfiles de entorno generic, coolify, k8s y production.
version: 1.0.0

project-evolution-triage

Sigue este flujo de forma estricta:

  1. •Ejecuta el análisis determinístico:
bash
python .agents/skills/project-evolution-triage/scripts/main.py --root . --source inst.md --mode generic
  1. •Usa --mode para aplicar perfil de entorno sin hardcodear infraestructura:
bash
python .agents/skills/project-evolution-triage/scripts/main.py --root . --source inst.md --mode coolify
python .agents/skills/project-evolution-triage/scripts/main.py --root . --source inst.md --mode k8s
python .agents/skills/project-evolution-triage/scripts/main.py --root . --source inst.md --mode production
  1. •Interpreta la salida JSON para construir la respuesta final:
  • •phase0: resumen reciente y extracción de patrones.
  • •decision: opción única A, B o C con justificación.
  • •scope: alcance y perfiles aplicables.
  • •warnings: advertencias críticas.
  • •next_actions: pasos ejecutables.
  1. •Si decision es A, crea la skill en .agents/skills/<skill_name>/ usando este estándar:
  • •SKILL.md con frontmatter YAML y comandos relativos.
  • •scripts/main.py con argparse, validación de entradas, --mode, sys.exit(0|1).
  • •Ejecuta prueba real y reporta evidencia.
  1. •Si decision es B, define herramienta interna como núcleo determinístico:
  • •tipo, entradas, salidas, lógica, prioridad, necesidad de LLM.
  • •implementa CLI mínimo funcional si el contexto lo permite.
  • •ejecuta ejemplo real y reporta evidencia.
  1. •Si decision es C, explica por qué no estandarizar todavía y qué evidencia falta.

Formato de salida esperado

En éxito:

  • •JSON válido en stdout con llaves phase0, decision, scope, warnings, next_actions, evidence.
  • •Código de salida 0.

En error:

  • •Mensaje claro en stderr indicando el problema exacto (ruta inválida, fuente faltante, modo inválido).
  • •Código de salida 1.