用途：面向 Paperclip 专用开发工作区，通过项目执行工作区运行时服务（通常是 paperclip-dev 这类 worktree 服务）启动、验证、重播种和修复隔离服务。成功标准包括：服务经正常受管运行时路径启动；worktree 数据库是主实例数据库的完整引导克隆；/api/health 返回 status: ok 与 bootstrapStatus: ready；根页面返回 200 且不显示首个管理员设置门；看板用户可用常规开发凭据登录；应用展示已填充的克隆数据；主控制面与所服务的工作区应用均显示服务 running/healthy 且 URL 一致；占用服务端口的进程其 readlink /proc/<pid>/cwd 确实位于目标 worktree 内。任一项失败需继续修复，不能因单个探针通过就标记完成。
主要能力与用法：先收集环境变量（PAPERCLIP_API_URL、PAPERCLIP_API_KEY、PAPERCLIP_RUN_ID、PAPERCLIP_TASK_ID、PAPERCLIP_COMPANY_ID、PAPERCLIP_AGENT_ID、执行工作区 id、运行时工作区命令 id、预期服务 URL 等），不要打印密钥或密码。运行 Paperclip CLI、dev server、worktree、数据库、构建或测试命令前先读 doc/DEVELOPING.md。通过主控制面的 runtime-services 端点做受管启停，请求需带 X-Paperclip-Run-Id。完整重播种命令：npx paperclipai worktree reseed --from-instance default --seed-mode full --yes。核心校验探针：curl -sS "$SERVICE_URL/api/health" | jq 与 curl -sS -I "$SERVICE_URL/" | head，期望 status: ok、bootstrapStatus: ready、bootstrapInviteActive: false。端口归属检查：pid=$(lsof -nP -iTCP:"$SERVICE_PORT" -sTCP:LISTEN -t | head -1) 后 readlink "/proc/$pid/cwd"，只有该结果权威。
限制与硬性规则：主检出 /srv/paperclip/home/paperclipai/paperclip 永不作为工作区修复目标，不得对其执行 git worktree add 或修改其 .env。不得仅凭 running/healthy 运行时行或通过的 /api/health 判断，因为固定端口可能被同级工作区进程占用。不要用 psql、原始嵌入式 Postgres 命令或临时复制行作为常规修复路径；不要只手动复制 auth 行作为最终修复。优先受管运行时启停而非 pnpm dev 或分离 shell 进程。避免破坏性 git 或数据库操作，保留 worktree 中的用户改动。修复后需在 issue 评论中写明根因、确切修复、验证与提交链接，并设置明确最终状态。若缺少执行工作区 id 或服务命令 id，先读 issue、项目或执行工作区 API 记录，不要猜测并在随机端口启动非受管服务。浏览器验证若无法执行，可委托 QA 并说明原因，同时完成所有可运行的 API 检查。