generalize
แปลง how-to หรือ instructions เป็น solution patterns ทั่วไปที่ใช้ซ้ำได้
SKILL.mdgeneralize/SKILL.md
GitHubGoal
แปลง skill หรือเอกสารที่เขียนแบบ how-to step-by-step เป็น solution patterns ทั่วไป ที่ระบุปัญหา เงื่อนไข ทางเลือก และ criteria ตัดสินใจ โดยไม่ผูกกับ tool/library/context เฉพาะ
Scope
ใช้เมื่อต้อง rewrite skill หรือข้อความให้:
- ไม่ใช่ how-to สำหรับ tool ตัวเดียว
- ใช้ได้หลาย context ด้วยการปรับเล็กน้อย
- อ่านแล้วรู้ว่าต้องแก้ปัญหาอย่างไร มากกว่าแค่ทำตามลำดับขั้น
Execute
1. Detect How-To Patterns
Goal: หาจุดที่เขียนเป็น step-by-step เฉพาะเจาะจง
- อ่าน target
SKILL.mdหรือเอกสาร - ทำเครื่องหมายทุกข้อที่เริ่มด้วย
ติดตั้ง,รัน,เพิ่ม,แก้ไข,ตั้งค่าโดยไม่มีเงื่อนไข - หาชื่อ tool/library ที่ปรากฏบ่อย และถามว่าเป็นตัวอย่างหรือเป้าหมายจริง
- บันทึก patterns ที่พบ เป็นรายการ
2. Extract Problem And Context
Goal: ระบุปัญหาทั่วไปที่ skill แก้
- ถาม: "ถ้าไม่มี tool/library เฉพาะนี้ ปัญหาคืออะไร?"
- ระบุ problem ในรูป:
เมื่อ <สถานการณ์> เกิด <ผลเสีย> - ระบุ context ทั่วไปที่ทำให้วิธีแก้ต่างกัน
- ลบชื่อ tool/library ออกจาก problem statement
3. Define Solution Pattern
Goal: เปลี่ยนขั้นตอนเป็น pattern ทั่วไป
- เปลี่ยนลำดับขั้นตอนเป็นรูปแบบ:
เมื่อ <condition> → <solution pattern> → <expected result> - แทนชื่อ tool ด้วยประเภท:
package manager,bundler,linter,database,runner,registry - ระบุ criteria ตัดสินใจระหว่าง solution ทางเลือก
- ถ้ามีหลาย solution → ใช้ decision tree หรือ bullet
เลือก X ถ้า Y
4. Generalize Step Instructions
Goal: แต่ละ step ไม่ผูก tool/technology
- เปลี่ยนคำสั่งเฉพาะ เช่น
bun addเป็นinstall package ด้วย package manager ที่ project ใช้ - ใช้ generic verbs:
prepare,configure,run,verify,fallback,isolate - ระบุ condition ก่อน command เสมอ
- ห้ามคัดลอก official docs ของ tool เข้า skill
5. Add Concrete Examples
Goal: ให้เห็นภาพ โดยไม่ผูก skill กับ tool ใด tool หนึ่ง
- ใส่ตัวอย่าง 2-3 กรณี ทีแตกต่างกัน (เช่น web, CLI, mobile, backend)
- ตัวอย่างต้องมี่
given → when → then - ถ้ามี code ตัวอย่าง → ระบุว่าเป็นตัวอย่างเท่านั้น และแทนด้วย type name
6. Validate Generalization
Goal: ตรวจว่า skill ใช้ซ้ำได้จริง
- อ่านทั้้ง skill แล้วถาม: "ถ้า tool เปลี่ยน ต้องแก้ไขกี่จุด?" ถ้ามากเกินไป → กลับไป generalize ต่อ
- ทำ
/write-explicitเพื่อตรวจความชัดเจน - ทำ
/deep-validateเพื่อตรวจ structure และ references - ทำ
/check-referenceเพื่อยื่นยันว่าrelatedถูกต้อง
Rules
1. Problem First
- เริ่มจากปัญหา ไม่ใช่ขั้นตอน
- ทุก solution pattern ต้องอธิบายว่าแก้ปัญหาอะไร
2. Conditional Not Prescriptive
- ใช้
ถ้า X → ทำ Yแทนทำ Yอย่างเดียว - ระบุข้อจำกัด/edge case ทีทำให้ solution ต่างกัน
3. Tool-Agnostic
- ไม่ผูก skill กับ tool/library ตัวใดตัวหนึ่ง
- ถ้าต้องระบุ tool จริง → ใช้เป็นตัวอย่าง ไม่ใช่ default
4. Reusable Patterns
- แต่ละ pattern ต้องใช้ซ้ำได้ใน context อื่น
- หลีกเลี่ยง project-specific details หรือ commit hashes
5. Explicit And Concise
- ทุก instruction มี action, condition, expected result
- ไม่ใช้ how-to filler หรือ generic advice ลอยๆ
Expected Outcome
- Skill หรือเอกสารไม่เขียนเป็น how-to อีกต่อไป
- ทุก section ระบุปัญหา เงื่อนไข ทางเลือก และ criteria ตัดสินใจ
- สามารถนำไปใช้กับหลาย tool/library โดยปรับเล็กน้อย
- ผ่าน
/deep-validateและ/check-reference