स्किल्स आणि टूल्स
सामायिक स्किल्स .agents/skills/ मध्ये असतात. हेच सोर्स संपादित करा, आणि मग Claude Code साठी .claude/skills/ तयार करण्यासाठी yarn ai-workflow:sync चालवा. Codex थेट .agents/skills/ मध्ये स्किल्स शोधतो.
सामायिक रोल प्रॉम्प्ट्स .agents/roles/*.md मध्ये असतात. हा रिपॉझिटरी-विशिष्ट सोर्स फॉरमॅट आहे, नेटिव्ह एजंट डिस्कव्हरी पथ नव्हे. scripts/ai-workflow-files.mjs हे सोर्स खालील ॲप-विशिष्ट फाइल्समध्ये रूपांतरित करते; yarn ai-workflow:sync त्या लिहिते. जनरेट केलेल्या फाइल्स त्यांच्या सोर्ससोबतच कमिट करा, जेणेकरून नवीन चेकआउटमध्ये आधी जनरेटर न चालवताही नेटिव्ह कॉन्फिगरेशन उपलब्ध असेल. एखादा सोर्स काढल्यानंतर त्याचे कालबाह्य झालेले जनरेट केलेले आउटपुट स्पष्टपणे काढून टाका; व्हॅलिडेटर फाइल्स गुपचूप डिलीट न करता त्यांची नोंद करतो.
नेटिव्ह डिस्कव्हरी पथ
2026-09-12 रोजी अधिकृत दस्तऐवजांशी पडताळलेले:
| ॲप | प्रोजेक्ट सूचना | या रिपॉझिटरीत वापरली जाणारी स्किल्स | या रिपॉझिटरीत वापरले जाणारे कस्टम एजंट |
|---|---|---|---|
| Codex | AGENTS.md | .agents/skills/<name>/SKILL.md | जनरेट केलेले .codex/agents/<name>.toml |
| Claude Code | CLAUDE.md हे @AGENTS.md इम्पोर्ट करते | जनरेट केलेले .claude/skills/<name>/SKILL.md | जनरेट केलेले .claude/agents/<name>.md |
स्रोत: Codex स्किल्स, Codex सबएजंट्स, Claude मेमरी, Claude स्किल्स, Claude सबएजंट्स.
नेटिव्ह एजंट डिरेक्टरीजच्या जागी .agents/roles वापरू नका, किंवा Claude .agents/skills शोधतो असे गृहीत धरू नका. तिथली एखादी संदर्भित फाइल Claude तरीही सामान्य प्रोजेक्ट कॉन्टेक्स्ट म्हणून वाचू शकतो.
AI डिरेक्टरीज .gitattributes द्वारे LF लाइन एंडिंग्ज वापरतात, जेणेकरून जनरेट केलेला मजकूर सर्व प्लॅटफॉर्मवर सारखाच राहतो. स्किलचे सहायक ॲसेट्स बाइट्सच्या स्वरूपात जसेच्या तसे कॉपी केले जातात.
स्किल्स
| स्किल | उद्देश |
|---|---|
commit | अधिकृत, मर्यादित व्याप्तीचे लोकल कमिट तयार करा |
commit-format, issue-format | विनंती केल्यावर सूचनांचे फॉरमॅटिंग |
make-closed-issue | अधिकृत इश्यू, मर्यादित व्याप्तीचा कमिट आणि PR तयार करा |
review-and-merge-pr | PR वरील अभिप्रायाचे वर्गीकरण; दुरुस्ती/प्रकाशन/मर्ज फक्त विनंती केलेल्या व्याप्तीतच |
fix-merge-conflicts | कॉन्फ्लिक्ट्स सोडवा आणि मर्ज झालेल्या निकालाची पडताळणी करा |
release | रिलीजचा मजकूर तयार करा आणि अधिकृत रिलीज पायऱ्या पार पाडा |
code-quality-review | क्षुल्लक नसलेल्या डिफचा किंवा स्पष्टपणे विनंती केलेल्या गुणवत्तेच्या मुद्द्याचा आढावा |
retro | प्रत्यक्ष दिसून आलेल्या चुकांचे रूपांतर पुनरावृत्ती टाळणाऱ्या केंद्रित तपासण्यांमध्ये किंवा मार्गदर्शनात करा |
refactor-pass, deslop | विद्यमान बदलांची विनंती केलेली साफसफाई |
debug-agent | पुराव्यावर आधारित डीबगिंग, गरज असल्यास इन्स्ट्रुमेंटेशनसह |
you-might-not-need-an-effect | इफेक्ट/memo चा केंद्रित आढावा |
vercel-react-best-practices | लागू होणारे React परफॉर्मन्स मार्गदर्शन; या Vite क्लायंटसाठी Next.js/फक्त-सर्व्हर नियम वगळा |
translate | भाषांतरे तयार करा, आणि मग एकाच रायटरमार्फत मॅप्स लागू करा |
playwright-cli, inspect-elements | ब्राउझर पडताळणी आणि DOM-ते-सोर्स मॅपिंग |
profile-browsing | मर्यादित व्याप्तीचे ब्राउझर आणि React प्रोफाइलिंग |
test-apk | पुरवलेल्या सहचर Android रॅपरची पडताळणी |
impeccable, improve-threejs | मर्यादित व्याप्तीचे इंटरफेस डिझाइन आणि Three.js रेंडरिंगचा आढावा |
implement-plan | पर्यायी, मर्यादित डेलिगेशनसह योजना अंमलात आणा |
readme | पडताळलेले प्रोजेक्ट दस्तऐवजीकरण सांभाळा |
context7 | आवृत्तीला अनुरूप लायब्ररी दस्तऐवज मिळवा |
find-skills | स्पष्ट विनंती केल्यावर अतिरिक्त स्किल्स शोधा |
रोल्स आणि मॉडेल्स
browser-check, profiler, test-apk, translator, आणि reviewer साठी कस्टम रोल्स ठेवा. सामान्य अंमलबजावणी आणि कोड शोधण्यासाठी हार्नेसचा अंगभूत worker/general-purpose किंवा explorer रोल वापरा. पॅरेंट स्वीकृती निकष आणि मालकी ठरवून देतो; जड तपासण्या एकच मालक चालवतो.
Codex एजंट फाइल्समध्ये name, description, आणि developer_instructions असतात. .codex/config.toml हे max_concurrent_threads_per_session वापरून एकाच वेळी चालणाऱ्या चाइल्ड एजंटची संख्या चारपर्यंत मर्यादित करते. सामायिक रोल मेटाडेटामध्ये नाव, वर्णन आणि पर्यायी सँडबॉक्स मोड असतो; त्यात मुद्दाम कोणतेही मॉडेल फील्ड ठेवलेले नाहीत.
कमिट केलेल्या स्किल्स आणि कस्टम एजंट्समधून मॉडेल आणि रीझनिंग फील्ड वगळा. त्यामुळे प्रत्येक ॲपच्या दस्तऐवजीकृत प्राधान्यक्रमानुसार रनटाइमवेळच्या इन्व्होकेशन निवडी, वापरकर्त्याचे डीफॉल्ट आणि पॅरेंटकडून मिळणारा वारसा लागू होऊ शकतात. Claude फॅमिली अलायसमुळे आवृत्त्यांची देखभाल कमी होते, पण ते तरीही एक फॅमिली निवडतात. गरज असल्यास अशा निवडी वापरकर्ता/सेशन सेटिंग्जमध्ये ठेवा. वारशामुळे सध्याचे सर्वोत्तम मॉडेल आपोआप निवडले जाईल असे आश्वासन मिळत नाही. latest अलायस स्वतःहून तयार करू नका, किंवा नेहमीच्या टास्कमध्ये मॉडेल-कॅटलॉगचे संशोधन जोडू नका. Codex मधील निवड आणि Claude मधील निवड पाहा.
sandbox-mode: read-only हे Codex च्या सँडबॉक्सशी जुळते. Claude ची टूल यादी आणि रोलच्या सूचना त्याच्या रिव्ह्यू वर्कफ्लोवर मर्यादा घालतात, पण Bash ॲक्सेस हा OS-स्तरीय सँडबॉक्स नाही.
लागू असेल तिथे, वापरकर्त्याने सुरू करायच्या वर्कफ्लोसाठी सामायिक स्किल फ्रंटमॅटर disable-model-invocation: true वापरते. Codex चे संबंधित सेटिंग agents/openai.yaml मध्ये policy.allow_implicit_invocation: false असे असते; व्हॅलिडेटरला दोन्ही आवश्यक असतात. इन्व्होकेशन मेटाडेटा स्पष्ट अधिकृततेच्या नियमांना पूरक असतो; एखाद्या स्किलमध्ये प्रकाशनाच्या पायऱ्या आहेत एवढ्यावरून रिव्ह्यूची विनंती कधीही प्रकाशनाची परवानगी ठरत नाही.
तपासण्या आणि डिस्कव्हरी
yarn ai-workflow:syncइन्स्टॉल केलेल्याjs-yamlआणिsmol-tomlवापरून सुसंगतता आउटपुट पुन्हा तयार करते.yarn ai-workflow:checkसोर्स/फ्रंटमॅटर/कॉन्फिग्ज पार्स करते, आणि जनरेट केलेले आउटपुट, इन्व्होकेशन मेटाडेटा, मॉडेल फील्ड्सचे स्थान, आणि फक्त-फॉरमॅटर हुक वायरिंग तपासते. ते मॉडेल आयडेंटिफायर्स प्रदात्याच्या कॅटलॉगशी जुळवून पाहत नाही.yarn ai-workflow:testहुक पेलोड आणि वर्कफ्लो जनरेशन/व्हॅलिडेशनसाठी स्वतंत्र Node फिक्स्चर्स चालवते.- एजंट ॲप्लिकेशन अपग्रेड केल्यानंतर त्या ॲप्लिकेशनमध्ये स्किल/रोल डिस्कव्हरीची पडताळणी करा. सिंटॅक्स/पॅरिटी तपासण्या लोडर तपासणीची जागा घेत नाहीत. चालू सेशनमध्ये जुना कॅटलॉग राहिला असल्यास ॲप्लिकेशन रीलोड करा.
- हुक्ससाठी हार्नेसचा प्रोजेक्ट ट्रस्ट आणि हुक रिव्ह्यू आवश्यक असतो; तपासणी पास व्हावी म्हणून ट्रस्टला बगल देऊ नका. hooks-setup.md पाहा.
उपयुक्त सूचनांची देखभाल
OpenAI चे स्किल्स आणि प्रॉम्प्ट्सविषयीचे मार्गदर्शन (2026-09-12 रोजी आढावा घेतलेले) पाळा: वर्णने नेमकी ठेवा, तपशील फक्त संबंधित असतील तेव्हाच लोड करा, आणि वापरकर्त्याने विनंती केलेली व्याप्ती जपा. सामायिक स्किल्स वेगवेगळ्या मॉडेल्सना सेवा देतात; प्रोजेक्ट-विशिष्ट अपरिवर्तनीय नियम कायम ठेवा, आणि नेहमीच्या अंमलबजावणीच्या निवडींना मोकळीक द्या.
स्किलचा उद्देश, निर्णयाच्या सीमा आणि आवश्यक मर्यादा SKILL.md मध्ये ठेवा. मोठ्या प्रमाणातील मोड-विशिष्ट कमांड्स किंवा उदाहरणे पर्यायी संदर्भ म्हणून लिंक करा. लहान वर्णनांमध्ये ट्रिगरच्या अटी सुरुवातीलाच द्या; फक्त एखादा जुळणारा कीवर्ड आढळल्याने टास्कची व्याप्ती वाढू नये. वर्तन जाणीवपूर्वक बदलले जात नसेल तर विद्यमान इन्व्होकेशन मेटाडेटा जसा आहे तसा ठेवा.
सूचनांमध्ये मोठा बदल केल्यानंतर काही प्रातिनिधिक लहान आणि मोठ्या विनंत्या चालवून पाहा. कोणती स्किल्स/संदर्भ निवडले गेले, कृती व्याप्तीतच राहिल्या का, पडताळणी बदलाशी जुळली का, आणि अधिकृत काम पूर्ण झाले का ते तपासा. स्कीमा आणि फिक्स्चर चाचण्या टूलिंगची अचूकता सिद्ध करतात, एजंटच्या निर्णयांची गुणवत्ता नव्हे.
टूल्स आणि ब्राउझरची मालकी
विद्यमान स्किल/टूल कॅटलॉग आणि इन्स्टॉल केलेल्या प्रोजेक्ट CLI ना प्राधान्य द्या. GitHub साठी gh, ब्राउझर पडताळणीसाठी playwright-cli, आणि लायब्ररीचे वर्तन महत्त्वाचे असेल तेव्हा अधिकृत/आवृत्ती-विशिष्ट दस्तऐवज वापरा. डुप्लिकेट स्किल्स इन्स्टॉल करणे, किंवा फक्त विद्यमान फॉरमॅटर चालवण्यासाठी पिन न केलेले पॅकेज आणणे टाळा.
MCP चा ओव्हरहेड हार्नेसवर अवलंबून असतो: डिफर्ड टूल लोडिंगमुळे प्रत्येक स्कीमा सुरुवातीलाच लोड करणे टाळता येते. MCP लाच कालबाह्य मानण्याऐवजी इंटिग्रेशन्स संबंधित तेवढीच ठेवा. पुनरुत्पादनक्षमता आणि संसाधनांवरील नियंत्रणासाठी विद्यमान CLI पर्याय अजूनही उपयुक्त आहेत.
सर्व ब्राउझर सेशन्स ./scripts/pw-session.sh वापरतात, जे संपूर्ण मशीनवर एका वेळी एकच सक्रिय ब्राउझर असल्याची खात्री करते. डीफॉल्टनुसार नवीन, स्वतंत्र सेशन वापरा. सध्याच्या वैयक्तिक ब्राउझरच्या ॲक्सेससाठी स्पष्ट परवानगी आवश्यक आहे; पुढील पायऱ्यांमध्ये तीच परवानगी पुन्हा वापरा. बाधित वर्तनानुसार ब्राउझर/व्ह्यूपोर्ट निवडा, निवडलेली एंजिन्स एकामागोमाग एक चालवा, क्लीनअपमध्ये नेमके त्या नावाचे सेशन बंद करा, आणि close-all/kill-all कधीही वापरू नका. playwright-cli स्किल आणि verification.md पाहा.