AI Diff Reviewer ऐड-ऑन
Deep Work Plan के निष्पादन को AI Diff Reviewer (मार्केटप्लेस पर “AI Diff Reviewer”, वर्तमान संस्करण v2.0.1) से जोड़ें ताकि अनिवार्य Final Review की सुरक्षा-जाँच एक संरचित स्थानीय समीक्षा चलाए — निर्णय, निष्कर्ष तालिका, और गंभीरता — और, Flow B चुनने पर, हर pull request को CI में उसी समीक्षा द्वारा नियंत्रित किया जा सके। संस्करण 2.3.0 से स्थानीय समीक्षा baseline का हिस्सा है: ऑनबोर्डिंग इसे इंस्टॉल करती है और हर Final Review इसे चलाता है। केवल CI सतह ऑप्ट-इन है।
जो वेंडर-तटस्थ बना रहता है वह वही सीमा है जो मायने रखती है: समीक्षक एक MIT, tag-pinned स्किल है जिसे आपका अपना coding agent चलाता है — कोई भी Deep Work Plan प्रवाह किसी व्यावसायिक सेवा, CI प्रोवाइडर या सीक्रेट की आवश्यकता नहीं रखता। Flow A (केवल स्थानीय) वह baseline है जो हर ऑनबोर्ड की गई रिपॉजिटरी को मिलता है; Flow B (CI Action) स्पष्ट रूप से प्रस्तावित होता है और बिना अनुरोध कभी इंस्टॉल नहीं किया जाता। डेवलपर स्थानीय समीक्षक को अस्वीकार कर सकता है; अस्वीकृति एक घोषित अपवाद के रूप में दर्ज होती है और verify उस बिंदु पर रिपॉजिटरी को तब तक अनुपालन-रहित बताता है जब तक वह इंस्टॉल न हो जाए।
कब उपयोग करें
| संकेत | कार्रवाई |
|---|---|
| हर ऑनबोर्ड की गई रिपॉजिटरी | ऑनबोर्डिंग के Phase 7a में Flow A इंस्टॉल होता है (वेंडर्ड स्किल + .review/extension.md); एक targeted harness upgrade इसे पहले ऑनबोर्ड की गई रिपॉजिटरी में जोड़ता है |
| टीम संरचित निष्कर्षों के साथ CI PR मर्ज गेट चाहती है | Flow B प्रस्तावित करें — स्पष्ट ऑप्ट-इन, कभी डिफ़ॉल्ट नहीं |
| व्यक्तिगत या प्रयोगात्मक रिपॉजिटरी; स्थानीय समीक्षा पर्याप्त है | Flow A पर बने रहें — baseline पूर्ण है |
दो अपनाने के प्रवाह
| प्रवाह | आपको क्या मिलता है |
|---|---|
| A — केवल स्थानीय (baseline) | वेंडर्ड स्किल + आवश्यक .review/extension.md (generate-extension के माध्यम से)। हर Final Review की सुरक्षा-जाँच के भीतर स्थानीय समीक्षा चलाता है। कोई GitHub Actions वर्कफ़्लो नहीं। |
| B — दोहरी सतह | Flow A के साथ setup .github/workflows/pr-review.yml (Action @v2) लिखता है, स्थानीय और CI के लिए एक ही एक्सटेंशन फ़ाइल। CI निष्कर्ष पोस्ट करने के बाद वैकल्पिक apply-review साथी। |
स्थानीय समीक्षा की पहचान के लिए निम्नलिखित में से किसी एक स्थान पर स्किल + एक्सटेंशन फ़ाइल की आवश्यकता है: .review/extension.md, .github/ai-diff-reviewer/extension.md, या .github/ai-pr-reviewer/extension.md। केवल स्किल पर्याप्त नहीं है।
यह ऐड-ऑन क्या जोड़ता है (जानबूझकर सीमित)
DWP ऐड-ऑन समीक्षक को पुनः आविष्कार नहीं करता। यह इंस्टॉलेशन, पद्धति, CI विज़ार्ड, एक्सटेंशन लेखन, PR ड्राफ्टिंग, और CI के बाद की वॉकथ्रू को अपस्ट्रीम स्किल के पांच सब-स्किल (मूल डिफ़ॉल्ट प्रवाह, generate-extension, setup, open-pr, apply-review) को सौंपता है।
आवश्यक स्थानीय समीक्षा
create हर Final Review की सुरक्षा-जाँच में स्थानीय समीक्षा चरण जोड़ता है और execute उसे चलाता है। आउटपुट plan-local analysis_results/SECURITY_REVIEW.md (plan के अपने folder के अंदर, repo root में कभी नहीं) में ## AI Diff Reviewer local review के नीचे जोड़ा जाता है।
- समीक्षक अनुपस्थित — दर्ज किया जाता है, कभी चुपचाप नहीं छोड़ा जाता: अनुपस्थित स्किल या एक्सटेंशन एक
local reviewer not installedनिष्कर्ष बन जाता है; Final Review स्किल मौजूद होने पर स्थानीय पास चलाता है और अन्यथा वह निष्कर्ष पूर्णता रिपोर्ट में ले जाता है — इंस्टॉल onboarding की सहमति या addon की स्पष्ट invocation से संबंधित है, कभी अचानक बूटस्ट्रैप नहीं। - सॉफ्ट-फेल (केवल आमंत्रण): एक समीक्षा जो शुरू तो हो सके पर त्रुटि दे दे → एक बार चेतावनी दें, दर्ज करें, जारी रखें; इसके लिए कभी कार्य को विफल न करें।
- पूर्ण पास के बाद गेट:
criticalनिष्कर्ष सुधार या स्पष्ट स्वीकृति तक Final Review की पूर्णता को अवरुद्ध करते रहते हैं।warning/infoदस्तावेज़ीकृत हैं लेकिन अवरोधक नहीं। - Flow A को CI सीक्रेट की आवश्यकता नहीं। अनसेट
CURSOR_API_KEYस्थानीय पास को दबाने में सक्षम नहीं होना चाहिए।
Flow B CI गेट (वैकल्पिक)
Action DailybotHQ/ai-diff-reviewer@v2, आमतौर पर लेबल-गेटेड (ready), ब्रांच सुरक्षा के लिए स्थिर नामित AI review gate जॉब और वैकल्पिक स्किप लेबल skip-review-label: skip-ai-review। साझा prompt.md + एक्सटेंशन पद्धति और गंभीरता को संरेखित करता है; Iteration-Aware Review के तहत CI राउंड 2+ छोटे हो सकते हैं जबकि स्थानीय पास पूर्ण रहता है।
वैकल्पिक apply-review साथी
CI समीक्षा पोस्ट करने के बाद, डेवलपर execute के दौरान apply-review को आमंत्रित कर सकता है ताकि सहमति के साथ निष्कर्षों की एक-एक करके समीक्षा की जा सके (लागू करें / स्थगित करें / छोड़ें)। डिफ़ॉल्ट रूप से केवल पठन; कभी प्लान टास्क फ़ाइल नहीं (अनिवार्य अंतिम-कार्य क्रम को तोड़ेगी)।
व्यवहार
- Flow A baseline है; Flow B पूछा जाता है, कभी अनुमान नहीं। अनुरोध के बिना वर्कफ़्लो इंस्टॉल करना Flow A पर बने रहने से बड़ा फुटप्रिंट है।
- समन्वय करें, ओवरराइट न करें। मौजूदा स्किल, एक्सटेंशन, या
pr-review.ymlसंरक्षित रहते हैं; केवल अंतराल भरें। - प्रमाणीकरण स्थगित। CI के लिए प्रोवाइडर सीक्रेट मेंटेनर द्वारा कॉन्फ़िगर किए जाते हैं; यह ऐड-ऑन कभी क्रेडेंशियल संग्रहीत नहीं करता।
- प्रोवाइडर-तटस्थ। किसी व्यावसायिक सेवा, CI प्रोवाइडर या सीक्रेट की कभी आवश्यकता नहीं होती; CI सतह ही एकमात्र हिस्सा है जो किसी प्रोवाइडर को छूता है।
नोट्स
संस्करण 2.3.0 से स्थानीय समीक्षा आवश्यक; CI सतह वैकल्पिक। अपस्ट्रीम स्किल: DailybotHQ/ai-diff-reviewer। स्पेक पेज: Add-ons।