design-agent

# Design-Agent — Espace de travail Agent de conception DSH Il s'agit d'un **package complet et reproductible** pour un Agent de conception basé sur [DeepSeek Harness (DSH)](https://github.com/deepseek-ai/deepseek-harness). Il intègre le preset `my-agent`, la compétence de routage `design-references` (adaptée à DSH) et le plugin d'outil déterministe `design-router`. Ce projet améliore les agents de conception basés sur HTML existants en adoptant la méthodologie [design-references](https://github.com/haohaiHuang/my-pi-skills/tree/main/skills/design-references). > ⚠️ **Ce package reproduit les mécanismes, pas le contenu.** Le routage, la discipline et les outils sont entièrement autonomes (cloner → `cp -RL` → exécuter). Cependant, la *bibliothèque de référence* est personnalisée : plusieurs ressources principales pointent vers `~/Desktop/Design/...` et `~/resources/design-references.md`, ces actifs privés n'étant pas fournis avec le dépôt. Sur une nouvelle machine, ils seront dégradés vers une chaîne de repli (`web_search` + `dembrandt` + discipline intégrale intégrée). Pour un ensemble de références personnelles complet, veuillez copier ces répertoires vous-même ; sans eux, ce package fonctionne toujours comme un agent de conception "discipline intégrale + recherche web". ## Contenu inclus | Composant | Rôle | | --- | --- | | [`plugins/design-router/`](plugins/design-router/) | Plugin Cordis d'outil déterministe (6 outils en lecture seule + 1 écriture de journal local, zéro dépendance d'exécution externe) | | [`presets/my-agent/`](presets/my-agent/) | Preset Agent DSH (`agent.cordis.yml` + `preset.yml`) : rôle de routage à trois niveaux (phase → branche → phase) avec portes de confirmation par phase | | [`skills/design-references/`](skills/design-references/) | Compétence de routage phase/branche (déroutement de phase → A Produit / B Contenu / C Général → cinq phases), version adaptée à DSH | | [`skills/hallmark/`](skills/hallmark/) | Compétence d'exécution anti-contenu généré par IA (copie amont MIT de [nutlope/hallmark](https://github.com/nutlope/hallmark) ; jetons de thème `site/` et exemples intégrés dans la compétence, autonome) | > **Exigence de version DSH : `0.1.5-rc.1` ou supérieure.** Le mode des plugins de rôle a changé dans la version 0.1.5 (`text` → `prefix` + `suffix`) ; les presets utilisant encore `text:` ne se monteront pas en raison de `$.prefix missing required value`. Les presets de ce dépôt sont basés sur le mode 0.1.5 et utilisent les deux lignes introduites en 0.1.5 : `present` (`dsh-tool-present`, déclaration de livraison) et `command-goal` (`/goal` commande). ## plugins/design-router — Outils déterministes Porté depuis `extensions/design-router` de [my-pi-skills](https://github.com/haohaiHuang/my-pi-skills) (extension pi → plugin Cordis DSH). Monté par le preset `my-agent` via une **ligne de chemin relatif** dans `agent.cordis.yml` (le `plugins/` du preset est un lien symbolique relatif vers le `plugins/` racine du dépôt, développé lors de l'installation via `cp -RL` — aucun chemin absolu requis) : ```yaml - id: design-router name: './plugins/design-router/index.mjs' ``` ### Outils | Outil | Usage | Phase | | --- | --- | --- | | `design_lookup <branche> <phase>` | Interroger le registre des ressources de conception (index 3D R/C/E/V + chaîne de repli + source ; sortie par seaux de style) | "Que dois-je consulter à cette étape ?" | | `design_route <besoin>` | Mapper les mots-clés de besoin aux combinaisons de seaux de style recommandées (principales obligatoires + secondaires au besoin) + ressources représentatives par seau | Phase 1 Recherche (routage anti-homogénéisation) | | `design_diversity <c1> <c2> <c3>` | Vérification machine de la diversité de 3 candidats (famille de teintes / tonalité de police / seaux de source), passage/échec | Avant présentation des candidats en phase 1 (vérification anti-homogénéisation) | | `design_quality <report\|query>` | Enregistrer/interroger les signaux de qualité des sources (taux d'extraction réussi / taux de refonte / accessibilité — objectif, non orienté goût) ; journal local, non inclus dans git | Enregistrement post-phase 4 / consommation décroissante phase 1 | | `design_audit <cible>` | Porte anti-gabarit machine (sous-ensemble intégral machine) + 8 règles CS-* interface + scan phase 4 + héritage comparatif | Vérification phase 4 | | `design_contrast <cible>` | Approximation contraste WCAG 2.1 + APCA | Vérification phase 4 | ### Différences intentionnelles avec la version pi - **Supprimé** `design_research` (DSH utilise ledger-grep + sondes refero + chaîne de repli `web_search`) - **Supprimé** `hallmark_study_fetch` (DSH utilise `dembrandt` / `defuddle` à la place) - **Supprimé** injection `before_agent_start` et commande `/design-router` (le mécanisme de chargement des compétences DSH couvre déjà le routage) - **Ne dépend pas de** `@deepseek-ai/dsh-tools` (les modules d'espace de travail ne peuvent pas résoudre le répertoire d'installation dsh) ; les définitions d'outils sont construites avec JSON Schema pur — zéro dépendance d'exécution externe ### Structure ``` plugins/design-router/ ├── index.mjs # Point d'entrée du plugin : enregistre 6 outils (5 en lecture seule + 1 écriture de journal local) ├── checks/ # Checkers portés (TS→JS) : typographie/mise en page/accessibilité/copy/contraste/triche/tuer-gabarit/actifs/types │ └── kill-slop.test.mjs # Tests régressifs KS-* (node checks/kill-slop.test.mjs) └── data/ └── registry.json # Forme de données de registry.md (91 ressources × 9 branchements de routage) ``` ### Couverture des portes machines `design_audit` exécute sept modules de checker et renvoie une liste de tâches avec numéros de porte : | Famille | Porte | Source | | --- | --- | --- | | Gabarit 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` (sous-ensemble machine) | | Interface CS-* | CS-1…CS-8 | Tableau de bord interfaces.dev | | Animation EM-* | EM-2/3/5 (EM-1/7/8 mappés aux portes 10/14/27) | emilkowalski/skills | | kill-ai-slop KS-* | KS-03/04/05/08/14 | Transcription kill-ai-slop | | Couche actifs DR-A* | DR-A1/DR-A2 | Portes couche actifs Anshu (existence logo/image marque) | | design-references phase 4 | DR-4 (sur-spécification graisse de caractère/bords arrondis) | design-references workflow.md | ### Maintenance - `registry.md` est la **source de vérité** (`~/.agents/skills/design-references/references/registry.md`) ; après édition, exécutez `node plugins/design-router/scripts/build-registry.mjs` pour régénérer `data/registry.json` (+ métadonnées de version `data/manifest.json`). **Ne jamais éditer registry.json manuellement.** - La logique des checkers suit l'amont `extensions/design-router/checks/` (portage TS→MJS) ; après mises à jour amont, exécutez `node plugins/design-router/scripts/check-checks-sync.mjs /path/to/my-pi-skills/extensions/design-router/checks` pour vérifier la couverture des portes — **puis comparez manuellement les constantes des checkers** : l'équivalence des numéros de porte ne capture pas les dérives de détails (par exemple, la liste de polices par défaut étendue). Les tests régressifs KS capturent ce type de dérive. - Après tout changement de checker : `node index.test.mjs` et `node checks/kill-slop.test.mjs`. ## Reproduction ponctuelle (nouvelle machine) Le dépôt reproduit les **mécanismes** : plugin + preset + compétences adaptées à DSH sont tous dans le dépôt (le *contenu* de la bibliothèque de référence est personnalisé — voir avertissement ci-dessus). ```bash # ── Fourni avec le dépôt (cloner → exécuter)── # 1. Compétences (design-references est la version adaptée DSH ; hallmark est la copie amont MIT) cp -R skills/design-references ~/.agents/skills/ cp -R skills/hallmark ~/.agents/skills/ # 2. Preset (cp -RL développe les liens symboliques de plugins relatifs dans presets/my-agent/ en copies autonomes — # après installation, le preset ne dépend plus des chemins du dépôt, peut être librement copié ou migré) mkdir -p ~/.dsh/.agent-presets cp -RL presets/my-agent ~/.dsh/.agent-presets/ # 3. Code source du plugin (conservé sous plugins/ à la racine du dépôt pour la gestion git) # Le preset fait référence via le chemin relatif './plugins/design-router/index.mjs' : # presets/my-agent/plugins est un lien symbolique relatif vers plugins/ racine du dépôt, # cp -RL le développe en répertoire réel — aucune édition de chemin requise sur n'importe quelle machine. # 4. Dépendances externes (dépendances douces — dégradation élégante si manquantes) npm install -g dembrandt # URL → jetons de conception (validation candidat phase 1) # defuddle: npm install -g defuddle # npm install -g @open-pencil/cli # Optionnel : lire/converter/valider fichiers de conception .fig/.pen (repli vers compétences famille Figma / revue manuelle) # ── À apporter (choix personnel ; dégradation vers chaîne de repli si manquant)── # 5. Actifs locaux machine (ledger + bibliothèques de référence kami/zine/logo-generator) # Sans eux, ce package fonctionne toujours — en tant qu'Agent de conception "discipline intégrale + web_search/dembrandt" # — mais le pool de candidats perdra vos choix personnels. ``` **Remarque** : La ligne de plugin du preset utilise des **chemins relatifs** (`./plugins/design-router/index.mjs`, `presets/my-agent/plugins` en tant que lien symbolique relatif développé par `cp -RL`), donc sur une nouvelle machine, il suffit de copier le répertoire du preset — **aucune édition de chemin requise**. Si vous souhaitez éviter les liens symboliques, vous pouvez copier `plugins/design-router/` dans `presets/my-agent/plugins/` et utiliser `cp -R` ordinaire (le résultat est identique, juste une copie supplémentaire). ### Structure du dépôt ``` ├── plugins/design-router/ # Plugin d'outil déterministe (6 outils, zéro dépendance d'exécution) ├── presets/my-agent/ # Preset DSH (agent.cordis.yml + preset.yml) ├── skills/ │ ├── design-references/ # Compétence de routage (version adaptée DSH) │ └── hallmark/ # Compétence anti-gabarit IA (copie amont MIT, inclut actifs thème site/) ├── README.md # Anglais (principal) └── README.zh.md # Chinois ``` ## Contenu tiers et attribution des licences Ce dépôt bundle les contenus tiers suivants (en conservant les licences/attribution amont) : | Contenu | Source | Licence | Emplacement | | --- | --- | --- | --- | | Compétence hallmark + jetons/exemples thème `site/` | [nutlope/hallmark](https://github.com/nutlope/hallmark) | MIT (voir [`skills/hallmark/LICENSE`](skills/hallmark/LICENSE) pour le texte intégral) | `skills/hallmark/` | | Ressources de conception externes référencées dans le registre (kami/zine/logo-generator, etc.) | Leurs dépôts respectifs | Liens uniquement (non bundled ; URL source voir [`registry.md`](skills/design-references/references/registry.md)) | — | Tout le reste (`plugins/`, `presets/`, `skills/design-references/`) est original à ce dépôt, sous licence [MIT](LICENSE) (Copyright © 2026 haohaiHuang). ## Projets connexes - [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) — Infrastructure exécutant ce package (`dsh`, tout est plugin) - [my-pi-skills](https://github.com/haohaiHuang/my-pi-skills) — Dépôt de compétences amont (design-references / skill-router / vision) - [awesome-dsh-plugin](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin) — Liste sélectionnée de plugins DSH