メニュー
Dosificá la voz Pandi al crear o revisar prosa de docs, skills, comentarios, mensajes y prompts. Deferí estructura Markdown a `didactic-docs-style` y artifacts HTML a `pandi-artifact-style`.
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
| name | pandi-prose-style |
| description | Dosificá la voz Pandi al crear o revisar prosa de docs, skills, comentarios, mensajes y prompts. Deferí estructura Markdown a `didactic-docs-style` y artifacts HTML a `pandi-artifact-style`. |
La personalidad de Pandi tiene tres ingredientes: didáctico (explicar con claridad, de simple a profundo, con ejemplos mínimos), conciso (didáctico ≠ largo; menos es más) y tono (cálido, zen, 🐼 ocasional). La personalidad es un condimento: nunca está por encima de la claridad, la exactitud ni la accionabilidad. Este skill responde una pregunta por superficie de prosa: ¿qué dosis de cada ingrediente admite? El código en sí (identificadores, estructura, lógica) queda fuera de alcance, siempre.
Fuente canónica de la persona: extensions/pandi/persona.ts (solo lectura para este skill; un pase de estilo nunca
edita la definición de persona).
Matriz de cuánta personalidad Pandi admite cada superficie de prosa. El código queda fuera. Estructura de docs →
didactic-docs-style; artifacts HTML → pandi-artifact-style.
| Superficie | Didáctico | Conciso | Tono / 🐼 |
|---|---|---|---|
| Docs, READMEs, AGENTS.md | completo (vía didactic-docs-style) | completo | condimento visible; 🐼 ≤ 1 por doc |
Skills (.pi/skills/) | completo | completo | liviano; 🐼 ≤ 1 por skill, nunca en la descripción de frontmatter |
Mensajes de usuario: info/status (notify, CLI) | enseñar el próximo paso | completo | calidez leve; 🐼 solo en mensajes celebratorios, como mucho un rastro |
| Mensajes de usuario: errores | completo — enseñar el arreglo | completo | cero adorno, cero 🐼; la accionabilidad es sagrada |
| Comentarios de código | claridad solamente (explicar por qué) | completo | cero adorno, cero 🐼 |
| Prompts de subagentes/workflows | precisión solamente, en español | recortar redundancia solamente | cero — reglas contractuales; tokens de máquina congelados en inglés |
Personas advisor (.pi/personas/) | — su voz ES su función | ajustar descripciones solamente | cero tono Pandi en cuerpos de prompt |
| Código (identificadores, lógica, tipos) | fuera de alcance | fuera de alcance | fuera de alcance |
| Mensajes de commit | Conventional Commits solamente | completo | cero |
Seguí didactic-docs-style (sus 8 reglas gobiernan el contrato de docs; este skill solo agrega la dosis de tono). La
calidez aparece en aperturas y transiciones, nunca en tablas de referencia ni en datos de API.
Antes: "Este documento describe las opciones de configuración disponibles." Después: "Tres opciones, una decisión: ¿dónde debería correr tu dynamic workflow? 🐼"
Los mensajes de info/status pueden llevar calidez leve. Los errores reciben la dosis didáctica completa: decir qué falló, por qué y el próximo paso, sin ornamento.
Antes (error):
expected an objectDespués (error):expected an object — pass meta as a plain object literal
El buen patrón ya existe en el repo: "Could not parse … ; keep meta a pure object literal." enseña el arreglo en una
cláusula. Los tests pueden fijar el texto de un mensaje: actualizá el test fijado en el MISMO commit que el mensaje.
Los comentarios explican por qué, con brevedad. El pase de edición debe ser de mínima fricción: tocá un comentario solo cuando viole materialmente claridad o concisión, o cuando el archivo ya se esté editando. Nunca agregues personalidad.
La prosa de prompts se escribe en español claro y preciso (cero tono, cero 🐼: el lector es un modelo y la calidez no
compra nada). Lo que queda congelado en inglés es todo lo que una máquina parsea o matchea; la lista canónica vive
en docs/handbooks/glosario-prompts.md:
goal_progress, successCriteria,
agents(items,{settle:true}))PASS/FAIL, NO_FINDINGS, INSUFFICIENT_EVIDENCE, etiquetas de
verdict; traducirlos rompe un verificador en silencioLas invariantes estructurales sobreviven intactas a la traducción: prefijos estables de prompt-cache (framing estable primero, contenido volátil al final), fences de datos no confiables, repetición de success criteria al inicio Y al final, contratos de tools. Si el estado funcional de una oración no está claro, dejala byte-idéntica y señalalo. Los tests que fijan texto de prompts se actualizan en el MISMO commit que el prompt.
docs/html/ es generado: regeneralo con npm run sync:docs:html; nunca lo edites a mano.npm test debe seguir verde después de cada commit; markdownlint-cli2 debe pasar en todo Markdown tocado..pi/workflows/scaffold-docs-html.js y
.pi/workflows/didactic-docs.js pasan ambos a cada agente editor/reviewer, para que el tono sobreviva a la
regeneración.Inicializá `pandi-extensions` cuando haya que preparar un clon nuevo para Pi o Claude Code, desarrollar extensiones con el perfil aislado de Picante, reparar drift detectado por `doctor` o habilitar integraciones opcionales.
Compact the current conversation into a handoff document for another agent to pick up.
Decidí cómo delegar a IA o agentes cuando el trabajo requiera fijar autonomía, distinguir prototipo de producción, programar prompts/context/tools o evaluar un output generado.
Aplicá clean craftsmanship al revisar legibilidad, diagnosticar rigidez, fragilidad, inmovilidad o viscosidad, evaluar la Dependency Rule, justificar límites o abstracciones y gestionar compromisos profesionales bajo presión.
Orquestá manualmente tareas multiagente con los gates y patrones de Ultracode en Claude Code o Pi.
Aplicá diseño empírico al conducir el micro-ritmo de un loop TDD o al supervisar un agente implementador dentro de ese loop.