面向开发者与 AI 代理的 Deep Work Plan

通过技能规划并执行

上面的 API 让代理能够读取本站点。DWP 技能则让代理能够运行这套方法论——只需在仓库中安装一次，它就会附带一个路由器和九项子技能，以斜杠命令的形式调用（或按名称调用，对于会拦截斜杠的代理，大多数改用 # 代替，例如 #dwp-execute）。

两个独立的选择：格式，以及你想要多少审阅

每个计划都从每个维度中选取一个值。这两个维度相互独立——Lite 计划可以以 trust 模式运行，Full 计划也可以以 guided 模式运行，而且两者都可以在之后切换模式而不切换格式。

九项子技能

每一项子技能都作为斜杠命令，在安装了该技能的仓库内部调用——而不是针对本网站。每一项的完整参考文档都在套件目录中。

两种运行方式

同一项技能，同样的九个命令——随工作的规模与风险而变化的是格式与审阅模式，而不是工具本身。

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

# 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

每一份计划的输出——清单、进度日志、任务记录、关卡证据——都保存在仓库自身内部一个被 gitignore 的 .dwp/ 目录下。没有任何内容会被发送到 deepworkplan.com 或由其存储；该技能完全不发起任何网络调用。

端点

代理 API 的核心端点。完整且带类型的规范——每一项操作、参数与响应模式——位于 OpenAPI 文档中。

未知的 /api/* 路径会返回带解决提示的结构化 JSON 错误，绝不返回 HTML 错误页。

版本管理与弃用

版本化的 JSON 家族位于 /api/v1/ 之下——index、sections、pages 与 health——而未加版本的规范路径（/llms.txt、/{page}.md、/api/mcp）属于同一个 v1 契约。破坏性变更只会随新的 /api/v{N+1}/ 家族发布，绝不会发生在 v1 内部。当某个端点被弃用时，其响应会携带 Deprecation: true 与至少早于移除 180 天的 Sunset 日期，并由 Link 头指向继任者。

速率限制

/api/* 的响应携带 RFC 9331 速率限制头——RateLimit-Limit、RateLimit-Remaining、RateLimit-Reset 与 RateLimit-Policy——让代理能够实时自我节流；429 响应额外携带 Retry-After。限流在边缘尽力执行（每位访客每 60 秒 120 次请求），访问保持匿名：无密钥、无注册、无层级。

MCP 服务器

一个基于 Streamable HTTP 的无状态 Model Context Protocol 服务器。三个只读工具：get_init_prompt、list_site_sections 与 read_page。支持协议版本 2025-03-26 与 2025-06-18；无需会话。

# 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，服务器卡片位于 /.well-known/mcp/server-card.json。Claude、ChatGPT 以及任何 MCP 客户端都能原生调用这些工具。

面向代理的 Markdown

每个已渲染的页面都会以原生源 Markdown 发布——而非 HTML 转换。通过 URL 后缀显式请求 Markdown，或在任意页面上通过 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 技能的官方安装路径——与 /init 端点交给代理的命令完全相同。它适用于任何兼容 skills 的编码代理（Claude Code、Cursor、Codex、Gemini 等）。

# 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/，因此每个接触该仓库的代理都共享同一套方法论。官方 deepworkplan CLI——一个基于同一 API 的零依赖客户端（init、sections、read、open、mcp）——已为 npm 做好准备，在发布之前存放于站点仓库的 cli/ 目录。

机器可读资源

• ▸ OpenAPI 规范 (/openapi.json)
• ▸ 代理访问与认证声明 (/auth.md)
• ▸ API 目录，RFC 9727 (/.well-known/api-catalog)
• ▸ MCP 清单 (/.well-known/mcp.json)
• ▸ 安全联系 (/.well-known/security.txt)
• ▸ 站点仓库描述符 (/.well-known/dwp.json)

把代理指向它

最快的路径仍然只有一行：把 /init 提示交给任意编码代理，它会安装技能、接入你的代码仓库，并开始完成深度工作。