understand-docs-03-runbook

แยกเจตนาและข้อมูลสำคัญสำหรับงานDocumentationเรื่องเขียน runbook ใช้เมื่อผู้ใช้ขอวิเคราะห์ความต้องการ เลือก skill หรือขอแผนงาน โดยยังไม่ลงมือเปลี่ยนแปลงระบบ

SKILL.md

GitHub

Intent Understand: เขียน runbook

ใช้เมื่อ

ใช้เมื่อคำสั่งเกี่ยวข้องกับDocumentationเรื่องเขียน runbook และต้องแยกเจตนาก่อนลงมือทำ

ขั้นตอน

  1. อ่านคำสั่งและบริบทโดยไม่สันนิษฐานข้อมูลที่ไม่มีหลักฐาน
  2. สกัดเจตนา ข้อมูลนำเข้า ข้อจำกัด และผลลัพธ์ที่ผู้ใช้คาดหวัง
  3. ตรวจความกำกวมและทำเครื่องหมายสิ่งที่ต้องถามเพิ่ม
  4. แนะนำ Skill Execute ที่ตรงกันจาก registry โดยเลือกเฉพาะรายการใน allowlist
  5. กำหนดว่าเรื่องนี้ต้องขอการยืนยันก่อนหรือไม่

ผลลัพธ์ที่ต้องคืน

คืน intent, entities, ambiguities, recommendedSkillIds และ needsConfirmation เป็นข้อมูลที่ตรวจสอบต่อได้ ห้ามลงมือแก้ไฟล์ ส่งข้อมูล หรือเรียกบริการภายนอกในโหมดนี้

ข้อจำกัด

  • ใช้เฉพาะเครื่องมือและไฟล์ที่ได้รับอนุญาตในแผนงาน
  • ห้ามอ่านหรือคัดลอก secret, API key, token หรือข้อมูลส่วนตัว
  • ห้ามรันคำสั่งอิสระหรือแก้ไฟล์นอกขอบเขตโดยไม่ได้รับการยืนยัน
  • ต้องตรวจผลลัพธ์จริงก่อนรายงานว่าสำเร็จ
  • งานที่มีผลภายนอกต้องแสดงแผนและขอการยืนยันก่อนดำเนินการ