draftgo-cli 1.0.0

package/README.md

@@ -0,0 +1,119 @@
+# draftgo-cli
+
+跨 AI 编码工具一键安装 / 更新 / 卸载 DraftGo 开发助手 skill 的命令行工具。
+
+支持的 AI 工具：Claude Code、Codex CLI、Cursor、Windsurf、Antigravity、GitHub Copilot、Gemini CLI、Kiro。
+
+## 前置条件
+
+- Node.js 14+（运行 CLI）
+- Python 3.9+（运行 DraftGo init/sync 脚本；CLI 本身不需要）
+
+## 安装
+
+```bash
+npm install -g draftgo-cli
+```
+
+## 快速开始
+
+```bash
+cd /path/to/your/project
+draftgo init                 # 自动识别当前项目在用的 AI 工具并安装
+```
+
+也可以手动指定要安装到哪些 AI 工具：
+
+```bash
+draftgo init claudecode                  # 只装 Claude Code
+draftgo init claudecode kiro cursor      # 多选
+draftgo init all                         # 所有支持的工具
+```
+
+## 命令清单
+
+| 命令 | 说明 |
+|---|---|
+| `draftgo init [target]...` | 安装 skill。不传 target 时自动识别；`all` 表示全部。 |
+| `draftgo update [target]...` | 覆盖 skill 内容到 CLI 内置版本，同时刷新已安装的入口；保留本地 `config / iteration / bugs / pages` 等运行时数据。 |
+| `draftgo uninstall [target]...` | 移除指定 AI 工具的入口文件；全量卸载时同时删除 `.draftgo/skill/`。加 `--purge` 会连 `.draftgo/` 整个删掉。 |
+| `draftgo status` | 查看当前项目装了哪些 AI 工具入口、skill 版本。 |
+| `draftgo doctor` | 诊断：Python 是否可用、检测到哪些 AI 工具、各入口状态。 |
+| `draftgo list-targets` | 列出支持的 AI 工具名。 |
+| `draftgo --version` | 打印 CLI 版本。 |
+| `draftgo --help` | 查看帮助。 |
+
+### 全局选项
+
+- `--project <dir>`：对指定目录操作（默认当前工作目录）。
+- `--force`：`init/update` 时覆盖已存在的 `.draftgo/skill/`。
+- `--purge`：`uninstall` 时连 `.draftgo/`（含 config / 日志 / 本地缓存）一起删。
+
+## 自动识别的依据
+
+| AI 工具 | 探测信号（任一命中即视为在用） |
+|---|---|
+| Claude Code | `.claude/` 或 `CLAUDE.md` |
+| Kiro | `.kiro/` |
+| Cursor | `.cursor/` |
+| Windsurf | `.windsurf/` |
+| Antigravity | `.agent/` |
+| GitHub Copilot | `.github/prompts/` 或 `.github/copilot-instructions.md` |
+| Codex CLI | `.codex/` 或 `AGENTS.md` |
+| Gemini CLI | `.gemini/` 或 `GEMINI.md` |
+
+若未命中任何信号，请用 `draftgo init all` 或 `draftgo init <target>` 手动指定。
+
+## 产物结构
+
+所有 AI 工具共用一份 skill 本体，位于 `.draftgo/skill/`。每个 AI 工具只放一个薄壳入口文件指向它。
+
+```
+<project>/
+├── .draftgo/
+│   ├── skill/                        # CLI 管理，不要手动改
+│   │   ├── SKILL.md
+│   │   ├── CLAUDE.md
+│   │   ├── init/SKILL.md
+│   │   ├── sync/SKILL.md
+│   │   ├── bug/SKILL.md
+│   │   ├── rules/
+│   │   ├── scripts/
+│   │   └── .version
+│   ├── config.json                   # init 后生成（已加入 .gitignore）
+│   ├── iteration/                    # 迭代日志
+│   ├── bugs/                         # 框架级 bug 记录
+│   ├── pages/  navigations/  ...     # init 拉取的本地缓存
+│   └── ...
+└── (AI 工具入口，按需写入)
+    .claude/skills/draftgo/SKILL.md
+    .cursor/commands/draftgo.md
+    .windsurf/workflows/draftgo.md
+    .agent/workflows/draftgo.md
+    .github/prompts/draftgo.prompt.md
+    .kiro/steering/draftgo.md
+    AGENTS.md                         # Codex：写入带标记的块
+    GEMINI.md                         # Gemini：写入带标记的块
+```
+
+对于 `AGENTS.md` / `GEMINI.md` 这种会被其它工具共享的 markdown 文件，CLI 只写入 `<!-- DRAFTGO:START ... -->` 和 `<!-- DRAFTGO:END -->` 之间的块，更新和卸载都只动自己的块，不破坏你的其他内容。
+
+## init / sync 的正确运行方式
+
+skill 内置两个 Python 脚本。**不要用 curl / npx 代替**，脚本会处理 token、字段结构、错误日志。
+
+```bash
+# 初始化（拉取服务器数据 → 生成本地上下文）
+python .draftgo/skill/scripts/draftgo_init.py --server <url> --token <sat>
+
+# 同步
+python .draftgo/skill/scripts/draftgo_sync.py pages   [page_id]
+python .draftgo/skill/scripts/draftgo_sync.py nav     [nav_id]
+python .draftgo/skill/scripts/draftgo_sync.py db_meta [meta_id]
+```
+
+更推荐的用法：在 AI 工具里说「初始化 draftgo 项目」或「同步页面 123」，skill 会自动触发对应脚本。
+
+## 许可证
+
+MIT

package/bin/draftgo.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+'use strict';
+require('../src/index.js').run(process.argv.slice(2));

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "draftgo-cli",
+  "version": "1.0.0",
+  "description": "Install and manage the DraftGo skill across AI coding agents (Claude Code, Codex, Cursor, Windsurf, Antigravity, Copilot, Gemini, Kiro).",
+  "bin": {
+    "draftgo": "bin/draftgo.js"
+  },
+  "main": "src/index.js",
+  "engines": {
+    "node": ">=14"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "resources/",
+    "README.md"
+  ],
+  "keywords": [
+    "draftgo",
+    "skill",
+    "cli",
+    "claude-code",
+    "codex",
+    "cursor",
+    "windsurf",
+    "antigravity",
+    "copilot",
+    "gemini",
+    "kiro"
+  ],
+  "author": {
+    "name": "draftgo",
+    "email": "cabinai@163.com",
+    "url": "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"
+  }
+}

package/resources/skill/CLAUDE.md

@@ -0,0 +1,239 @@
+# DraftGo 项目上下文
+
+> 由 draftgo-init 自动生成。重新初始化：`/draftgo init`
+
+## 架构认知（必读）
+
+**DraftGo 不是传统 SPA，是"数据库驱动的页面资产运行时"：**
+- 壳层（Vue 3 + Vite）只负责 runtime 编排，源码在 `frontend/src/core/`
+- 业务页面 HTML 存在数据库 `page.value.html`，运行在 `iframe.srcdoc`
+- 导航栏 HTML 存在数据库 `navigation.html`，由壳层按需加载
+- 页面与壳层通过 `window.parent.App` API 通信
+
+**技术栈：**
+- 后端：FastAPI 0.115.0 + SQLAlchemy 2.0.36 + Pydantic 2.10.0 + MySQL + Redis
+- 前端：Vue 3 + Vite + Tailwind CSS（本地 `/assets/tailwindcss.js`）
+
+## 连接信息
+- 服务器：https://dev.draftgo.cn
+- Token：存储于 `.draftgo/config.json`（已加入 .gitignore）
+
+## 开发规范
+→ 前端页面开发：读取 `.draftgo/rules/frontend.md`
+→ 页面排错指南：读取 `.draftgo/rules/debugging-syntax.md`（页面功能不执行时必读！）
+- 任何开发，必读！
+
+## 开发禁区（违反必报错）
+
+- ❌ 禁止境外 CDN（googleapis/jsdelivr/cdnjs/unpkg）→ ✅ 允许国内镜像（npmmirror.com/staticfile.net）
+- ❌ 禁止 `App()` 写法（App 是对象不是函数）→ ✅ 正确：`const App = window.parent?.App`
+- ❌ 禁止 `const App = () => window.parent?.App` → ✅ 去掉箭头函数
+- ❌ 禁止 `window.location.search` 读参数 → ✅ 用 `window.__DG_ROUTE_CONTEXT__.query`
+- ❌ 禁止 `App?.user?.role` 判断管理员 → `App.user` 不存在！✅ 用 `App.isAdmin` 或 `App.currentUser?.role_code`
+- ❌ 禁止 `navigate('/login')` 退出 → ✅ 用 `window.location.href = '/login'`
+- ❌ 禁止 `window.alert/confirm/prompt` → ✅ 用 `App.toast()` / `App.confirm()` / `App.showModal()`
+  - `App.showSuccess(msg)` 成功提示（绿色 3s）— 推荐用于操作成功反馈
+  - `App.showError(msg)` 错误提示（红色 4s）— 推荐用于失败反馈
+  - `App.showWarning(msg)` 警告提示（黄色 3s）— 推荐用于提醒
+  - `App.showInfo(msg)` 信息提示（蓝色 3s）— 推荐用于中性信息
+  - `App.toast(msg, type)` 通用方法 — type: success/error/warning/info
+  - `App.confirm(msg, title?)` 确认弹窗 — 玻璃蒙层 + 弹跳动画 + ⚠ 图标，双按钮，返回 Promise\<boolean\>
+  - `App.showModal(msg, title?)` 信息模态框 — 玻璃蒙层 + 弹跳动画 + i 图标，单按钮，替代 alert()
+  - `App.showLoading()` / `App.hideLoading()` — 全局 loading 玻璃蒙层，手动开关
+  - 详见 `.draftgo/rules/frontend.md` App API 章节
+- ⚠️ 尽量避免硬编码颜色 → 优先用 `var(--dg-accent)` 等 token 以适配主题切换 
+
+## 主题切换适配
+
+DraftGo 支持多套配色方案 + 亮暗模式，通过 CSS 变量实现。
+
+**概念分层：**
+| 概念 | 存储键 | 取值 |
+|---|---|---|
+| 显示模式 | `dg_theme` | `'light'` \| `'dark'` \| `'system'` |
+| 配色方案 | `dg_color_scheme` | `'dark-gray-white'` \| `'deep-blue-white'` \| `'orange-white'` \| `'custom'` |
+
+**内置配色方案：**
+- `dark-gray-white` 深灰白（默认）— 冷调深灰，干净利落
+- `deep-blue-white` 深蓝白 — 专业稳重，企业风
+- `orange-white` 橙白 — 温暖醒目，创意风
+
+**颜色 Token（优先使用）：**
+- `--dg-bg-base` / `--dg-bg-page` / `--dg-bg-surface` — 背景层级
+- `--dg-text-primary` / `--dg-text-secondary` / `--dg-text-muted` — 文字层级
+- `--dg-accent` / `--dg-accent-hover` / `--dg-accent-subtle` — 主题色
+- `--dg-border` / `--dg-success` / `--dg-error` / `--dg-warning` — 功能色
+
+**App API 切换配色：**
+```javascript
+App.setColorScheme('deep-blue-white');              // 切换为预设方案
+App.setColorScheme('custom', customVarsObject);     // 应用自定义配色
+```
+
+**硬编码颜色的场景（允许但需注意）：**
+- 品牌色（如 Logo 固定色）
+- 数据可视化图表（需保证对比度）
+- 第三方组件库强制要求
+
+**硬编码时的要求：**
+- 同时提供亮色/暗色两套值，通过 `[data-theme="dark"]` 选择器切换
+- 确保对比度符合 WCAG AA 标准（文字至少 4.5:1）
+
+## 本地开发流程
+
+**原则：有功能修改就读本地数据，自主决策是否调用 API 完成高质量修改。**
+
+1. **开发时**：读写 `.draftgo/` 本地文件
+   - 查元数据：读 `index.json`
+   - 查/改 HTML：按 `html_file` 字段路径读对应 `.html` 文件
+2. **修改后**：运行同步脚本推送到服务器（见下方"同步命令"）
+3. **同步成功**：本地与服务器数据一致
+
+**本地数据目录：**
+
+| 目录 | 内容 |
+|---|---|
+| pages/ | index.json（无 html）+ 若干 .html |
+| navigations/ | index.json（无 html）+ 若干 .html |
+| roles/ | index.json |
+| users/ | index.json |
+| db_meta/ | index.json |
+| aihub/ | index.json |
+| system_config/ | index.json |
+| iteration/ | YYYY-MM-DD.txt（迭代日志） |
+| error/ | YYYY-MM-DD.txt（错误日志） |
+
+## 数据库 Schema（关键字段）
+
+| 表 | 关键字段 | 说明 |
+|---|---|---|
+| `page` | `id`, `title`, `route`, `permission`, `value` (JSON: `{html: "..."}`) | value.html 存页面完整 HTML |
+| `navigation` | `id`, `code`, `name`, `html`, `order`, `status` | html 字段存导航栏完整 HTML |
+| `user` | `id`, `username`, `email`, `role_id`, `status` | role_id 关联 role 表 |
+| `role` | `id`, `code`, `name`, `permissions` (JSON) | admin 角色拥有所有权限 |
+| `db_meta` | `id`, `type`, `fields` (JSON: `[{name, type, required}]`) | 动态表结构定义 |
+| `db` | `id`, `type`, `data` (JSON), `userid`, `status`, `created_at`, `updated_at` | 动态数据存储（含自动时间戳） |
+| `aihub` | `id`, `name`, `type`, `config` (JSON), `status` | AI 服务配置 |
+| `sys_config` | `config_key`, `config_value`, `value_type`, `category`, `is_sensitive` | 系统配置 KV |
+
+## API 速查与示例
+
+| 模块 | 端点 |
+|---|---|
+| 认证 | POST /api/auth/login, /register, /logout, /refresh, /forgot-password, /reset-password |
+| 微信认证 | POST /api/auth/wechat/mp/oauth, /wechat/mini/login, /wechat/mp/qr/create · GET /wechat/mp/qr/poll |
+| 用户 | GET/PUT /api/users/me · GET/POST /api/users · GET/PUT/DELETE /users/{id} · POST /users/{id}/ban, /unban |
+| 角色 | GET/POST /api/roles · GET/PUT/DELETE /roles/{id} · POST /roles/{id}/assign/{uid} · DELETE /roles/{id}/revoke/{uid} |
+| 页面 | GET/POST /api/pages/ · GET/PUT/DELETE /pages/{id} · POST /pages/{id}/reset-system · GET /pages/by-route · GET /pages/public/{route} |
+| 导航栏 | GET/POST /api/navigations · GET /navigations/{code} · PUT/DELETE /navigations/{id} · POST /navigations/{id}/reset-system |
+| 系统配置 | GET /api/system/config · GET /system/category/{category} · GET/PUT/DELETE /system/{key} · POST /system/ · POST /system/config/ensure |
+| 备份恢复 | GET/POST /api/system/backup · POST /system/restore · POST /system/reset · POST /system/backup/selective · POST /system/restore/selective · GET /system/backup/logs |
+| 通知公告 | GET/POST /api/notices · GET/PUT/DELETE /notices/{id} |
+| 反馈 | GET/POST /api/feedback · GET /feedback/updates · GET/PUT/DELETE /feedback/{id} · DELETE /feedback/batch |
+| 日志 | GET /api/logs · GET /logs/{id} |
+| 智能体 | GET /api/agents · GET /agents/logs · POST /agents/{id}/chat · POST /agents/{id}/preview-chat |
+| 动态DB | GET/POST /api/db/{type} · GET/PUT/DELETE /db/{type}/{id} |
+| DB Meta | GET/POST /api/db-meta · GET /db-meta/{type} · PUT/DELETE /db-meta/{id} |
+| ⚠️ DB Meta 查询 | GET /db-meta/{type} 用 **type**（如 `patient_profile`），不是 id。用 id 查会返回 "元数据不存在"。PUT/DELETE 才用 id。 |
+| AIHub | GET/POST /api/aihub · GET/PUT/DELETE /aihub/{id} · PATCH /aihub/{id}/basic · POST /aihub/{id}/sync · POST /aihub/discover · GET /aihub/types |
+| AI推理 | GET /api/v1/models · POST /v1/chat/completions |
+| 文件上传 | POST /api/upload |
+| 通知测试 | POST /api/system/notifications/test-email, /test-sms · GET /system/notifications/logs |
+
+### 高频 API 示例
+
+**创建页面（需 admin）：**
+```
+POST /api/pages/
+Body: { "title": "新页面", "route": "/new", "permission": "public", "value": {"html": "<html>...</html>"} }
+Response: { "id": 123, "title": "新页面", "route": "/new", ... }
+```
+
+**更新页面 HTML（需 admin）：**
+```
+PUT /api/pages/123
+Body: { "value": {"html": "<html>更新后...</html>"} }
+```
+
+**重置系统页面（需 admin）：**
+```
+POST /api/pages/123/reset-system
+Body: 空
+说明：从 backend/init/pages/ 重新加载该页面
+```
+
+**创建动态数据（普通用户自动绑定 userid）：**
+```
+POST /api/db/patient
+Body: { "data": {"name": "张三", "age": 30} }
+Response: { "id": 456, "type": "patient", "data": {...}, "userid": 当前用户id, "status": 1, "created_at": "2026-01-01T12:00:00", "updated_at": "2026-01-01T12:00:00" }
+```
+
+**查询动态数据（带分页）：**
+```
+GET /api/db/patient?page=1&page_size=20
+Response: { "items": [{ "id": 456, "type": "patient", "data": {...}, "userid": 1, "status": 1, "created_at": "...", "updated_at": "..." }], "total": 100, "page": 1, "page_size": 20 }
+```
+
+## URL 参数读取
+
+页面运行在 `iframe.srcdoc` 中，`window.location.search` 不可靠。框架通过 `<script data-dg-route-bridge>` 注入路由上下文。
+
+```javascript
+// 标准三阶回落（推荐）
+const routeContext =
+  window.__DG_ROUTE_CONTEXT__
+  || window.__DG_GET_ROUTE_CONTEXT__?.()
+  || window.parent?.App?.getCurrentRouteContext?.()
+  || { query: {} };
+const query = routeContext.query || {};
+
+// 使用示例
+// 路由 /doctor/prescription-estimate?patientId=42&visitId=7
+const patientId = query.patientId;  // "42"
+const visitId = query.visitId;      // "7"
+```
+
+禁止：`new URLSearchParams(window.location.search)` — iframe 中取不到壳层 URL。
+
+## 常见问题排查
+
+| 问题 | 排查步骤 |
+|---|---|
+| 同步失败 | 1. 检查 `.draftgo/config.json` token 是否有效<br>2. 检查服务器连接（ping/curl）<br>3. 查看 `.draftgo/error/YYYY-MM-DD.txt` 错误日志 |
+| 页面加载空白 | 1. 检查 `permission` 字段与当前用户角色是否匹配<br>2. 检查路由是否正确（`/api/pages/by-route?route=/xxx`）<br>3. 浏览器控制台查看 JS 错误 |
+| API 返回 401 | Token 过期，前端会自动用 refresh token 刷新，无需手动处理 |
+| API 返回 403 | 权限不足，检查当前用户角色是否有对应权限 |
+| DB Meta GET 返回"元数据不存在" | 你用了 id，应该用 **type**（如 `/api/db-meta/patient_profile`）。PUT/DELETE 才用 id。 |
+| 颜色不生效 | 检查是否用了 `var(--dg-*)` 而非硬编码 hex/rgb |
+| URL 参数读取失败 | 检查是否用了 `window.__DG_ROUTE_CONTEXT__.query` 而非 `window.location.search` |
+| 退出登录后导航栏未更新 | 检查是否用了 `window.location.href = '/login'` 而非 `navigate('/login')` |
+
+## 错误日志规范
+
+**遇到任何开发/运行时错误，必须自动追加到 `.draftgo/error/YYYY-MM-DD.txt`：**
+
+格式：`[HH:MM:SS] [错误类型] 描述`
+
+示例：
+```
+[14:23:45] [同步失败] pages/123 同步到服务器失败：401 Unauthorized
+[14:30:12] [API错误] GET /api/db/patient 返回 500：数据库连接超时
+[15:10:33] [页面错误] admin-users.html 第 42 行：App is not a function
+```
+
+操作流程：
+1. 捕获错误后，获取当前日期和时间
+2. 检查 `.draftgo/error/YYYY-MM-DD.txt` 是否存在
+3. 存在则 Read 后追加新行；不存在则直接 Write
+4. 无需告知用户（静默执行）
+
+## 同步命令
+
+> **禁止用 npx/npm/curl 同步。必须用 Python 脚本：**
+> `python .draftgo/skill/scripts/draftgo_sync.py pages <page_id>`
+> `python .draftgo/skill/scripts/draftgo_sync.py nav <nav_id>`
+
+- `/draftgo sync pages` — 触发 sync skill（不是 CLI 命令）
+- `/draftgo sync nav` — 触发 sync skill（不是 CLI 命令）
+- `/draftgo init` — 触发 init skill（不是 CLI 命令）

package/resources/skill/SKILL.md

@@ -0,0 +1,75 @@
+---
+name: draftgo
+description: Use this skill when the user is developing, maintaining, or debugging a DraftGo-based application. Activates for tasks involving DraftGo pages, navigation, API calls, roles, DB meta, or any DraftGo-specific development work. ALSO activates when user says "同步", "sync", "同步到云端", "push to server", "上传页面", "上传导航" — route to /draftgo sync skill immediately, do NOT attempt manual API calls.
+version: 1.0.0
+---
+
+# DraftGo 开发助手
+
+> **每次完成任何开发/修复/修改/完善/删除/重构操作后，必须立即写迭代记录到 `.draftgo/iteration/YYYY-MM-DD.txt`，格式：`[操作类型] 描述`。这是强制步骤，不得跳过。**
+
+## 命令路由
+
+**不要在此 Skill 中直接执行任何操作。** 根据用户意图路由到对应子命令：
+
+| 用户意图 | 执行 |
+|---|---|
+| 初始化项目 / 连接服务器 / `/draftgo init` | 调用 `/draftgo init` Skill |
+| 同步页面或导航 / `/draftgo sync` | 调用 `/draftgo sync` Skill |
+| 开发页面 / 修改页面 / 新建导航 | 读取 `CLAUDE.md` + `.draftgo/rules/frontend.md` + `.draftgo/rules/debugging-syntax.md` 后开始开发，**完成后必须：1) 写迭代记录 2) 自动同步到服务器**（见下方规范） |
+
+## 开发前置检查
+
+进行任何开发任务前，先确认：
+
+```
+!test -f CLAUDE.md && echo "OK" || echo "请先运行 /draftgo init"
+```
+
+`CLAUDE.md` 存在后，读取它获取页面列表、导航列表、服务器地址等上下文。
+
+开发规范读取：`.draftgo/rules/frontend.md`
+
+## 迭代记录规范
+
+每次对系统进行开发/修复/修改/完善/删除/重构等操作后，**必须**在 `.draftgo/iteration/` 目录下按日期写入迭代记录。
+
+### 规则
+
+- 文件名：`YYYY-MM-DD.txt`，当天所有操作追加到同一文件
+- 每行一条，格式：`[HH:MM:SS] [操作类型] 描述`
+- 操作类型：`新增` / `修复` / `修改` / `完善` / `删除` / `重构`
+- 描述精简，一句话，不超过 30 字
+- 文件不存在时直接 Write 创建；已存在时 Read 后追加新行再 Write
+
+### 示例（2026-05-06.txt）
+
+```
+[14:23:15] [新增] 用户登录页面表单验证逻辑
+[15:10:42] [修复] 脉象输入组件在 Safari 下无法聚焦
+[16:05:33] [修改] 问诊表单字段顺序，主诉移至首位
+```
+
+### 操作流程
+
+1. 完成任何系统操作后，获取当前日期和时间
+2. 检查 `.draftgo/iteration/YYYY-MM-DD.txt` 是否存在
+3. 存在则 Read 后追加新行；不存在则直接 Write
+4. 无需告知用户（静默执行）
+
+## 自动同步规范
+
+> **每次修改页面或导航栏 HTML 后，必须立即自动同步到服务器。这是强制步骤，不得跳过，不得等用户提醒。**
+
+### 同步规则
+
+- 修改了哪个页面的 HTML → 同步该页面：`python .draftgo/skill/scripts/draftgo_sync.py pages <page_id>`
+- 修改了哪个导航栏的 HTML → 同步该导航：`python .draftgo/skill/scripts/draftgo_sync.py nav <nav_id>`
+- 同时修改多个 → 逐个同步
+- 同步失败时告知用户，不得静默忽略
+
+### 完整操作顺序（每次开发任务结束时）
+
+1. 写迭代记录（静默）
+2. 运行同步脚本（必须执行）
+3. 告知用户同步结果

package/resources/skill/bug/SKILL.md

@@ -0,0 +1,72 @@
+---
+name: draftgo-bug
+description: Use this skill when encountering a DraftGo framework-level runtime bug. Automatically records the bug as a separate markdown file in the project's bugs/ directory.
+version: 1.0.0
+allowed-tools: Read, Write, Glob
+---
+
+# DraftGo Bug 记录规范
+
+## 触发条件
+
+遇到以下情况时**自动触发**，无需用户提示：
+- DraftGo 框架本身的运行时错误（非业务逻辑错误）
+- 页面加载/渲染异常
+- 导航栏挂载失败
+- API 鉴权/Token 异常
+- 初始化流程中断
+- 前端 runtime 与后端不一致导致的系统级问题
+
+## 存储规则
+
+- **每个 bug 一个独立 md 文件**，存放于 `.draftgo/bugs/` 文件夹（与 `pages/`、`navigations/` 同级的 `.draftgo` 目录内）
+- 文件名格式：`YYYY-MM-DD_{slug}.md`（slug 为 bug 标题的简短英文描述，用下划线连接）
+- `.draftgo/bugs/` 目录不存在时自动创建（直接 Write 文件即可，路径中的目录会自动创建）
+
+## 文件模板
+
+```markdown
+---
+date: YYYY-MM-DD
+status: open
+env: local | docker | production
+---
+
+# {简短标题}
+
+## 复现步骤
+1. ...
+
+## 预期行为
+...
+
+## 实际行为
+...
+
+## 错误日志
+\`\`\`
+{相关日志}
+\`\`\`
+
+## 解决方案
+> 未解决时留空
+```
+
+## 状态值
+
+| status | 含义 |
+|---|---|
+| `open` | 未解决 |
+| `in_progress` | 排查中 |
+| `resolved` | 已解决（补充解决方案后更新） |
+
+## 操作流程
+
+1. 确认是框架级 bug（非业务代码问题）
+2. 生成文件名：`.draftgo/bugs/YYYY-MM-DD_{slug}.md`
+3. 用 Write 工具写入文件
+4. 告知用户已记录，文件路径为 `.draftgo/bugs/{filename}`
+
+## 初始化时
+
+`/draftgo init` 执行时，脚本会创建 `.draftgo/bugs/` 文件夹。

package/resources/skill/init/SKILL.md

@@ -0,0 +1,63 @@
+---
+name: draftgo-init
+description: Use this skill when the user runs "/draftgo init", wants to initialize a DraftGo development project, connect to a DraftGo server, or set up DraftGo development context for the first time.
+version: 1.0.0
+allowed-tools: Bash(python:*), Bash(find:*), Read
+---
+
+# DraftGo 项目初始化
+
+## 第一步：收集连接信息
+
+检查是否已有配置：
+
+```
+!test -f .draftgo/config.json && cat .draftgo/config.json || echo "NOT_FOUND"
+```
+
+- **已存在**：询问用户是否覆盖，确认后继续
+- **不存在**：向用户询问：
+  1. DraftGo 服务器地址（如 `https://your-server.com`）
+  2. 系统访问令牌（SAT，管理后台 → 系统设置 → API Token）
+
+---
+
+## 第二步：执行初始化脚本
+
+脚本固定位于 `.draftgo/skill/scripts/draftgo_init.py`，直接运行（**不要读取脚本内容**）：
+
+```
+# 默认：项目根由脚本自动推导（向上查找含 .draftgo/ 的目录）
+!python .draftgo/skill/scripts/draftgo_init.py --server "<server>" --token "<token>"
+
+# 用户明确指定了项目路径时，作为位置参数传入
+!python .draftgo/skill/scripts/draftgo_init.py --server "<server>" --token "<token>" "<project_path>"
+```
+
+脚本会自动完成所有工作并输出摘要，**不要读取任何中间 JSON 文件**。
+
+---
+
+## 第三步：读取结果
+
+脚本执行完毕后，只读取 `CLAUDE.md` 确认生成成功：
+
+```
+!test -f CLAUDE.md && echo "OK" || echo "FAIL"
+```
+
+---
+
+## 初始化目录
+
+脚本执行完毕后，确保以下目录存在（不存在则创建）：
+
+```
+!mkdir -p .draftgo/bugs .draftgo/iteration
+```
+
+## 完成提示
+
+将脚本的输出摘要（页面数、导航数、服务器地址）告知用户，并提示：
+- 下一步：描述要开发的功能，或运行 `/draftgo sync` 同步修改
+- 如需刷新数据：重新运行 `/draftgo init`