अपने कोडिंग एजेंट को WordPress Playground ब्लूप्रिंट लिखना सिखाएँ – DocsWP

नया ब्लूप्रिंट एजेंट स्किल आपके कोडिंग एजेंट को Playground Blueprint स्कीमा सिखाता है, जो मान्य प्रॉपर्टी नाम, संसाधन प्रकार और चरणों का क्रम निर्धारित करता है। अब pluginData की जगह pluginZipFile नहीं होगा। अब runPHP चरणों में require '/wordpress/wp-load.php' गायब नहीं होगा।

इसे एक बार इंस्टॉल करें, और आपका एजेंट उच्च सफलता दर के साथ प्राकृतिक भाषा में मान्य Blueprint JSONJSON JSON, या JavaScript Object Notation, डेटा को संरचित करने का एक न्यूनतम, पठनीय प्रारूप है। इसका उपयोग मुख्य रूप से सर्वर और वेब एप्लिकेशन के बीच डेटा भेजने के लिए किया जाता है, XML के विकल्प के रूप में। तैयार करेगा। सबसे अच्छी बात यह है कि यह सब प्राकृतिक भाषा में होगा। यह नए विचारों का परीक्षण करने, अपने Plugins और Themes में किनारी मामलों को खोजने और अपनी परियोजनाओं के डेमो बनाने के लिए बिल्कुल सही है।

ब्लूप्रिंट स्किल क्या करता है

यह स्किल एक संरचित Markdown संदर्भ है, जिसे आपका कोडिंग एजेंट अपने संदर्भ में लोड करता है। इसमें शामिल हैं:

हर शीर्ष-स्तरीय प्रॉपर्टी: landingPage, preferredVersions, features, steps, शॉर्टहैंड (login, plugins, siteOptions, constants)
सभी संसाधन प्रकार: wordpress.org/plugins, wordpress.org/themes, url, git:directory, literal:directory, bundled
चरण संदर्भ: installPlugin, writeFile, writeFiles, runPHP, wp-cli, runSql, और अन्य
सामान्य गलतियाँ: उन कमियों की एक तालिका, जिनके विरुद्ध एजेंट आउटपुट तैयार करने से पहले जाँच करता है
ब्लूप्रिंट बंडल: बंडल किए गए संसाधनों वाले स्व-निहित पैकेज

कोई भी Blueprint लिखने से पहले एजेंट इस संदर्भ को पढ़ता है। प्रॉपर्टी नामों का अनुमान लगाने के बजाय, वह दस्तावेज़ित स्कीमा का पालन करता है।

स्किल कैसे इंस्टॉल करें

त्वरित इंस्टॉलेशन के लिए, अपने प्रोजेक्ट में ब्लूप्रिंट स्किल जोड़ने हेतु npx skills CLICLI कमांड लाइन इंटरफ़ेस। Mac में Terminal (Bash), Windows में Command Prompt, या WordPress के लिए WP-CLI। का उपयोग करें:

npx skills add wordpress/agent-skills --skill blueprint

या agent-skills repository को क्लोन करके और बिल्ड स्क्रिप्ट चलाकर मैन्युअल रूप से इंस्टॉल करें:

git clone https://github.com/WordPress/agent-skills.git
cd agent-skills
node shared/scripts/skillpack-build.mjs --clean
node shared/scripts/skillpack-install.mjs --dest=../your-wp-project --targets=claude,gemini,codex,cursor,vscode

यह स्किल Claude Code, Gemini CLI, GitHubGitHub GitHub एक वेबसाइट है जो git रिपॉज़िटरी के ऑनलाइन कार्यान्वयन की सुविधा देती है, जिन्हें अन्य डेवलपर आसानी से साझा, कॉपी और संशोधित कर सकते हैं। सार्वजनिक रिपॉज़िटरी होस्ट करना निःशुल्क है, जबकि निजी रिपॉज़िटरी के लिए सशुल्क सदस्यता आवश्यक है। GitHub ने ‘pull request’ की अवधारणा प्रस्तुत की, जिसमें योगदानकर्ताओं द्वारा शाखाओं में किए गए कोड परिवर्तनों की समीक्षा और चर्चा रिपॉज़िटरी मालिक द्वारा मर्ज किए जाने से पहले की जा सकती है। https://github.com/ Copilot, Cursor और Codex के साथ काम करता है।

पाँच उदाहरण

नीचे दिया गया प्रत्येक उदाहरण आपके एजेंट को दिए गए प्रॉम्प्ट और उसके द्वारा तैयार किए गए Blueprint को दिखाता है। ये वास्तविक परिस्थितियाँ हैं, जहाँ ब्लूप्रिंट स्किल सामान्य त्रुटियों को रोकता है।

1. त्वरित विकास वातावरण

प्रॉम्प्ट:

Create a Blueprint that sets up a development environment with
debug mode, the Developer plugin, and landing on the admin dashboard.

तैयार किया गया Blueprint:

{
  "$schema": "https://playground.wordpress.net/blueprint-schema.json",
  "landingPage": "/wp-admin/",
  "preferredVersions": { "php": "8.3", "wp": "latest" },
  "features": { "networking": true },
  "constants": {
    "WP_DEBUG": true,
    "WP_DEBUG_LOG": true
  },
  "login": true,
  "plugins": ["developer"],
  "steps": []
}

ध्यान दें कि एजेंट defineWpConfigConsts चरण के बजाय constants शॉर्टहैंड और अलग लॉगिन चरण के बजाय login: true का उपयोग करता है। स्किल एजेंटों को सिखाता है कि सरल मामलों में शॉर्टहैंड और क्रम महत्वपूर्ण होने पर स्पष्ट चरण चुनें।

WordPress Admin panel showing the Developer plugin enabled via blueprint

2. GitHub शाखा से PluginPlugin प्लगइन सॉफ़्टवेयर का एक भाग है, जिसमें ऐसे फ़ंक्शन होते हैं जिन्हें WordPress वेबसाइट में जोड़ा जा सकता है। ये आपके WordPress वेबसाइटों की कार्यक्षमता बढ़ा सकते हैं या नई सुविधाएँ जोड़ सकते हैं। WordPress प्लगइन PHP प्रोग्रामिंग भाषा में लिखे जाते हैं और WordPress के साथ सहज रूप से एकीकृत होते हैं। ये WordPress.org Plugin Directory https://wordpress.org/plugins/ में निःशुल्क उपलब्ध हो सकते हैं या किसी तृतीय-पक्ष के सशुल्क प्लगइन हो सकते हैं।

प्रॉम्प्ट:

Write a Blueprint that installs my plugin from the feature/checkout-v2
branch on GitHub and activates it.

तैयार किया गया Blueprint:

{
  "$schema": "https://playground.wordpress.net/blueprint-schema.json",
  "landingPage": "/wp-admin/plugins.php",
  "preferredVersions": { "php": "8.3", "wp": "latest" },
  "steps": [
    { "step": "login" },
    {
      "step": "installPlugin",
      "pluginData": {
        "resource": "git:directory",
        "url": "https://github.com/your-org/your-plugin",
        "ref": "feature/checkout-v2",
        "refType": "branch",
        "path": "/"
      },
      "options": { "activate": true }
    }
  ]
}

स्किल के बिना, एजेंट अक्सर refType छोड़ देते हैं, जिससे शाखा नामों के लिए git:directory विफल हो जाता है। स्किल की सामान्य गलतियों वाली तालिका इसे स्पष्ट रूप से चिह्नित करती है: “शाखा/टैग ref के साथ refType छोड़ना — आवश्यक; इसके बिना केवल HEAD काम करता है।”

3. नमूना उत्पादों वाला WooCommerce स्टोर

प्रॉम्प्ट:

Create a Blueprint for a WooCommerce store with 5 sample products
across 2 categories, running on PHP 8.2.

तैयार किया गया Blueprint:

{
  "$schema": "https://playground.wordpress.net/blueprint-schema.json",
  "landingPage": "/shop/",
  "preferredVersions": { "php": "8.2", "wp": "latest" },
  "features": { "networking": true },
  "steps": [
    { "step": "login" },
    {
      "step": "installPlugin",
      "pluginData": { "resource": "wordpress.org/plugins", "slug": "woocommerce" },
      "options": { "activate": true }
    },
    {
      "step": "runPHP",
      "code": "<?php\nrequire '/wordpress/wp-load.php';\n\n// Create categories\n$cat_clothing = wp_insert_term('Clothing', 'product_cat');\n$cat_accessories = wp_insert_term('Accessories', 'product_cat');\n\n$products = [\n  ['T-Shirt', 29.99, $cat_clothing['term_id']],\n  ['Hoodie', 59.99, $cat_clothing['term_id']],\n  ['Jeans', 49.99, $cat_clothing['term_id']],\n  ['Watch', 89.99, $cat_accessories['term_id']],\n  ['Backpack', 39.99, $cat_accessories['term_id']]\n];\n\nforeach ($products as [$title, $price, $cat_id]) {\n  $post_id = wp_insert_post([\n    'post_title' => $title,\n    'post_type' => 'product',\n    'post_status' => 'publish'\n  ]);\n  update_post_meta($post_id, '_regular_price', $price);\n  update_post_meta($post_id, '_price', $price);\n  wp_set_object_terms($post_id, [$cat_id], 'product_cat');\n}\n"
    }
  ]
}

स्किल यह सुनिश्चित करता है कि एजेंट हर runPHP चरण की शुरुआत में require '/wordpress/wp-load.php' शामिल करे। इस पंक्ति के बिना सभी WordPress फ़ंक्शन चुपचाप विफल हो जाते हैं — यह एक ऐसी गलती है जो एजेंट स्किल संदर्भ के बिना अक्सर करते हैं।

WordPress Playground Loading a store with 5 products in a woo store.

4. कस्टम व्यवहार के लिए इनलाइन mu-plugin

प्रॉम्प्ट:

Write a Blueprint that disables the admin bar and adds a custom
dashboard widget showing the server's PHP version.

तैयार किया गया Blueprint:

{
  "$schema": "https://playground.wordpress.net/blueprint-schema.json",
  "landingPage": "/wp-admin/",
  "preferredVersions": { "php": "8.3", "wp": "latest" },
  "steps": [
    { "step": "login" },
    {
      "step": "writeFile",
      "path": "/wordpress/wp-content/mu-plugins/custom-dashboard.php",
      "data": "<?php\nadd_filter('show_admin_bar', '__return_false');\n\nadd_action('wp_dashboard_setup', function() {\n  wp_add_dashboard_widget(\n    'php_version_widget',\n    'PHP Version',\n    function() {\n      echo '<p>Running PHP ' . phpversion() . '</p>';\n    }\n  );\n});"
    }
  ]
}

एजेंट writeFile का उपयोग करके एक mu-plugin बनाता है, जो सक्रिय किए बिना अपने-आप लोड हो जाता है। स्किल इस पैटर्न का स्पष्ट रूप से दस्तावेज़ीकरण करता है और एजेंटों को mu-plugin कोड के अंदर require wp-load.php जोड़ने से सावधान करता है (यह पंक्ति केवल runPHP चरणों में आवश्यक है)।

5. कस्टम प्लगइन वाला Blueprint बंडल

प्रॉम्प्ट:

Create a Blueprint bundle that installs a custom analytics plugin
from a local zip file.

तैयार किए गए बंडल की संरचना:

analytics-bundle/
├── blueprint.json
└── analytics-plugin.zip

blueprint.json:

{
  "$schema": "https://playground.wordpress.net/blueprint-schema.json",
  "landingPage": "/wp-admin/plugins.php",
  "preferredVersions": { "php": "8.3", "wp": "latest" },
  "steps": [
    { "step": "login" },
    {
      "step": "installPlugin",
      "pluginData": {
        "resource": "bundled",
        "path": "/analytics-plugin.zip"
      },
      "options": { "activate": true }
    }
  ]
}

इसे स्थानीय रूप से चलाएँ:

npx @wp-playground/cli server --blueprint=./analytics-bundle/ --blueprint-may-read-adjacent-files

डायरेक्टरी बंडल के लिए --blueprint-may-read-adjacent-files फ़्लैग आवश्यक है। इसके बिना कोई भी bundled संसाधन संदर्भ “File not found” त्रुटि के साथ विफल हो जाता है। स्किल इस महत्वपूर्ण बात का दस्तावेज़ीकरण करता है, इसलिए एजेंट फ़्लैग को अपने-आप शामिल करते हैं।

ब्लूप्रिंट स्किल अन्य टूल्स के साथ कैसे काम करता है

ब्लूप्रिंट स्किल AI एजेंटों के लिए दो अन्य Playground टूल्स के साथ काम करता है:

टूल	यह क्या करता है	कब उपयोग करें
Blueprint skill	मान्य Blueprint JSON तैयार करता है	जब आपको साझा करने, वर्ज़न नियंत्रण या CI के लिए Blueprint फ़ाइल चाहिए
wp-playground skill	CLI कमांड चलाता है, सर्वर प्रबंधित करता है और इंस्टेंस की डीबगिंग करता है	जब आपको लाइव इंटरैक्शन वाला चलता हुआ Playground इंस्टेंस चाहिए
MCP server	एजेंटों को सीधे ब्राउज़र Playground से जोड़ता है	जब आपको रीयल-टाइम PHPPHP PHP (PHP: Hypertext Preprocessor का पुनरावर्ती संक्षिप्त नाम) एक व्यापक रूप से उपयोग की जाने वाली ओपन-सोर्स सामान्य-उद्देश्य स्क्रिप्टिंग भाषा है, जो विशेष रूप से वेब विकास के लिए उपयुक्त है और HTML में एम्बेड की जा सकती है। https://www.php.net/manual/en/index.php निष्पादन और फ़ाइलों में हेरफेर चाहिए

जब आपको पोर्टेबल, पुनरुत्पादित कॉन्फ़िगरेशन चाहिए, तब ब्लूप्रिंट स्किल का उपयोग करें। जब आपको चलता हुआ सर्वर चाहिए, तब wp-playground स्किल का उपयोग करें। दोनों को मिलाएँ: ब्लूप्रिंट स्किल से Blueprint तैयार करें, फिर wp-playground स्किल के CLI कमांड से उसे लॉन्च करें।

अपने Blueprints का परीक्षण करें

इनलाइन URLURL इंटरनेट पर किसी वेबसाइट या वेब पेज का विशिष्ट वेब पता, जैसे वेबसाइट का URL www.wordpress.org (त्वरित परीक्षण)

Blueprint JSON को छोटा करें और उसे Playground URL में जोड़ें:

https://playground.wordpress.net/#{"preferredVersions":{"php":"8.3","wp":"latest"},"steps":[{"step":"login"}]}

स्थानीय CLI (पूर्ण परीक्षण)

# Start a server with your Blueprint
npx @wp-playground/cli server --blueprint=./blueprint.json

# Headless validation (runs and exits)
npx @wp-playground/cli run-blueprint --blueprint=./blueprint.json

शुरू करें

अपने प्रोजेक्ट में ब्लूप्रिंट स्किल इंस्टॉल करें:

npx skills add wordpress/agent-skills --skill blueprint

फिर अपने एजेंट से Blueprint लिखने को कहें। अपनी ज़रूरत बताएँ: प्लगइन, थीम, सामग्री और कॉन्फ़िगरेशन — एजेंट मान्य JSON तैयार करेगा, जो पहली कोशिश में चलेगा।

आपने जो बनाया है उसे #playground चैनल पर Making WordPress Slack में साझा करें या GitHub पर समस्या दर्ज करें।

#agent-skills, #ai