ส่วนติดต่อสำหรับ agent และนักพัฒนา

Deep Work Plan สำหรับนักพัฒนาและ AI agent

deepworkplan.com จัดส่วนติดต่อที่อ่านได้ด้วยเครื่องควบคู่กับหน้าเว็บของตัวเอง: agent API ที่อธิบายด้วย OpenAPI, MCP server แบบ stateless, มิเรอร์ Markdown ต้นฉบับของทุกหน้าใน 17 ภาษา และสกิล DWP ที่ติดตั้งได้ ทุกอย่างในหน้านี้ใช้งานได้จริง เปิดกว้าง และฟรี — ไม่มีอะไรต้องสมัคร

ไร้การยืนยันตัวตนโดยการออกแบบ

ไม่มี API key ต้องสร้าง ไม่มีกระบวนการ OAuth และไม่มี sandbox แยกจาก production — พื้นที่ให้บริการจริงของ production ตัวเองคือ sandbox นี่คือคุณสมบัติที่ตั้งใจไว้ของระเบียบวิธี: agent กรอกแบบฟอร์ม "contact sales" ไม่ได้ เว็บไซต์จึงไม่ขอสิ่งนั้นเลย

อ่านอย่างเดียว

ทุกการดำเนินการเป็น GET ที่ปลอดภัยและแคชได้ — ยกเว้น endpoint ของ MCP ซึ่งเป็น POST ไม่มีการเขียน อัปโหลด หรือเปลี่ยนแปลงสถานะใด ๆ ทั้งสิ้น

ไม่มี API key

ไม่ต้องสมัคร ไม่มีโทเคน ไม่มีระดับ rate limit การเข้าถึงแบบไม่ระบุตัวตนคือสัญญาที่บันทึกไว้ในเอกสาร ประกาศไว้ใน /auth.md และ stub การค้นพบ OAuth

ฟรีและโอเพนซอร์ส

เนื้อหาของเว็บไซต์และสกิล DWP อยู่ภายใต้สัญญาอนุญาต MIT ใช้ในงานเชิงพาณิชย์และไม่เชิงพาณิชย์ได้โดยไม่ต้องขออนุญาต

Machine-first

JSON error แบบมีโครงสร้างบนเส้นทาง /api, เนื้อหา 404 แบบกู้คืนด้วย Markdown, แค็ตตาล็อก API ตาม RFC 9727 และแมนิเฟสต์ความสามารถ ARD — สร้างมาเพื่อให้ agent บริโภค

วางแผนและดำเนินการด้วยสกิล

API ข้างต้นทำให้ agent อ่านเว็บไซต์นี้ได้ ส่วนสกิล DWP คือสิ่งที่ทำให้ agent รันระเบียบวิธีได้ — ติดตั้งครั้งเดียวใน repository แล้วมันจะนำ router มาพร้อมกับสกิลย่อยเก้าตัว เรียกใช้เป็น slash command (หรือเรียกด้วยชื่อ สำหรับ agent ที่ intercept slash — ส่วนใหญ่ใช้ # แทน เช่น #dwp-execute)

สองทางเลือกที่เป็นอิสระจากกัน: รูปแบบ และปริมาณการตรวจทานที่ต้องการ

ทุกแผนเลือกค่าหนึ่งจากแต่ละแกน ทั้งสองแกนเป็นอิสระจากกัน — แผน Lite รันแบบ trust ได้ แผน Full รันแบบ guided ได้ และแต่ละแผนสามารถเปลี่ยนโหมดภายหลังได้โดยไม่ต้องเปลี่ยนรูปแบบ

Lite

บันทึกงานอยู่ใน README ของแผนโดยตรง อยู่หลัง anchor #task-N ที่คงที่ — ไม่มีไฟล์งานแยกต่างหาก สร้างมาสำหรับงานเล็กและมีขอบเขตจำกัด: ประเด็นเดียว ประมาณหนึ่งรอบการทำงาน ยังคงเป็นแผนที่สมบูรณ์: มี task id ที่คงที่ Touched Surface เกณฑ์การยอมรับ validation gate และ Final Review — ไม่เคยเป็นแค่โครงร่างที่ตัดทอน

Full

หนึ่งไฟล์ต่อหนึ่งงานภายใต้ N.task_<slug>.md สำหรับงานระยะยาวที่กินเวลาหลายชั่วโมงหรือหลายวัน หรือเมื่อแผนมีการพึ่งพากันจริงระหว่างงาน แผน Lite จะยกระดับเป็น Full ภายหลังด้วย /dwp-refine promote เมื่อบันทึกแบบกระชับไม่เพียงพออีกต่อไป — การยกระดับไม่เคยรันงานที่เสร็จแล้วซ้ำ

Guided (ค่าเริ่มต้น)

dwp-create วิเคราะห์เป้าหมาย แตกย่อย และสร้างแผนที่ตรวจทานได้ — ซึ่งเป็นแผนจริงที่รันได้อยู่แล้ว ไม่ใช่ร่างทิ้งขว้าง — จากนั้นถาม: เก็บไว้ตามเดิม ยกระดับ Lite เป็น Full แก้ไข หรือหยุด มนุษย์ยังอยู่ในลูปก่อนงานจริงใด ๆ จะเริ่มต้น แนะนำสำหรับไม่กี่ครั้งแรก หรือสำหรับงานที่มีความเสี่ยงสูงกว่า

Trust (หรือ auto)

เติม trust (หรือ auto) เป็นคำสุดท้าย — เช่น /dwp-create <goal> trust — แล้ว agent จะข้ามรอบตรวจทาน สร้างแผนที่อนุมัติล่วงหน้า และคืนคำสั่ง execute ให้ทันที เป็นทางลัดสำหรับผู้ใช้ที่ไว้ใจ flow แล้ว ยังคงบันทึกทุกการตัดสินใจและทุก gate เพียงแต่ไม่หยุดถาม

สกิลย่อยทั้งเก้าตัว

สกิลย่อยแต่ละตัวถูกเรียกเป็น slash command ภายใน repository ที่ติดตั้งสกิลไว้ — ไม่ใช่กับเว็บไซต์นี้ รายละเอียดฉบับเต็มของแต่ละตัวอยู่ใน kit catalog

สกิลย่อยทั้งเก้าตัว
`/dwp-create <goal>`	แปลงเป้าหมายให้เป็นแผน — เป็น Lite โดยดีฟอลต์ เป็น Full สำหรับงานที่ใหญ่กว่า เลือกโหมดใดก็ได้ตามตารางด้านบน
`/dwp-execute`	รันแผนที่มีอยู่ทีละงาน: อ่านให้ครบถ้วน ดำเนินงานแต่ละงานตามลำดับ ตรวจสอบ gate ของมัน อัปเดตความคืบหน้า
`/dwp-refine`	เพิ่ม ลบ หรือจัดลำดับงานใหม่ในแผนที่มีอยู่ โดยรักษางานที่เสร็จแล้วและหลักฐานที่บันทึกไว้
`/dwp-resume`	สร้างสถานะขึ้นใหม่จากไฟล์ของแผนเอง และดำเนินแผนที่ถูกขัดจังหวะต่อจากงานที่ยังไม่เสร็จตัวแรก
`/dwp-status`	รายงานความคืบหน้าของแผน — เสร็จแล้ว กำลังดำเนินการ งานที่รอดำเนินการ — โดยไม่เปลี่ยนแปลงอะไร
`/dwp-verify`	ตรวจสอบอย่างเป็นกลไกว่า repository เป็น AI-first หรือไม่ และแผนของมันมีโครงสร้างถูกต้องหรือไม่ ไม่เปลี่ยนแปลงอะไร รายงานแค่ผ่านหรือไม่ผ่าน
`/deepworkplan-onboard`	ทำให้ repository เป็น AI-first: ให้เหตุผลเกี่ยวกับสแตกของมัน แล้วสร้าง AGENTS.md, docs/, .agents/ ที่ปรับให้เหมาะสม และ .dwp/ ที่ถูก gitignore
`/skill-create, /agent-create`	สกิลย่อยสำหรับผู้เขียน: ขยาย kit ของ repository เอง — สกิลที่นำกลับมาใช้ได้สำหรับขั้นตอนที่ทำซ้ำ หรือ agent สำหรับบทบาทที่เกิดซ้ำพร้อมโมเดลและเครื่องมือของตัวเอง
`/dwp-upgrade`	ตรวจสอบว่ามีสกิลรุ่นใหม่เผยแพร่หรือไม่ และหลังได้รับอนุมัติอย่างชัดเจนเท่านั้น จึงติดตั้งและรัน onboarding ใหม่อีกครั้ง — ทุกแผนที่กำลังดำเนินอยู่ภายใต้ .dwp/ จะไม่ถูกแตะต้อง

สองวิธีในการรัน

สกิลเดียวกัน คำสั่งเก้าคำสั่งเดียวกัน — รูปแบบและโหมดตรวจทานเปลี่ยนไปตามขนาดและความเสี่ยงของงาน ไม่ใช่ตามเครื่องมือ

การแก้ไขเล็ก ๆ ที่มีขอบเขตจำกัด — Lite, trust

ประเด็นเดียว ประมาณหนึ่งรอบการทำงาน ความเสี่ยงต่ำ: ข้ามรอบตรวจทานและให้ agent สร้างและรันแผน Lite โดยตรง

เทอร์มินัล — slash command

# A small, bounded fix: skip the review round, run it directly.
/dwp-create fix the flaky checkout test trust
/dwp-execute

งานระยะยาว — Full, guided

มีการพึ่งพากันจริงระหว่างงาน หรือความเสี่ยงสูงกว่า: ตรวจทานแผนที่เสนอก่อนที่งานจริงใด ๆ จะเริ่ม ยกระดับเป็น Full หากเป้าหมายต้องการ แล้วรันและกลับมาทำต่อข้ามเซสชันได้ตามต้องการ

เทอร์มินัล — slash command

# Long-horizon work with real stakes: review before anything runs.
/dwp-create migrate the billing service to the new payments API
# ...review the proposed plan, then:
/dwp-execute
# ...interrupted? pick up again, even in a fresh session:
/dwp-resume

ผลลัพธ์ของทุกแผน — manifest, progress log, บันทึกงาน, หลักฐาน gate — อยู่ภายใต้ไดเรกทอรี .dwp/ ที่ถูก gitignore ในตัว repository เอง ไม่มีอะไรถูกส่งไปหรือเก็บไว้ที่ deepworkplan.com สกิลไม่เรียก network ใด ๆ เลย

Endpoint

endpoint หลักของ agent API ข้อกำหนดฉบับเต็มที่มีชนิดข้อมูลครบทุกการดำเนินการ พารามิเตอร์ และสคีมาการตอบกลับ อยู่ที่เอกสาร OpenAPI

Endpoint
`GET`	`/openapi.json`	ข้อกำหนด OpenAPI 3.1 ของ agent API ทั้งหมด
`GET`	`/llms.txt`	ดัชนีคำแนะนำ LLM ที่คัดสรรแล้ว — จุดเริ่มต้นที่แนะนำสำหรับ agent
`GET`	`/init.md`	พรอมต์การรับเอา DWP อย่างเป็นทางการ (ทำให้ repository ใดก็ได้เป็น AI-first)
`GET`	`/{page}.md`	หน้าใดก็ได้ในรูป Markdown ต้นฉบับ — ครบทั้ง 17 ภาษา (เช่น /es/developers.md)
`GET`	`/api/health.json`	ตัวบ่งชี้สถานะสุขภาพแบบคงที่ พร้อมลิงก์ไปยังสเปกและพอร์ทัลนี้
`GET`	`/api/v1/index.json`	แคตตาล็อกแบบมีเวอร์ชันของตระกูล v1: เส้นทาง endpoint เวอร์ชันของไซต์ และลิงก์ไปยัง spec
`GET`	`/api/v1/sections.json`	แผนผังไซต์เป็น JSON แบบมีชนิดข้อมูล — ชื่อ เส้นทาง และคำอธิบายของแต่ละส่วน
`GET`	`/api/v1/pages.json`	endpoint แบบ Markdown ทุกรายการในทุกภาษา จัดกลุ่มตามรหัสภาษา
`GET`	`/api/v1/health.json`	ตัวบ่งชี้สถานะแบบมีเวอร์ชัน — ภาพสะท้อน v1 ของ /api/health.json
`POST`	`/api/mcp`	MCP server (Streamable HTTP, stateless): initialize, ping, tools/list, tools/call
`GET`	`/.well-known/ai-catalog.json`	แมนิเฟสต์ความสามารถ ARD — agentmap ที่ประกาศไว้ใน robots.txt

เส้นทาง /api/* ที่ไม่รู้จักจะคืน JSON error แบบมีโครงสร้างพร้อมคำแนะนำแก้ปัญหา ไม่เคยคืนหน้า error แบบ HTML

การกำหนดเวอร์ชันและการเลิกใช้

ตระกูล JSON แบบมีเวอร์ชันอยู่ภายใต้ /api/v1/ — index, sections, pages และ health — และเส้นทางมาตรฐานที่ไม่มีเวอร์ชัน (/llms.txt, /{page}.md, /api/mcp) จัดอยู่ในสัญญา v1 เดียวกัน การเปลี่ยนแปลงที่ทำลายความเข้ากันได้ออกเฉพาะในตระกูล /api/v{N+1}/ ใหม่เท่านั้น ไม่มีทางเกิดขึ้นภายใน v1 เมื่อ endpoint ถูกเลิกใช้ คำตอบจะมี Deprecation: true และวันที่ Sunset ล่วงหน้าอย่างน้อย 180 วันก่อนการลบ และ header แบบ Link ชี้ไปยังตัวแทน

ขีดจำกัดอัตราการร้องขอ

คำตอบบน /api/* มี header ขีดจำกัดอัตราแบบ RFC 9331 — RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset และ RateLimit-Policy — เพื่อให้ agent ปรับความเร็วของตัวเองได้แบบเรียลไทม์ คำตอบ 429 เพิ่ม Retry-After การบังคับใช้เป็นแบบ best-effort ที่ขอบเครือข่าย (120 คำขอต่อ 60 วินาทีต่อผู้เยี่ยมชม) และการเข้าถึงยังคงไม่ระบุตัวตน: ไม่มีคีย์ ไม่มีการลงทะเบียน ไม่มีการแบ่งระดับ

MCP server

Model Context Protocol server แบบ stateless ผ่าน Streamable HTTP เครื่องมือแบบอ่านอย่างเดียวสามตัว: get_init_prompt, list_site_sections และ read_page รองรับเวอร์ชันโปรโตคอล 2025-03-26 และ 2025-06-18 และไม่ต้องมีเซสชัน

เทอร์มินัล — JSON-RPC ผ่าน HTTP

# 1. Initialize (no session needed — the server is stateless)
curl -s https://deepworkplan.com/api/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize",
       "params":{"protocolVersion":"2025-06-18","capabilities":{},
                 "clientInfo":{"name":"curl","version":"1.0"}}}'

# 2. Discover the tools
curl -s https://deepworkplan.com/api/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

# 3. Call one — read any page as source Markdown
curl -s https://deepworkplan.com/api/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call",
       "params":{"name":"read_page","arguments":{"path":"/init"}}}'

แมนิเฟสต์ MCP อยู่ที่ /.well-known/mcp.json และการ์ด server อยู่ที่ /.well-known/mcp/server-card.json — Claude, ChatGPT และไคลเอนต์ MCP ใดก็ได้เรียกใช้เครื่องมือเหล่านี้ได้โดยตรง

Markdown สำหรับ agent

ทุกหน้าที่เรนเดอร์ถูกเผยแพร่เป็น Markdown ต้นฉบับ — ไม่ใช่การแปลงจาก HTML ขอ Markdown อย่างชัดเจนด้วยคำต่อท้าย URL หรือผ่านการเจรจาเนื้อหา HTTP บนหน้าใดก็ได้

เทอร์มินัล — การเจรจาเนื้อหา

# Ask for Markdown on any URL (content negotiation)
curl -s https://deepworkplan.com/methodology \
  -H 'Accept: text/markdown'

# Or fetch the .md mirror directly — every page has one, in every language
curl -s https://deepworkplan.com/es/developers.md

การเจรจาเนื้อหาคืน Markdown ต้นฉบับชุดเดียวกับที่เว็บไซต์ใช้เรนเดอร์ ในภาษาของ URL ที่คุณร้องขอ

ติดตั้งชุดเครื่องมือ

เส้นทางติดตั้งอย่างเป็นทางการของสกิล Deep Work Plan — คำสั่งเดียวกับที่ endpoint /init มอบให้ agent ใช้ได้กับ coding agent ใดก็ตามที่รองรับ skills (Claude Code, Cursor, Codex, Gemini และอื่น ๆ)

เทอร์มินัล — skills CLI และ CLI อย่างเป็นทางการ

# 1. Install the DWP skill — same command the /init endpoint gives agents
npx skills add DailybotHQ/deepworkplan-skill@latest

# 2. Official CLI — zero-dependency client over this API (Node >= 18),
#    prepared in the site repo's cli/ directory pending npm publication
deepworkplan init
deepworkplan read /es/developers

สกิลถูกฝังไปที่ .agents/skills/deepworkplan/ ภายใน repository ของคุณ จึงทำให้ agent ทุกตัวที่แตะ repo นี้ใช้ระเบียบวิธีเดียวกัน CLI อย่างเป็นทางการ deepworkplan — client ที่ไม่มี dependency บน API เดียวกันนี้ (init, sections, read, open, mcp) — เตรียมพร้อมสำหรับ npm แล้วและอยู่ที่ไดเรกทอรี cli/ ของ repository ไซต์จนกว่าจะเผยแพร่

ทรัพยากรที่อ่านได้ด้วยเครื่อง

ชี้ agent ตัวหนึ่งมาที่นี่

เส้นทางที่เร็วที่สุดยังคงเป็นหนึ่งบรรทัด: มอบพรอมต์ /init ให้ coding agent ตัวใดก็ได้ แล้วมันจะติดตั้งสกิล ออนบอร์ด repository ของคุณ และเริ่มทำงานเชิงลึกจนเสร็จ

เปิดพรอมต์ /init อ่านระเบียบวิธี