draftgo-cli 1.0.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DraftGo contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,249 @@
+# DraftGo CLI 1.0.0
+
+面向 AI 编码工具的 DraftGo CLI。它负责 Skill 安装、项目连接、System MCP 发现、长正文 checkout/commit、组件开发、统一本地验收和 worklog 记录。
+
+## 项目开发
+
+以轻量高效为原则，用户描述需求，宿主 Agent 依据 Skill 操作底座。`draftgo init` 只创建根目录 `Design/README.md` 说明页，保留已有文件；模块使用编号文件夹，业务文档和 UI 资料按需建立。
+
+用户 Design 保存产品当前及未来目标，`.draftgo/worklog.md` 保存实施范围、状态与证据。新系统先形成最小设计，再实施业务闭环；需求变化直接修订设计，不并列新旧版本或维护“不做什么”清单。设计存在不等于已经实现。CLI 自身的 Design 描述工具能力，与用户产品设计独立。
+
+任务恢复用 `draftgo work list --status active --limit 20 --output json` 和 `draftgo work show <日期#序号>`。list 按最新事项优先，支持 `--date`、`--offset`，返回 `next_offset`；show 不带引用时保留完整历史查看能力。备注记录设计路径、需求编号、owner、阻塞和下一步。
+
+UI 稿用于必要的视觉讨论；已有页面先准确定位元素，再修改并验收。Git 管理文档和源码历史，DraftGo checkout/commit 操作实例资源，二者不能互相替代。旧 Story 按[开发实践](resources/skill/references/development.md)迁入 Design，新项目不再创建 Story。
+
+## 核心规则
+
+- 根 Skill 自动加载；Agent 只读取当前任务需要的 Reference。
+- pages、navigations 和 docs/articles 的完整正文使用 `checkout`、worktree、`diff`、`commit`；结构化资源使用 MCP/API。
+- MCP schema 是服务端实时契约。已知 operation 优先使用项目私有缓存；首次使用或 `registry_revision` 变化时 describe。schema 不写入 Skill 或聊天上下文。
+- 独立资源按 owner 并行，CLI 请求使用有界并发；同一资源的依赖步骤保持串行。
+- 每个任务开始记录到 `.draftgo/worklog.md`，验证和交付成功后再标记完成。
+- 已知页面使用 `draftgo map --type pages --route <path>` 或 `--title <title>` 精确定位；只需范围和状态时使用 `--summary`，浏览列表时使用 `--limit`（默认 20）/`--cursor`，不默认全量 map。
+- `--output json` 的 stdout 只包含 UTF-8 JSON；诊断和进度写入 stderr。大变更先用 `draftgo diff --stat` 或 `--summary`。
+
+跨板块任务先看[极简方法指南](resources/skill/references/methods.md)：它按 AI 能力、知识库/记忆、页面/内容、动态数据、MCP、运行诊断和交付验收给出“适用场景 + 最短正确命令链 + 失败定位 + 完成条件”。动态 operation 不写死；未知契约统一用 `draftgo api search`、`draftgo api describe`、`draftgo api call` 实时发现。
+
+## 验收策略
+
+普通交付只运行：
+
+```bash
+draftgo verify
+```
+
+默认验收只做本地检查，不启动浏览器，也不生成截图。用户要求视觉修改或视觉验收时才访问浏览器或截图；两者同时要求时先截图并查看结果，再做交互或 DOM 检查。
+
+```bash
+# 截图验收，默认 desktop 1440x900
+draftgo verify --url http://localhost:3000/path --screenshot always
+
+# 用户明确要求交互或 DOM 验收
+draftgo verify --url http://localhost:3000/path --ui always
+
+# 仅在用户要求时增加移动端
+draftgo verify --url http://localhost:3000/path --screenshot always --viewport both
+```
+
+`--ui` 和 `--screenshot` 的默认值都是 `never`；截图模式只有 `always` 和 `never`。默认视口是 desktop `1440x900`，移动端为 `390x844`。
+
+## 安装与连接
+
+```bash
+npm install -g draftgo-cli
+cd /path/to/project
+draftgo init
+draftgo connect --server https://draftgo.example --api-key "$DRAFTGO_API_KEY"
+draftgo mcp setup
+draftgo mcp test
+```
+
+`connect` 会验证当前用户的 DraftGo API Key、MCP initialize、tools/list、Registry search/describe，并通过 `api_call` 读取脱敏的当前 API Key 状态，然后才把连接写入项目私有的 `.draftgo/config.json`。该探测固定为无参数、低风险、非破坏的 GET，不创建或修改业务数据。宿主 MCP 配置只包含 `draftgo mcp serve`，不会保存 API Key。API Key 只代表真实用户，CLI 不附加契约之外的授权字段。
+
+本地底座：
+
+```bash
+draftgo local setup
+draftgo local start
+draftgo local status
+draftgo local logs app
+draftgo local stop
+```
+
+## 命令
+
+### 项目与 Skill
+
+```text
+draftgo init [target...]
+draftgo update [target...]
+draftgo uninstall <target|all> [--purge]
+draftgo status
+draftgo list-targets
+draftgo connect [target...]
+```
+
+`draftgo status` 会通过只读 MCP 诊断显示服务连接健康状态、服务版本和 Registry revision；`--output json` 适合读取 `connection.health` 与 `connection.registry_revision`。
+
+`draftgo update` 和 `draftgo update all` 只刷新项目中已经安装的 DraftGo Skill，不会升级全局 CLI，也不会因为检测到 `.cursor`、`AGENTS.md` 等工具痕迹而新增配置。`draftgo init` 的自动识别只看宿主自有目录或文件（例如 `.cursor`、`.codex`），不把 `AGENTS.md`、`CLAUDE.md`、`GEMINI.md` 这类可共享说明文件当成安装目标。显式指定 target 时（例如 `draftgo update cursor` 或 `draftgo init cursor`），如果该 Skill 尚未安装，会按你的明确请求直接安装；首次接入请使用 `draftgo init <target>`。
+
+### 发现与正文
+
+```text
+draftgo map [--type pages|nav|docs] [--route <path>] [--title <title>] [--summary] [--limit <1-100>] [--cursor <opaque>] [--output json]
+draftgo checkout <pages|nav|docs> <id...> [--force]
+draftgo check [--remote]
+draftgo verify [<type> <id...>] [visual flags]
+draftgo diff <type> <id> [--stat|--summary] [--output json]
+draftgo commit <type> <id...>
+draftgo refresh <type> <id...>
+draftgo reconcile <type> <id...>
+draftgo conflicts [--all]
+draftgo conflict show <type> <id>
+draftgo conflict resolve <type> <id>
+```
+
+`checkout` 下载正文和经过 hash 校验的 base。`commit` 先并发完成所有目标的本地与远端 preflight，全部通过后再并发上传；任何 409/412 都保留 base/local/remote 冲突材料，不 force、不覆盖、不自动合并。
+
+`--route`、`--title` 为精确匹配，同时给出时取交集。CLI 可用资源搜索缩小候选，但最终在本地做精确判定；服务端 `resource_search` 只接受通用 `query`，不能传 route/title。`map --summary` 不输出 project overview、资源列表或 hash。`diff --stat` 输出文件与增删行数，`--summary` 输出资源、版本和变更概要；只有不带这两个参数的 diff 才展开正文。
+
+### Page 组件库
+
+```bash
+draftgo components search <query> --output json
+draftgo components show <library/component> --output json
+draftgo components expand --page <id> --instance <data-dg-instance>
+draftgo verify pages <id>
+
+# 开发组件：commit 保存草稿，publish 显式上线
+draftgo components checkout <library/component>
+draftgo components diff <library/component>
+draftgo components verify <library/component>
+draftgo components commit <library/component>
+draftgo components publish <library/component>
+
+# 库管理和标准 ZIP 迁移
+draftgo components libraries list|show|create|update|delete
+draftgo components import <archive.zip> --dry-run
+draftgo components export <library> --file <archive.zip>
+```
+
+`search` 和 `show` 始终读取当前 DraftGo 实例的组件目录，AI 不得按名称猜写 props/slots。Page 以真实根标签和 `data-dg-use="library/component"` 保存活引用，发布新 revision 后刷新自动升级。高度个性化时先 checkout Page，再用 `expand` 固化当前 props、slots、组件/库 CSS、公共资产和 mount 初始化；展开实例变成普通 HTML/CSS/JavaScript，不再随组件升级，仍需经过 `diff -> verify -> commit`。
+
+最终版服务端内置 `DraftGo` 组件库（slug 为 `draftgo`），当前包含 47 个组件，目录以实例实时返回为准。常用组件包括 `button`、`input`、`select`、`multi-select`、`switch`、`dialog`、`drawer`、`data-filter-bar`、`data-table`、`data-list`、`pagination`、`date-picker`、`number-input`、`file-upload`、`tabs`、`menu`、`popover`、`tooltip`、`empty-state`、`chat` 等。官方页面中的可见选择器必须使用 `draftgo/select` 或 `draftgo/multi-select`，不要写原生 `<select>`。
+
+Page Runtime 的共享资源由最终版 `draftgo` 本地提供：`/assets/adapters/draftgo-components.js`、`/assets/adapters/draftgo-theme.css`、`/assets/tailwindcss.js`、`/assets/icons/`、`/assets/fontawesome/`、`/assets/vendor/{dompurify,marked,highlightjs}/`、`/assets/vendor/gsap/{gsap.min.js,Draggable.min.js}`。`draftgo/chat` 的完整实现直接存放在组件 `Definition.JS`，与其他组件走同一发布和按需解析流程，不存在独立 Chat SDK 静态文件。模型供应商品牌图标位于 `/assets/providers/`，通过 `DraftGoProviderIcons.get(kind)` 查找，未知供应商回退通用图标；不要引用 CDN。历史第三方组件资源不属于最终版契约。
+
+### MCP/API
+
+`api search` 和 `capabilities list/search` 默认 20 条，支持 `--module`、`--method`、`--limit`、`--cursor`。保留 `next_cursor`，需要更多时继续读取；只有显式 `capabilities audit` 才遍历全部能力。describe 保留完整契约，分页不裁剪接口能力。
+
+```text
+draftgo mcp setup [target...]
+draftgo mcp status [target...]
+draftgo mcp test
+draftgo mcp serve
+draftgo api <query>
+draftgo api search <query>
+draftgo api describe <operation_id>
+draftgo api call <operation_id> --input <json-file>
+draftgo delete <operation_id> [id] [--params JSON]
+draftgo capabilities list [--module <name>] [--type <module>] [--method <method>]
+draftgo capabilities search <query> [--risk <level>] [--permission <permission>]
+draftgo capabilities show <operation_id>
+draftgo capabilities audit --output json
+```
+
+`capabilities --type` 是 `--module` 的简写，用于 Registry module 筛选；它不表示 organization、space、scope 或 `resource_type`。
+
+`api call` 对已缓存 operation 直接调用并携带 `registry_revision`。服务端返回 `CONTRACT_CHANGED` 时重新 describe；只读或 operation 契约未变化时最多重试一次，危险 operation 自身契约变化时阻断调用并提示升级 CLI 后重新确认。调用输入必须是 UTF-8 JSON object；输出包含 HTTP status、服务端 code 和 request ID。System MCP 是动态 API 的唯一契约来源，CLI 不固化业务 URL 或请求结构。
+
+RBAC 与 API Key 快捷命令：
+
+```bash
+draftgo role list
+draftgo group members add --input request.json
+draftgo api-key status
+draftgo api-key rotate
+```
+
+`role` 管理 Role 权限模板，`group` 管理用户组及其角色。交互式 CLI、MCP 和普通 HTTP API 均使用当前用户的 API Key，并按同一基础 RBAC 与业务守卫授权；API Key 不能创建或伪造服务身份。未知能力始终通过 `api search/describe/call` 使用实时 Registry，不依赖固化权限表。
+
+### 交付与记录
+
+```text
+draftgo deploy <type> <id...> [--delivery local|preview|deploy]
+draftgo auto-push [<type> <id...>]
+draftgo work start <item>
+draftgo work add <item>
+draftgo work start-item <number|date#number>
+draftgo work wait <number|date#number> [--note <reason>]
+draftgo work complete <number|date#number> [--note <evidence>]
+draftgo work show|list
+draftgo clean [--dry-run|--yes]
+```
+
+`draftgo work start <item>` 的文本输出会返回可直接传给后续命令的引用，例如 `Started work item #21 (2026-08-20#21)`。
+
+## Worklog
+
+`.draftgo/worklog.md` 是任务、进度和完成证据的唯一记录。格式如下：
+
+```markdown
+[ 2026-08-09 ]
+1. [ ● ] 实现页面权限
+// 正在开发
+2. [ ] 补充验收
+
+[ 2026-08-10 ]
+1. [ √ ] 完成文档
+// draftgo verify、commit 已通过
+```
+
+`●` 表示进行中，`?` 表示待确认，`√` 表示已完成。旧空标记仍可读取，对外显示待确认；不自动重写历史。`work add` 新增待确认事项，`work wait` 暂停事项，`work start-item` 恢复。任务相关的验证、冲突或交付失败不能标记完成。
+
+## 运行时目录
+
+```text
+.draftgo/
+├── config.json
+├── api-contract-cache.json
+├── worklog.md
+├── worktree/
+├── conflicts/
+├── artifacts/
+└── tmp/
+```
+
+连接配置、契约缓存、worktree、冲突材料和截图都属于项目运行时数据并写入 `.gitignore`。`.draftgo/tmp/` 可由 `draftgo clean` 清理；需要用户查看的证据放在已注册的 `.draftgo/artifacts/` 下。
+
+## Skill 与 Reference
+
+Skill 只放稳定的领域知识、项目边界和操作规则；动态 operation schema 由 MCP 提供并缓存在项目运行时。Reference 不拆成更小文件，保留按任务路由、前端运行时、安全、checkout 和 MCP 契约所需的完整上下文，避免过度拆分损失效果。
+
+支持的 Skill target 包括 Claude Code、Cursor、Windsurf、Antigravity、Kiro、GitHub Copilot、Codex CLI、Gemini CLI 和 Pi。Pi 的项目级 Skill 安装到 `.agents/skills/draftgo/`，可被 Pi 按 Agent Skills 标准自动发现。
+
+## 开发与测试
+
+```bash
+npm run validate:skill
+npm test
+```
+
+本地开发要求 Node.js `>=20.19`。浏览器依赖仅在显式视觉验收时使用；普通 `npm test` 不会启动浏览器。
+
+许可证：MIT
+
+## Install without npm
+
+DraftGo can be installed from the China download endpoint. The installer falls back to a GitHub mirror and the official GitHub Release when the primary endpoint is unavailable.
+
+```bash
+# macOS / Linux
+curl -fsSL https://draftgo.cn/draftgo-cli/install.sh | sh
+
+# Windows PowerShell
+irm https://draftgo.cn/draftgo-cli/install.ps1 | iex
+```
+
+The download source can be overridden with `DRAFTGO_INSTALL_BASE_URL`, the GitHub Release mirror with `DRAFTGO_GITHUB_MIRROR`, and the version with `DRAFTGO_VERSION`. The CLI archive includes its npm dependencies but currently requires Node.js >=20.19.

package/bin/draftgo.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+'use strict';
+
+Promise.resolve(require('../src/index.js').run(process.argv.slice(2)))
+  .then((code) => { process.exitCode = Number(code) || 0; })
+  .catch((err) => {
+    console.error(err && err.stack ? err.stack : String(err));
+    process.exitCode = 1;
+  });

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "draftgo-cli",
+  "version": "1.0.4",
+  "description": "Install and manage the DraftGo skill across AI coding agents (Claude Code, Codex, Cursor, Windsurf, Antigravity, Copilot, Gemini, Kiro, Pi).",
+  "bin": {
+    "draftgo": "bin/draftgo.js"
+  },
+  "main": "src/index.js",
+  "engines": {
+    "node": ">=20.19"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "resources/",
+    "!resources/**/__pycache__/**",
+    "!resources/**/*.py[cod]",
+    "LICENSE",
+    "README.md"
+  ],
+  "keywords": [
+    "draftgo",
+    "skill",
+    "cli",
+    "claude-code",
+    "codex",
+    "cursor",
+    "windsurf",
+    "antigravity",
+    "copilot",
+    "gemini",
+    "kiro",
+    "pi"
+  ],
+  "author": "draftgo <cabinai@163.com> (https://github.com/draftgo)",
+  "license": "MIT",
+  "homepage": "https://github.com/draftgo/draftgo-cli#readme",
+  "bugs": {
+    "url": "https://github.com/draftgo/draftgo-cli/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/draftgo/draftgo-cli.git"
+  },
+  "scripts": {
+    "lint": "node scripts/check-syntax.js",
+    "validate:skill": "node scripts/validate-skill.js",
+    "build:release": "node scripts/build-release.js",
+    "verify:package": "node scripts/verify-package.js",
+    "test": "npm run lint && npm run validate:skill && npm run verify:package && npm run test:unit && npm run test:components && npm run test:capabilities && npm run test:worklog && npm run test:mcp && npm run test:worktree && npm run test:integration && npm run test:local && npm run test:e2e",
+    "test:unit": "node tests/unit.js",
+    "test:components": "node --test tests/components.test.js",
+    "test:capabilities": "node --test tests/capabilities.test.js",
+    "test:worklog": "node tests/worklog.test.js",
+    "test:mcp": "node --test tests/mcp.test.js",
+    "test:worktree": "node tests/worktree.test.js",
+    "test:integration": "node tests/integration.test.js",
+    "test:local": "node tests/local-runtime.js",
+    "test:e2e": "node tests/e2e.js"
+  },
+  "dependencies": {
+    "@grpc/grpc-js": "1.14.1",
+    "adm-zip": "0.5.16",
+    "parse5": "6.0.1",
+    "playwright-core": "1.61.1"
+  },
+  "directories": {
+    "test": "tests"
+  }
+}

package/resources/project-design/README.md

@@ -0,0 +1,42 @@
+# 项目设计
+
+本目录保存项目当前及未来的目标设计，包括系统概述、愿景、产品目标、业务规则、页面交互和验收条件。初始化时仅提供本文档，具体模块随需求明确逐步建立。
+
+## 设计与实现
+
+设计呈现最新确定的目标形态，能力可能已经实现，也可能尚待开发。实际进度通过 `.draftgo/worklog.md` 和项目实例检查。愿景提供方向，本轮任务范围由用户需求确定。
+
+变化时直接修订正文，保持一套有效设计；不并列维护原版与新版，不追加迭代流水账。正向描述应具备的能力，不设置“不做什么”清单。未确定的设想标为待明确，不能自行扩写成确定需求。
+
+## 文档组织
+
+- 产品目标明确后创建 `01 产品概述/README.md`，记录愿景、用户、场景和核心流程。
+- 每个模块使用稳定编号的文件夹，例如 `02 客户管理/README.md`。编号用于定位，不代表优先级或开发阶段。
+- 简单模块只需 README；复杂后按需拆出 `01 需求与规则.md`、`02 页面与交互.md` 等文件，不预建空目录。
+- 公共规则出现实际需要后集中定义，模块通过链接引用。新增、移动或拆分文件时更新索引。
+- 模块记录目标、流程、规则、验收条件和未决问题；按需补充数据关系、权限、依赖。需要追踪的需求使用稳定编号，供工作项引用。
+- 动态接口契约通过 CLI 实时发现，不复制 schema、凭据或响应快照到文档。
+
+## 页面与 UI
+
+涉及页面的模块说明页面用途、路由、关键操作及加载、空数据、错误等状态。简单内容直接写入模块 README。
+
+独立 UI 稿按需制作，用于确定视觉方向、复杂布局或用户要求的方案讨论。普通页面与小修改可以直接基于实际页面实现，不强制先画稿。
+
+实际产生视觉资料时创建模块内 `UI/`，保存目标稿、原型、参考图或标注材料，并在页面说明中注明用途和对应页面。视觉稿与文字保持一致，不堆积中间版本。验收截图通过 CLI 的 `.draftgo/artifacts/` 机制保存。
+
+描述位置模糊时，先定位页面、区域和具体元素；必要时利用实际截图标注候选并澄清。截图帮助定位和验收，不作为默认的整页重建依据。
+
+## 阅读与维护
+
+Agent 通过索引读取当前模块及相关公共规则，不默认加载全部设计或日志。用户最新明确要求与旧设计冲突时同步修订，有歧义才澄清。公共规则变化时检查受影响模块。
+
+不得为了迁就实现擅自删减需求或降低验收条件。修复实现偏差无需修改正确设计。交付时核对设计与结果，将完成范围和证据写入 worklog。
+
+## 工作记录与历史
+
+`.draftgo/worklog.md` 是任务状态的唯一记录，保存设计引用、进度、阻塞、下一步和完成证据。Design 不重复维护进度看板。项目采用 Git 时由 Git 保存文档历史；Git 回退不自动回退实例资源。
+
+## 模块索引
+
+尚未建立业务设计。首次形成需求后，在此添加模块链接及职责说明。

package/resources/skill/SKILL.md

@@ -0,0 +1,62 @@
+---
+name: draftgo
+description: Use this skill to inspect, develop, debug, or deliver a DraftGo application. Read only the task-specific references, locate long-content resources precisely, and use checkout/commit with a project worklog.
+---
+
+# DraftGo 开发助手
+
+## 开始前
+
+- 任务开始即运行 `draftgo work start "<事项>"`；记录 CLI 返回的工作项引用。独立事项用 `draftgo work add`，仅在验证和交付成功后运行 `draftgo work complete <ref> --note "<证据>"`。
+- 根 Skill 会在触发时自动加载；先读取下表中最少必要的 Reference，再用 MCP 查询当前项目。不要预先读取所有 Reference，也不要把动态 operation schema 写入 Skill 或聊天上下文。
+- pages、navigations 与 docs/articles 的完整正文只能通过 `draftgo checkout`、worktree、`draftgo diff`、`draftgo verify` 和 `draftgo commit` 处理；MCP 只用于定位、元数据和结构化资源。不要把完整正文或响应快照写入聊天上下文或手工归档。
+- 已知页面 route 或标题时，用 `draftgo map --type pages --route <path>` 或 `--title <title>` 精确定位；两个筛选条件取交集。只需范围或状态时加 `--summary`；需要浏览时使用 `--limit`（默认 20）和后续 `--cursor`，绝不默认全量枚举。
+- `--output json` 的 stdout 是单一 UTF-8 JSON；诊断和进度走 stderr。不要依赖终端截断来控制上下文。
+- 正常交付只运行 `draftgo verify`。默认跳过 UI；用户要求视觉修改或视觉验收时才使用截图，要求交互或 DOM 验证时才使用 `--ui always`。
+
+不要用 MCP 摘要代替完整正文，也不要把 Skill 中列出的 `/assets/` 能力声称为当前服务器全部文件。CLI 不提供页面模板；页面根据任务、受众、现有产品语言和可用资源设计。
+
+## 任务路由
+
+用户项目的 Design 保存当前及未来目标，worklog 保存实施状态；设计不表示功能已完成。新系统先形成最小设计，需求变化直接修订相关模块，不并列新旧稿或增加“不做什么”清单。新系统、迭代、恢复、UI 定位及多 Agent 协作按需读 `references/development.md`。已有任务优先通过 work list 筛选及 work show <ref> 恢复，不默认读全部日志。
+
+需求理解和编排由宿主 Agent 完成，CLI 不提供 build/run/deliver Agent。简单修改直接处理；跨页面与数据任务先确定字段、关系和接口，再实现页面，只读取涉及资源。需要用户决定时执行 `draftgo work wait <ref> --note "<原因>"`，继续时用 `work start-item`。
+
+能力搜索默认 20 条，保留 `next_cursor`，结果不足时继续 `--cursor`；`api search` 支持 `--module`、`--method`。摘要仅用于定位，精确 operation 的完整 schema 和完整正文按需读取。不把全量 audit 作为每次任务的起点。
+
+| 任务 | 先读 |
+|---|---|
+| 页面、导航、交互或 UI | `references/frontend.md`；涉及 iframe、路由、认证或全局层加读 `runtime.md` / `app-api.md` |
+| pages/nav/docs 正文、版本或冲突 | `references/checkout.md` |
+| 自定义 Go 服务、源码、SDK、草稿或策略 | `references/services.md` |
+| 动态 DB、筛选或关系 | `references/data.md`；复杂关系再读 `db-relations.md` |
+| 模型、提示词、插件、知识库、记忆、智能体或 AI 页面调用 | `references/ai.md`；页面调用再读 `chat-sdk.md` |
+| 角色、用户组、API Key 或其他结构化管理能力 | `references/mcp.md`；业务细节以实时 operation 为准 |
+| MCP 配置、API 契约或故障 | `references/mcp.md`；连接或调用失败时运行 `draftgo mcp test` |
+| 运行失败、日志或请求链路 | `references/diagnostics.md` |
+| 验证、发布或交付验收 | `references/delivery.md` |
+| 跨领域任务且不确定最短链路 | `references/methods.md`，再打开所需领域资料 |
+| 架构、模块选型或陌生项目 | `references/architecture.md`、`references/modules.md`；按 `Design/README.md` 定位用户项目设计 |
+
+业务归属、系统资源或页面类型没有元数据时，报告证据不足，不凭标题、路径或片段猜测。页面需求不因出现“页面”二字就默认新建或 checkout：修改已有资源时先唯一定位，确需独立新页面时先通过 MCP 实时 API 创建并取得 ID，再 checkout 正文；多个候选会导致不同产品结果时再向用户澄清。
+
+## 长正文与结构化资源
+
+1. 精确定位目标后再 checkout；对需要完整分析或编辑的目标批量 checkout，并在 `.draftgo/worktree/` 由唯一 owner 编辑。
+2. 先用 `draftgo diff <type> <id> --stat` 或 `--summary` 判断范围；只有需要审查内容时才展开完整 diff。
+3. 运行所需的 `draftgo verify`，再 commit。409/412 时停止，保留 base/local/remote；不得 force、覆盖或自动合并。
+4. 结构化资源不 checkout：未知 operation 才 search，首次使用或 registry revision 变化时 describe，其余使用缓存后 call；describe 不完整就停止，不猜字段、权限或风险。
+
+完整传输、manifest 和冲突规则见 `references/checkout.md`；交付证据见 `references/delivery.md`。
+
+## 所有权与安全
+
+- 同一文件或 DraftGo 资源全程只能由一个 Agent 修改；不同资源、operation 和 owner 不冲突的单元可以并发，CLI 请求使用有界并发；同一资源的依赖步骤保持串行。主 Agent 负责 owner 分配、汇总、验证、交付和 worklog 状态。
+- 用户 API Key 只保存在 `.draftgo/config.json`，不得进入宿主配置、命令参数、Skill、日志、manifest 或错误消息。宿主 MCP 配置只运行 `draftgo mcp serve`。
+- 页面优先使用可信本地资源；禁止境外 CDN。净化不可信 HTML，关键状态不能只靠颜色或动效表达。页面通过 `window.parent.App` 使用认证、权限、反馈和主题；详细规则见前端与运行时 Reference。
+- API Key 始终代表真实用户；CLI 不创建服务身份，不注入额外授权上下文，也不把 session token 用于 System MCP。未知权限和业务守卫以实时 describe 与服务端响应为准。
+- `.draftgo/tmp/` 可清理；先运行 `draftgo clean --dry-run`，再在需要时使用 `--yes`。用户可查验的证据放入已注册的 `.draftgo/artifacts/`。
+
+## 完成条件
+
+每个目标均有与其类型相符的证据：正文有 checkout、验证、commit 返回的版本/哈希及必要远端回读；结构化资源有 describe、写入结果和回读。任何验证失败、409/412 或交付失败都不得标记为完成；任何 verify、写入、回读或要求的视觉验收失败时，工作项保持 active。

package/resources/skill/init/SKILL.md

@@ -0,0 +1,41 @@
+---
+name: draftgo-init
+description: Install or refresh the DraftGo skill, connect a project to a DraftGo base, and configure or diagnose its project-level MCP host integration.
+---
+
+# DraftGo 初始化
+
+使用公开 CLI 完成安装和连接；不要直接调用已删除的同步脚本，也不要创建全量业务镜像。
+
+## 执行
+
+1. 运行 draftgo status 查看已安装目标、Skill 版本和项目连接状态。
+2. 需要查看宿主能力时运行 draftgo list-targets；不要假设每个宿主都支持项目级 MCP。
+3. 尚未安装时运行 draftgo init [target...]；不指定 target 时只按宿主自有目录自动识别，不因 AGENTS.md 等共享文件安装全部工具。需要全部宿主时才使用 draftgo init all。
+4. 已安装但需要刷新时运行 draftgo update；它只覆盖已安装 Skill，不升级 CLI，也不按工具痕迹新增宿主。新增某个工具时显式运行 draftgo init <target> 或 draftgo update <target>。
+5. 项目缺少 .draftgo/config.json 时选择基座：
+   - 已有 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 不可用时报告原因。
+
+draftgo init 只负责 Skill 安装；draftgo connect 负责保存并验证 server/API Key；draftgo mcp setup 负责宿主配置。不要混用职责。
+
+初始化创建用户项目 `Design/README.md` 说明页并保留已有文件，不预建业务模块或 UI 目录。用户设计与 CLI 自身 Design 分开。初始化后 `.draftgo/` 只保留已经写入的 `config.json`。不要预建 worklog、lessons、worktree、conflicts 或其他占位文件和目录；首次实际使用对应能力时再创建。
+
+## API Key 与配置
+
+- 交互式连接使用当前用户的 DraftGo API Key 和隐藏输入；不要把 API Key 写入宿主配置、Skill 文件、命令行示例或日志。
+- .draftgo/config.json、checkout manifest、base 和冲突目录必须加入项目 .gitignore。
+- bridge 从当前项目配置读取 API Key；宿主配置只引用 draftgo mcp serve。
+
+## 后续动作
+
+- 宿主配置和诊断：draftgo mcp setup/status/test，详见 ../references/mcp.md。
+- 开发准备：根 Skill 自动加载；按任务路由读取最少必要的 Reference，再按需直接调用 MCP。
+- 远端资源补充定位：MCP project_overview、resource_search、resource_list。
+- 正文编辑：遵循根 Skill 的 checkout/commit 与统一验证策略。
+- 结构化资源：直接使用 MCP 的 api_search、api_describe、api_call；不 checkout、不生成本地镜像。
+- 工作记录：开发开始时运行 `draftgo work start "<事项>"`；只有统一验证且全部 commit/MCP 交付成功后运行 `draftgo work complete <编号> --note "<结果>"`。验证、冲突或交付失败时不得标记为完成。
+- 管理本地基座：draftgo local setup|start|stop|logs|status。
+- 移除指定目标：draftgo uninstall <target>；完整移除所有目标只在用户明确要求时运行 draftgo uninstall all，--purge 会删除 .draftgo/。

package/resources/skill/manifest.json

@@ -0,0 +1,35 @@
+{
+  "schema_version": "1.0",
+  "id": "draftgo",
+  "name": "DraftGo 开发助手",
+  "version": "1.0.4",
+  "entry": "SKILL.md",
+  "description": "以 Skill/reference 任务路由、MCP 实时发现、长正文 checkout/commit、统一验证和完成日志为边界的 DraftGo 工作流。",
+  "license": "MIT",
+  "capabilities": [
+    "draftgo-development",
+    "reference-routing",
+    "worklog-tracking",
+    "minimal-method-guides",
+    "ai-knowledge-memory",
+    "mcp-bridge",
+    "content-checkout-commit",
+    "runtime-diagnostics",
+    "delivery-acceptance",
+    "conflict-safe-delivery",
+    "project-validation",
+    "skill-installation"
+  ],
+  "permissions": [
+    "process:run",
+    "network:explicit"
+  ],
+  "resources": {
+    "references": [
+      "references"
+    ],
+    "subskills": [
+      "init"
+    ]
+  }
+}

package/resources/skill/references/ai.md

@@ -0,0 +1,41 @@
+---
+read_when: 管理模型、提示词、插件、知识库、记忆或智能体时 · 调试 AI 调用与运行记录时
+---
+
+# DraftGo AI 能力
+
+## 模块边界
+
+最终版 AI 板块由模型、提示词、插件、知识库、长期记忆和智能体组成。它们都是结构化远端资源，使用实时 Registry Operation 管理，不 checkout、不生成本地镜像，也不通过动态 DB 重建。
+
+- 模型负责 Provider、逻辑模型、路由和统一调用网关。
+- 提示词负责版本化内容和发布状态。
+- 插件负责 Skill 与外部 MCP 扩展。
+- 知识库负责资料导入、切分、索引、检索和重建。
+- 长期记忆负责智能体运行过程中提炼和召回的记忆。
+- 智能体组合模型、提示词、插件、知识库与记忆。
+
+模块之间通过明确 ID 和服务端规则组合。不要在客户端复制模型路由、插件执行、知识检索、记忆写入或智能体编排逻辑。
+
+## 最短流程
+
+```bash
+draftgo api search "<model|prompt|plugin|knowledge|memory|agent>"
+draftgo api describe <operation_id>
+draftgo api call <operation_id> --input request.json --output json
+```
+
+已有精确 `operation_id` 时跳过 search。首次使用或 Registry revision 变化时 describe；输入只包含 `input_schema` 声明的 `path`、`query` 和 `body`。写入后使用对应 get/list Operation 回读目标 ID；任务涉及运行行为时，再调用运行 Operation 并按 run ID 或 request ID 查询日志。
+
+## 开发规则
+
+- Provider 密钥、上游 Authorization、API Key 和原始敏感响应不得进入 Skill、请求示例、日志或项目文件。
+- 权限、风险、幂等性、能力名和状态枚举全部以实时 describe 为准，不使用历史权限前缀或字段表。
+- 模型是否支持 Chat、Responses、Embedding、Rerank、TTS、ASR、图片或视频，必须由当前模型声明、Provider readiness 和有效路由共同证明。
+- 知识库和长期记忆用途不同，不能互相替代；索引完成不等于检索质量达标。
+- 智能体调用失败时分层检查模型路由、提示词版本、插件可用性、知识检索、记忆配置和运行日志，不在客户端自动重放非幂等调用。
+- DraftGo Page 的 AI 对话使用组件目录中的 `draftgo/chat`；完整 Chat 实现由组件 `Definition.JS` 随同一 revision 发布并按需解析，不存在第二套静态 SDK。其他模型能力（包括图片、Embedding、Rerank、TTS、ASR 和 Video）通过服务端 AI Registry 调用。浏览器端不得持有 Provider 密钥，也不要复制一套客户端 Provider SDK。
+
+## 完成条件
+
+结构化配置任务必须有 describe、写入结果和回读证据。调用任务还必须证明运行成功，并能通过 run ID 或 request ID 关联日志；知识任务需要最小检索验证；任何输出均不得泄露凭据。