Sobre el proyecto

# Design-Agent — Espacio de trabajo del agente de diseño DSH Este es un **paquete reproducible completo de agente de diseño** basado en [DeepSeek Harness (DSH)](https://github.com/deepseek-ai/deepseek-harness), que incluye el preset `my-agent`, la habilidad de enrutamiento `design-references` (versión adaptada a DSH) y el plugin de herramientas deterministas `design-router`. El proyecto se construye actualizando el agente de diseño basado en HTML existente y adoptando la metodología de [design-references](https://github.com/haohaiHuang/my-pi-skills/tree/main/skills/design-references). > ⚠️ **Este paquete reproduce el mecanismo, no el contenido.** El enrutamiento, la disciplina y las herramientas están completamente autocontenidos (clonar → `cp -RL` → ejecutar). Pero la *biblioteca de referencias* es personal: varios recursos principales apuntan a `~/Desktop/Design/...` y `~/resources/design-references.md`, activos privados que no se incluyen en el repositorio. En una máquina nueva, estos se degradan a la cadena de respaldo (`web_search` + `dembrandt` + la disciplina característica integrada). Para un conjunto completo de referencias personales, copie esos directorios usted mismo; sin ellos, este paquete sigue funcionando como un agente de diseño de "disciplina característica + investigación web". ## Contenido incluido | Componente | Rol | | --- | --- | | [`plugins/design-router/`](plugins/design-router/) | Plugin Cordis de herramientas deterministas (6 herramientas de solo lectura + 1 escritor de registros local, sin dependencias de runtime externas) | | [`presets/my-agent/`](presets/my-agent/) | Preset de agente DSH (`agent.cordis.yml` + `preset.yml`): rol de enrutamiento de tres capas (etapa → rama → etapa) con puertas de confirmación por etapa | | [`skills/design-references/`](skills/design-references/) | Habilidad de enrutamiento por etapa/rama (derivación de etapa → producto A / contenido B / general C → cinco etapas), versión adaptada a DSH | | [`skills/hallmark/`](skills/hallmark/) | Habilidad de ejecución anti-contenido basura de IA (copia MIT de [nutlope/hallmark](https://github.com/nutlope/hallmark); los tokens de tema y ejemplos de `site/` están integrados en la habilidad, autocontenidos) | > **Requisito de versión DSH: `0.1.5-rc.1` o superior.** El modo de plugin de roles cambió en 0.1.5 (`text` → `prefix` + `suffix`); los presets que aún usan `text:` no se montan y fallan con `$.prefix missing required value`. El preset de este repositorio se basa en el modo 0.1.5 y usa dos líneas introducidas en 0.1.5: `present` (`dsh-tool-present`, declaración de entrega) y `command-goal` (comando `/goal`). ## plugins/design-router — Herramientas deterministas Portado desde `extensions/design-router` de [my-pi-skills](https://github.com/haohaiHuang/my-pi-skills) (extensión pi → plugin Cordis DSH). Lo monta el preset `my-agent` mediante una **línea de ruta relativa** en `agent.cordis.yml` (el `plugins/` del preset es un enlace simbólico relativo al `plugins/` de la raíz del repositorio, expandido con `cp -RL` en la instalación — sin rutas absolutas): ```yaml - id: design-router name: './plugins/design-router/index.mjs' ``` ### Herramientas | Herramienta | Uso | Etapa | | --- | --- | --- | | `design_lookup <branch> <stage>` | Consulta el registro de recursos de diseño (índice 3-D R/C/E/V + cadena de respaldo + fuentes; genera cubos de estilo etiquetados) | "¿Qué debo consultar en este paso?" | | `design_route <need>` | Mapea palabras clave de necesidad a combinaciones de cubos de estilo recomendadas (principal obligatorio + secundario según demanda) + recursos representativos por cubo | Etapa 1 investigación (enrutamiento anti-homogeneización) | | `design_diversity <c1> <c2> <c3>` | Verificación automática de diferencias entre 3 candidatos (familia de tono / tono tipográfico / cubo de fuente), aprobado/rechazado | Etapa 1 antes de presentar candidatos (verificación anti-homogeneización) | | `design_quality <report\|query>` | Registra/consulta señales de calidad de fuente (tasa de extracción exitosa / tasa de retrabajo / accesibilidad — objetivo, no basado en gusto); registro local, no en git | Registro después de etapa 4 / consumo descendente en etapa 1 | | `design_audit <target>` | Puerta de basura automática (subconjunto automático de hallmark) + reglas de interfaz CS-* 8 + escaneo de etapa 4 + comparación de herencia | Verificación de etapa 4 | | `design_contrast <target>` | Contraste aproximado WCAG 2.1 + APCA | Verificación de etapa 4 | ### Diferencias intencionales con la versión pi - **Eliminado** `design_research` (DSH usa ledger-grep + sondas refero + cadena de respaldo `web_search`) - **Eliminado** `hallmark_study_fetch` (DSH usa `dembrandt` / `defuddle` en su lugar) - **Eliminado** la inyección `before_agent_start` y el comando `/design-router` (el mecanismo de carga de habilidades de DSH ya cubre el enrutamiento) - **Sin dependencia de `@deepseek-ai/dsh-tools`** (los módulos del espacio de trabajo no pueden resolver el directorio de instalación de dsh); las definiciones de herramientas usan JSON Schema puro — cero dependencias de runtime externas ### Diseño ``` plugins/design-router/ ├── index.mjs # Entrada del plugin: registra 6 herramientas (5 de solo lectura + 1 escritor de registros local) ├── checks/ # Verificadores portados (TS→JS): tipografía/diseño/accesibilidad/copia/contraste/trampa/mata-basura/activos/tipos │ └── kill-slop.test.mjs # Pruebas de regresión KS-* (node checks/kill-slop.test.mjs) └── data/ └── registry.json # Forma de datos de registry.md (91 recursos × 9 enrutamientos de rama) ``` ### Cobertura de puertas automáticas `design_audit` ejecuta siete módulos verificadores y devuelve una lista de pendientes con números de puerta: | Familia | Puertas | Fuente | | --- | --- | --- | | Basura Hallmark | 1/2/10/14/19/24/26/27/30/33/34/37/38a/39/40/41/46/47/50/51 | hallmark `slop-test.md` (subconjunto automático) | | Interfaz CS-* | CS-1…CS-8 | Hoja de referencia interfaces.dev | | Movimiento EM-* | EM-2/3/5 (EM-1/7/8 mapeados a puertas 10/14/27) | emilkowalski/skills | | kill-ai-slop KS-* | KS-03/04/05/08/14 | Transcripción kill-ai-slop | | Capa de activos DR-A* | DR-A1/DR-A2 | Puertas de capa de activos Anshu (existencia de marca/imágenes) | | design-references etapa 4 | DR-4 (peso de fuente/radio de esquina sobreespecificados) | design-references workflow.md | ### Mantenimiento - `registry.md` es la **fuente de verdad** (`~/.agents/skills/design-references/references/registry.md`); tras editarlo, ejecute `node plugins/design-router/scripts/build-registry.mjs` para regenerar `data/registry.json` (+ metadatos de versión `data/manifest.json`). **Nunca edite registry.json manualmente.** - La lógica de los verificadores sigue el `extensions/design-router/checks/` ascendente (portado TS→MJS); tras actualizaciones ascendentes, ejecute `node plugins/design-router/scripts/check-checks-sync.mjs /path/to/my-pi-skills/extensions/design-router/checks` para validar la cobertura de puertas — **luego compare manualmente las constantes de los verificadores**: la equivalencia de números de puerta no captura la deriva de detalles (por ejemplo, la lista de fuentes predeterminadas extendida). Las pruebas de regresión KS capturan ese tipo de deriva. - Tras cualquier cambio en verificadores: `node index.test.mjs` y `node checks/kill-slop.test.mjs`. ### Estructura del repositorio ``` ├── plugins/design-router/ # Plugin de herramientas deterministas (6 herramientas, cero dependencias de runtime) ├── presets/my-agent/ # Preset DSH (agent.cordis.yml + preset.yml) ├── skills/ │ ├── design-references/ # Habilidad de enrutamiento (versión adaptada a DSH) │ └── hallmark/ # Habilidad anti-basura de IA (copia MIT ascendente, con activos de tema site/) ├── README.md # Inglés (principal) └── README.zh.md # Chino ``` ## Contenido de terceros y atribución de licencias Este repositorio incluye el siguiente contenido de terceros (se conservan licencias/atribuciones ascendentes): | Contenido | Fuente | Licencia | Ubicación | | --- | --- | --- | --- | | Habilidad hallmark + tokens de tema y ejemplos de `site/` | [nutlope/hallmark](https://github.com/nutlope/hallmark) | MIT (texto completo en [`skills/hallmark/LICENSE`](skills/hallmark/LICENSE)) | `skills/hallmark/` | | Recursos de diseño externos referenciados en el registro (kami/zine/logo-generator, etc.) | Repositorios ascendentes respectivos | Solo referencia de enlace (no incluidos; URL de fuente en [`registry.md`](skills/design-references/references/registry.md)) | — | Todo lo demás (`plugins/`, `presets/`, `skills/design-references/`) es original de este repositorio, bajo [licencia MIT](LICENSE) (copyright © 2026 haohaiHuang). ## Proyectos relacionados - [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) — Infraestructura para ejecutar este paquete (`dsh`, todo es un plugin) - [my-pi-skills](https://github.com/haohaiHuang/my-pi-skills) — Repositorio de habilidades ascendente (design-references / skill-router / vision) - [awesome-dsh-plugin](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin) — Lista curada de plugins DSH