ส่วนเสริม

ขอบเขตเวอร์ชัน: นี่คือเอกสารพื้นฐาน v5.0.0 ที่ยังคงไว้ มาตรฐานปัจจุบัน DWP 7.0.0 ยังกำหนดให้ใช้ส่วนขยาย V6_*.md และ V7_*.md ที่เกี่ยวข้องตามรายการในดัชนีข้อกำหนด แผน v5 และ v6 ที่มีอยู่ยังคงใช้กฎที่บันทึกไว้

เวอร์ชัน 2.1.0 ส่วนเสริมเป็นส่วนขยายของวิธีการ Deep Work Plan หลัก จากแปดตัวมีเจ็ดตัวเป็นแบบเลือกใช้และ ไม่จำเป็นสำหรับการสอดคล้อง — รีโพที่มี addon เลือกใช้ศูนย์ตัวก็ AI-first และสอดคล้อง DWP ครบ แต่ละ addon ที่เลือกใช้ถูกเสนอระหว่าง onboarding ยอมรับหรือปฏิเสธอย่างชัดเจน และเมื่อยอมรับจะ กระทบกัน กับการตั้งค่าที่มีแทนการทับล้าง หนึ่งองค์ประกอบเป็นข้อยกเว้นที่ประกาศไว้: ตั้งแต่มาตรฐาน 2.3.0 การตรวจสอบในเครื่องของ AI Diff Reviewer เป็นส่วนหนึ่งของพื้นฐานที่จำเป็น — onboarding ติดตั้งมันและทุก Final Review รันมัน — ส่วนพื้นผิว CI ของมันยังคงเป็นแบบเลือกใช้

สัญญา addon

ทุก addon ที่จัดส่งมีสี่ส่วนประกอบบังคับ:

การค้นพบ: ขั้นตอน onboard นับ skills/deepworkplan/addons/ และนำเสนอแต่ละ addon เป็นขั้นตอน opt-in ใน Phase 7b หลัง scaffolding หลัก

Addon ที่จัดส่ง (แปดตัว)

วันนี้มีแปด addon — เจ็ดตัวเลือกใช้บวกการตรวจสอบในเครื่องที่จำเป็น แต่ละตัวมี หน้าแคตตาล็อก kit พร้อมรายละเอียดสำหรับผู้ใช้ และ spec normative ภายใน skill Deep Work Plan สี่ตัวในนั้น — devcontainer, Herdr, DeepWorkPlan Vim และ Agentkit — เป็นตัวผสานรวมแบบบางที่ปักหมุดด้วย tag กับผลิตภัณฑ์ที่มีรีโพและรอบการเผยแพร่ของตัวเอง ทุกผลิตภัณฑ์ทำงานได้โดยไม่ต้องมี Deep Work Plan addon ที่ยอมรับแล้วจะถูกบันทึกในทะเบียน addon .dwp/config.json (DWP 7.0.0) ซึ่งทำได้เพียงเสนอหรือเสริมความสามารถ — ไม่เคยเป็นเงื่อนไขของการสอดคล้องหรือของแผน

Devcontainer (addon แรก)

ตัวผสานรวมแบบบางของ devcontainer-kit (dck ตรึงไว้ที่ v1.0.1 อินเทอร์เฟซ 2): เทมเพลต Dev Containers ที่ dck init เรนเดอร์ลงในรีโพเป็นคอนเทนเนอร์ของรีโพเอง พร้อม skill dck-dockerfile

• หน้า kit: Devcontainer
• สิ่งที่เพิ่ม: docker/local/<service>/Dockerfile จากอิมเมจทางการของรันไทม์ที่ตรึงด้วย digest (python-3.13 node-24 หรือ debian ไม่มีอิมเมจพื้นฐานที่ใช้ร่วมกัน) dev.sh ที่ทำงานบนตัวเรียกใช้ dck (up, shell, rebuild, doctor) เอเจนต์เขียนโค้ดเป็นเลเยอร์แบบ opt-in พอร์ตเฉพาะ loopback git ผ่าน SSH โดยใช้ agent ของโฮสต์โดยไม่มีคีย์อยู่ภายใน เว้นแต่นักพัฒนาจะเลือกเปิดใช้ [ssh] copy_keys ในโปรไฟล์โฮสต์ของตน และเครื่อง Herdr ต่อคอนเทนเนอร์พร้อมเลย์เอาต์มาตรฐาน
• พฤติกรรม: ตรวจพบผ่าน dck doctor --json (อินเทอร์เฟซ 2) dck init กระทบยอด devcontainer ที่มีอยู่เฉพาะหลังจากยอมรับ diff แล้ว และสำรองไฟล์ก่อน — ไม่ทับล้าง
• เมื่อเสนอ: รีโพส่วนใหญ่ที่มี 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.9.0)
• Skill คู่กัน: ติดตั้ง DailybotHQ/agent-skill (ปัจจุบัน 3.23.14) เปิด 17 ความสามารถ — แชทบน Slack/Teams/Discord/Google Chat check-in การเขียนฟอร์ม ask AI kudos บอร์ดและงาน Plan label ขององค์กร 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/ เฉพาะเมื่อยอมรับ
• เมื่อเสนอ: เสนอให้ทุก repo ที่มี dependency ที่ประกาศไว้; ตัวมอบหมายแบบเฉื่อย /lib-upgrade จะติดตั้งภายใต้ความยินยอมของ onboarding เว้นแต่จะปฏิเสธอย่างชัดเจน — การติดตั้งไม่ได้รันการอัปเกรดใด ๆ

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 ที่ห้า — การตรวจสอบในเครื่องที่จำเป็น, พื้นผิว CI แบบเลือกใช้)

AI Diff Reviewer (marketplace “AI Diff Reviewer”) ทำให้การตรวจสอบความปลอดภัยบังคับของ Final Review มีการตรวจสอบในเครื่องแบบมีโครงสร้าง และเลือกที่จะควบคุม pull request ใน CI ตั้งแต่มาตรฐาน 2.3.0 การตรวจสอบในเครื่องเป็นส่วนหนึ่งของพื้นฐาน สิ่งที่เป็นแบบเลือกใช้คือพื้นผิว CI เท่านั้น addon นี้รีเฟรชอัตโนมัติตามรีลีส (release-auto-refreshed) ดังนั้นแท็กที่แสดงด้านล่างคือแท็กที่เป็นปัจจุบัน ณ เวลาที่เขียน และอาจตามหลังสำเนาที่ถูก vendor ไว้ — SKILL.md ของ addon เองและ GitHub releases ของมันคือแหล่งอ้างอิงที่ถูกต้องสำหรับแท็กที่ติดตั้งจริง การติดตั้งจะถูกตรึงไว้กับแท็กที่เผยแพร่แล้วเสมอ ไม่เคยตรึงกับ branch ที่เคลื่อนที่

• หน้า kit: AI Diff Reviewer — ข้อมูลอ้างอิงความสามารถเต็มรูปแบบ
• จำเป็นตั้งแต่ onboarding (Phase 7a): ติดตั้ง vendored skill แบบตรึงแท็ก (npx --yes skills add https://github.com/DailybotHQ/ai-diff-reviewer/tree/v3.3.14 --skill ai-diff-reviewer -y) พร้อม .review/extension.md ที่ปรับให้เข้ากับรีโพ (ผ่าน generate-extension) ภายใต้ความยินยอมของ onboarding; การอัปเกรด harness แบบเจาะจงกระทบทั้งสองเมื่อขาดหายไป; การปฏิเสธถูกบันทึกเป็นข้อยกเว้นที่ประกาศไว้และ verify รายงานจนกว่าจะถูกติดตั้ง
• จำเป็นในทุก Final Review: การตรวจสอบความปลอดภัยรันโฟลว์หลักเริ่มต้นของ upstream บนชุดการเปลี่ยนแปลงสะสมและผนวกผลลัพธ์เข้า analysis_results/SECURITY_REVIEW.md ท้องถิ่นของแผน (ภายในโฟลเดอร์ของแผนเอง ไม่ใช่ที่รูทของ repo); skill หรือส่วนขยายที่หายไปเป็นข้อค้นพบ local reviewer not installed ที่ถูกบันทึก — ไม่เคยข้ามอย่างเงียบ ๆ และไม่เคยเป็นการบูตสแตรปโดยไม่แจ้งล่วงหน้า: การติดตั้งเป็นของความยินยอมของ onboarding หรือการเรียกใช้ addon อย่างชัดเจน; ข้อค้นพบ critical ที่ผ่านการตรวจสอบแล้ว จากการรันที่เสร็จสิ้นบล็อกการเสร็จสิ้นจนกว่าจะแก้ไขหรือได้รับการยอมรับอย่างชัดเจน (v3, BC-07 — การอ้างสิทธิ์ระดับ critical ที่ยังไม่ผ่านการตรวจสอบจะปรากฏเป็นคำเตือนพร้อมหมายเหตุ และการตรวจสอบ incomplete/timeout ไม่ถือเป็นการรันที่สะอาด BC-04)
• พื้นผิว CI แบบเลือกใช้ (Flow B): pr-review.yml (DailybotHQ/ai-diff-reviewer@v3) ผ่าน sub-skill setup ต้นทาง พร้อมผู้ช่วย apply-review (อ่านอย่างเดียว) และ address-review (ทำ commit, push และติดอาวุธใหม่; ใหม่ใน v3.1.1) เป็นเครื่องมือที่นักพัฒนาเรียกใช้ — เสนออย่างชัดเจน ไม่ติดตั้งเมื่อไม่ถูกขอ ไม่เคยเป็นค่าเริ่มต้น ไม่เคยเป็นไฟล์งานของแผน
• ไม่บล็อก (เฉพาะการเรียก): การตรวจสอบในเครื่องที่เริ่มได้แต่เกิดข้อผิดพลาดคือ เตือนครั้งเดียว-บันทึก-ดำเนินต่อ; มันไม่เคยทำให้งานล้มเหลว
• ความเท่าเทียม (Flow B): prompt.md ที่ใช้ร่วมกัน + ส่วนขยายจัดแนวระเบียบวิธีและระดับความรุนแรง; Iteration-Aware Review ของ CI อาจทำให้รอบที่ 2+ สั้นลงในขณะที่การรันในเครื่องยังคงสมบูรณ์
• การป้องกันที่เป็นกลางต่อผู้ให้บริการ: ไม่มีโฟลว์ Deep Work Plan ใดต้องการบริการเชิงพาณิชย์ ผู้ให้บริการ CI หรือ secret — ตัวรีวิวเวอร์เป็น skill ใบอนุญาต MIT แบบตรึงแท็กที่รันโดย coding agent ของนักพัฒนาเอง
• การสอดคล้อง: verify รายงานตัวรีวิวเวอร์ในเครื่องที่หายไปเป็นความล้มเหลวสำหรับรีโพที่ประกาศมาตรฐาน 2.3.0 หรือใหม่กว่า และเป็นข้อค้นพบเวอร์ชัน harness สำหรับรีโพ legacy

Herdr (addon ที่หก)

ตัวผสานรวมแบบบางของ herdr-peers (ปักหมุดที่ v1.0.0, protocol 1) ซึ่งเป็นช่องทางการมอบหมายงานแบบ โต้ตอบ ของแผน v7

• หน้า kit: Herdr
• สิ่งที่เพิ่ม: แผนสามารถส่งงานที่มีขอบเขตให้ coding agent ใน pane อื่นของ Herdr บนเครื่องเดียวกันหรือเครื่องที่ Herdr เข้าถึงผ่าน SSH และบันทึกการตอบกลับที่ได้รับอนุญาตเพียงครั้งเดียวลงใน journal
• พฤติกรรม: protocol ของ peer (stamp, grant, reply, ตัวป้องกันลูป, ขีดจำกัดความลึกและการกระจายงาน) อยู่ใน herdr-peers ไม่เคยอยู่ในแพ็ก การใช้งานใด ๆ ต้องได้สิทธิ์ agent_delegation จากสัญญา และผลลัพธ์ของผู้รับมอบหมายยังคงเป็นเพียงข้อกล่าวอ้างจนกว่า runner ของแผนเองจะสังเกตเห็น
• เมื่อเสนอ: เลือกเข้าร่วมอย่างชัดเจนระหว่าง Phase 7b ตรวจหา herdr และ herdr-peers แบบอ่านอย่างเดียว ช่องทางนี้ใช้ได้เฉพาะภายในเซสชัน Herdr

DeepWorkPlan Vim (addon ที่เจ็ด)

ตัวผสานรวมแบบบางของ DeepWorkPlan Vim (ปักหมุดที่ v1.0.0, interface 1) ตัวแก้ไขบนเทอร์มินัลสำหรับ Deep Work Plan (Neovim 0.12+)

• หน้า kit: DeepWorkPlan Vim
• สิ่งที่เพิ่ม: พื้นผิวตัวแก้ไขระดับเครื่องแบบเลือกได้สำหรับ agent และมนุษย์ — ดัชนีคำสั่งที่สร้างขึ้น ตัวเรียกดูแผนแบบอ่านอย่างเดียว และตัวแสดง Markdown ทุกข้อกล่าวอ้างอ่านจากพื้นผิวที่เครื่องอ่านได้ซึ่งปักหมุดไว้ของผลิตภัณฑ์
• พฤติกรรม: การกำหนดค่า Neovim ที่มีอยู่จะไม่ถูกเขียนทับหากไม่ได้รับความยินยอมอย่างชัดเจน การตรวจหาเป็นแบบอ่านอย่างเดียว
• เมื่อเสนอ: เลือกเข้าร่วมอย่างชัดเจนระหว่าง Phase 7b เป็นเพียงข้อมูลเมื่อไม่มี Neovim 0.12+

Agentkit (addon ที่แปด)

ตัวผสานรวมแบบบางของ coding-agents-kit (ak, ปักหมุดที่ v1.0.1, interface 1) ซึ่งเป็นช่องทางการมอบหมายงานแบบ headless ของแผน v7

• หน้า kit: Agentkit
• สิ่งที่เพิ่ม: พื้นผิวคำสั่ง ak เดียวครอบ coding agent บนเทอร์มินัล ใช้รันงานในแผนที่มีขอบเขตแบบ headless โดยมอบความสามารถ subagents, cancel_children และ model_routing เฉพาะในขณะรันเมื่อเปิดใช้ ตรวจพบ และ interface เข้ากันได้เท่านั้น
• พฤติกรรม: การใช้งานใด ๆ ต้องได้สิทธิ์ agent_delegation จากสัญญา kit จะเปิดเอเจนต์ในโหมดทำงานอิสระ (autonomy) เป็นค่าเริ่มต้น และตัวเลือกปิดโหมดนี้ (--ask หรือ AGENTKIT_PERMISSIONS=ask) มีผลเหนือกว่าเสมอ — addon ไม่ระบุแฟล็กโหมดอิสระใด ๆ ส่ง --ask เมื่อแผนบันทึกตัวเลือกปิดไว้ และส่งเสมอสำหรับผู้รับมอบหมายแบบอ่านอย่างเดียว addon ไม่เคยติดตั้ง CLI ของ coding agent เอง และไม่เคยอ่านค่าคีย์ของผู้ให้บริการ
• เมื่อเสนอ: เลือกเข้าร่วมอย่างชัดเจนระหว่าง Phase 7b ตรวจหาแบบอ่านอย่างเดียวผ่าน ak doctor --json

Skills

Skills เป็นขั้นตอนที่ใช้ซ้ำได้ เรียกด้วยชื่อ skill ห่อ workflow ที่ทำซ้ำได้ (รันเทสต์ แก้ lint สร้างคอมโพเนนต์)

วิธีการจัดส่ง sub-skill หลักชุดเล็ก ในบรรดานั้น sub-skill author ให้รีโพ ขยาย kit ของตนเอง: เรียกผ่าน /skill-create และ /agent-create ให้เหตุผลจาก layout .agents/ และแบบแปลงที่มี แล้วเขียน skill เอเจนต์ หรือ command delegator บางๆ ที่ตรงกัน และซิงก์แคตตาล็อก sub-skill เดียวกันหนุนหลังช่วงกระทบยอด skill ของ Final Review

รายการ 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