kl-autonomous/agent-team-skills

Escritorio del propietario

Las preguntas en el chat se entierran, y el propietario tiene que responder cuando el agente pregunta, no cuando tiene tiempo. El escritorio las saca del chat y las coloca en un tablero: una pestaña Te necesita con cada elemento abierto, una pestaña Urgente amarilla solo cuando algo no puede esperar, una pestaña Decidido para los respondidos, una pestaña Después para lo que puede esperar, y un Archivo para lo terminado. En un teléfono o iPad, el propietario desliza lateralmente para moverse entre pestañas. El propietario responde allí; tú lees las respuestas, actúas y archivas.

Lo que necesita

• Artefactos de Claude con las capacidades db y comments, en claude.ai o en la aplicación de escritorio de Claude. Añade assets solo si los elementos llevarán archivos adjuntos.

• Herramientas:

  • Artifact, para publicar el tablero y subir archivos;
  • ArtifactData, para escribir y leer elementos;
  • ArtifactComments, para vigilar el tablero y responder a los comentarios que te despiertan.

  Cárgalas con ToolSearch cuando estén diferidas.

• Una sesión de bucle principal. Solo una sesión de bucle principal puede mantener una vigilancia; un subagente no puede.

Sin esto, dilo y mantén las preguntas en el chat como una lista numerada. No finjas que hay un tablero.

Quién escribe en él

Una sola sesión:

• el jefe de personal, si lo hay (ver el skill de jefe de personal);
• en caso contrario, la sesión que trabaja con el propietario.

Dos escritores numerarían los elementos dos veces y archivarían el trabajo del otro.

Crear el tablero

1. Rellena la plantilla, assets/desk.html. Tiene tres marcadores de posición:

   • {{TITLE}}: el nombre del tablero, de dos a cuatro palabras, como "Escritorio de la App de Recetas";
   • {{EYEBROW}}: una pequeña línea sobre el título, como "App de recetas · desde el jefe de personal";
   • {{AGENT}}: quién lee las respuestas, tal como se lee en medio de una frase: "el jefe de personal", o "Claude". Solo palabras simples, sin comillas.

   Por ejemplo:

   sed -e 's/{{TITLE}}/Escritorio de la App de Recetas/g' -e 's/{{EYEBROW}}/App de recetas · desde el jefe de personal/g' -e 's/{{AGENT}}/el jefe de personal/g' <skill>/assets/desk.html > desk.html
   

2. Publícalo con la herramienta Artifact:

   • capabilities: {"db": {}, "user": {}, "comments": {}}, más "assets": {} si los elementos llevarán archivos;
   • icon: "inbox";
   • una description de una línea.

   Publicar también inicia la vigilancia de esta sesión sobre el tablero.

3. Verifícalo una vez: ArtifactData list en la colección items. Está vacío, y la página dice "Nada te necesita."

4. Dale al propietario el enlace, y di que el tablero es privado para él.

5. Escribe el enlace en un archivo del proyecto (la página de estado, o las notas del proyecto), para que una sesión nueva pueda encontrarlo.

Abierto fuera de Claude, en un navegador normal, la página muestra elementos de ejemplo ficticios con una nota que lo indica. Eso es para vistas previas y capturas de pantalla; nunca escribe nada.

Ser despertado por respuestas

Una escritura en la base de datos no te despierta; un comentario enviado a Claude sí. Cuando el propietario responde, marca una tarea como hecha o hace una pregunta, la página envía un comentario corto en el hilo del elemento, por ejemplo "N.º 12 · ¿Abrimos la beta este viernes? Respuesta: Sí". Ese comentario despierta a la sesión que vigila el tablero.

• Publicar inicia la vigilancia, pero solo es una vigilancia una vez que ArtifactComments watch (sin url) lista el tablero como conectado, con respuestas automáticas armadas.
• Una sesión nueva debe vigilar de nuevo, con ArtifactComments watch y la url del tablero. Las respuestas automáticas se arman solo cuando el propietario dio ese enlace en su propio mensaje, por lo que el enlace va en el mensaje de reinicio que el propietario pega.
• La página le dice al propietario en qué caso se encuentra: "…se le informa en el momento en que respondes", o "Guardado aquí; … lo lee en su próxima revisión".
• Si los comentarios no pueden alcanzarte (están desactivados, o ninguna sesión está vigilando), recurre a esto:
  • lee el escritorio al inicio de cada turno;
  • pide al propietario que diga "escritorio" en el chat después de responder;
  • ofrece una revisión programada, solo si el propietario la quiere.

Un elemento

Cada elemento es un documento en la colección items. Su id de documento es su identificador: usa q<número> para decisiones y t-<palabra> para tareas. Usa palabras simples en todo momento, ya que el propietario puede leerlo en un teléfono.

Campo	Escrito por	Qué contiene
kind	tú	"decision" o "task"
status	ambos	"open"; la página establece "answered"; tú estableces "archived"
later	tú	true lo aparca en la pestaña Después
urgent	tú	true lo pone en una pestaña Urgente amarilla y al principio de la Vista General. Solo para lo que no puede esperar: una fecha límite hoy, o algo roto para los usuarios
num	tú	un número correlativo, el mismo que usas en el chat; nunca reutilizado
title	tú	la pregunta en sí, que se puede responder con las opciones, o la tarea como una acción
body, bullets	tú	párrafos cortos y puntos: por qué importa, qué afecta
recommendation	tú	tu respuesta primero, luego la razón, en una o dos frases
choices	tú	de dos a cuatro respuestas; por defecto Sí / No
steps, stepsDone	tú; página	los pasos de una tarea, y los marcados (índices)
copies	tú	[{label, text}]: texto que el propietario pegará en algún lugar
links	tú	[{label, url, note}]: guías, páginas, archivos adjuntos
from	tú	qué sesión preguntó
priority	tú	1 primero; ordena los elementos abiertos
created	tú	cuándo lo publicaste (hora ISO)
answer	página	{choice, note, at}
asks	página; tú	[{q, at, via, a, aAt}]: las preguntas del propietario sobre el elemento; tú rellenas a y aAt
thread	página	el hilo de comentarios que la página usa para este elemento; déjalo en paz
outcome, archived	tú	qué pasó, en una línea; cuándo lo archivaste

assets/example-items.json contiene siete elementos ficticios, tal como los escribe ArtifactData batch. Úsalos para probar un tablero, nunca en el tablero real del propietario.

Publicar elementos

• Añade nuevos elementos con ArtifactData. Usa set para un documento nuevo, y batch para más de dos. Nunca republices la página para cambiar elementos.
• Luego di en el chat lo que añadiste, con un enlace a cada elemento: <url del tablero>#<id del doc> abre su pestaña y se desplaza hasta él.
• Si también trabajas desde una lista de chat de preguntas abiertas (como hace el jefe de personal), mantén ambas igual: el mismo número, las mismas palabras.
• Escribe cada elemento para que se sostenga por sí mismo: qué se está decidiendo, qué cambia en cada caso, y qué recomiendas.
• Una tarea enumera los pasos exactos, el texto para pegar en copies, y la guía en links.
• Para adjuntar un archivo: lee el archivo completo primero, luego súbelo con Artifact (url del tablero, asset: true) y enlázalo como /_blob/<id del asset>.
• Nunca pongas contraseñas, claves o registros privados en un elemento. Una tarea que necesita un secreto dice dónde escribirlo, nunca qué es.

Leer, actuar, archivar

Cuando un comentario te despierte, o al inicio de un turno:

1. ArtifactData query en items con where: [["status", "==", "answered"]]. Lee el answer de cada elemento y cualquier asks nuevo.
2. Actúa según la respuesta. Con un jefe de personal, transmite la elección y nota del propietario textualmente a la sesión que preguntó.
   • El comentario y el elemento normalmente coinciden.
   • Si el elemento no está guardado como respondido, pero el comentario lleva una respuesta, el comentario es la palabra más reciente del propietario. Escríbelo tú mismo en el elemento.
3. Archiva el elemento: update con status: "archived", un outcome de una línea ("El constructor movió la beta al viernes"), y archived (la hora). Fija cada escritura con if_version, para que una respuesta que el propietario cambie mientras tanto no sea sobrescrita.
4. Responde a cada entrada abierta en asks en el mismo elemento. Envía el array completo asks de vuelta, con a y aAt rellenos, fijado con if_version.
5. Responde en el hilo de comentarios con una línea ("Entendido: moviendo la beta al viernes"), luego resuelve el hilo (ArtifactComments reply, luego resolve).

Aparca un elemento con later: true, y tráelo de vuelta con later: false. Un elemento decidido puede quedarse en Después hasta que sea momento de actuar sobre él. Archiva en lugar de eliminar: el Archivo es el registro de lo que se decidió. Elimina solo si el propietario lo dice.

Estado y Hoja de ruta (opcional)

Dos pestañas más muestran al propietario dónde está el proyecto, entre la Vista General y los elementos. Cada una aparece una vez que escribes su documento en la colección board, y se actualiza en vivo. Escribe cada una con ArtifactData (set la primera vez, luego update fijado con if_version). assets/example-board.json contiene un par ficticio.

board/status: dónde está cada sesión. Actualízalo cada vez que verifiques al equipo; un jefe de personal lo escribe cada vez que actualiza su página de estado.

Campo	Qué contiene
updated	cuándo verificaste por última vez (hora ISO); la página muestra hace cuánto tiempo
oneLine	dónde está el proyecto, en una frase
sessions	[{name, state, doing, last, restart}], una fila por sesión. state es una o dos palabras ("Trabajando", "Esperando", "Detenido en un límite"), y la página lo colorea. restart comienza con "Sí" cuando es un buen momento para reiniciar esa sesión
done	qué terminó desde la última actualización, una línea cada uno
next	[{who, what}]: los próximos pasos, también los del propietario (who: "you")

La pestaña Estado cuenta los elementos urgentes y abiertos del propietario por sí misma; no los repitas en oneLine.

board/roadmap: el plan, etapa por etapa. Actualízalo cuando una etapa o uno de sus elementos se mueva.

Campo	Qué contiene
updated	cuándo lo cambiaste por última vez
headline	dónde está el proyecto en su plan, en una frase
stages	[{id, name, state, when, summary, items}], en orden. state es done, now, next o later; items son [{text, state}] con done, now o next. La etapa marcada now se abre al principio

Cambiar la página

• Republica la página solo para cambiar la página en sí. Pasa las mismas capacidades, u omite capabilities para mantenerlas.
• Si otra sesión publicó el tablero, léelo primero (Artifact read) y construye sobre lo que devuelve.
• Los elementos viven en la base de datos, por lo que sobreviven a una republicación.