รายงานข้อผิดพลาด Slack ไปยังการแก้ไข GitHub

สิ่งที่ Okou มอบให้: จากข้อความ Slack ไปจนถึงการแก้ไขในการตรวจสอบ

เธรดจริงจากช่อง #bug-report ของทีม Okou ที่บันทึกไว้ขณะที่เกิดขึ้น เพื่อนร่วมทีมวางรายงานของลูกค้าและขอการแก้ไข สี่นาทีต่อมา Okou ได้ยื่นปัญหา GitHub พร้อมการวินิจฉัย สิบสี่นาทีหลังจากข้อความแรก มันได้เปิดคำขอดึงและโพสต์ลิงก์ตัวอย่าง ด้านล่างนี้คือทั้งสองส่วนที่บันทึกไว้: เธรดที่เริ่มต้น และคำขอดึงที่ Okou เขียน พวกเขาเป็นสาธารณะ ดังนั้นคุณสามารถอ่านปัญหา ความแตกต่าง และการตรวจสอบได้ด้วยตัวเอง

คลิกเพื่อเปิดขนาดเต็ม

การสร้างปัญหา GitHub จาก Slack หมายความว่าอย่างไร

การสร้างปัญหา GitHub จาก Slack หมายถึงการเปลี่ยนข้อบกพร่องที่ใครบางคนอธิบายในการสนทนาให้เป็นปัญหาที่มีโครงสร้างที่เหมาะสมในที่เก็บของคุณ โดยที่ไม่มีใครต้องออกจากเธรดเพื่อพิมพ์ใหม่ ส่วนที่ยากไม่เคยเป็นการเรียก API; มันคือการเขียนชื่อที่ชัดเจน, การแยกขั้นตอนการทำซ้ำออกจากพฤติกรรมที่คาดหวัง, การเลือกป้ายกำกับ, การตั้งค่าลำดับความสำคัญ, และการหาเจ้าของที่เหมาะสม Okou ทำงานนั้น มันอ่านข้อความ Slack และการตอบกลับรอบๆ, เขียนเนื้อหาปัญหา, ใช้ป้ายกำกับและลำดับความสำคัญที่สามารถอธิบายได้, แก้ไขผู้รับมอบหมายโดยการจับคู่ชื่อที่แสดง Slack กับชื่อผู้ใช้ GitHub, และโพสต์ลิงก์ปัญหาในเธรดเดียวกันเพื่อให้ผู้รายงานสามารถตรวจสอบได้ในพริบตา

ทำไมรายงานข้อบกพร่องถึงหายไปในเธรด Slack

มีคนพบข้อผิดพลาดระหว่างการสาธิต หรือลูกค้าเขียนเข้ามาในวันเสาร์ เส้นทางเก่าใช้เวลานาน: เปิด GitHub, ค้นหาที่เก็บ, เขียนปัญหาที่จัดรูปแบบ, มอบหมายให้ใครบางคน, จากนั้นรอให้คนนั้นรับงาน, อ่านโค้ด, และเขียนการแก้ไข การเปลี่ยนแปลงสิบนาทีกลายเป็นการเดินทางไปกลับหลายวันข้ามสามคน และครึ่งหนึ่งของรายงานไม่เคยหลุดออกจากเธรดเลย แทนที่จะเป็นเช่นนั้น คุณอธิบายมันใน Slack Okou จะยื่นปัญหาพร้อมขั้นตอนการทำซ้ำ, ป้ายกำกับ, และเจ้าของ และในกรณีที่สาเหตุถูกจำกัด มันจะดำเนินการและเปิดคำขอดึงพร้อมการแก้ไขและการทดสอบ คุณตรวจสอบและจัดส่ง

Okou สร้างปัญหา GitHub จาก Slack ได้อย่างไร

ขั้นตอนที่ 1: เชื่อมต่อเครื่องมือของคุณ

GitHub

จำเป็น

การเชื่อมต่อ OAuth กับ GitHub Okou ต้องการสิทธิ์อ่าน/เขียนเพื่อสร้างปัญหา และเมื่อมีการแก้ไข เพื่อพุชสาขาและเปิดคำขอดึง

เชื่อมต่อ

Slack

จำเป็น

Okou อ่านข้อความของคุณและตอบกลับในเธรดเดียวกัน

เชื่อมต่อ

การรวม Slack และ GitHub ที่อยู่เบื้องหลังเวิร์กโฟลว์

นี่คือการผสานรวม Slack GitHub กับเอเจนต์ตรงกลาง: Okou อ่านการสนทนาใน Slack และเขียนบันทึกใน GitHub ตัวเชื่อมต่อแต่ละตัวจะได้รับสิทธิ์แยกต่างหากและจำกัดขอบเขตตามสิ่งที่เวิร์กโฟลว์ใช้งานจริง ดังนั้นการอ่านช่องทางจึงไม่เคยหมายถึงสิทธิ์ในการเขียนไปยังที่เก็บของคุณ

การรวม Slack: การสนทนา Okou อ่าน

จำเป็น

Okou อ่านข้อความที่คุณชี้ไปและข้อความตอบกลับรอบๆ ดังนั้นบริบทที่มาถึงสามข้อความต่อมาก็ยังคงอยู่ในประเด็น มันจะเลือกภาพหน้าจอที่แนบมาและนำติดตัวไปด้วย อ่านชื่อที่แสดงของผู้รายงานเพื่อแก้ไขผู้รับมอบหมาย และเก็บลิงก์ถาวรของข้อความไว้เพื่อให้ทุกประเด็นเชื่อมโยงกลับไปยังจุดเริ่มต้นของรายงาน การเขียนมีเพียงสิ่งเดียวเท่านั้น: การตอบกลับในเธรดเดียวกันพร้อมหมายเลขประเด็นและลิงก์ Okou จะไม่โพสต์ไปยังช่องทางอื่น ส่ง DM หรือแก้ไขข้อความของใครก็ตาม

การผสานรวม GitHub: ปัญหาที่ Okou ยื่น

จำเป็น

Okou สร้างปัญหาในที่เก็บที่คุณตั้งชื่อ โดยมีชื่อเรื่องที่เขียนจากรายงานแทนที่จะเป็นสำเนาของข้อความดิบ คำอธิบาย ขั้นตอนในการทำซ้ำ พฤติกรรมที่คาดหวัง และพื้นที่ที่ได้รับผลกระทบเมื่อเธรดระบุชื่อ มันใช้ป้ายกำกับที่คุณระบุหรืออนุมานจากถ้อยคำ กำหนดลำดับความสำคัญที่อธิบาย และมอบหมายเจ้าของ ก่อนที่จะยื่นเรื่อง มันจะค้นหาปัญหาที่เปิดอยู่สำหรับอาการเดียวกันและแสดงความคิดเห็นในปัญหาที่มีอยู่แทนเมื่อพบการจับคู่ เมื่อมันสามารถแก้ไขข้อบกพร่องได้ มันจะพุชสาขาและเปิดคำขอดึงที่ปิดปัญหาและขอการตรวจสอบ การเข้าถึงการเขียนถูกจำกัดขอบเขตไปยังที่เก็บที่คุณให้สิทธิ์ และนั่นคือพื้นผิวทั้งหมด: ปัญหา ความคิดเห็น และคำขอดึงที่เปิดสำหรับการตรวจสอบ Okou ไม่รวม ไม่บังคับพุช หรือแตะการตั้งค่าที่เก็บ

Okou เทียบกับแอป GitHub สำหรับ Slack เทียบกับเครื่องมือสร้างระบบอัตโนมัติ

การนำข้อผิดพลาดจากข้อความ Slack ไปยัง GitHub มีสามส่วน: การจับภาพรายงาน การเขียนปัญหาที่ใช้งานได้ และการส่งต่อไปยังเจ้าของ ตัวเลือกที่มีอยู่แต่ละตัวแก้ปัญหาหนึ่งในนั้น

เคล็ดลับเพื่อผลลัพธ์ที่ดีขึ้น

คำถามที่พบบ่อย