पाठ 23 / 26
Template और Workflow Skills
दस्तावेज़ और बहु-चरणीय workflows एकसमान रूप में बनाएँ।
निर्माण से ही एकरूपता
कई कार्य एक ही प्रकार का आउटपुट भरोसे से बनाने के हैं: release notes, incident रिपोर्ट, design docs, बैठक के सार, API दस्तावेज़, commit संदेश। Template (templates/ में), छोटी style guide (references/ में) और एक हल किए उदाहरण वाली skill हर आउटपुट को आपके format और लहजे का पालन करवाती है। Workflow skills कई चरणों को चौकियों के साथ जोड़ती हैं: तथ्य जुटाएँ (scripts से), मसौदा बनाएँ, नियमों से जाँचें, user से अनुमोदन माँगें, फिर समाप्त करें। उपयोगी विचार: ग़ायब इनपुट एक बार, शुरू में माँगें; अपरिवर्तनीय कार्रवाइयों से पहले अनुमोदन द्वार रखें; क्या किया गया उसकी checklist पर समाप्त करें; और निकास रास्ता दें ("repository में tags न हों तो पूछें किस commit से शुरू करें")। जहाँ मदद करे वहाँ रचनात्मक स्वतंत्रता (शब्दांकन) और जहाँ मायने रखे वहाँ कठोरता (संरचना, संख्याएँ, नाम) रखें।
अनुमोदन द्वारों वाला workflow (उदाहरण)
किसी अपरिवर्तनीय चीज़ से पहले चौकियाँ। यहाँ चलाया नहीं गया।
## Workflow
1. **Gather** (no side effects): run `scripts/collect.py`; if inputs are missing, ask for them once.
2. **Draft**: fill `templates/incident-report.md` using only collected facts.
3. **Check**: confirm every number and timestamp appears in the collected data.
4. **Approval gate**: show the draft and ask "Publish to the wiki? (yes/no)". Stop if no.
5. **Publish**: run `scripts/publish.py --page <name>` (only after a clear yes).
6. **Report**: list what was done and the page URL.ग़ायब इनपुट एक बार माँगें
बार-बार टोकने की जगह सभी आवश्यक इनपुट शुरू में जुटाएँ।
त्वरित जाँच: Workflow skill को अनुमोदन द्वार कहाँ रखना चाहिए?
- अपरिवर्तनीय या बाहरी कार्रवाइयों जैसे publish या delete से पहले
- सब कुछ हो जाने के बाद
- कभी नहीं
- सिर्फ़ पहली पंक्ति पर
Answer
अपरिवर्तनीय या बाहरी कार्रवाइयों जैसे publish या delete से पहले — अनुमोदन तभी उपयोगी है जब वह उस कार्रवाई से पहले हो जिसकी वह रक्षा करता है।