POBIM avatar

boq

Comprehensive BOQ (Bill of Quantities) creation and management for construction projects. This skill

提供方 POBIM|开源

BOQ Skill - README

โครงสร้าง Folder

.claude/skills/boq/
├── boq_helper.py           # Core script สำหรับสร้างและจัดการ BOQ
├── validate_boq.py         # Validation script ตรวจสอบสัดส่วนงบประมาณ
├── recalc.py              # Formula recalculation script
├── BEST_PRACTICES.md      # คู่มือแนวทางการจัดทำ BOQ
├── skill.md               # Skill documentation
├── examples/              # ตัวอย่างการใช้งาน
│   ├── create_house_boq.py
│   └── README.md
└── README.md             # ไฟล์นี้

workspace/boq_examples/    # Output folder สำหรับไฟล์ BOQ ที่สร้าง
└── BOQ_*.xlsx

การใช้งาน

Quick Start

# สร้าง BOQ บ้านพักอาศัย 2 ชั้น (ตาม Best Practices)
cd .claude/skills/boq
python examples/create_house_boq.py

ไฟล์ BOQ จะถูกสร้างที่: workspace/boq_examples/BOQ_House_2Story_4M_[timestamp].xlsx

สร้าง BOQ แบบกำหนดเอง

python boq_helper.py create output.xlsx "ชื่อโครงการ" "สถานที่" "ลูกค้า"

ตรวจสอบสัดส่วนงบประมาณ

from validate_boq import validate_from_data

boq_totals = {
    "งานเตรียมการ": 186916,
    "งานโครงสร้าง": 1122092,
    "งานสถาปัตยกรรม": 1495327,
    "งานระบบไฟฟ้า": 448598,
    "งานระบบสุขาภิบาล": 485981
}

validate_from_data(boq_totals)

Best Practices

สัดส่วนงบประมาณมาตรฐาน (สำหรับบ้านพักอาศัย):

  • งานเตรียมการ: ≤ 5%
  • งานโครงสร้าง: 28-32% (เป้าหมาย 30%)
  • งานสถาปัตยกรรม: 38-42% (เป้าหมาย 40%)
  • งานระบบไฟฟ้า: 10-14% (เป้าหมาย 12%)
  • งานระบบสุขาภิบาล: 12-16% (เป้าหมาย 13%)

อ่านรายละเอียดเพิ่มเติมใน BEST_PRACTICES.md

Files Description

Core Scripts

  • boq_helper.py - สร้างและจัดการ BOQ (create, add items)
  • validate_boq.py - ตรวจสอบสัดส่วนงบประมาณ
  • recalc.py - คำนวณ formula ใน Excel

Documentation

  • BEST_PRACTICES.md - แนวทางการจัดทำ BOQ ที่ถูกต้อง
  • skill.md - Skill documentation (API reference)
  • README.md - ไฟล์นี้

Examples

  • examples/create_house_boq.py - ตัวอย่างสร้าง BOQ บ้าน 2 ชั้น
  • examples/README.md - คำอธิบายตัวอย่าง

หมายเหตุสำคัญ

  1. Output Location: ไฟล์ BOQ จะถูกสร้างที่ workspace/boq_examples/ เสมอ เพื่อแยกออกจาก skill folder
  2. Best Practices: ควรตรวจสอบสัดส่วนด้วย validate_boq.py ก่อนส่งมอบทุกครั้ง
  3. Formula: ใช้ Excel formula เสมอ อย่าคำนวณใน Python
  4. Thai Language: Skill นี้รองรับภาษาไทยเต็มรูปแบบ

ตัวอย่าง BOQ ที่ได้

BOQ ที่สร้างจะมี:

  • ข้อมูลโครงการ (ชื่อ, สถานที่, ลูกค้า)
  • 5 หมวดงานมาตรฐาน
  • Formula อัตโนมัติ (ราคารวมวัสดุ, ค่าแรงรวม, รวมราคา)
  • รวมทั้งโครงการ (ก่อนและหลัง VAT 7%)
  • Format สวยงาม มีสี มี border

การพัฒนาต่อ

หากต้องการเพิ่มตัวอย่างใหม่:

  1. สร้างไฟล์ใน examples/
  2. ตั้งค่า output path ให้ชี้ไปที่ workspace/boq_examples/
  3. เพิ่มคำอธิบายใน examples/README.md

Last updated: 2025-10-29

下载 Skill