Skip to content

CONTRIBUTING.hi.md

Latest commit

 

History

History
142 lines (100 loc) · 7.46 KB

CONTRIBUTING.hi.md

File metadata and controls

142 lines (100 loc) · 7.46 KB

Hive Mind में योगदान (languages: en • zh • hi • ru)

मानव-AI सहयोग दिशानिर्देश

यह प्रोजेक्ट मानव निगरानी के साथ AI-संचालित विकास का उपयोग करता है। इन प्रथाओं का पालन करें:

विकास कार्यप्रवाह

  1. Issue बनाना - मनुष्य स्पष्ट आवश्यकताओं के साथ issues बनाते हैं
  2. AI प्रसंस्करण - Hive Mind विश्लेषण करता है और समाधान प्रस्तावित करता है
  3. मानव समीक्षा - कोड समीक्षा और आर्किटेक्चरल निर्णय
  4. पुनरावृत्त सुधार - सहयोगी सुधार चक्र

कोड मानक

  • TypeScript/JavaScript: सख्त टाइपिंग आवश्यक
  • फ़ाइल आकार: प्रति फ़ाइल अधिकतम 1000 लाइनें
  • परीक्षण: महत्वपूर्ण पथों के लिए 100% टेस्ट कवरेज
  • दस्तावेज़ीकरण: मशीन-पठनीय, टोकन-कुशल

Changesets के साथ संस्करण प्रबंधन

यह प्रोजेक्ट संस्करणों और changelogs को प्रबंधित करने के लिए Changesets का उपयोग करता है। इससे वे merge conflicts समाप्त हो जाते हैं जो तब उत्पन्न होते हैं जब एकाधिक PRs package.json में संस्करण बढ़ाते हैं।

Changeset जोड़ना

जब आप ऐसे बदलाव करें जो उपयोगकर्ताओं को प्रभावित करते हैं, तो एक changeset जोड़ें:

npm run changeset

यह आपसे निम्नलिखित के लिए संकेत करेगा:

  1. परिवर्तन का प्रकार चुनें (patch/minor/major)
  2. परिवर्तनों का सारांश प्रदान करें

Changeset .changeset/ में एक markdown फ़ाइल के रूप में सहेजा जाएगा और इसे आपके PR के साथ commit किया जाना चाहिए।

Changeset दिशानिर्देश

  • Patch: बग फिक्स, दस्तावेज़ीकरण अपडेट, आंतरिक refactoring
  • Minor: नई सुविधाएं, गैर-breaking संवर्द्धन
  • Major: Breaking changes जो public API को प्रभावित करते हैं

उदाहरण changeset सारांश:

Add support for automatic fork creation with --auto-fork flag

रिलीज़ प्रक्रिया

  1. जब changesets वाले PRs को main में merge किया जाता है, तो Release workflow स्वचालित रूप से "Version Packages" PR बनाता है
  2. Version Packages PR, package.json संस्करणों और CHANGELOG.md को अपडेट करता है
  3. जब Version Packages PR को merge किया जाता है, तो पैकेज स्वचालित रूप से NPM पर प्रकाशित होता है

AI Agent कॉन्फ़िगरेशन

interface AgentConfig {
  model: 'sonnet' | 'haiku' | 'opus';
  priority: 'low' | 'medium' | 'high' | 'critical';
  specialization?: string[];
}

export const defaultConfig: AgentConfig = {
  model: 'sonnet',
  priority: 'medium',
  specialization: ['code-review', 'issue-solving'],
};

गुणवत्ता गेट

merge से पहले, सुनिश्चित करें:

  • सभी परीक्षण पास हों
  • फ़ाइल आकार सीमाएं लागू हों
  • टाइप चेकिंग पास हो
  • मानव समीक्षा पूर्ण हो
  • AI सहमति प्राप्त हो (यदि multi-agent)

टेस्ट सूट एंट्रीपॉइंट

डिफ़ॉल्ट स्थानीय सूट के लिए npm test का उपयोग करें। जो नए परीक्षण डिफ़ॉल्ट सूट में चलने चाहिए, उन्हें टेस्ट फ़ाइल में ही यह मार्कर रखना चाहिए:

/**
 * @hive-mind-test-suite default
 */

जिन परीक्षणों को बाहरी सेवाओं की आवश्यकता होती है या जो वास्तविक repositories को बदलते हैं, उनके लिए github-integration जैसे समर्पित suite marker का उपयोग करें। package.json या मुख्य CI test-suite job में अलग-अलग node tests/... commands न जोड़ें।

संचार प्रोटोकॉल

मानव → AI

# स्पष्ट, विशिष्ट निर्देश
./solve.mjs https://github.com/owner/repo/issues/123 --requirements "Security focus, maintain backward compatibility"

AI → मानव

# कार्यसाधक items के साथ स्थिति रिपोर्ट
echo "🤖 Analysis complete. Requires human decision on breaking changes."

AI Agents का परीक्षण

import { testAgent } from './tests/agent-testing.ts';

// Agent व्यवहार का परीक्षण करें
await testAgent({
  scenario: 'complex-issue-solving',
  expectedOutcome: 'pull-request-created',
  timeout: 300000, // 5 मिनट
});

कोड समीक्षा प्रक्रिया

  1. स्वचालित समीक्षा - AI agents प्रारंभिक विश्लेषण करते हैं
  2. Cross-Agent सत्यापन - कई agents समाधानों को सत्यापित करते हैं
  3. मानव निगरानी - अंतिम आर्किटेक्चरल और सुरक्षा समीक्षा
  4. सहमति निर्माण - चर्चा के माध्यम से संघर्षों का समाधान

समीक्षा चेकलिस्ट

  • एल्गोरिदम की शुद्धता सत्यापित
  • सुरक्षा कमजोरियों का आकलन
  • प्रदर्शन निहितार्थों पर विचार
  • दस्तावेज़ीकरण की संपूर्णता
  • एकीकरण परीक्षण कवरेज
⚡