ส่วนเสริม
เวอร์ชัน 2.0 ส่วนเสริมเป็นส่วนขยายเลือกได้ของวิธีการ Deep Work Plan หลัก ไม่จำเป็นสำหรับการสอดคล้อง — รีโพที่มี addon ศูนย์ตัวก็ AI-first และสอดคล้อง DWP ครบ แต่ละ addon ถูกเสนอระหว่าง onboarding ยอมรับหรือปฏิเสธอย่างชัดเจน และเมื่อยอมรับจะ กระทบกัน กับการตั้งค่าที่มีแทนการทับล้าง
สัญญา addon
ทุก addon ที่จัดส่งมีสี่ส่วนประกอบบังคับ:
| ส่วนประกอบ | วัตถุประสงค์ |
|---|---|
| Spec | คำอธิบาย normative แบบ RFC-2119 ว่า addon ให้อะไรและ “สอดคล้องกับ addon นี้” หมายถึงอะไร |
| Reasoning templates | แนวทางที่เอเจนต์เติมโดยให้เหตุผลจาก stack ของรีโพเป้าหมาย — ไม่ใช่ copy-paste |
| Onboarding hook | จุดเข้า SKILL.md ที่ขั้นตอน onboard เรียกเมื่อนักพัฒนายอมรับ |
| Validation step | เช็กลิสต์ยืนยันว่า addon ถูกนำไปใช้ถูกต้อง |
การค้นพบ: ขั้นตอน onboard นับ skills/deepworkplan/addons/ และนำเสนอแต่ละ addon เป็นขั้นตอน opt-in ใน Phase 7b หลัง scaffolding หลัก
Addon ที่จัดส่ง (ห้าตัว)
วันนี้มีห้า addon แต่ละตัวมี หน้าแคตตาล็อก kit พร้อมรายละเอียดสำหรับผู้ใช้ และ spec normative ภายใน skill Deep Work Plan
Devcontainer (addon แรก)
การตั้งค่า .devcontainer/ + docker/ แบบ compose ที่ให้เหตุผลจาก stack ที่ตรวจพบ
- หน้า kit: Devcontainer
- สิ่งที่เพิ่ม: volume auth AI-CLI ถาวร (Claude, Codex, Cursor, gh, Dailybot)
dailybot-project-networkDOCKER_DEV_ENV=vscodealias การตรวจสอบ (codecheck,check,fix,test) สุขอนามัย secret แบบ public-OSS - พฤติกรรม: ~85% โครงคงที่ ~15% ให้เหตุผลต่อ stack devcontainer ที่มีอยู่ถูกกระทบกัน ไม่ทับล้าง
- เมื่อเสนอ: รีโポส่วนใหญ่ที่มี Docker หรือบริการที่ได้ประโยชน์จาก dev container แยก
Dailybot (addon ที่สอง)
การเชื่อม opt-in กับ ทีม Dailybot ของนักพัฒนาเพื่อมองเห็นความคืบหน้าของเอเจนต์
- หน้า kit: Dailybot — อ้างอิงความสามารถครบ
- สิ่งที่ DWP addon เชื่อม: รายงาน lifecycle แผนสี่แบบ (kickoff, significant task, blocked, completion) ผ่าน sub-skill dailybot
report; การบังคับใช้ hook แบบ deterministic แบบเลือกได้ (dailybot hook, CLI>= 3.7.0) - Skill คู่กัน: ติดตั้ง DailybotHQ/agent-skill (ปัจจุบัน 3.10.3) เปิด 14 ความสามารถ — แชทบน Slack/Teams/Discord/Google Chat check-in การเขียนฟอร์ม ask AI kudos per-repo API keys (
.dailybot/env.json) อีเมล และอื่นๆ DWP addon เชื่อมเฉพาะ report ความสามารถอื่นเรียกผ่าน skill Dailybot โดยตรง - Auth: มอบหมายทั้งหมดให้ skill Dailybot (
dailybot loginหรือDAILYBOT_API_KEY) addon นี้ไม่เก็บ credentials - Guardrail แบบ vendor-neutral: DWP หลัก ไม่พึ่งพา Dailybot เลย อย่าติดตั้งอัตโนมัติให้ทุกคน
- เมื่อเสนอ: นักพัฒนาหรือทีมใช้ Dailybot อยู่แล้ว หรือขอการรายงานทีมอย่างชัดเจน
Dependency upgrade (addon ที่สาม)
การอัปเกรด dependency แบบไม่ผูก package manager แบ่ง batch ตรวจสอบ และย้อนกลับได้
- หน้า kit: Dependency upgrade
- สิ่งที่เพิ่ม: ตรวจ manager จริง ของรีโพ (npm/pnpm/yarn + ncu, pip/poetry/uv, cargo, go mod, bundler, composer, …) อัปเกรดเป็น batch ตาม semver รัน validation gate ของรีโพหลังแต่ละ batch ย้อนเมื่อล้มเหลว สรุปโดยไม่ auto-commit
- คำสั่ง: ติดตั้ง
/lib-upgradeใน.agents/commands/เฉพาะเมื่อยอมรับ - เมื่อเสนอ: มี lockfile และ stack หนัก dependency แนะนำเฉพาะเมื่อเกี่ยวข้อง
Design system (addon ที่สี่)
DESIGN.md ขอบเขตพื้นผิวอินเทอร์เฟซที่ coding agent ใดๆ อ่านเพื่อ UI CLI หรือผลลัพธ์แบบสนทนาที่สอดคล้อง
- หน้า kit: Design system
- สิ่งที่เพิ่ม:
docs/DESIGN.md(อ้างอิงจากAGENTS.md) สูงสุดสาม profile ในไฟล์เดียว: visual-ui (โทเค็นและคอมโพเนนต์ UI ที่เรนเดอร์) cli-output (สไตล์เทอร์มินัลเชิงความหมาย การเสื่อม TTY/NO_COLOR) conversational (น้ำเสียง โครงสร้างข้อความ การเรนเดอร์ต่อแพลตฟอร์มพร้อม fallback ข้อความธรรมดา) - ความแรงของ profile: visual-ui เปิดโดยค่าเริ่มต้นเมื่อตรวจพบ cli-output และ conversational แนะนำเมื่อตรวจพบ ถามเสมอ ไม่ auto-apply
- เมื่อเสนอ: เฉพาะเมื่อตรวจพบพื้นผิวอินเทอร์เฟซสำหรับผู้ใช้ — ไม่ใช่ไลบรารีล้วน บริการ headless หรือรีโพ infra เท่านั้น
AI Diff Reviewer (addon ที่ห้า)
การเชื่อมต่อแบบเลือกใช้กับ AI Diff Reviewer (marketplace “AI Diff Reviewer” เวอร์ชันปัจจุบัน v2.0.0) ที่เสริมการตรวจสอบความปลอดภัยบังคับด้วยการตรวจสอบในเครื่องแบบมีโครงสร้าง และเลือกที่จะควบคุม pull request ใน CI
- หน้า kit: AI Diff Reviewer — ข้อมูลอ้างอิงความสามารถเต็มรูปแบบ
- สิ่งที่ DWP addon เชื่อมต่อ: การเสริมการตรวจสอบความปลอดภัยในเครื่องผ่านโฟลว์หลักเริ่มต้นของ skill ต้นทาง;
.review/extension.mdที่จำเป็น (skill เพียงอย่างเดียวไม่สมบูรณ์); Flow B ติดตั้งpr-review.yml(DailybotHQ/ai-diff-reviewer@v2) ตามเลือกและนำเสนอapply-reviewเป็นผู้ช่วยที่นักพัฒนาเรียกใช้ได้ — ไม่เคยเป็นไฟล์งานของแผน - โฟลว์: A — เฉพาะในเครื่อง (skill + ส่วนขยาย) หรือ B — สองพื้นผิว (skill + ส่วนขยาย + CI Action) addon ต้องถาม โฟลว์ใด; ไม่เคยสันนิษฐานค่าเริ่มต้น
- ความล้มเหลวแบบนุ่มนวลเทียบกับเกท: ข้อผิดพลาดของ skill/ส่วนขยาย/การเรียกที่หายไปไม่เคยบล็อก; ผลการค้นพบ
criticalจากการรันในเครื่องที่ เสร็จสิ้น ยังคงปฏิบัติตามสัญญาการตรวจสอบความปลอดภัย - ความเท่าเทียม (Flow B):
prompt.mdที่ใช้ร่วมกัน + ส่วนขยายจัดแนวระเบียบวิธีและระดับความรุนแรง; Iteration-Aware Review ของ CI อาจทำให้รอบที่ 2+ สั้นลงในขณะที่การรันในเครื่องยังคงสมบูรณ์ - การป้องกันที่เป็นกลางต่อผู้ให้บริการ: DWP หลักมีการพึ่งพา AI Diff Reviewer เป็นศูนย์; ไม่เคยติดตั้งให้ทุกคนโดยอัตโนมัติ
- เมื่อเสนอ: นักพัฒนาหรือทีมต้องการการตรวจสอบในเครื่องแบบมีโครงสร้างและ/หรือเกทการรวม PR CI
Skills
Skills เป็นขั้นตอนที่ใช้ซ้ำได้ เรียกด้วยชื่อ skill ห่อ workflow ที่ทำซ้ำได้ (รันเทสต์ แก้ lint สร้างคอมโพเนนต์)
วิธีการจัดส่ง sub-skill หลักชุดเล็ก ในบรรดานั้น sub-skill author ให้รีโพ ขยาย kit ของตนเอง: เรียกผ่าน /skill-create และ /agent-create ให้เหตุผลจาก layout .agents/ และแบบแปลงที่มี แล้วเขียน skill เอเจนต์ หรือ command delegator บางๆ ที่ตรงกัน และซิงก์แคตตาล็อก sub-skill เดียวกันทำงาน Skills & Agents Discovery บังคับ
รายการ kit: Skill create, Agent create
Agents
Agents เป็นผู้ทำงานเฉพาะทางที่มีบทบาทชัด (reviewer, executor, architect) อยู่ภายใต้ .agents/agents/ และอยู่ในแคตตาล็อกที่ .agents/docs/
Addon บำรุงรักษา
addon dependency-upgrade (ด้านบน) เป็น addon บำรุงรักษาหลัก ให้เหตุผลจาก package manager จริงของรีโพแทนการสมมติ npm จัดประเภทอัปเกรดตาม semver อัปเกรดเป็น batch ปลอดภัย รันการตรวจสอบหลังแต่ละ batch และย้อน batch ที่ล้มเหลว
Addon design-system
ดู Design system ภายใต้ addon ที่จัดส่ง DESIGN.md ระดับรีโพต่างจากเอกสารออกแบบเทคนิคต่อฟีเจอร์: README แผน DWP เกณฑ์การยอมรับงาน และ validation gate ครอบคลุมการออกแบบต่อฟีเจอร์อยู่แล้ว addon design-system เติมบริบทการออกแบบ อินเทอร์เฟซ ถาวรแบบ repo-native
Presets
Presets ปรับ DWP ให้เข้ากับ tech stack เฉพาะ (Django, React, Go, Astro + Svelte และอื่นๆ) เรียกดู แคตตาล็อก kit
Adapters
Adapters แมปคำสั่ง DWP ไปยังระบบคำสั่งของเอเจนต์เฉพาะ (Claude Code, Cursor, Codex, Gemini, Copilot, OpenClaw และอื่นๆ) รายการ adapter อยู่ใน kit ภายใต้ชื่อแต่ละเอเจนต์
Examples
Examples แสดง DWP ในทางปฏิบัติ: เปรียบเทียบก่อน/หลัง แผนตัวอย่าง กรณีศึกษา ดู Examples และ Dogfood this site
การเตือนเรื่องการสอดคล้อง
รีโพ ต้อง สอดคล้องครบด้วย addon ศูนย์ ตัว addon เป็นความสามารถ opt-in แบบชั้น — ไม่ใช่เงื่อนไขเบื้องต้น ดู Conformance