@comate/zulu 1.1.0 → 1.2.0

package/comate-engine/assets/skills/auto-commit/scripts/logger.py

@@ -0,0 +1,32 @@
+"""smart-commit 统一日志模块
+
+日志写入 ~/.comate-engine/log/kernel-yyyy-mm-dd.log
+"""
+
+import logging
+from datetime import date
+from pathlib import Path
+
+
+def get_logger(name: str = "smart-commit") -> logging.Logger:
+    """获取 smart-commit 日志实例
+
+    Args:
+        name: 日志名称，默认 "smart-commit"
+
+    Returns:
+        配置好的 Logger 实例，写入 ~/.comate-engine/log/kernel-yyyy-mm-dd.log
+    """
+    logger = logging.getLogger(f"comate.{name}")
+    if not logger.handlers:
+        log_dir = Path.home() / ".comate-engine" / "log"
+        log_dir.mkdir(parents=True, exist_ok=True)
+        log_file = log_dir / f"kernel-{date.today().isoformat()}.log"
+        handler = logging.FileHandler(log_file, encoding="utf-8")
+        handler.setFormatter(logging.Formatter(
+            "[%(asctime)s] [smart-commit] [%(levelname)s] %(message)s",
+            datefmt="%Y-%m-%d %H:%M:%S"
+        ))
+        logger.addHandler(handler)
+        logger.setLevel(logging.DEBUG)
+    return logger

package/comate-engine/assets/skills/auto-commit/scripts/recognize_card_cli.py

@@ -0,0 +1,63 @@
+"""命令行工具：通过链接或卡片 ID 识别并获取 iCafe 卡片详情
+
+用法:
+    python3 recognize_card_cli.py --link "DevOps-iScan-35835"
+    python3 recognize_card_cli.py --link "https://console.cloud.baidu-int.com/devops/icafe/issue/xxxx/show"
+
+输出:
+    JSON 格式的卡片详情，包含 sequence、title、type、status、spacePrefix 等字段。
+    失败时输出 {"error": "错误信息"}。
+"""
+
+import argparse
+import json
+import os
+import sys
+
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+
+from icafe.client import ICafeQueryClient
+from icafe.matching import parse_card_id_from_link
+
+
+def main():
+    """识别 iCafe 卡片的主函数"""
+    parser = argparse.ArgumentParser(description="识别 iCafe 卡片")
+    parser.add_argument("--link", required=True,
+                        help="卡片链接或卡片 ID，示例: "
+                        "'DevOps-iScan-35835' 或 "
+                        "'https://console.cloud.baidu-int.com/devops/icafe/issue/DevOps-iScan-35835/show'")
+    args = parser.parse_args()
+
+    try:
+        parsed = parse_card_id_from_link(args.link)
+        if not parsed:
+            print(json.dumps({"error": "无法解析卡片链接或 ID，请检查格式"}))
+            sys.exit(1)
+
+        space_prefix = parsed["space_prefix"]
+        card_id = parsed["card_id"]
+
+        client = ICafeQueryClient()
+        card_detail = client.get_card_by_id(space_id=space_prefix, card_id=card_id)
+
+        if card_detail and card_detail.get("cards"):
+            card = card_detail["cards"][0]
+            print(json.dumps({
+                "success": True,
+                "sequence": card_id,
+                "title": card.get("title", ""),
+                "type": card.get("type", ""),
+                "status": card.get("status", ""),
+                "spacePrefix": space_prefix,
+            }))
+        else:
+            print(json.dumps({"error": "无法获取卡片信息，请检查链接或 ID 是否正确"}))
+            sys.exit(1)
+    except Exception as e:
+        print(json.dumps({"error": f"识别卡片异常: {type(e).__name__}: {e}"}))
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

package/comate-engine/assets/skills/automation-browser-comate/SKILL.md

@@ -1,125 +1,228 @@
 ---
 name: comate-automation-browser
 description: |
-    浏览器自动化，用于网页浏览、UI 测试、截图验证和网页内容抓取。
-    在以下场景使用此 skill：
-    - 需要浏览网站、导航网页或与网页 UI 交互
-    - 需要截图进行视觉验证
-    - 需要测试 Web 应用的 UI 行为
-    - 需要抓取或提取网页内容
-    - 需要点击按钮或在网页中输入文本
+    Browser automation for web browsing, UI testing, screenshot verification, and web content scraping.
+    When to use:
+    - Pages requiring JavaScript rendering (SPA, React, Vue, Angular apps)
+    - Need to interact with UI: click buttons, fill forms, login
+    - Need screenshots or visual verification
+    - Content loads dynamically via AJAX/fetch
+    - Multi-step navigation, complex workflows, or authenticated sessions
+    - Testing UI behavior of web applications
+    When NOT to use (use `web_fetch` tool instead):
+    - Simple static HTML pages (no JS rendering needed)
+    - Server-rendered content that's immediately available in HTML
+    - API documentation, blog posts, or articles
+    - Quick content lookup without interaction
+    For complex tasks or information-heavy pages, use `delegate_subtask` to invoke a subagent with this skill.
 hidden: true
 ---
 
 # Comate Automation Browser
 
-通过 `run_command` 工具加 `comate-automation-browser` 前缀来调用浏览器自动化能力。
+Invoke browser automation capabilities via the `run_command` tool with the `comate-automation-browser` prefix.
 
-## 调用方式
+## Invocation
 
 ```json
-{ "command": "comate-automation-browser <子命令> [参数]" }
+{ "command": "comate-automation-browser <subcommand> [arguments]" }
 ```
 
-**重要**：必须通过 `run_command` 加 `comate-automation-browser` 前缀调用。不要将 `browser_use` 作为独立工具直接调用，也不要将 `comate-automation-browser` 作为 shell 命令执行。
+**Important**: Must be invoked via `run_command` with the `comate-automation-browser` prefix. Do not call `browser_use` as a standalone tool directly, and do not execute `comate-automation-browser` as a shell command. The `run_command` call **MUST** contain only the `comate-automation-browser ...` command exactly as shown — do not prepend, append, or chain any other commands (e.g., no `&&`, `||`, `;`, `|`, or subshells). This is Comate's wrapper around the IDE browser, not Claude Code's native `browser-use` CLI.
 
-## 可用命令
+## Core Workflow
 
-### 导航
+Follow this sequence by default, unless the task explicitly does not require it:
 
-| 命令 | 参数 | 说明 |
-|------|------|------|
-| `navigate <url>` | `url`（必填） | 导航到指定 URL |
-| `back` | — | 浏览器后退 |
-| `forward` | — | 浏览器前进 |
-| `reload` | — | 重新加载当前页面 |
-
-### 页面检查
-
-| 命令 | 参数 | 说明 |
-|------|------|------|
-| `snapshot` | — | 获取无障碍快照（包含元素 UID 的 YAML 树），用于了解页面结构和获取交互所需的元素 UID |
-| `html [selector]` | `selector`（可选，CSS 选择器） | 获取页面 HTML，可通过选择器过滤 |
-| `screenshot` | 见下方选项 | 对当前页面截图 |
-| `status` | — | 显示浏览器状态和所有打开的标签页 |
-| `console` | — | 获取浏览器控制台消息 |
+```text
+1. navigate/open
+2. snapshot or status
+3. click/type/fill_form/drag/click_at
+4. snapshot/status
+5. screenshot/console/evaluate for verification
+```
 
-**`screenshot` 选项**（均为可选）：
-- 位置参数：`filePath` — 截图保存路径
-- `--format <png|jpeg|webp>` — 图片格式
-- `--full-page` — 截取整个可滚动页面
-- `--uid <uid>` — 截取指定 UID 的元素
+For asynchronously updating pages, do not assume success after a single action. Repeatedly verify using `snapshot`, `status`, `evaluate`, `console`, or `screenshot`.
+
+## Browser Modes
+
+The current mode is determined by IDE settings; the agent does not need to choose.
+
+- `builtin`
+  - Runs in the IDE's built-in browser or webview.
+  - `snapshot` returns an approximate accessibility tree, not a full Playwright snapshot.
+  - Post-action waits are heuristic-based; complex frontend pages may require additional verification.
+- `chrome`
+  - Connects to the local Chrome/CDP, reusing a Comate-dedicated persistent profile.
+- `standalone`
+  - Uses a standalone Chromium downloaded by Comate.
+- `off`
+  - Browser capabilities are disabled; tool calls will fail.
+
+## Available Commands
+
+### Navigation
+
+| Command | Arguments | Description |
+|---------|-----------|-------------|
+| `navigate <url>` | `url` (required) | Navigate to the specified URL |
+| `open <url>` | `url` (required) | Alias for `navigate` |
+| `back` | — | Go back in browser history |
+| `forward` | — | Go forward in browser history |
+| `reload` | — | Reload the current page |
+
+### Page Inspection
+
+| Command | Arguments | Description |
+|---------|-----------|-------------|
+| `snapshot` | — | Get an accessibility snapshot (YAML tree with element UID/`ref`) |
+| `html [selector]` | `selector` (optional) | Get page HTML, optionally filtered by CSS selector |
+| `screenshot` | See options below | Take a screenshot of the current page |
+| `status` | — | Show current browser state and all open tabs |
+| `console` | See options below | Get console messages |
+| `evaluate <script>` | `script` (required) | Execute JavaScript in the page context |
+
+`screenshot` options:
+- Positional argument: `filePath`, path to save the screenshot
+- `--format <png|jpeg|webp>`, image format
+- `--full-page`, capture the entire scrollable page
+- `--uid <uid>`, capture a specific element by UID
+
+`console` options:
+- `--types <type...>`, filter by type, available values: `log info warn error debug`
+- `--limit <n>`, limit the number of returned entries
+- `--offset <n>`, start reading from the specified offset
+- `--include-preserved`, include previously collected messages
+
+### Interaction
+
+| Command | Arguments | Description |
+|---------|-----------|-------------|
+| `click <uid>` | `uid` (required) | Click an element |
+| `dblclick <uid>` | `uid` (required) | Double-click an element |
+| `rightclick <uid>` | `uid` (required) | Right-click an element |
+| `click_at <x> <y>` | Coordinates (required) | Click at coordinates, suitable for canvas/special controls |
+| `type <text>` | See options below | Type text |
+| `scroll <direction>` | `up/down/left/right` | Scroll the page |
+| `drag <startUid> <endUid>` | Start and end UIDs (required) | Drag an element |
+| `fill_form <json>` | JSON (required) | Batch fill form fields |
+
+`click` options:
+- `--double`, double-click
+- `--button <left|right|middle>`, specify mouse button
+- `--modifiers <Alt Control Meta Shift>`, click with modifier keys
+
+`type` options:
+- `<text>` (required), the text to type; wrap multi-word text in quotes
+- `--uid <uid>`, specify the target element
+- `--submit`, press Enter after typing
+- `--slowly`, type character by character
+
+`scroll` options:
+- `--amount <pixels>`, specify scroll distance in pixels
+
+`fill_form` notes:
+- Argument should be a JSON array, or a JSON object containing a `fields` array
+- Each field object must include at least `name`, `type`, `ref`/`uid`, and `value`
+- `ref`/`uid` must come from the most recent `snapshot`
+
+Example:
+
+```text
+comate-automation-browser fill_form '[{"name":"Email","type":"textbox","uid":"e3","value":"hi@example.com"}]'
+```
 
-### 交互
+### Tab Management
 
-| 命令 | 参数 | 说明 |
-|------|------|------|
-| `click <uid>` | `uid`（必填，来自 snapshot） | 通过 UID 点击元素 |
-| `type <text>` | 见下方选项 | 在页面或聚焦元素中输入文本 |
-| `scroll <direction>` | `up` 或 `down`（默认 `down`） | 滚动页面 |
+| Command | Arguments | Description |
+|---------|-----------|-------------|
+| `new_page [url]` | `url` (optional) | Open a new tab, optionally navigating to a URL |
+| `select_page <index>` | `index` (integer) | Switch to a tab by index |
+| `close_page <index>` | `index` (integer) | Close a tab by index |
 
-**`type` 选项**：
-- `<text>`（必填）— 要输入的文本，多词文本用 `"` 包裹
-- `--uid <uid>` — 输入前先聚焦该元素
-- `--submit` — 输入后按回车
-- `--slowly` — 逐字符输入
+## Execution Behavior
 
-### 标签页管理
+- Manual confirmation mode (default): Commands enter a `pending` state and wait for user confirmation.
+- Auto-execute mode: When `autoExecute` is enabled in settings, commands execute immediately.
+- Status flow: `pending -> running -> success / failed / aborted / skipped`
 
-| 命令 | 参数 | 说明 |
-|------|------|------|
-| `new_page [url]` | `url`（可选） | 打开新标签页，可选导航到指定 URL |
-| `select_page <index>` | `index`（整数） | 按索引切换标签页 |
-| `close_page <index>` | `index`（整数） | 按索引关闭标签页 |
+## Standard Workflows
 
-### 高级
+### General Interaction
 
-| 命令 | 参数 | 说明 |
-|------|------|------|
-| `evaluate <script>` | `script`（剩余参数拼接为一个字符串） | 在页面上下文中执行 JavaScript |
+```text
+1. run_command: "comate-automation-browser navigate https://example.com"
+2. run_command: "comate-automation-browser snapshot"
+3. run_command: "comate-automation-browser click e15"
+4. run_command: "comate-automation-browser snapshot"
+5. run_command: "comate-automation-browser screenshot"
+```
 
-## 执行行为
+### Reading Page Content
 
-- **手动确认模式**（默认）：命令进入 `pending` 状态，等待用户手动确认。
-- **自动执行模式**：当设置中启用 `autoExecute` 时，命令立即执行，无需用户确认。
-- **状态流转**：`pending` -> `running` -> `success` / `failed` / `aborted` / `rejected`
+```text
+1. run_command: "comate-automation-browser navigate https://example.com"
+2. run_command: "comate-automation-browser evaluate document.body.innerText"
+3. For a specific section: evaluate document.querySelector('.article').innerText
+```
 
-## 标准工作流
+### Form Filling
 
-### 交互操作（点击、输入等）
-```
-1. run_command: "comate-automation-browser navigate https://example.com"
-2. run_command: "comate-automation-browser snapshot"
-   -> 读取 YAML 输出获取元素 UID
-3. run_command: "comate-automation-browser click 15"
-   -> 点击 UID 为 15 的元素
+```text
+1. run_command: "comate-automation-browser snapshot"
+2. Identify field UIDs/refs from the snapshot
+3. run_command: "comate-automation-browser fill_form '[{\"name\":\"Email\",\"type\":\"textbox\",\"uid\":\"e3\",\"value\":\"hi@example.com\"}]'"
 4. run_command: "comate-automation-browser snapshot"
-   -> 获取更新后的页面状态和新的 UID
 5. run_command: "comate-automation-browser screenshot"
-   -> 视觉验证
 ```
 
-### 读取页面内容
+## Key Rules
+
+- UIDs/refs come from `snapshot`. Always run `snapshot` before using `click`, `type --uid`, `drag`, `fill_form`, or `screenshot --uid`.
+- Re-run `snapshot` after interactions by default. After clicking, navigating, scrolling, reloading, submitting forms, switching tabs, or executing `evaluate` that modifies the DOM, always refresh the page state.
+- Use `snapshot` for structure and interaction; prefer `evaluate ...innerText` for reading body text. Do not use `html` as a text extraction tool.
+- When `type` is used without `--uid`, only use it when an element is already focused. If the input target is unclear, run `snapshot` first and pass `--uid`.
+- There is no explicit `wait` command for async pages. Poll and verify results using `snapshot`, `status`, `console`, `evaluate`, or `screenshot`.
+- Fall back to alternative actions for complex controls. If a regular click fails, consider `dblclick`, `rightclick`, `click_at`, or `drag`.
+- Always run `status` before tab operations. Closing the last tab is generally not possible.
+- Sessions are automatically managed per conversation; no need to manually create or destroy sessions.
+- Do not expose cache paths or temporary paths for screenshots, HTML, or script results in responses.
+- When a command indicates that content has been written to a file, read the corresponding file directly to get the full result.
+
+## Pause for Manual User Actions
+
+Pause automation and wait for the user to complete the following scenarios:
+
+- CAPTCHA, slider verification, or bot detection challenges
+- SMS or email verification codes
+- QR code login
+- User-specific sensitive credentials such as passwords, OTP, or security tokens
+- Complex choices requiring the user's subjective judgment
+
+Regular form filling, button clicking, and text input do not fall into this category and should be handled by the agent.
+
+## Troubleshooting
+
+### Element Not Found
+
+```text
+1. snapshot
+2. scroll down --amount 600
+3. snapshot
+4. If still failing, use screenshot or console to assist in locating the element
 ```
-1. run_command: "comate-automation-browser navigate https://example.com"
-2. run_command: "comate-automation-browser evaluate document.body.innerText"
-   -> 获取页面纯文本内容（无 HTML 噪声）
-   -> 如需特定区域：evaluate document.querySelector('.article').innerText
+
+### No Response After Action
+
+```text
+1. snapshot
+2. status
+3. console --types warn error --limit 20
+4. evaluate document.readyState
+5. screenshot
 ```
 
-## 关键规则
-
-- **UID 来自 `snapshot`**：在使用 `click` 或 `type --uid` 前，必须先执行 `snapshot` 获取当前元素的 UID。
-- **交互后重新 snapshot**：点击和导航后 UID 会变化，必须重新获取。
-- **`snapshot` 用于结构和交互**：`snapshot` 用于了解页面结构和获取元素 UID 以进行点击、输入等交互操作。需要读取页面文本内容时，不要使用 `snapshot` 或 `html`（HTML 噪声大），应使用 `evaluate document.body.innerText` 提取纯文本；如需读取特定区域内容，可用 `evaluate document.querySelector('选择器').innerText`。
-- **会话自动管理**：浏览器会话按对话自动管理，无需手动管理。
-- **不暴露缓存路径**：在回复中不得描述截图、文件等的缓存地址或本地临时路径（如 `/tmp/...`、`~/.cache/...` 等），仅描述操作结果或展示图片内容。
-- **需要用户手动操作时暂停**：当遇到需要用户手动操作的场景时（如：
-  - 图形验证码、滑块验证、人机验证（CAPTCHA）
-  - 短信/邮箱验证码
-  - 扫码登录
-  - 用户专属的敏感凭证（如密码、OTP、安全令牌）
-  - 需要用户主观判断或选择的复杂交互
-  ），暂停自动化执行，等待用户 10 秒并提示用户需要进行操作。用户完成操作后，继续执行后续自动化流程。
-  **注意**：普通表单填写、文本输入、按钮点击等可自动化的操作由 agent 自行处理，不在此列。
-- **内容过长时读取文件**：当命令返回结果提示内容过长已写入文件时（如 `snapshot`、`html` 等命令），应直接读取对应文件获取完整内容，以确保任务正常完成。
+### IDE Built-in Browser Behaving Unexpectedly
+
+- In `builtin` mode, waits and snapshots are approximate implementations.
+- If the page relies heavily on animations, virtual lists, canvas, or complex focus management, always perform an additional verification step — do not assume the first action succeeded.

package/comate-engine/assets/skills/figma2code-comate/SKILL.md

@@ -30,12 +30,12 @@ description: 根据Figma设计稿信息生成代码。当用户选择设计稿
 
 
 2. 图片资源管理
-   - 请使用终端命令一次性将需要的图像复制到项目中的合适目录中 (请避免一个一个复制图片，尽可能一个命令复制整个图片目录)，并记住复制后的【图片目录】。注意无需执行终端命令检查目录中是否有图片。
+   - 请使用终端命令一次性将需要的图像复制到项目中的合适目录中 (请避免一个一个复制图片，使用一个命令复制整个图片目录)，并记住复制后的【图片目录】。注意无需执行终端命令检查目录中是否有图片。
    - 请确保在项目中使用正确的方法引用【图片目录】中的图片资源。【图片目录】中的图片名称和html代码中的图片名称是一致的。
 **请注意tailwind框架中不要使用bg-[url]来引入本地图片资源，比如bg-[url('/images.png')]，而是使用style中的background-image属性。**
 
 3. 代码生成
-   - 根据用户要求和上述分析，生成对应代码。
+   - 根据读取的userRule和上述分析，生成对应代码。
 
 # 其他
 生成的代码写入项目中。

package/comate-engine/assets/skills/figma2code-comate/references/codeConnect.md

@@ -1,7 +1,7 @@
 # Code Connect指南
 应当严格按下列步骤分析设计稿中使用的组件：
 
-1. 解析【设计稿html】包含 **组件标记（Component Markers）**的注释。
+1. 解析【设计稿html】包含 **组件标记（Component Markers）**的注释,明确需要引入的组件列表。
 组件标记格式如下：
 \`\`\`html
 <!-- [START: ComponentName] -->
@@ -10,7 +10,7 @@
 <!-- [END: ComponentName] -->
 \`\`\`
 
-2. 分析【设计稿图片】，识别其中未标记的可复用组件。请逐个检查是否包含下面这几个未标记的组件
+2. 分析【设计稿图片】，识别其中未标记的可复用组件作为补充。请逐个检查是否包含下面这几个未标记的组件：
 - 表单与表单项 (Form + Form-item)
 - 表格 (Table)
 - 按钮 (Button)
@@ -18,14 +18,11 @@
 - 单选框 (Radio)
 - 多选框 (Checkbox)
 - 模态框 (Modal)
+如果标记的组件与自动识别需要使用的组件不匹配，以标记的组件优先。如果有明显标记错误应当以友好方式提示用户。
 
 3. 确定需要引入的组件后，使用read_file工具在.comate/components目录下读取对应的组件文档。
-
-4. 结合组件文档，正确引入组件，并根据原html的特征正确使用组件属性。
-
-
-## 注意事项：
-- **冲突处理**：如果标记的组件与自动识别需要使用的组件不匹配，以标记的组件优先。如果有明显标记错误应当以友好方式提示用户。
-- 如果识别到的组件对应的文档在项目中不存在或无法找到，回退到根据 Figma HTML 实现
+- 如果识别到的组件对应的文档在项目中不存在或无法找到，回退到根据 Figma HTML 实现。
 - 非用户要求禁止读取无关的组件知识。
-- 非用户要求禁止在.comate/components目录以外全局检索组件知识。
+- 非用户要求禁止在.comate/components目录以外全局检索组件知识。
+
+4. 结合组件文档，正确引入组件，并根据原html的特征正确使用组件属性。