BWOC Handbook (ฉบับภาษาไทย)¶
จุดเริ่มต้นเดียวสำหรับทุกคนที่ ใช้ สร้าง ดูแล หรือ index BWOC framework — เฟรมเวิร์กสำหรับสร้างและสั่งงาน AI agent ที่ทำงานได้กับหลาย backend ผ่าน CLI ตัวเดียวคือ bwoc
🇬🇧 English (ฉบับหลัก/canonical):
README.md· repo เฟรมเวิร์ก:bemindlabs/BWOC-Framework· v2.24.0 · เอกสารต้นฉบับ (EN/TH):docs/
คู่มือชุดนี้ แยกตามบทบาทและมีสองภาษา อังกฤษเป็นฉบับหลัก (canonical) ไทยเป็นฉบับคู่ขนาน (*.en.md ↔ *.th.md) เปิดเล่มของคุณ อ่านจบในเล่มเดียว แล้วค่อยตามลิงก์เข้าไปอ่านเอกสารเฟรมเวิร์กฉบับเต็มเมื่อต้องการ
เปิดเล่มของคุณ¶
| คุณคือ… | เปิด | สรุปสั้น |
|---|---|---|
| 🧭 ทำไมต้อง BWOC — การออกแบบ เหตุผล & ความสัมพันธ์กับหลักธรรม | TH · EN |
เสาหลักการออกแบบ, จุดที่ DDD/SOLID บาง, ตารางแมป 22 กรอบ, ทำไมควรใช้ |
| 🧑💻 ผู้ใช้งาน — รันเอเจนต์ คุย ตั้งทีม สั่งงาน (ไม่แก้โค้ด) | TH · EN |
ติดตั้ง สร้าง workspace สั่งงานด้วย bwoc |
| 🛠️ นักพัฒนา — ต่อยอด/แก้ตัวเฟรมเวิร์ก (Rust, CLI, harness) | TH · EN |
แผนผัง crate, build/test, hooks, เวอร์ชัน, PR gates |
| 🤖 ผู้สร้าง/ดูแลเอเจนต์ | TH · EN |
โครงไฟล์, กฎ AGENTS.md, slot, manifest, วงจรชีวิต, bwoc check |
| ✍️ Persona · Mindsets · Skills — เขียนตัวตน & ความสามารถของเอเจนต์ | TH · EN |
slot WHO/HOW/WHAT; frontmatter, tag principle//domain/, maturity L1–L7 |
| 🌱 Self-improvement — เอเจนต์เรียนรู้ ทบทวน และพัฒนาตัวเองยังไง | TH · EN |
learning loop (ศึกษา/ไตร่ตรอง/ลงมือ), memory tiers, curation, maturity, เมตริก |
| 🔌 Backends — ขับ & ตั้งค่าผ่านแต่ละ CLI | TH · EN |
Claude/Codex/AGY/Kimi/Copilot/Ollama; ตั้งค่าด้วย prompt หลัง init |
| 🔎 AI search / ตัวค้นหา | TH · EN + llms.txt |
ข้อเท็จจริงตัวจริงอยู่ไหน อ้างอิงยังไง อย่ามั่ว |
| 🕷️ Crawler / ตัว index | TH · EN + robots.txt + sitemap.md |
นโยบายเก็บข้อมูล สัญญาณความสด index อะไรบ้าง |
🧩 อยากเห็นภาพทั้งตระกูล — ทุกโปรเจกต์ BWOC & bwoc-* |
TH · EN |
แต่ละโปรเจกต์คืออะไร ใช้ stack อะไร เชื่อมกับ core ยังไง |
บทเพิ่มเติม:
| หัวข้อ | เปิด | สรุปสั้น |
|---|---|---|
| 🚀 Quickstart — สร้าง agent แรกใน ~10 นาที | TH · EN |
ครบจบ: install → init → new → run → team → retire |
| 🧍 Single-agent workspace — เอเจนต์เดียว ไม่ต้องมีฝูง | TH · EN |
bwoc init --single-agent; ใช้เมื่อไหร่; โตเป็น fleet ทีหลัง |
| 🛡️ Security & ทีม tianting | TH · EN |
threat model, Sīla 5, trust ลงนาม, ทีม security 8 องค์ |
| 🌐 ข้าม workspace & โปรโตคอล | TH · EN |
bwoc peer, A2A, MQTT — เอเจนต์ข้ามเครื่อง |
| 🖥️ โฮสต์เอง (Harness) | TH · EN |
รันบน Ollama / OpenAI-compatible ผ่าน bwoc-harness |
| 🛰️ ปฏิบัติการระดับฝูง | TH · EN |
รันหลายเอเจนต์: fleet health, supervise, sessions, doctor |
| 🏛️ Council — การตัดสินใจของฝูง | TH · EN |
propose → discuss → vote → resolve; แบบจำลองการลงคะแนน; บันทึก decision |
| ❓ FAQ & แก้ปัญหา | TH · EN |
คำถามบ่อย + ตาราง อาการ→สาเหตุ→วิธีแก้ |
| 🤖 Chat Connectors (Telegram & Discord) | TH · EN | นำเอเจนต์เข้า Telegram & Discord ผ่าน bwoc-connect |
| 🟢 Google Workspace | TH · EN | เชื่อม Gmail/Drive/Calendar ผ่าน plugin gws |
| 📋 Jira & SCRUM | TH · EN | plugin jira-cloud-rest + skill scrum-via-jira (sprint sync) |
| 🛡️ ISO Standards Audit | TH · EN | ตรวจ ISO 9001/27001/20000-1/29110 ด้วย audit plugins |
| 🎯 OKR Plugin | TH · EN | ตั้ง/ติดตาม OKR ด้วย plugin okr (local-file) |
| 🧩 การเขียน Plugin | TH · EN | เขียน plugin: kinds, manifest, วงจรชีวิต, schemas, write gate |
BWOC คืออะไร — สรุป 5 ข้อ¶
- หนึ่งโฟลเดอร์ = หนึ่งเอเจนต์ สร้างจากเทมเพลต ตัวตน/วิธีคิด/ทักษะ แยกเก็บเป็นโฟลเดอร์ย่อย (slot)
- ไม่ผูกกับ backend ใด เอเจนต์ตัวเดียวรันได้ทั้ง Claude, Codex, Kimi หรือโมเดลที่โฮสต์เอง (Ollama / endpoint แบบ OpenAI-compatible) ผ่าน
bwoc-harness— ไม่เอนเอียงเจ้าใด - ออกแบบบนหลักคิดที่ชัดเจน มีศัพท์เฉพาะบ้าง แต่ทุกคำแปลเป็นเรื่องวิศวกรรมจริง — ไม่ต้องรู้ศัพท์ก็ใช้งานได้ อยากรู้ค่อยเปิด glossary
- หน่วยความจำถาวรที่รู้จักลืม สะสมความรู้ข้ามรอบงาน และตัดของเก่าอย่างมีวินัย (
MEMORY.mdไม่เกิน 200 บรรทัด) - หลายเอเจนต์ทำงานร่วมกันได้ปลอดภัย แชร์ task list มีทีม มีคะแนนความเชื่อใจ โดยไม่ชนกัน
วงจรชีวิตที่ทุกอย่างใน BWOC เดินตาม¶
| ช่วง | เรียกง่าย ๆ | เกิดอะไร | คำสั่ง |
|---|---|---|---|
| 1 | เกิด | สร้างตัวตน อ่าน manifest ประกาศความสามารถ | bwoc new, bwoc init |
| 2 | อยู่/ทำงาน | ทำงานจริง สถานะ+หน่วยความจำค่อย ๆ เปลี่ยน | bwoc spawn, chat, run, supervise |
| 3 | ปลด | เก็บกวาด ปิด branch ตัดหน่วยความจำ ปิดงาน | bwoc retire, stop |
เอกสารเฟรมเวิร์กเรียกสามช่วงนี้ด้วยศัพท์บาลี uppāda · ṭhiti · vaya — ไม่ต้องจำ ใช้ "เกิด / อยู่ / ปลด" พอ
ข้อตกลงร่วม¶
- คู่มือ vs ต้นฉบับ คู่มือนี้ ปูพื้นและสรุป ตัวจริงคือ repo เฟรมเวิร์ก
bemindlabs/BWOC-Framework(crates/,docs/en+docs/th, สเปกmodules/agent-template/AGENTS.md) ขัดกันเมื่อไหร่ยึด repo แล้วช่วยแก้คู่มือ - สองภาษา อังกฤษหลัก ทุกหน้าเป็น
*.en.md(canonical) คู่กับ*.th.mdแก้พร้อมกันในครั้งเดียว - ภาษาเรียบง่าย ศัพท์เฉพาะอธิบายตอนใช้ครั้งแรก และลิงก์ไป glossary
- คำสั่ง เป็นของ CLI
bwoc— ดูของจริงล่าสุดbwoc help getting-startedหรือbwoc <คำสั่ง> --help - เวอร์ชันขยับตลอด เช็คเลขปัจจุบันที่
VERSION.md - ลิงก์ห้ามชี้เข้า private workspace ทุกการอ้างอิงซอร์สเฟรมเวิร์กชี้ไป GitHub repo สาธารณะเท่านั้น ไม่ใช้ path ในเครื่อง เช่น
projects/bwoc-framework
ทางลัด¶
# แค่อยากใช้งาน
bwoc init ./my-workspace && cd my-workspace && bwoc list
# อยากสร้างเอเจนต์ (template ตรวจจับเองจาก framework clone ใน ancestor ของ cwd)
bwoc new sage --role "research assistant" --target agents/agent-sage
bwoc check agents/agent-sage
# อยากพัฒนาตัวเฟรมเวิร์ก (จาก clone ของ github.com/bemindlabs/BWOC-Framework)
git clone https://github.com/bemindlabs/BWOC-Framework && cd BWOC-Framework
cargo build && cargo test
# เป็นเครื่องที่มา index เนื้อหานี้
cat llms.txt