design-agent

# Design-Agent — DSH 設計エージェントワークスペース これは [DeepSeek Harness (DSH)](https://github.com/deepseek-ai/deepseek-harness) ベースの**設計エージェント完全再現パッケージ**であり、`my-agent` プリセット、`design-references` ルーティングスキル（DSH 適用版）、`design-router` 決定論的ツールプラグインを含みます。このプロジェクトは、既存の HTML ベースの設計エージェントをアップグレードし、[design-references](https://github.com/haohaiHuang/my-pi-skills/tree/main/skills/design-references) メソッドを採用して構築されています。 > ⚠️ **このパッケージが再現するのはメカニズムであり、コンテンツではありません。** ルーティング、規律、ツールは完全に自己完結しています（クローン → `cp -RL` → 実行）。ただし、*リファレンスライブラリ*は個人用です。主要なリソースのいくつかは `~/Desktop/Design/...` と `~/resources/design-references.md` を指しており、これらはリポジトリに含まれないプライベートアセットです。新しいマシンでは、これらはフォールバックチェーン（`web_search` + `dembrandt` + 組み込みのシグネチャ規律）に縮退します。完全な個人用リファレンスセットが必要な場合は、これらのディレクトリを自分でコピーしてください。これらがなくても、このパッケージは「シグネチャ規律 + ウェブ調査」設計エージェントとして機能します。 ## 含まれるもの | コンポーネント | 役割 | | --- | --- | | [`plugins/design-router/`](plugins/design-router/) | 決定論的ツール Cordis プラグイン（6 つの読み取り専用ツール + 1 つのローカルログライター、外部ランタイム依存ゼロ） | | [`presets/my-agent/`](presets/my-agent/) | DSH エージェントプリセット（`agent.cordis.yml` + `preset.yml`）：3 層ルーティングロール（フェーズ → ブランチ → フェーズ）、各フェーズに確認ゲート付き | | [`skills/design-references/`](skills/design-references/) | フェーズ/ブランチルーティングスキル（フェーズ分流 → A プロダクト / B コンテンツ / C 汎用 → 5 フェーズ）、DSH 適用版 | | [`skills/hallmark/`](skills/hallmark/) | 反 AI スラップ実行スキル（[nutlope/hallmark](https://github.com/nutlope/hallmark) からの MIT アップストリームコピー；`site/` テーマトークンとサンプルはスキルに組み込まれており自己完結） | > **DSH バージョン要件：`0.1.5-rc.1` 以降。** ロールプラグインモードは 0.1.5 で変更されました（`text` → `prefix` + `suffix`）。`text:` を使用し続けるプリセットは `$.prefix missing required value` でマウントに失敗します。このリポジトリのプリセットは 0.1.5 モードに基づいており、0.1.5 で導入された 2 行を使用します：`present`（`dsh-tool-present`、配信宣言）と `command-goal`（`/goal` コマンド）。 ## plugins/design-router — 決定論的ツール [my-pi-skills](https://github.com/haohaiHuang/my-pi-skills) の `extensions/design-router` から移植（pi 拡張 → DSH Cordis プラグイン）。`my-agent` プリセットによって `agent.cordis.yml` の**相対パス行**を介してマウントされます（プリセットの `plugins/` はリポジトリルート `plugins/` への相対シンボリックリンクであり、インストール時に `cp -RL` で展開されます — 絶対パスは不要）： ```yaml - id: design-router name: './plugins/design-router/index.mjs' ``` ### ツール | ツール | 用途 | フェーズ | | --- | --- | --- | | `design_lookup <branch> <stage>` | 設計リソースレジストリを照会（R/C/E/V 3-D インデックス + フォールバックチェーン + ソース；出力はスタイルバケット） | 「このステップでは何を参照すべきか？」 | | `design_route <need>` | ニーズキーワードを推奨スタイルバケットの組み合わせにマッピング（主要必須 + 二次オンデマンド）+ バケットごとの代表リソース | フェーズ 1 調査（反均質化ルーティング） | | `design_diversity <c1> <c2> <c3>` | 3 つの候補の差異を機械チェック（色相ファミリー / フォントトーン / ソースバケット）、合格/不合格 | フェーズ 1 候補提示前（反均質化チェック） | | `design_quality <report\|query>` | ソース品質シグナルを記録/照会（抽出成功率 / リワーク率 / 到達可能性 — 客観的、好みベースではない）；ローカルログ、git 管理外 | フェーズ 4 後の記録 / フェーズ 1 降順消費 | | `design_audit <target>` | 機械スラップゲート（シグネチャ機械サブセット）+ インターフェース CS-* 8 ルール + フェーズ 4 スキャン + 継承比較 | フェーズ 4 検証 | | `design_contrast <target>` | WCAG 2.1 + APCA 近似コントラスト | フェーズ 4 検証 | ### pi バージョンとの意図的な違い - **削除** `design_research`（DSH は ledger-grep + refero プローブ + `web_search` フォールバックチェーンを使用） - **削除** `hallmark_study_fetch`（DSH は `dembrandt` / `defuddle` を使用） - **削除** `before_agent_start` インジェクションと `/design-router` コマンド（DSH のスキルロードメカニズムがルーティングをカバー） - **`@deepseek-ai/dsh-tools` に依存しない**（ワークスペースモジュールは dsh インストールディレクトリを解決できない）；ツール定義は純粋な JSON Schema で構築 — 外部ランタイム依存ゼロ ### レイアウト ``` plugins/design-router/ ├── index.mjs # プラグインエントリ：6 つのツールを登録（5 つの読み取り専用 + 1 つのローカルログライター） ├── checks/ # 移植されたチェッカー（TS→JS）：タイポグラフィ/レイアウト/アクセシビリティ/コピー/コントラスト/チート/スラップキル/アセット/タイプ │ └── kill-slop.test.mjs # KS-* 回帰テスト（node checks/kill-slop.test.mjs） └── data/ └── registry.json # registry.md のデータ形式（91 リソース × 9 ブランチルート） ``` ### 機械ゲートカバレッジ `design_audit` は 7 つのチェッカーモジュールを実行し、ゲート番号付きの TODO リストを返します： | ファミリー | ゲート | ソース | | --- | --- | --- | | 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`（機械サブセット） | | インターフェース CS-* | CS-1…CS-8 | interfaces.dev チートシート | | モーション EM-* | EM-2/3/5（EM-1/7/8 はゲート 10/14/27 にマッピング） | emilkowalski/skills | | kill-ai-slop KS-* | KS-03/04/05/08/14 | kill-ai-slop トランスクリプト | | アセットレイヤー DR-A* | DR-A1/DR-A2 | Anshu アセットレイヤーゲート（ブランドロゴ/画像存在性） | | design-references フェーズ 4 | DR-4（フォントウェイト/角丸オーバースペック） | design-references workflow.md | ### メンテナンス - `registry.md` が**事実上のソース**です（`~/.agents/skills/design-references/references/registry.md`）；編集後、`node plugins/design-router/scripts/build-registry.mjs` を実行して `data/registry.json`（+ `data/manifest.json` バージョンメタデータ）を再生成します。**registry.json を手動で編集しないでください。** - チェッカーロジックはアップストリームの `extensions/design-router/checks/`（TS→MJS 移植）に従います；アップストリーム更新後、`node plugins/design-router/scripts/check-checks-sync.mjs /path/to/my-pi-skills/extensions/design-router/checks` を実行してゲートカバレッジを検証してください — **その後、チェッカー定数を手動で比較してください**：ゲート番号の等価性は詳細のドリフトを捕捉しません（例：拡張されたデフォルトフォントリスト）。KS 回帰テストがこの種のドリフトを捕捉します。 - チェッカー変更後：`node index.test.mjs` と `node checks/kill-slop.test.mjs` を実行。 ## ワンショット再現（新マシン） リポジトリは**メカニズム**を再現します：プラグイン + プリセット + DSH 適用スキルはすべてリポジトリ内にあります（リファレンスライブラリの*コンテンツ*は個人用です — 上部の警告を参照）。 ```bash # ── リポジトリに同梱（クローン → 実行）── # 1. スキル（design-references は DSH 適用版；hallmark は MIT アップストリームコピー） cp -R skills/design-references ~/.agents/skills/ cp -R skills/hallmark ~/.agents/skills/ # 2. プリセット（cp -RL は presets/my-agent/ 内の相対プラグインシンボリックリンクを自己完結コピーに展開 — # インストール後、プリセットはリポジトリパスに依存せず、自由にコピーまたは移行可能） mkdir -p ~/.dsh/.agent-presets cp -RL presets/my-agent ~/.dsh/.agent-presets/ # 3. プラグインソース（git 管理のためリポジトリルート plugins/ に保持） # プリセットは相対パス './plugins/design-router/index.mjs' で参照： # presets/my-agent/plugins はリポジトリルート plugins/ への相対シンボリックリンク、 # cp -RL が実ディレクトリに展開 — どのマシンでもパス編集不要。 # 4. 外部依存（ソフト依存 — 欠落時は優雅に縮退） npm install -g dembrandt # URL → デザイントークン（フェーズ 1 候補検証） # defuddle: npm install -g defuddle # npm install -g @open-pencil/cli # オプション：.fig/.pen デザインファイルの読み取り/変換/検証（Figma ファミリースキル / 手動レビューにフォールバック） # ── 自己提供（個人の選択；欠落時はフォールバックチェーンに縮退）── # 5. マシンローカルアセット（ledger + kami/zine/logo-generator リファレンスライブラリ） # これらがなくても、このパッケージは「シグネチャ規律 + web_search/dembrandt」 # 設計エージェントとして動作します — ただし候補プールは個人の選択を失います。 ``` **注意**：プリセットのプラグイン行は**相対パス**を使用します（`./plugins/design-router/index.mjs`、`presets/my-agent/plugins` は `cp -RL` で展開される相対シンボリックリンク）。したがって、新マシンではプリセットディレクトリをコピーするだけで済みます — **パス編集は不要**です。シンボリックリンクを避けたい場合は、`plugins/design-router/` を `presets/my-agent/plugins/` にコピーし、通常の `cp -R` を使用してください（結果は同じで、コピーが 1 つ増えるだけです）。 ### リポジトリ構造 ``` ├── plugins/design-router/ # 決定論的ツールプラグイン（6 ツール、ランタイム依存ゼロ） ├── presets/my-agent/ # DSH プリセット（agent.cordis.yml + preset.yml） ├── skills/ │ ├── design-references/ # ルーティングスキル（DSH 適用版） │ └── hallmark/ # 反 AI スラップスキル（MIT アップストリームコピー、site/ テーマアセット含む） ├── README.md # 英語（主要） └── README.zh.md # 中国語 ``` ## サードパーティコンテンツとライセンス帰属 このリポジトリは以下のサードパーティコンテンツをバンドルしています（アップストリームのライセンス/帰属を保持）： | コンテンツ | ソース | ライセンス | 場所 | | --- | --- | --- | --- | | hallmark スキル + `site/` テーマトークンとサンプル | [nutlope/hallmark](https://github.com/nutlope/hallmark) | MIT（全文は [`skills/hallmark/LICENSE`](skills/hallmark/LICENSE) を参照） | `skills/hallmark/` | | レジストリが参照する外部設計リソース（kami/zine/logo-generator など） | 各アップストリームリポジトリ | リンク参照のみ（バンドルなし；ソース URL は [`registry.md`](skills/design-references/references/registry.md) を参照） | — | その他すべてのコンテンツ（`plugins/`、`presets/`、`skills/design-references/`）はこのリポジトリのオリジナルであり、[MIT ライセンス](LICENSE)（著作権 © 2026 haohaiHuang）の下で提供されます。 ## 関連プロジェクト - [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) — このパッケージを実行するインフラストラクチャ（`dsh`、すべてがプラグイン） - [my-pi-skills](https://github.com/haohaiHuang/my-pi-skills) — アップストリームスキルリポジトリ（design-references / skill-router / vision） - [awesome-dsh-plugin](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin) — 厳選された DSH プラグインリスト