इस प्रोजेक्ट के बारे में

# 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`): तीन-स्तरीय रूटिंग भूमिका (चरण → शाखा → चरण) प्रत्येक चरण में पुष्टिकरण द्वार के साथ | | [`skills/design-references/`](skills/design-references/) | चरण/शाखा रूटिंग स्किल (चरण विभाजन → A उत्पाद / B सामग्री / C सामान्य → पाँच चरण), 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 में पेश की गई दो पंक्तियों का उपयोग करते हैं: `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` सात चेकर मॉड्यूल चलाता है और गेट नंबर के साथ टू-डू सूची लौटाता है: | परिवार | गेट | स्रोत | | --- | --- | --- | | 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` का उपयोग करें (परिणाम समान, बस एक अतिरिक्त प्रति)। ### रिपॉजिटरी संरचना ``` ├── 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/` | | रजिस्ट्री में संदर्भित बाहरी ड