draftgo-cli 3.0.55 → 4.0.1

package/resources/skill/SKILL.md

@@ -1,15 +1,15 @@
 ---
 name: draftgo
-description: Use this skill to inspect, develop, debug, or deliver a DraftGo application. Read task-specific references before using live MCP discovery, use checkout/commit for complete page, navigation, document, and custom-service bodies, and write the changelog only after all verification and delivery succeed.
+description: Use this skill to inspect, develop, debug, or deliver a DraftGo application. Read task-specific references before live MCP discovery, use checkout/commit for complete page, navigation, document, and custom-service bodies, and track work in the project worklog.
 ---
 
 ## Workflow 2.0 authority
 
 - Treat pages, navigations, docs/articles, and custom services as checkout resources. Never save complete MCP responses, duplicate source snapshots, temporary Go modules, SDK stubs, executables, or build directories by hand.
 - The root Skill loads automatically. Before acting, read the smallest relevant Reference set from the task-routing table, then use MCP only for live project evidence.
-- Custom-service flow: read `references/custom-services.md` -> locate the service through MCP -> `checkout custom-services` -> edit four files -> `commit` cloud draft -> `test` in the server Runner -> `check --remote` -> `publish` -> `refresh`. CLI and admin UI edit the same cloud draft.
-- Do not create Task overhead for a small, single-point change. For cross-module, cross-session, or multi-Agent work, create or resume `.draftgo/Task/[YYYY-MM-DD]<slug>/Task.md`. It is the only task state: preserve both the user's original request and the clarified executable requirement, assign one owner per item/resource, and check an item only with verification evidence. Changelog remains the final delivery record, not a task tracker.
-- Normal delivery uses `draftgo verify`; add `--remote` only when remote comparison is required and `--url` only for browser evidence. UI verification is iframe-aware and defaults to one viewport with no screenshot. Only explicit visual acceptance or regression diagnosis may pass `--viewport both` or `--screenshot on-failure|always`.
+- Custom-service flow: read `references/custom-services.md`, locate and checkout the service, edit four files, then commit and validate the cloud draft. Run a server test or publish only when the task requires it. CLI and admin UI edit the same cloud draft.
+- At task start, run `draftgo work start "<item>"`. Add independent items with `draftgo work add`; mark them active with `start-item` and complete only after verification and delivery. `.draftgo/worklog.md` is the only task and completion record.
+- Normal delivery runs `draftgo verify` once; it already includes the local checks. Never start browser verification or create screenshots unless the user explicitly requests visual acceptance. For explicit visual acceptance, capture and inspect a desktop screenshot first with `--url <url> --screenshot always`; use `--ui always` only when the user also requests interaction or DOM verification, and add mobile/multi-viewport checks only when requested.
 - `.draftgo/tmp/` is entirely disposable. CLI data uses `.draftgo/tmp/<command>/<run-id>/`; AI-created scratch files use `.draftgo/tmp/ai/<run-id>/`. User-facing evidence belongs under registered `.draftgo/artifacts/`. Use `draftgo clean --dry-run` before `draftgo clean --yes`.
 
 # DraftGo 开发助手
@@ -17,9 +17,9 @@ description: Use this skill to inspect, develop, debug, or deliver a DraftGo app
 ## 核心边界
 
 - 本地 Skill / Reference 提供产品约束、运行机制和实践；MCP 提供当前项目、资源、API、权限与 schema。
-- pages、navigations、docs/articles 的完整正文只通过 `draftgo checkout`、本地 worktree 和 `draftgo commit` 处理，不放进 MCP 参数、结果、日志或聊天上下文。
+- pages、navigations、docs/articles、custom_services 的完整正文只通过 `draftgo checkout`、本地 worktree 和 `draftgo commit` 处理，不放进 MCP 参数、结果、日志或聊天上下文。
 - db_meta、AIHub、system_config、roles、users、doc_categories 和自定义服务元数据直接通过 MCP 读写，不建立本地索引。
-- 根 Skill 会在触发时自动加载。Agent 必须先按任务读取最少必要的 Reference，再通过 MCP 获取实时项目证据；MCP 不可用时报告连接、协议或 SAT 问题，不回退到旧索引或 `pull --all`。
+- 根 Skill 会在触发时自动加载。Agent 必须先按任务读取最少必要的 Reference，再通过 MCP 获取实时项目证据；MCP 不可用时报告连接、协议或 SAT 问题。
 - CLI 不提供页面模板，不预设页面骨架、视觉风格、原生技术或组件库选择。Agent 根据任务、受众、现有产品语言和可用资源自主设计。
 - 本地 Docker、MySQL、Redis、Milvus 与 `draftgo local ...` 独立于 MCP 工作流，必须保留。
 
@@ -44,9 +44,8 @@ description: Use this skill to inspect, develop, debug, or deliver a DraftGo app
 ## 所有权与执行
 
 - 同一文件或 DraftGo 资源全程只能由一个 Agent 修改；其他 Agent 只读分析并回传建议。
-- 先确定共享 schema、接口、权限和 route，再并行处理无依赖且 owner 不冲突的工作单元。
-- 单页面、强依赖或仍共享主要资源的任务不强行并行。
-- 主 Agent 负责 Reference/MCP 路由、owner 分配、汇总回读、统一验证、交付和完成日志；子 Agent 不单独写 changelog。
+- 不同资源、operation 和 owner 不冲突的工作单元并发执行，不设置客户端并发上限；同一资源的依赖步骤保持串行。
+- 主 Agent 负责 Reference/MCP 路由、owner 分配、汇总回读、统一验证、交付和 worklog 状态。
 - 冲突 owner、接口依赖或验证失败会阻塞依赖项，不影响无关分支继续汇总。
 
 ## 开发与交付
@@ -55,25 +54,26 @@ description: Use this skill to inspect, develop, debug, or deliver a DraftGo app
 
 1. 确认目标 pages/nav/docs 已存在并通过 MCP 读取 metadata；新增资源先按实时 API 契约创建并取得 ID。
 2. 对需要完整分析或编辑的目标批量 checkout；在 `.draftgo/worktree/` 按唯一 owner 编辑。
-3. 主 Agent 回读全部修改，编辑过程中统一运行一次快速 `draftgo check`。交付前运行 `draftgo verify <type> <id...>`；需要远端证据时加 `--remote`，页面布局或交互变化时加对应 `--url`。
-4. 用 `draftgo diff <type> <id>` 检查 base/local 差异，再按类型运行 `draftgo commit ...`。commit 后需要验证远端页面时运行 `draftgo verify <type> <id> --remote --url <url>`。
+3. 主 Agent 回读全部修改，并按顶部统一验证策略完成交付前验收。
+4. 用 `draftgo diff <type> <id>` 检查 base/local 差异，再按类型运行 `draftgo commit ...`。
 5. 409/412 时停止自动提交，保留 base/local/remote 冲突材料；不得 force、覆盖或自动合并。
 
 完整 manifest、流式传输、哈希和冲突规则见 `references/checkout.md`。
 
 ### 结构化资源
 
-严格按 `references/mcp.md` 的 `draftgo_api_search` → `draftgo_api_describe` → `draftgo_api_call` 流程执行。describe 不完整就停止，不猜参数、响应、权限或风险。按唯一资源 owner 写入，回读结果并验证副作用；结构化资源不 checkout。
+遵循 `references/mcp.md` 的契约缓存：operation 未知才 search，首次使用或 revision 变化时 describe，其他情况复用缓存并直接 call。describe 不完整就停止，不猜参数、响应、权限或风险。独立资源并发读写，回读结果并验证副作用；结构化资源不 checkout。
 
-### 完成日志
+### 工作记录
 
-只有整个任务的检查、UI/API 验证和所有 commit/MCP 写入都成功后，主 Agent 执行一次：
+任务开始即写入开发中状态；独立事项可先以待开发状态加入：
 
 ```bash
-draftgo changelog add "<完成结果>"
+draftgo work start "<事项>"
+draftgo work add "<独立事项>"
 ```
 
-任何验证失败、409/412 或交付失败都不得写 changelog。日志只写完成结果，不写排查过程。
+开始处理待开发项时运行 `draftgo work start-item <编号>`。只有 `draftgo verify` 和所有 commit/MCP 写入成功后，才运行 `draftgo work complete <编号> --note "<结果或证据>"`。用户明确要求视觉验收时还需完成对应截图或浏览器校验。任何验证失败、409/412 或交付失败都不得标记为完成。
 
 ## 安全规则
 
@@ -82,25 +82,26 @@ draftgo changelog add "<完成结果>"
 - 页面通过 `window.parent.App` 使用认证、权限、反馈和主题；登出调用 `await App.logout()`，路由参数读取运行时注入对象。详细规则见 `frontend.md`、`runtime.md` 与 `app-api.md`。
 - 自定义服务普通 SDK 继承调用者权限；仅显式 `draftgo.Admin.*` 提升单次调用并进入审计。Route 权限、脚本管理权限、定时/事件身份和出站限制见 `custom-services.md`。
 - 高风险 MCP operation 仅在用户意图明确且影响范围已核对时设置 `confirm=true`。不要传 SAT、Authorization、tenant override 或自行实现旧式二次认证。
-- 旧 `.draftgo` 缓存不是事实来源；不自动删除。不要隐式 force、自动重试覆盖或自动合并冲突。
+- 不要隐式 force、自动重试覆盖或自动合并冲突。
 
 ## 验证证据
 
 | 范围 | 最低证据 |
 |---|---|
 | MCP 连接 | 失败时用 `draftgo mcp test` 核对 initialize、tools/list 和关键工具；输出不含 SAT |
-| 页面、导航、文档 | checkout manifest、`draftgo check`、交付前 `draftgo verify`、diff、commit 返回版本与哈希 |
-| 结构化资源 | search/describe 契约、call 结果与回读的权限、字段、错误和副作用 |
-| 自定义服务 | 动态 Route describe、无副作用健康请求或目标行为结果，以及管理员调用审计 |
-| 冲突 | `.draftgo/conflicts/` 的 base/local/remote；解决后重新 check、必要的 verify 和 commit |
+| 页面、导航、文档 | checkout manifest、交付前 `draftgo verify`、diff、commit 返回版本与哈希 |
+| 结构化资源 | 缓存或最新 describe 契约、call 结果与必要回读 |
+| 自定义服务 | commit revision、validate 结果；任务涉及运行或发布时再提供 test/publish 结果 |
+| 冲突 | `.draftgo/conflicts/` 的 base/local/remote；解决后重新 `draftgo verify`、diff 和 commit |
 | 本地底座 | `draftgo local status`、日志和相关 local 测试 |
 
-`draftgo deploy`、`auto-push` 和兼容 `push pages|nav|docs` 只能沿用当前 check/commit 语义，不能恢复旧的全量 push。主 Agent 最终明确区分 Skill 约束、MCP 实时状态和 checkout 正文证据。
+`draftgo deploy` 和 `auto-push` 只能沿用当前 check/commit 语义。主 Agent 最终明确区分 Skill 约束、MCP 实时状态和 checkout 正文证据。
 
 ## 本地工作区
 
 - `.draftgo/config.json`：server、SAT 与 CLI 设置，必须 gitignore。
+- `.draftgo/api-contract-cache.json`：按 registry revision 缓存的私有 operation schema，必须 gitignore。
 - `.draftgo/worktree/`、`.base/`、`manifest.json`：checkout 正文及基线，必须 gitignore。
 - `.draftgo/conflicts/`：409/412 材料，必须 gitignore。
-- `.draftgo/story.yaml`、`Task/`、`lessons/`：项目决策、任务和经验。
-- `.draftgo/changelog.md`：仅在整个任务验证和交付成功后写入。
+- `.draftgo/story.yaml`、`lessons/`：项目决策和经验。
+- `.draftgo/worklog.md`：待开发、开发中和已完成事项及备注。

package/resources/skill/init/SKILL.md

@@ -17,30 +17,25 @@ description: Install or refresh the DraftGo skill, connect a project to a DraftG
    - 已有 DraftGo 服务器：运行 draftgo connect。
    - 需要本地 Docker 基座：运行 draftgo local setup。
 6. 连接后运行 draftgo mcp setup（或指定目标），再运行 draftgo mcp test 验证 initialize、tools/list 和关键工具。
-7. 根 Skill 自动加载后，按实际任务读取最少必要的 Reference，并通过 MCP project_overview、resource_search 或 api_search 获取实时信息；需要叠加本地 checkout 状态时运行 `draftgo map`。MCP 不可用时报告原因，不回退到 pull --all。
+7. 根 Skill 自动加载后，按实际任务读取最少必要的 Reference，并通过 MCP project_overview、resource_search 或 api_search 获取实时信息；需要叠加本地 checkout 状态时运行 `draftgo map`。MCP 不可用时报告原因。
 
 draftgo init 只负责 Skill 安装；draftgo connect 负责保存并验证 server/SAT；draftgo mcp setup 负责宿主配置。不要混用职责。
 
-初始化后 `.draftgo/` 只保留已经写入的 `config.json`。不要预建 Task、lessons、changelog、worktree、conflicts 或其他占位文件和目录；首次实际使用对应能力时再创建。
+初始化后 `.draftgo/` 只保留已经写入的 `config.json`。不要预建 worklog、lessons、worktree、conflicts 或其他占位文件和目录；首次实际使用对应能力时再创建。
 
 ## SAT 与配置
 
 - 交互式连接应使用隐藏输入；不要把 SAT 写入宿主配置、Skill 文件、命令行示例或日志。
 - .draftgo/config.json、checkout manifest、base 和冲突目录必须加入项目 .gitignore。
 - bridge 从当前项目配置读取 SAT；宿主配置只引用 draftgo mcp serve。
-- 旧 .draftgo 缓存不自动删除。把它当作 legacy 数据，提示用户使用 MCP 或 checkout 重新建立上下文。
 
 ## 后续动作
 
 - 宿主配置和诊断：draftgo mcp setup/status/test，详见 ../references/mcp.md。
 - 开发准备：根 Skill 自动加载；按任务路由读取最少必要的 Reference，再按需直接调用 MCP。
 - 远端资源补充定位：MCP project_overview、resource_search、resource_list。
-- 正文编辑：自主设计并批量 checkout，不同资源按唯一 owner 并行修改，由主 Agent 统一运行 check、交付前 verify、diff 和 commit。
+- 正文编辑：遵循根 Skill 的 checkout/commit 与统一验证策略。
 - 结构化资源：直接使用 MCP 的 api_search、api_describe、api_call；不 checkout、不生成本地镜像。
-- 完成日志：只有整个任务统一验证且全部 commit/MCP 交付成功后，由主 Agent 执行一次 `draftgo changelog add "<完成结果>"`；验证、冲突或交付失败时不得写入。
-- 管理本地基座：draftgo local start|stop|logs|status；local-dev、local up/down 仍可用。
+- 工作记录：开发开始时运行 `draftgo work start "<事项>"`；只有统一验证且全部 commit/MCP 交付成功后运行 `draftgo work complete <编号> --note "<结果>"`。验证、冲突或交付失败时不得标记为完成。
+- 管理本地基座：draftgo local setup|start|stop|logs|status。
 - 移除指定目标：draftgo uninstall <target>；完整移除所有目标只在用户明确要求时运行 draftgo uninstall all，--purge 会删除 .draftgo/。
-
-## 迁移旧命令
-
-draftgo pull 不再执行同步。它只能给出迁移提示并返回非零，指导使用 MCP 定位资源或 checkout 长正文。不要悄悄恢复全量下载。

package/resources/skill/manifest.json

@@ -2,14 +2,14 @@
   "schema_version": "1.0",
   "id": "draftgo",
   "name": "DraftGo 开发助手",
-  "version": "3.0.55",
+  "version": "4.0.1",
   "entry": "SKILL.md",
   "description": "以 Skill/reference 任务路由、MCP 实时发现、长正文 checkout/commit、统一验证和完成日志为边界的 DraftGo 工作流。",
   "license": "MIT",
   "capabilities": [
     "draftgo-development",
     "reference-routing",
-    "completion-changelog",
+    "worklog-tracking",
     "custom-service-ai-sdk",
     "mcp-bridge",
     "content-checkout-commit",

package/resources/skill/references/aihub.md

@@ -5,7 +5,7 @@ read_when: 创建或调优 AI Agent 时 · 需要工具/子智能体/记忆/多
 # AIHub / Agent 资源
 
 AIHub 是结构化远端资源，不 checkout，也不生成本地镜像。先使用 MCP `draftgo_resource_search`/`draftgo_resource_list`
-定位资产，再用 `draftgo_api_search`、`draftgo_api_describe` 获取实时契约，最后通过 `draftgo_api_call` 读写。
+定位资产；未知 operation 才用 `draftgo_api_search`，首次使用或 registry revision 变化时 `draftgo_api_describe`，然后通过 `draftgo_api_call` 读写。
 更新 AIHub 资产时只发送实时契约允许的字段；常见字段包括
 `type, name, data, priority, version, tags, describe, permission, status`。供应商和模型使用各自的实时接口，
 不要经旧 AIHub 资产接口写入。任何输出、工作区文件或调用参数都不得保存 API Key 或 header 值；只可处理
@@ -29,7 +29,7 @@ AIHub 是结构化远端资源，不 checkout，也不生成本地镜像。先
 
 页面对话 UI 使用 `<dg-chat protocol="draftgo-agent" agent-id="AGENT_ID">` 或 `DraftGoChat.create()`；
 旧代码/无 UI 文本调用可用 `DraftGoAI.chat(...)`，图片模式使用 `DraftGoAI.images(...)`。调用前都必须加载
-`/assets/draftgo-chat.js`，完整用法见 `references/chat-sdk.md`。后端 operation 与可调用 Agent 列表通过 MCP `draftgo_api_search` → `draftgo_api_describe` 实时确认。
+`/assets/draftgo-chat.js`，完整用法见 `references/chat-sdk.md`。后端 operation 与可调用 Agent 列表通过 MCP 实时确认；已知契约可复用项目缓存。
 
 ## `data.spec` 字段地图
 
@@ -44,7 +44,8 @@ AIHub 是结构化远端资源，不 checkout，也不生成本地镜像。先
 | `ttft_timeout` | number（秒，1–600，空=不启用） | 首字超时 failover：首个 SSE data 事件超时即跨模型+跨供应商切换，推理模型不误杀 |
 | `sync_request_timeout` | number（秒，1–600，默认 100） | 非流式请求上限 |
 | `stream_ttl` | number（秒，1–3600，默认 600） | 流式请求上限 |
-| `reasoning_effort` | `minimal`/`low`/`medium`/`high` | 纯透传，仅 OpenAI 系模型生效 |
+| `max_tokens` | number / 空 | 最大输出 token；留空时不写入请求，即不由 Agent 额外限制 |
+| `reasoning_effort` | `off`/`minimal`/`low`/`medium`/`high` | `off`/留空均不透传；其它值仅 OpenAI 系模型生效 |
 | `system_prompt_template` | string | 系统提示模板 |
 | `context.max_history` | number（默认 20） | 工作窗口：保留最近 N 条；关闭持续对话时即滑动窗口硬上限 |
 | `output_format.mode` | `text` / `json` | JSON 时按 `output_format.json.{schema,schema_name,strategy}` 约束/校验/降级 |
@@ -68,7 +69,9 @@ AIHub 是结构化远端资源，不 checkout，也不生成本地镜像。先
 | `memory.{enabled,scope}` | false / `user_agent` | 长期记忆：对话后自动提炼、下轮召回注入；作用域 `agent`/`user`/`user_agent` |
 | `compaction.{enabled,keep_recent,trigger_messages,trigger_tokens,preset}` | 关闭 | **持续对话/上下文闭环**：见下 |
 | `checkpoint_input_mode` / `checkpoint_max_messages` / `checkpoint_ttl_seconds` | 全量 / 100 / 86400 | 会话历史持久化（配合请求 `session_id`） |
-| `delegation.{max_depth,max_total_calls}` | 2 / 8 | 子智能体委派的深度与调用预算护栏 |
+| `delegation.{max_depth,max_total_calls}` | 2 / 8 | 最大嵌套层数与整棵调用树共享的子 Agent 调用次数；并行分支也从同一预算扣减 |
+
+同一模型步骤返回多个子 Agent 工具调用时，运行时立即按 `tool_concurrency` 并发执行；不同步骤自然串行，由模型自行决定编排方式。委派成功后，子 Agent 的每个模型回合 token 会汇总到入口 run，总量也写入对应委派 span。一次入口请求只创建一条主 run，Agent 列归属入口 Agent，委派链路从 span 查看。
 
 ### 持续对话（上下文闭环）
 
@@ -83,6 +86,8 @@ AIHub 是结构化远端资源，不 checkout，也不生成本地镜像。先
 ## 观测
 
 每次调用都开一条 AI run，管理台 `/admin/ai-runs` 展示状态、tokens、延迟、`ttft_ms` 与 span 链路。
-运行记录接口通过 MCP `draftgo_api_search` / `draftgo_api_describe` 实时发现，不维护静态路径表。
+运行记录接口通过 MCP 实时发现，不维护静态路径表；已知 operation 复用 registry revision 未变化的契约缓存。
+
+Agent 对外响应（`/api/agents/{id}/chat`、图片接口、Go/Script SDK Agent 调用）不返回内部 `model`、`fallback_models` 或 `upstream_model`；错误也不暴露内部模型名、供应商名称、服务地址或运行时实现名。只有显式启用 `model_selection.user_selectable` 后，`/selectable-models` 才作为授权的模型选择目录返回可选逻辑模型名。运行日志仍在服务端保留真实模型、供应商与链路信息用于定位。
 
 > 权威细节以 DraftGo 后端 `docs/backend/modules/agent-runtime.md` 为准；本页是基座开发者视角的字段速查。

package/resources/skill/references/chat-sdk.md

@@ -165,6 +165,9 @@ chat.addEventListener('dg-chat:run-finish', event => {
 - `persist` 默认开启，将 UI thread 历史写入 `localStorage`；敏感或临时页面设为 `false`。
 - 同一路由存在多个实例时，每个实例设置唯一 `storageKey`。
 - 每个 UI thread 自动维护独立 `sessionId`；`draftgo-agent` 将其作为 `session_id` 发送。
+- 切换会话只改变当前视图，不会停止其它 thread 的在途请求。会话列表标题左侧显示运行中状态；后台完成或失败后显示未读状态，进入该会话即视为已读并清除。
+- 每个请求使用独立 `run_id`。用户停止或 SDK 超时会调用 Agent 取消接口；普通会话切换不会发送取消。
+- 推理片段和工具调用按服务端事件的输出位置保留在消息内，不固定贴在消息底部；思考在正文、工具或结束事件到达后进入完成态，不再闪烁或滚动预览。
 - `newThread()` 创建新的后端会话边界；不要让不同用户共享固定 `storageKey` 或 `sessionId`。
 - `clear()` 和 `setMessages([])` 会重置当前 session，避免视觉清空后恢复旧 checkpoint。
 
@@ -197,5 +200,12 @@ chat.configure({ protocol: 'page-protocol' });
 - 页面 HTML、JSON config、`headers`、`context` 和 `localStorage` 中不得保存长期供应商密钥。
 - 不把模型输出直接赋给 `innerHTML`；使用 SDK 内置 Markdown/URL 安全渲染或显式净化。
 - 后端始终负责 Agent 调用权限、模型白名单、附件能力和大小限制，前端开关不能越权。
+- Agent 协议响应不应包含 Agent 内部模型名。模型选择器只能读取 Agent 明确授权的 `/selectable-models` 目录。
 
 交付前确认：只加载一个完整版脚本；新页面以 `<dg-chat>` 为对话 UI；同页多实例隔离 `storageKey`；外部协议走服务端代理；页面离开时停止在途请求。
+
+## 移动端契约
+
+- `inline`、`floating`、`drawer`、`fullscreen` 四种 surface 均由 SDK 自适应窄屏；`threads`、`workspace` 和 Artifact 会按容器宽度自动收敛为单栏，不要复制 Shadow DOM 内部布局规则。
+- SDK 使用 `VisualViewport` 和 `safe-area-inset-*` 跟随软键盘、浏览器工具栏与横竖屏变化。触摸设备打开面板时不会主动弹出软键盘。
+- 触摸端按钮和行操作具有移动端点击尺寸，输入字号防止 iOS 自动缩放；所有内部滚动区隐藏滚动条，但仍保留触摸、滚轮和键盘滚动能力。

package/resources/skill/references/checkout.md

@@ -95,14 +95,14 @@ base 已变化时必须拒绝覆盖。
 ## Commit 流程
 
 1. 读取 manifest 指向的 worktree 文件，计算当前字节数和 SHA-256；未变化时返回 `unchanged`。
-2. 按 content_type 执行本地结构和内联脚本检查；页面布局或交互有变化时运行 `draftgo verify <type> <id> --url <url>`。
+2. 按 content_type 执行本地结构和内联脚本检查。
 3. 通过专用 HTTP 流式上传原始文件，携带 `If-Match`、base version/revision、content_type、长度和 SHA-256。
 4. 完整正文不得作为 MCP tool 参数发送。
 5. 底座确认 hash 和新版本后，CLI 原子更新 `.base` 与 manifest。返回 hash 不一致时不得推进基线。
 
-推荐编辑顺序：主 Agent 按任务读取相关 Reference -> MCP 精确定位 -> Agent 自主设计并批量 checkout -> 独立资源按唯一 owner 并行编辑 -> 主 Agent 汇总回读 -> 统一运行一次 `draftgo check` -> `draftgo diff` -> commit -> 页面变化时用 `draftgo verify <type> <id> --remote --url <url>` 验证远端已提交版本。遇到本地正文已经等于远端、但 base/manifest 落后时，先用 `draftgo check --remote` 确认 `committed_unrecorded`，再运行 `draftgo reconcile`；不要手改 manifest。
+本地正文已经等于远端、但 base/manifest 落后时，先用 `draftgo check --remote` 确认 `committed_unrecorded`，再运行 `draftgo reconcile`；不要手改 manifest。
 
-单个 commit 成功不自动写 changelog。只有整个任务统一验证且全部 commit/MCP 交付成功后，主 Agent 才执行一次 `draftgo changelog add "<完成结果>"`。任何检查失败、409/412 或交付失败都不得写入。
+单个 commit 成功不自动完成 worklog 项。只有整个事项统一验证且全部 commit/MCP 交付成功后，主 Agent 才执行 `draftgo work complete <编号> --note "<完成结果>"`。任何检查失败、409/412 或交付失败都不得标记为完成。
 
 ## 409 / 412 冲突
 
@@ -119,7 +119,7 @@ base 已变化时必须拒绝覆盖。
 - `base` 是 checkout 时的内容；`local` 是发生冲突时的本地快照；`remote` 是重新下载并校验的当前远端内容。
 - `conflict.json` 记录三份路径、版本、ETag 和哈希，不嵌入完整正文。
 - Agent 或用户在 worktree local 文件中完成合并；不要手写 HTML 自动合并器，也不要改动保存的三份证据。
-- 合并完成后运行 `draftgo check`、必要时 `draftgo verify`，再执行 `draftgo conflict resolve <type> <id>`。
+- 合并完成后运行 `draftgo verify`，再执行 `draftgo conflict resolve <type> <id>`。
 - resolve 校验 worktree 与 remote，采用 remote 版本作为新的 base，但保留合并后的 worktree；随后运行
   `draftgo diff` 并 `draftgo commit`。