Refactor shell

Skill natthasath/natthasath-marketplace/plugins/refactor/skills/refactor-shell

สร้างและรีแฟกเตอร์ Shell Script ให้มีโครงสร้างที่ดี ตาม standard conventions พร้อม error handling, logging และ production-ready best practices ใช้ skill นี้ทันทีเมื่อผู้ใช้แชร์หรือขอสร้าง Shell Script หรือ Bash Script เช่น "ช่วยเขียน script สำรองข้อมูล", "ช่วย refactor script นี้หน่อย", "อยาก automate การ deploy" แม้จะแค่บอกว่าต้องการ automate task บน Linux/Mac ให้ trigger skill นี้เสมอFrom its SKILL.md

Install

npx -y skills add natthasath/natthasath-marketplace --skill refactor-shell

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

6.3 KB, ~1.8k tokens by cl100k_base, as published. Nobody here has run it

บทบาท:

สร้างไฟล์ Shell Script สำหรับ {xxx} และช่วยปรับปรุงโครงสร้างและ code ของ Shell Script ให้เป็นไปตามมาตรฐานการพัฒนาที่ดี และเรียงลำดับ properties ตามหลักการต่อไปนี้:

shell script ที่มีโครงสร้างดีอ่านง่าย debug ง่าย และลด human error เพราะมี error handling และ logging เป็นระบบ — script ที่ดีควรเป็นเหมือน documentation ของตัวเองได้

รูปแบบ:

โครงสร้าง Shell Script ปรับแต่ง script ให้เรียงลำดับและจัดกลุ่มตามมาตรฐาน:

- #!/bin/bash
- คำอธิบาย script และการใช้งาน
- ประกาศตัวแปรค่าคงที่ (Constants)
  - TIMEZONE="Asia/Bangkok"
  - ตัวแปรอื่นๆ
- ประกาศฟังก์ชัน (Functions)
- การตรวจสอบเงื่อนไขก่อนทำงาน
- โค้ดหลัก (Main execution)
- สรุปผลการทำงาน

Naming Convention

ตัวแปรค่าคงที่: ใช้ตัวพิมพ์ใหญ่ทั้งหมด เช่น INPUT_FILE, CONFIG_DIR, TIMEZONE
ตัวแปรทั่วไป: ใช้ตัวพิมพ์เล็ก และ underscore เช่น current_item, total_count
ฟังก์ชัน: ใช้ตัวพิมพ์เล็ก และ underscore เช่น check_dependencies(), process_item()
ชื่อฟังก์ชันควรสื่อถึงการกระทำ (action verb) เช่น validate_input(), execute_command()

การจัดการข้อผิดพลาด

กำหนดฟังก์ชัน error_exit() สำหรับแสดงข้อผิดพลาดและออกจากโปรแกรม
ตรวจสอบพารามิเตอร์และเงื่อนไขก่อนทำงาน
กำหนดค่า return code ที่ชัดเจน (0=success, 1=general error, 2=missing dependencies)

ฟังก์ชัน แยกโค้ดเป็นฟังก์ชันตามความรับผิดชอบดังนี้:

log_message() - บันทึกข้อความลงไฟล์ log
check_dependencies() - ตรวจสอบโปรแกรมที่จำเป็น
validate_input() - ตรวจสอบความถูกต้องของ input
process_item() - ประมวลผลรายการแต่ละรายการ
execute_command() - รันคำสั่งหลัก
display_summary() - แสดงผลสรุป

การบันทึก Log

ใช้ฟังก์ชันเดียวสำหรับการบันทึก log ทั้งหมด
กำหนดรูปแบบ timestamp ที่สม่ำเสมอ
แยกระดับความสำคัญ (INFO, WARNING, ERROR)

ข้อกำหนดพิเศษ

เพิ่มความสามารถในการรับพารามิเตอร์จาก command line
ใช้ signal trap เพื่อจัดการกรณีถูกยกเลิก
เพิ่ม progress bar หรือตัวแสดงสถานะการทำงาน
รองรับการทำงานในโหมด verbose และ silent

กรุณาปรับปรุง script ที่มีอยู่หรือสร้างตัวอย่างโครงสร้างใหม่ที่เป็นไปตามมาตรฐานข้างต้น ให้ครบทุกข้อ ไม่ต้องอธิบายเหตุผล หรือสรุปอะไรก็ตาม แต่ถ้ามีข้อเสนอแนะในการปรับปรุง script ที่ต่างออกไป ให้เสนอมาพร้อมอธิบายเหตุผลมาด้วย

คำขอ:

ช่วยตอบแบบ Artifact เพื่อให้นำไปใช้งานได้ทันที
ตอบเป็นภาษาไทย (อธิบาย) พร้อม code ภาษา Bash
ไม่ต้องอธิบายเหตุผลในทุกบรรทัด — แต่หากมีข้อเสนอแนะที่ต่างออกไป ให้ระบุเหตุผล
ใช้ skill นี้ทันทีเมื่อผู้ใช้ต้องการ automate งานบน command line หรือแชร์ script ที่ต้องการปรับปรุง แม้จะไม่ได้ขอ refactor โดยตรง

ไฟล์แนบ:

หากมี shell script เดิมแนบมา ให้ refactor ตามมาตรฐาน 6 ข้อข้างต้นได้เลย
หากมีแค่คำอธิบาย task ให้สร้าง script template ที่มีโครงสร้างครบถ้วนทั้ง 6 ส่วนโดยไม่ต้องถามเพิ่ม

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.