Add-on

Phạm vi phiên bản: Đây là tài liệu nền v5.0.0 được giữ lại. Tiêu chuẩn hiện tại, DWP 7.0.0, cũng yêu cầu các phần mở rộng V6_*.md và V7_*.md áp dụng được liệt kê trong mục lục đặc tả. Các kế hoạch v5 và v6 hiện có giữ nguyên quy tắc đã ghi nhận.

Phiên bản 2.1.0. Add-on là phần mở rộng của phương pháp Deep Work Plan cốt lõi. Bảy trong tám addon là tùy chọn và không bao giờ bắt buộc để tuân thủ — kho lưu trữ không có addon tùy chọn nào vẫn hoàn toàn AI-first và tuân thủ DWP. Mỗi addon tùy chọn được đề xuất trong onboarding, chấp nhận hoặc từ chối rõ ràng và — khi được chấp nhận — đối chiếu với thiết lập hiện có thay vì ghi đè. Một thành phần là ngoại lệ được khai báo: kể từ chuẩn 2.3.0, đánh giá cục bộ AI Diff Reviewer là một phần của chuẩn cơ sở bắt buộc — onboarding cài đặt nó và mọi Final Review chạy nó — trong khi bề mặt CI của nó vẫn là opt-in.

Hợp đồng addon

Mỗi addon đang phát hành cung cấp bốn thành phần bắt buộc:

Khám phá: luồng onboard liệt kê skills/deepworkplan/addons/ và trình bày mỗi addon như bước opt-in trong Giai đoạn 7b, sau scaffolding cốt lõi.

Addon đang phát hành (tám)

Hôm nay có tám addon — bảy addon opt-in cộng với đánh giá cục bộ bắt buộc. Mỗi addon có trang danh mục kit với chi tiết hướng người dùng và spec chuẩn bên trong skill Deep Work Plan. Bốn trong số đó — devcontainer, Herdr, DeepWorkPlan Vim và Agentkit — là các bộ tích hợp mỏng được ghim theo tag vào một sản phẩm có repository và chu kỳ phát hành riêng; mọi sản phẩm đều hoạt động mà không cần Deep Work Plan. Một addon được chấp nhận sẽ được ghi vào sổ đăng ký addon .dwp/config.json (DWP 7.0.0), vốn chỉ có thể đề xuất hoặc khuếch đại — không bao giờ chặn sự tuân thủ hay một kế hoạch.

Devcontainer (addon đầu tiên)

Một bộ tích hợp mỏng của devcontainer-kit (dck, ghim ở v0.2.2, giao diện 2): một template Dev Containers mà dck init tạo vào repository như container riêng của repository, kèm skill dck-dockerfile.

• Trang kit: Devcontainer
• Bổ sung: docker/local/<service>/Dockerfile từ image chính thức của runtime được ghim theo digest (python-3.13, node-24 hoặc debian, không có image cơ sở dùng chung), dev.sh chạy trên trình khởi chạy dck (up, shell, rebuild, doctor), coding agent như một lớp opt-in, cổng chỉ dùng loopback, git qua SSH thông qua agent của máy host mà không có khóa nào bên trong, và máy Herdr cho mỗi container với bố cục tiêu chuẩn
• Hành vi: được phát hiện qua dck doctor --json (giao diện 2); dck init chỉ đối chiếu một devcontainer hiện có sau khi diff của nó được chấp nhận, và sao lưu tệp trước — không bao giờ ghi đè
• Khi đề xuất: hầu hết repo có Docker hoặc dịch vụ hưởng lợi từ dev container cô lập

Dailybot (addon thứ hai)

Kết nối opt-in tới nhóm Dailybot của nhà phát triển để hiển thị tiến độ agent.

• Trang kit: Dailybot — tham chiếu khả năng đầy đủ
• Addon DWP kết nối: bốn báo cáo vòng đời kế hoạch (kickoff, significant task, blocked, completion) qua sub-skill dailybot report; thực thi hook xác định tùy chọn (dailybot hook, CLI >= 3.9.0)
• Skill đi kèm: cài DailybotHQ/agent-skill (hiện tại 3.23.3) mở 17 khả năng — chat trên Slack/Teams/Discord/Google Chat, check-in, tạo biểu mẫu, ask AI, kudos, board và tác vụ Plan, nhãn tổ chức, API key theo repo (.dailybot/env.json), email và hơn thế. Addon DWP chỉ kết nối report; khả năng khác được gọi trực tiếp qua skill Dailybot
• Auth: hoàn toàn hoãn sang skill Dailybot (dailybot login hoặc DAILYBOT_API_KEY); addon này không bao giờ lưu thông tin xác thực
• Rào vendor-neutral: DWP cốt lõi không phụ thuộc Dailybot; không bao giờ tự cài cho mọi người
• Khi đề xuất: nhà phát triển hoặc nhóm đã dùng Dailybot, hoặc yêu cầu rõ ràng báo cáo nhóm

Dependency upgrade (addon thứ ba)

Nâng cấp phụ thuộc không phụ thuộc package manager, theo lô, đã xác thực, có thể hoàn tác.

• Trang kit: Dependency upgrade
• Bổ sung: phát hiện trình quản lý thực của repo (npm/pnpm/yarn + ncu, pip/poetry/uv, cargo, go mod, bundler, composer, …), nâng cấp theo lô phân loại semver, chạy validation gate repo sau mỗi lô, hoàn tác thất bại, tóm tắt không tự commit
• Lệnh: cài /lib-upgrade vào .agents/commands/ chỉ khi được chấp nhận
• Khi đề xuất: được đề xuất cho mọi repo có phụ thuộc được khai báo; ủy quyền bất hoạt /lib-upgrade được cài dưới sự chấp thuận của onboarding trừ khi bị từ chối rõ ràng — một lần cài đặt không chạy bất kỳ nâng cấp nào

Design system (addon thứ tư)

DESIGN.md phạm vi bề mặt giao diện mà mọi agent mã hóa đọc để đầu ra UI, CLI hoặc hội thoại nhất quán.

• Trang kit: Design system
• Bổ sung: docs/DESIGN.md (tham chiếu từ AGENTS.md) với tối đa ba hồ sơ xếp chồng trong một file: visual-ui (token và thành phần UI được render), cli-output (kiểu terminal ngữ nghĩa, suy giảm TTY/NO_COLOR), conversational (giọng, giải phẫu thông điệp, render theo nền tảng với fallback văn bản thuần)
• Độ mạnh hồ sơ: việc phát hiện khiến đề xuất trở thành bắt buộc; việc cài đặt được kiểm soát bằng sự chấp nhận, như nhau ở cả chế độ có hướng dẫn lẫn chế độ tin cậy — visual-ui được khuyến nghị mạnh mẽ khi được phát hiện; cli-output và conversational khuyến nghị khi phát hiện, luôn hỏi, không bao giờ tự áp dụng
• Khi đề xuất: chỉ khi phát hiện bề mặt giao diện người dùng — không cho thư viện thuần, dịch vụ headless hoặc repo chỉ hạ tầng

AI Diff Reviewer (addon thứ năm — đánh giá cục bộ bắt buộc, bề mặt CI tùy chọn)

AI Diff Reviewer (marketplace “AI Diff Reviewer”) trao cho bước rà soát bảo mật của Final Review bắt buộc một đánh giá cục bộ có cấu trúc, và tùy chọn kiểm soát các pull request trong CI. Kể từ chuẩn 2.3.0, đánh giá cục bộ là một phần của chuẩn cơ sở; chỉ bề mặt CI là opt-in. Addon này được tự động cập nhật theo mỗi bản phát hành, nên tag hiển thị bên dưới là tag hiện hành tại thời điểm viết và có thể đi sau bản sao đang được vendor — SKILL.md riêng của addon và các bản phát hành GitHub của nó mới là nguồn chuẩn cho tag thực sự được cài. Việc cài đặt luôn được ghim vào một tag đã phát hành, không bao giờ vào một nhánh di động.

• Trang kit: AI Diff Reviewer — tài liệu tham khảo khả năng đầy đủ
• Bắt buộc tại onboarding (Giai đoạn 7a): cài đặt skill vendored được ghim theo tag (npx --yes skills add https://github.com/DailybotHQ/ai-diff-reviewer/tree/v3.3.0 --skill ai-diff-reviewer -y) cùng .review/extension.md được điều chỉnh riêng cho repo (qua generate-extension), dưới sự chấp thuận của onboarding; một nâng cấp harness có mục tiêu đối chiếu cả hai khi thiếu; một lần từ chối được ghi lại như một ngoại lệ được khai báo và được verify báo cáo cho đến khi được cài đặt
• Bắt buộc trong mọi Final Review: bước rà soát bảo mật chạy luồng mặc định cha của skill thượng nguồn trên toàn bộ tập thay đổi đã tích lũy và nối thêm kết quả vào analysis_results/SECURITY_REVIEW.md nội bộ của plan (bên trong thư mục riêng của plan, không bao giờ ở thư mục gốc của repo); một skill hoặc tiện ích mở rộng bị thiếu là một phát hiện local reviewer not installed được ghi lại — không bao giờ là một lần bỏ qua âm thầm, và không bao giờ là một bootstrap bất ngờ: việc cài đặt thuộc về sự chấp thuận của onboarding hoặc một lời gọi addon rõ ràng; các phát hiện nghiêm trọng đã xác minh từ một lượt hoàn tất chặn việc hoàn tất cho đến khi được sửa hoặc được chấp nhận rõ ràng (v3, BC-07 — các xác nhận nghiêm trọng chưa xác minh xuất hiện dưới dạng cảnh báo có chú thích, và một lượt đánh giá incomplete/timeout không phải là một lượt sạch, BC-04)
• Bề mặt CI tùy chọn (Flow B): pr-review.yml (DailybotHQ/ai-diff-reviewer@v3) qua sub-skill setup thượng nguồn, cùng các công cụ đồng hành apply-review (chỉ đọc) và address-review (thực hiện commit, push và kích hoạt lại; mới trong v3.1.1) như các tiện ích do nhà phát triển gọi — được đề xuất rõ ràng, không bao giờ cài khi chưa được yêu cầu, không bao giờ là mặc định, không bao giờ là một tệp nhiệm vụ kế hoạch
• Không bao giờ chặn (chỉ đối với lỗi gọi): một đánh giá cục bộ có thể khởi động nhưng gặp lỗi thì cảnh báo một lần, ghi lại và tiếp tục; nó không bao giờ làm thất bại tác vụ
• Tương đồng (Flow B): prompt.md dùng chung + tiện ích mở rộng căn chỉnh phương pháp luận/mức độ nghiêm trọng; Đánh giá Nhận thức Lặp lại CI có thể rút ngắn vòng 2+ trong khi lượt kiểm tra cục bộ vẫn đầy đủ
• Rào trung lập với nhà cung cấp: không luồng Deep Work Plan nào yêu cầu một dịch vụ thương mại, nhà cung cấp CI hay bí mật — reviewer là một skill MIT được ghim theo tag, chạy bởi chính agent lập trình của nhà phát triển
• Tuân thủ: verify báo cáo một local reviewer bị thiếu như một thất bại đối với các repository khai báo chuẩn 2.3.0 hoặc mới hơn, và như một phát hiện phiên bản harness đối với các repository cũ

Herdr (addon thứ sáu)

Bộ tích hợp mỏng của herdr-peers (ghim v0.1.0, giao thức 1), phương thức truyền ủy quyền tương tác của các kế hoạch v7.

• Trang kit: Herdr
• Bổ sung: một kế hoạch có thể giao một tác vụ có giới hạn cho một coding agent trong một pane Herdr khác, trên cùng máy hoặc trên một máy mà Herdr kết nối tới qua SSH, và ghi lại phản hồi được ủy quyền duy nhất của nó vào nhật ký
• Hành vi: giao thức peer (stamp, grant, reply, loop guard, giới hạn độ sâu và fan-out) nằm trong herdr-peers, không bao giờ nằm trong gói; mọi lần sử dụng đều cần grant hợp đồng agent_delegation, và kết quả của agent được ủy quyền vẫn chỉ là khẳng định cho đến khi runner của chính kế hoạch quan sát được nó
• Khi đề xuất: opt-in rõ ràng trong Giai đoạn 7b; phát hiện chỉ đọc herdr và herdr-peers; phương thức truyền chỉ dùng được bên trong một phiên Herdr

DeepWorkPlan Vim (addon thứ bảy)

Bộ tích hợp mỏng của DeepWorkPlan Vim (ghim v0.5.1, giao diện 1), trình soạn thảo terminal cho Deep Work Plan (Neovim 0.12+).

• Trang kit: DeepWorkPlan Vim
• Bổ sung: một bề mặt trình soạn thảo tùy chọn ở cấp máy cho agent và con người — chỉ mục lệnh được sinh tự động, trình duyệt kế hoạch chỉ đọc và trình xem Markdown; mọi tuyên bố đều được đọc từ bề mặt máy đọc được đã ghim của sản phẩm
• Hành vi: cấu hình Neovim hiện có không bao giờ bị ghi đè khi chưa có sự đồng ý rõ ràng; việc phát hiện là chỉ đọc
• Khi đề xuất: opt-in rõ ràng trong Giai đoạn 7b; chỉ mang tính thông tin khi thiếu Neovim 0.12+

Agentkit (addon thứ tám)

Bộ tích hợp mỏng của coding-agents-kit (ak, ghim v0.3.0, giao diện 1), phương thức truyền ủy quyền headless của các kế hoạch v7.

• Trang kit: Agentkit
• Bổ sung: một bề mặt lệnh ak duy nhất cho các coding agent trên terminal, dùng để chạy headless một tác vụ kế hoạch có giới hạn; nó chỉ đóng góp các khả năng subagents, cancel_children và model_routing khi chạy, lúc được bật, được phát hiện và ở trên một giao diện tương thích
• Hành vi: mọi lần sử dụng đều cần grant hợp đồng agent_delegation; kit mặc định khởi chạy agent ở chế độ tự chủ và tùy chọn từ chối của nó (--ask hoặc AGENTKIT_PERMISSIONS=ask) luôn được ưu tiên — addon không chỉ định cờ tự chủ nào, truyền --ask khi kế hoạch ghi nhận tùy chọn từ chối và luôn truyền cho các delegate chỉ đọc; addon không bao giờ tự cài CLI của coding agent và không bao giờ đọc giá trị khóa của nhà cung cấp
• Khi đề xuất: opt-in rõ ràng trong Giai đoạn 7b; phát hiện chỉ đọc qua ak doctor --json

Skill

Skill là quy trình tái sử dụng được gọi theo tên. Skill đóng gói luồng công việc lặp lại (chạy test, sửa lint, tạo thành phần).

Phương pháp cung cấp một tập nhỏ sub-skill cốt lõi. Trong đó, sub-skill author cho phép kho lưu trữ phát triển kit riêng: gọi qua /skill-create và /agent-create, suy luận về bố cục .agents/ và quy ước repo hiện có, rồi viết skill, agent hoặc ủy quyền lệnh mỏng mới phù hợp và giữ danh mục đồng bộ. Cùng sub-skill hậu thuẫn cho bước đối chiếu skill của Final Review.

Mục kit: Skill create, Agent create.

Agent

Agent là công nhân chuyên biệt với vai trò xác định (reviewer, executor, architect). Chúng nằm trong .agents/agents/ và được liệt kê trong .agents/docs/.

Addon bảo trì

Addon dependency-upgrade (ở trên) là addon bảo trì chính. Nó suy luận về package manager thực của repo thay vì giả định npm, phân loại nâng cấp theo semver, nâng cấp theo lô an toàn, chạy xác thực sau mỗi lô và hoàn tác lô thất bại.

Addon design-system

Xem Design system trong addon đang phát hành. DESIGN.md cấp repo khác với tài liệu thiết kế kỹ thuật theo tính năng: README kế hoạch DWP, tiêu chí chấp nhận tác vụ và validation gate đã bao phủ thiết kế theo tính năng. Addon design-system lấp ngữ cảnh thiết kế giao diện bền vững, native repo.

Preset

Preset điều chỉnh DWP cho stack công nghệ cụ thể (Django, React, Go, Astro + Svelte và hơn thế). Duyệt danh mục kit.

Adapter

Adapter ánh xạ lệnh DWP sang hệ thống lệnh của agent cụ thể (Claude Code, Cursor, Codex, Gemini, Copilot, OpenClaw và khác). Mục adapter nằm trong kit dưới tên từng agent.

Ví dụ

Ví dụ minh họa DWP trong thực tế: so sánh trước/sau, kế hoạch mẫu, nghiên cứu điển hình. Xem Examples và Dogfood this site.

Nhắc tuân thủ

Kho lưu trữ PHẢI hoàn toàn tuân thủ với không addon tùy chọn nào. Addon là khả năng opt-in xếp lớp — không bao giờ là điều kiện tiên quyết. Xem Conformance.