draftgo-cli 3.0.38 → 3.0.41

package/resources/skill/references/frontend.md

@@ -9,10 +9,10 @@ version: 2.0.0
 > 根 `SKILL.md` 是完整核心规则源；本文件只展开前端实现方法。若表述冲突，以根 `SKILL.md` 为准，不额外叠加固定验收动作。
 
 > 本文件只规定前端**操作性规则**，已剥离的内容见：
-> 架构原理 → `{{SKILL_DIR}}/references/architecture.md`
-> App API / Token / 路由 / 运行时 → `{{SKILL_DIR}}/references/runtime.md` · `{{SKILL_DIR}}/references/app-api.md`
-> 动态 DB / filters → `{{SKILL_DIR}}/references/data.md`
-> 开发禁区 → `{{SKILL_DIR}}/references/security.md`
+> 架构原理 → `references/architecture.md`
+> App API / Token / 路由 / 运行时 → `references/runtime.md` · `references/app-api.md`
+> 动态 DB / filters → `references/data.md`
+> 开发禁区 → `references/security.md`
 
 ---
 
@@ -27,177 +27,11 @@ version: 2.0.0
 - 业务模块尽量不要复制大量同构工作台；列表、详情、编辑、管理页优先按任务差异设计结构、密度和操作区
 - 无法实现真实闭环时停止开发，向用户说明阻塞点；确认为平台限制、可复用经验或连续排查失败时再写入 `.draftgo/lessons/`
 
-### 操作型页面布局（强制）
+### 数据型页面可用性约束（强制）
 
-后台管理、表格、列表等操作型页面用**工作台布局**，不用文档流堆叠：
-```css
-.workbench-page { min-height:100vh; display:flex; flex-direction:column; overflow:hidden; }
-.workbench-toolbar { flex-shrink:0; }
-.workbench-body { flex:1; min-height:0; display:flex; flex-direction:column; }
-.workbench-data { flex:1; min-height:0; overflow:auto; }
-.workbench-footer { flex-shrink:0; }
-```
-
-- 分页/操作栏/保存栏固定在工作区底部，不随数据量上浮
-- 滚动发生在数据区，不是整页
-
-### 表格工作区布局
-
-所有数据表格页面，无论使用原生表格、AntD 或其他组件库，都遵守同一布局契约：
-
-- 页面根容器占满可用视口或 iframe 内容区，使用 `height: 100%`、`height: 100vh` 或已知导航高度的 `calc(...)`；不能由表格内容决定页面高度。
-- 表格内容区占据工具栏和底部控制区以外的所有剩余空间：`flex: 1; min-height: 0`。
-- 纵向和横向滚动只能发生在表格内容区。横向滚动条必须紧贴在分页或批量操作栏上方，不能落在长列表的末尾。
-- 分页、批量操作栏、保存栏等底部控制区使用 `flex-shrink: 0`，始终停在工作区底部；数据只有一行或没有数据时也不向上漂移。
-- 禁止使用 `min-height` 加自然文档流模拟该布局，也不要让 `body`、页面根和表格内容区同时滚动。
-
-通用骨架：
-
-```html
-<main class="table-workspace">
-  <header class="table-toolbar">...</header>
-  <section class="table-viewport">
-    <table>...</table>
-  </section>
-  <footer class="table-footer">...</footer>
-</main>
-```
-
-```css
-.table-workspace {
-  height: 100%;
-  min-height: 0;
-  display: flex;
-  flex-direction: column;
-  overflow: hidden;
-}
-.table-toolbar,
-.table-footer { flex-shrink: 0; }
-.table-viewport {
-  flex: 1;
-  min-height: 0;
-  overflow: auto; /* X scrollbar remains immediately above .table-footer */
-}
-.table-viewport > table { min-width: max-content; }
-```
+数据型页面必须保证主要操作可达、滚动边界清晰，并使分页、批量操作或保存控件在空数据、少量数据和长列表状态下始终可用。横向溢出不能把核心操作藏到不可达区域，加载态、空态、错误态和成功态都必须保持页面结构稳定。
 
-### 表格数据区与分页钉底
-
-当页面主体是表格、日志列表、后台数据管理页时，必须先做固定高度的 flex column 容器，再放表格。不要让分页跟随表格内容高度往下跑，也不要让整页滚动。
-
-参考骨架：
-
-```css
-/* 整页表格页 */
-.table-page {
-  height: 100vh;
-  min-height: 0;
-  display: flex;
-  flex-direction: column;
-  overflow: hidden;
-}
-
-/* 如果页面外已有顶部导航，用实际导航高度替换 56px */
-.table-page.with-top-nav {
-  height: calc(100vh - 56px);
-}
-
-.table-toolbar {
-  flex-shrink: 0;
-}
-
-.table-shell {
-  flex: 1;
-  min-height: 0;
-  display: flex;
-  flex-direction: column;
-  overflow: hidden;
-}
-
-.table-data {
-  flex: 1;
-  min-height: 0;
-  overflow: auto;
-}
-
-.table-pagination {
-  flex-shrink: 0;
-  margin-top: auto;
-}
-```
-
-AntD Table 示例结构：
-
-```javascript
-h('div', { className: 'table-page' },
-  toolbar && h('div', { className: 'table-toolbar' }, toolbar),
-  h('div', { className: 'table-shell' },
-    h('div', { className: 'table-data' },
-      h(antd.Table, {
-        rowKey: 'id',
-        columns,
-        dataSource: items,
-        loading,
-        pagination: false,
-        scroll: { x: 1100 },
-        onChange: handleTableChange,
-      })
-    ),
-    h('div', { className: 'table-pagination' },
-      h(antd.Pagination, {
-        current: page,
-        pageSize,
-        total,
-        showSizeChanger: true,
-        onChange: loadPage,
-      })
-    )
-  )
-)
-```
-
-如果表格列很多，横向滚动条必须固定在分页上方，而不是藏在长数据列表底部。做法是让 antd Table 自己生成 `.ant-table-body` 滚动区：外层 `.table-data` 只负责 flex 占位和 `overflow:hidden`，Table 设置 `pagination:false`、`scroll:{ x: 1100, y: '100%' }`，再用 CSS 让 `.ant-table-body` 填满剩余高度。
-
-```css
-.table-data {
-  flex: 1;
-  min-height: 0;
-  overflow: hidden;
-  display: flex;
-  flex-direction: column;
-}
-
-.table-data .ant-table-wrapper,
-.table-data .ant-spin-nested-loading,
-.table-data .ant-spin-container,
-.table-data .ant-table,
-.table-data .ant-table-container {
-  flex: 1;
-  min-height: 0;
-  min-width: 0;
-  display: flex;
-  flex-direction: column;
-}
-
-.table-data .ant-table-header { flex-shrink: 0; }
-.table-data .ant-table-body {
-  flex: 1 1 0;
-  min-height: 0;
-  max-height: none !important;
-  overflow: auto !important;
-}
-```
-
-```javascript
-h(antd.Table, {
-  rowKey: 'id',
-  columns,
-  dataSource: items,
-  loading,
-  pagination: false,
-  scroll: { x: 1100, y: '100%' },
-})
-```
+具体信息架构、DOM、组件、布局和视觉风格由 Agent 根据任务目标、受众、数据规模和现有资源自主设计。CLI 与 Skill 不提供页面骨架，也不指定工作台、表格页或其他固定页面结构。
 
 ### 文本与图标换行控制（强制）
 
@@ -225,119 +59,16 @@ h(antd.Table, {
 
 移动端适配是产品与受众判断，不是所有页面的固定验收门。公众页面、用户可能从手机访问的业务页面、已有响应式断点，或本次修改涉及布局/CSS/导航/弹窗时，应认真处理窄屏；明确的桌面工作台、仅改文案/数据逻辑、后端或脚本任务，不要机械增加移动端检查。需要窄屏布局时，可以先保证小屏可用，再在宽屏增强信息密度。
 
----
-
-#### 1. 容器宽度：禁止固定像素，用流式布局
-
-内容容器宽度必须随可用空间伸缩，永远不要写死像素宽度：
-
-```css
-/* ✅ */
-.container { width: 100%; max-width: 960px; margin: 0 auto; padding: 0 16px; }
-
-/* ❌ 窄屏必然横向溢出 */
-.container { width: 1200px; }
-```
-
-Tailwind：`w-full max-w-4xl mx-auto px-4`
+响应式实现只规定结果，不提供固定配方：
 
----
-
-#### 2. 并排布局：默认纵向堆叠，宽屏才横排
-
-任何"左右并排"的布局，首先决定窄屏下如何堆叠，再决定多宽时切换为横排：
-
-```css
-/* 窄屏纵向，768px+ 横排 */
-.layout { display: flex; flex-direction: column; gap: 16px; }
-@media (min-width: 768px) {
-  .layout { flex-direction: row; }
-  .sidebar { width: 240px; flex-shrink: 0; }
-  .main { flex: 1; min-width: 0; } /* min-width:0 防长内容撑破父容器 */
-}
-```
-
-Tailwind：`flex flex-col md:flex-row gap-4`，主内容区加 `flex-1 min-w-0`。
-
-多列卡片 / 统计块，让列数随宽度自动伸缩：
-
-```css
-.cards { display: grid; grid-template-columns: repeat(auto-fit, minmax(200px, 1fr)); gap: 16px; }
-```
-
-Tailwind 固定列数降级写法：`grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-4 gap-4`
-
----
-
-#### 3. 可点击区域：触控友好
-
-手指触摸区域不能太小，按钮、链接、导航项应结合页面密度提供足够内边距和间距，相邻元素避免误触：
-
-```css
-.btn { padding: 8px 16px; display: inline-flex; align-items: center; }
-.nav-item { display: flex; align-items: center; padding: 8px 12px; }
-```
-
----
-
-#### 4. 文字：正文不缩，标题宽屏再放大
-
-正文 16px 在任何屏幕都合适，不需要响应式。大标题在手机上不要过大，宽屏再逐步放大：
-
-```css
-.title { font-size: 20px; }
-@media (min-width: 1024px) { .title { font-size: 28px; } }
-```
-
-Tailwind：`text-xl lg:text-3xl`
-
----
-
-#### 5. 超宽内容（表格、代码）：容器内横滚，不让整页横滚
-
-表格列多时，不能让整个页面出现横向滚动条，必须在容器层限制：
-
-```html
-<div style="overflow-x: auto;">
-  <table style="min-width: 640px; width: 100%;">...</table>
-</div>
-```
-
-antd Table 加 `scroll={{ x: 'max-content' }}`，无需额外包裹。
-
----
-
-#### 6. 间距：小屏收紧，大屏舒展
-
-```css
-.page { padding: 16px; }
-@media (min-width: 768px) { .page { padding: 24px 32px; } }
-```
-
-Tailwind：`p-4 md:p-6 lg:p-8`
-
----
-
-#### 7. 弹窗与抽屉：宽度跟屏幕走
-
-```css
-.modal { width: min(90vw, 520px); }           /* 窄屏自动收缩 */
-.modal-body { max-height: 60vh; overflow-y: auto; } /* 内容多时内部滚动 */
-```
-
-antd Modal：`width="min(90vw, 520px)"`；抽屉窄屏优先 `placement="bottom"`。
-
----
-
-#### 按需验收参考
-
-| 参考宽度 | 适用时的观察项 |
-|---|---|
-| **390px** | 面向手机用户时，观察横向溢出、核心操作和文字截断 |
-| **768px** | 涉及平板或断点切换时，观察重叠和挤压 |
-| **1440px** | 桌面工作台或宽屏页面，观察信息密度和空间利用 |
+- 内容使用可用空间并避免整页横向溢出；容器宽度、断点和边距沿用现有设计系统，或根据真实内容和目标设备确定。
+- 并排区域必须在目标窄屏上保持阅读顺序、核心操作和导航可达；是否堆叠、隐藏次要信息或调整密度由 Agent 自主设计。
+- 按钮、链接和导航项应提供适合目标设备的操作区域，相邻操作避免误触。
+- 字体、标题层级和间距在目标视口保持清晰且不遮挡内容，不预设统一字号或间距尺度。
+- 表格、代码和其他超宽内容应在合理边界内可访问，不能让核心操作因溢出而不可达。
+- 弹窗和抽屉在目标视口内完整可用，长内容有明确滚动边界。
 
-不要为了收尾机械遍历全部宽度。需要浏览器证据时优先运行 `draftgo verify-ui <url> --mobile-check auto`：默认单个 `390x844` 视口，检查空白页、横向溢出、console/page error 和可选关键元素，仅失败时截图。只有必须依赖用户现有登录会话、浏览器扩展或真实桌面状态时才考虑 computer use。
+CLI 与 Skill 不预选容器宽度、断点、侧栏尺寸、卡片列数、标题字号、页面间距或弹窗宽度。不要为了收尾机械遍历无关视口；需要浏览器证据时按页面受众和现有断点运行 `draftgo verify-ui <url> --mobile-check auto`。只有必须依赖用户现有登录会话、浏览器扩展或真实桌面状态时才考虑 computer use。
 
 ---
 
@@ -355,11 +86,11 @@ antd Modal：`width="min(90vw, 520px)"`；抽屉窄屏优先 `placement="bottom"
 - 公开页 → 顶部/侧边导航、首页入口、相关按钮之一
 - 后台页 → 后台导航、管理菜单或现有后台入口
 - 多页面功能：列表/详情/新建/编辑/管理必须互相走通
-- 用户明确要求"隐藏页/草稿页"才可不绑定，但必须在 changelog / Task 说明原因
+- 用户明确要求"隐藏页/草稿页"才可不绑定，并在 Task 记录原因；changelog 只记录最终完成结果
 
 ### `page_1_root.html` 首页特例（强制）
 
-- 仍是默认内置首页 → 通常按官网介绍、品牌门面和入口聚合重新实现，不沿用内置文案和结构；只有用户明确要“进入即使用”的首页，才把首页当实际工作台
+- 仍是默认内置首页 → 根据用户目标、受众和现有资源自主决定改造方式；CLI 不指定官网、工作台或其他页面结构
 - 已被用户改过 → 只做要求范围内的修改，不强制重做
 - 判断依据：看 HTML 内容是否保留 DraftGo 默认文案/系统介绍/未定制品牌，不要只凭文件名判断
 
@@ -861,4 +592,4 @@ const dbRes = await App.get('db/order', params);
 const q = (window.__DG_ROUTE_CONTEXT__ || window.__DG_GET_ROUTE_CONTEXT__?.() || App?.getCurrentRouteContext?.() || { query: {} }).query;
 ```
 
-完整 API 表 → `{{SKILL_DIR}}/references/app-api.md`
+完整 API 表 → `references/app-api.md`

package/resources/skill/references/mcp.md

@@ -12,6 +12,8 @@ DraftGo MCP 用于实时发现、结构化查询和普通 API 操作。完整 pa
 MCP tool result 或参数传输；需要全文时使用 `draftgo checkout`，提交时使用 `draftgo commit`。MCP 返回
 `artifact` / `omitted` 时保留该语义，不要尝试重新展开长内容。
 
+`draftgo context` 是注册在 CLI 的确定性编排命令，不是 MCP 工具，也不得在 MCP 服务端新增同名或等价的聚合工具。它先精确读取任务路由中的本地 Reference 章节，再复用一个 MCP 会话并行查询项目、资源、API 和数据结构，原样输出结构化结果及来源。context 完成后，Agent 仍可按需继续直接调用任意现有 MCP 工具。
+
 标准发现顺序：
 
 1. `draftgo_project_overview`
@@ -26,12 +28,14 @@ MCP tool result 或参数传输；需要全文时使用 `draftgo checkout`，提
 ## CLI
 
 ```bash
+draftgo context --task frontend --output json
 draftgo mcp setup [target...]
 draftgo mcp status [target...]
 draftgo mcp test
 draftgo mcp serve
 ```
 
+- `context` 是开发任务的一次性准备入口；不保存业务镜像，不传输完整正文。
 - `setup` 写入项目级宿主配置，只替换 `draftgo` MCP 条目并保留其他配置。
 - `status` 检查配置是否存在、格式是否有效，以及是否误写了凭据或远端 URL。
 - `test` 从 `.draftgo/config.json` 读取连接，验证 initialize、tools/list 和关键 tools/call。

package/resources/skill/references/parallel.md

@@ -1,5 +1,7 @@
 # DraftGo 并行执行
 
+主 Agent 在任务开始时只执行一次 `draftgo context --task <task> --output json`，随后维护共享契约和资源 owner。并行是按依赖和资源边界选择的执行方式，不是每个任务的固定要求。
+
 ## 资源依赖
 
 先为每个工作单元记录：
@@ -13,10 +15,12 @@
 | 资源关系 | 执行顺序 |
 |---|---|
 | 多个实现依赖同一 schema、API、权限或路由 | 先确定共享契约，再并行实现消费者。 |
-| 两个工作单元修改同一文件或资源 | 合并为一个单元，或安排到连续 wave。 |
+| 多个工作单元涉及同一文件或 DraftGo 资源 | 全程分配给同一个修改 owner；其他 Agent 只能只读分析并回传建议。 |
 | 页面与对应导航入口 | 页面 route 确定后接入导航。 |
 | 不同文件且没有数据或接口依赖 | 放入同一 wave 并行执行。 |
 
+单页面、强依赖任务，或拆分后仍共享主要文件/资源的任务由一个 Agent 完成，不强行并行。
+
 ## 工作单元
 
 分发内容包括：
@@ -29,17 +33,18 @@ evidence: 返回的检查或运行证据
 delivery_owner: main
 ```
 
-工作单元返回修改结果、验证证据和阻塞信息。主代理维护共享契约、推进 wave、汇总资源并执行交付。
+工作单元返回修改结果、验证证据和阻塞信息。主 Agent 独占资源 owner 分配、共享契约维护、wave 推进、汇总回读、统一验证、commit 和 changelog 职责；子 Agent 不写 changelog。
 
 ## Wave 执行
 
-1. 确定 schema、服务端点、权限、route 和导航结构等共享契约。
+1. 主 Agent 执行一次 context，确定 schema、服务端点、权限、route 和导航结构等共享契约，并建立唯一资源 owner 表。
 2. 将 `depends` 已满足且 `resource_lock` 不冲突的工作单元放入同一 wave。
 3. 并行执行当前 wave，汇总后回读所有变更资源。
 4. 处理接口接线和入口绑定，再启动依赖已满足的下一 wave。
-5. 统一运行 `draftgo check`、必要的 API/UI 验证；只对已 checkout 的 pages/nav/docs 执行 commit，结构化资源通过 MCP 实时 API 交付。
+5. 主 Agent 统一运行一次 `draftgo check` 和必要的 API/UI 验证；只对已 checkout 的 pages/nav/docs 执行 commit，结构化资源通过 MCP 实时 API 交付。
+6. 全部验证和交付成功后，由主 Agent 执行一次 `draftgo changelog add "<完成结果>"`。
 
-某个工作单元失败时，其依赖项等待处理；其余独立分支继续汇总。发现资源锁冲突时，将冲突单元合并或移到后续 wave。
+某个工作单元失败时，其依赖项等待处理；其余独立分支继续汇总。发现资源锁冲突时，将相关实现重新归并给既有唯一 owner，不得通过移动到后续 wave 改由另一个 Agent 修改。
 
 已 checkout 长正文的批量交付示例：
 
@@ -48,4 +53,4 @@ draftgo commit pages 1 2 3
 draftgo commit nav 4
 ```
 
-不同类型分开提交。发生 409/412 时当前 wave 必须停止并保留冲突材料，不得继续自动提交后续依赖项。
+不同类型分开提交。发生 409/412 时当前 wave 必须停止并保留冲突材料，不得继续自动提交后续依赖项。统一验证失败、409/412 或任何交付失败时都不得执行 `changelog add`。

package/resources/skill/references/runtime.md

@@ -36,7 +36,7 @@ read_when: 需要理解运行时机制时 · 处理 token/路由/事件相关问
 
 `app` 组成：`api.js`（请求）+ `feedback.js`（弹窗/Toast）+ `runtime.js`（路由/主题）+ `i18n.js`（国际化）+ state（currentUser/isAdmin/config/theme）
 
-完整 API 见 `{{SKILL_DIR}}/references/app-api.md`
+完整 API 见 `references/app-api.md`
 
 ---
 

package/resources/skill/references/ui-protocol.md

@@ -74,7 +74,7 @@ data-ui 节点               → DraftGo bridge 挂载真实 shadcn/Radix
 
 ## Tailwind 规则
 
-Page 资产仍然以 Tailwind HTML 为主。完整页面需要任意 Tailwind 原子类时，继续使用本地 `/assets/tailwindcss.js` 或已有页面模板；禁止外部 CDN。
+Page 资产仍然以 Tailwind HTML 为主。完整页面需要任意 Tailwind 原子类时使用本地 `/assets/tailwindcss.js`；修改既有页面时保留其已验证的本地资源引用。禁止外部 CDN。
 
 bridge 注入的 CSS 只保证 `data-ui` 组件需要的 shadcn/Tailwind 样式，不负责动态编译数据库 HTML 中任意 Tailwind class。
 

package/resources/skill/scripts/README.md

@@ -3,6 +3,8 @@
 DraftGo execution is provided by the installed `draftgo` CLI. Legacy Python pull, push, init, and delete helpers were
 removed because they depended on full local mirrors and bypassed the MCP plus checkout/commit safety model.
 
+Context orchestration belongs to the registered `draftgo context` CLI command. Do not duplicate it in Skill scripts and do not add an aggregate MCP tool for it.
+
 Do not add a script that downloads `.draftgo/*/index.json`, embeds SAT credentials, sends full pages/nav/docs content
 through MCP, or retries version conflicts with force. Reusable helpers added here must preserve the workflows in
 `references/mcp.md` and `references/checkout.md`.