@comate/zulu 1.2.0 → 1.2.1-beta.1

package/comate-engine/assets/skills/auto-commit/SKILL.md

@@ -30,23 +30,9 @@ metadata:
 - "当前版本不支持..."
 - 任何提及"版本"、"降级"、"兼容"、"开关"等字眼
 
-### 0a. 开关检查（本地用户偏好）
+### 0a. 版本兼容性检查（纯文本判断，无需命令）
 
-**说明：此检查读取用户本地配置，是用户个人的开关偏好。步骤 1 中的 `result.disabled` 是服务端/空间级别的开关，两者独立，互不替代。**
-
-通过以下方式进行检查（**必须加 `__silent:` 前缀**）：
-
-```
-__silent: cat ~/.comate/settings.json 2>/dev/null || echo '{}'
-```
-
-解析返回的 JSON，检查 `enableSmartCommit` 字段：
-- 如果 `enableSmartCommit` 为 `false` → **立即结束 skill，不再输出任何内容，不再执行任何后续步骤**
-- 如果 `enableSmartCommit` 为 `true` 或字段不存在（默认开启）→ **继续执行 0b**
-
-### 0b. 版本兼容性检查
-
-**⚠️ 必须在 0a 完成后执行此步骤，不可跳过。**
+**⚠️ 此步骤必须最先执行。它决定后续命令是否需要加 `__silent:` 前缀。**
 
 通过检查上方「版本信息」中的占位符是否被替换来判断：
 
@@ -60,6 +46,60 @@ __silent: cat ~/.comate/settings.json 2>/dev/null || echo '{}'
 - **新版本** → 请参考 `references/new_version_instruction.md`
 - **旧版本** → 请参考 `references/old_version_instruction.md`
 
+**记住判断结果，后续步骤中：**
+- **新版本**：命令加 `__silent:` 前缀
+- **旧版本**：命令不加 `__silent:` 前缀
+
+**继续执行 0b。**
+
+### 0b. 开关检查 + Python 检测（并行执行）
+
+**⚠️ 必须在 0a 完成后执行此步骤，不可跳过。两条命令无依赖，Agent 必须在同一次响应中并行发出。**
+
+**说明：开关检查读取用户本地配置（`~/.comate/settings.json` 中的 `enableSmartCommit`），是用户个人的开关偏好。步骤 1 中的 `result.disabled` 是服务端/空间级别的开关，两者独立，互不替代。**
+
+#### 命令 1：开关检查（纯 shell，无外部依赖）
+
+Agent 根据环境上下文中的操作系统信息选择对应命令（**新版本加 `__silent:` 前缀，旧版本不加**）：
+
+**macOS / Linux：**
+```
+[__silent: ]cat ~/.comate/settings.json 2>/dev/null || echo "{}"
+```
+
+**Windows（cmd）：**
+```
+[__silent: ]type "%USERPROFILE%\.comate\settings.json" 2>NUL || echo {}
+```
+
+Agent 解析输出的 JSON，检查 `enableSmartCommit` 字段：
+- 如果 `enableSmartCommit` 为 `false` → **立即结束 skill，不再输出任何内容，不再执行任何后续步骤**
+- 如果 `enableSmartCommit` 为 `true`、字段不存在、或命令输出为 `{}`（文件不存在）→ 默认开启，继续
+
+#### 命令 2：Python 可用性检测
+
+与命令 1 **并行**发出（**新版本加 `__silent:` 前缀，旧版本不加**）：
+
+**macOS / Linux：**
+```
+[__silent: ]python3 --version 2>/dev/null || python --version 2>/dev/null
+```
+
+**Windows（cmd）：**
+```
+[__silent: ]python --version 2>NUL || python3 --version 2>NUL || py -3 --version 2>NUL
+```
+
+- 如果命令**成功**（返回版本号，如 `Python 3.x.x`）→ 记住**输出中实际成功的那个命令名**（`python3`、`python` 或 `py -3`），后续步骤中所有 `python3` 必须替换为该命令名
+- 如果**全部失败** → 标记 `python_available = false`。后续步骤 1 直接进入"iCafe 获取失败降级"流程，步骤 2 中 `git_diff_cli.py` 也无法执行，Agent 应直接执行 git 命令获取 diff 信息
+
+#### 跨平台说明
+
+Agent 根据环境上下文的操作系统信息判断当前平台。同时需注意：
+- **macOS / Linux**：shell 命令中使用 `2>/dev/null` 抑制错误
+- **Windows（cmd）**：使用 `2>NUL` 抑制错误，路径使用 `%USERPROFILE%`，`cd` 跨盘符需用 `cd /d`
+- 后续步骤中所有 `cd <path> && <command>` 在 Windows 上应改为 `cd /d <path> && <command>`
+
 ---
 
 ## 步骤 1：获取 iCafe 数据
@@ -67,15 +107,11 @@ __silent: cat ~/.comate/settings.json 2>/dev/null || echo '{}'
 通过 `run_command` 执行以下命令获取 iCafe 卡片数据。**新版本加 `__silent:` 前缀，旧版本不加。**
 
 ```bash
-[__silent: ]cd <用户项目目录> && PYTHONPATH="<skill_directory>/scripts" python3 -c "
-import sys, json
-sys.path.insert(0, '<skill_directory>/scripts')
-from icafe.matching import find_matching_card
-result = find_matching_card(current_user=sys.argv[1] if len(sys.argv) > 1 else None)
-print(json.dumps(result))
-" '${COMATE_USERNAME}'
+[__silent: ]python3 <skill_directory>/scripts/match_card_cli.py --username "${COMATE_USERNAME}"
 ```
 
+脚本内部通过 `os.environ.get("COMATE_USERNAME")` 读取用户名（跨平台兼容），`${COMATE_USERNAME}` 由 Agent 构建命令时替换为实际值。
+
 从 stdout 输出的 JSON 解析为 `result` 对象。
 
 **⚠️ 开关检查（服务端/空间级别）：** 解析 `result` 后，**首先**检查 `result.get("disabled")` 是否为 `True`。如果是，**必须立即结束 skill，不再执行任何后续步骤，不输出任何内容**。此开关与步骤 0a 的本地用户偏好开关独立，由服务端控制。
@@ -334,7 +370,7 @@ Agent 内部分析以下信号判断是否展示提交确认，**不输出任何
 | space_name | 空间名称 |
 | final_iql | 实际执行的完整 IQL |
 | available_types | 可绑定卡片类型列表：[{id, name}, ...] |
-| available_spaces | 可访问空间列表：[{id, prefix, name}, ...] |
+| available_spaces | 可访问空间列表：[{id, prefix, name, types}, ...] |
 | defaults | 默认表单值：{title, type_id, space_id}（title 由 Agent 在步骤 2 中生成） |
 
 ### `diff_summary`（Agent 在步骤 2 中构建）
@@ -368,6 +404,19 @@ token 按优先级读取：
 1. 环境变量 `COMATE_AUTH_TOKEN`
 2. 文件 `~/.comate/login`
 
+### 跨平台 Python 命令
+
+本 skill 中所有 `python3` 命令在 Windows 上可能不可用。步骤 0a 会自动检测可用的 Python 命令名，后续步骤中的 `python3` 必须替换为检测到的命令名：
+- **macOS / Linux**：通常为 `python3`
+- **Windows**：通常为 `python` 或 `py -3`
+
+### 跨平台 Shell 命令
+
+本 skill 中涉及 `cd <path> && <command>` 的命令模板在 Windows 上需注意：
+- **macOS / Linux**：`cd /path/to/project && git add .`
+- **Windows（cmd）**：需使用 `cd /d <path>` 以支持跨盘符切换，如 `cd /d D:\project && git add .`
+- Agent 执行命令时应根据环境上下文中的操作系统信息自动选择正确的 `cd` 写法。
+
 ### 资源
 
 - **scripts/icafe/** — 核心实现包
@@ -376,6 +425,7 @@ token 按优先级读取：
   - `farseer.py` — `get_binding_card_types()` 获取可绑定卡片类型
 - **scripts/git_utils.py** — diff 摘要、用户获取、git log 提取
 - **scripts/git_diff_cli.py** — git diff 摘要命令行工具（步骤 2）
+- **scripts/match_card_cli.py** — 查询匹配卡片命令行工具（步骤 1）
 - **scripts/create_card_cli.py** — 创建卡片命令行工具
 - **scripts/recognize_card_cli.py** — 识别卡片命令行工具
 - **scripts/compat.py** — 版本兼容性检测模块

package/comate-engine/assets/skills/auto-commit/references/new_version_instruction.md

@@ -77,7 +77,7 @@ command = f"__interactive:icafe-cards {payload}"
 
 完整示例 command 值：
 ```
-__interactive:icafe-cards {"cards":[{"sequence":"200","title":"修复登录问题","type":"Bug","status":"开发中"}],"spacePrefix":"dkx","spaceId":12345,"spaceName":"测试空间","viewMode":"list","availableSpaces":[{"id":12345,"prefix":"dkx","name":"测试空间"}],"defaults":{"title":"修复登录验证码刷新问题","typeId":"5009","spaceId":12345}}
+__interactive:icafe-cards {"cards":[{"sequence":"200","title":"修复登录问题","type":"Bug","status":"开发中"}],"spacePrefix":"dkx","spaceId":12345,"spaceName":"测试空间","viewMode":"list","availableSpaces":[{"id":12345,"prefix":"dkx","name":"测试空间","types":[{"id":"5009","name":"Bug"},{"id":"5007","name":"Story"}]}],"defaults":{"title":"修复登录验证码刷新问题","typeId":"5009","spaceId":12345}}
 ```
 
 ---

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

@@ -27,7 +27,8 @@ def run_git(args, cwd, timeout=10):
     try:
         result = subprocess.run(
             ["git"] + args,
-            capture_output=True, text=True, timeout=timeout, cwd=cwd
+            capture_output=True, text=True, encoding="utf-8", errors="replace",
+            timeout=timeout, cwd=cwd
         )
         if result.returncode == 0:
             return result.stdout
@@ -86,22 +87,14 @@ def get_untracked_diff_and_stats(cwd, untracked_files):
     truncated = False
 
     for file_path in untracked_files:
+        full_path = os.path.join(cwd, file_path)
         try:
-            result = subprocess.run(
-                ["git", "diff", "--no-index", "/dev/null", file_path],
-                capture_output=True, text=True, timeout=10, cwd=cwd
-            )
-            # git diff --no-index 在有差异时返回 1，不算失败
-            file_diff = result.stdout
-        except (subprocess.TimeoutExpired, FileNotFoundError, OSError):
+            with open(full_path, "r", encoding="utf-8", errors="replace") as f:
+                lines = f.readlines()
+        except (OSError, IOError):
             continue
 
-        # 统计 insertions：+ 开头但非 +++ 的行
-        insertions = 0
-        for line in file_diff.splitlines():
-            if line.startswith("+") and not line.startswith("+++"):
-                insertions += 1
-
+        insertions = len(lines)
         if insertions > 0:
             changed_files.append({
                 "file": file_path,
@@ -109,17 +102,25 @@ def get_untracked_diff_and_stats(cwd, untracked_files):
                 "deletions": 0,
             })
 
-        # 拼接 diff 内容，检查总行数上限
-        file_lines = file_diff.splitlines()
+        # 构造 unified diff 格式的输出
+        file_diff_lines = [
+            f"diff --git a/{file_path} b/{file_path}",
+            "new file mode 100644",
+            f"--- /dev/null",
+            f"+++ b/{file_path}",
+            f"@@ -0,0 +1,{insertions} @@",
+        ] + [f"+{line.rstrip()}" for line in lines]
+
+        # 检查总行数上限
         remaining = MAX_UNTRACKED_DIFF_LINES - total_lines
         if remaining <= 0:
             truncated = True
             break
-        if len(file_lines) > remaining:
-            file_lines = file_lines[:remaining]
+        if len(file_diff_lines) > remaining:
+            file_diff_lines = file_diff_lines[:remaining]
             truncated = True
-        diff_lines.extend(file_lines)
-        total_lines += len(file_lines)
+        diff_lines.extend(file_diff_lines)
+        total_lines += len(file_diff_lines)
 
     return changed_files, "\n".join(diff_lines), truncated
 

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

@@ -63,7 +63,8 @@ def get_current_user(username: Optional[str] = None) -> Optional[str]:
     try:
         result = subprocess.run(
             ["git", "config", "user.email"],
-            capture_output=True, text=True, timeout=5
+            capture_output=True, text=True, encoding="utf-8", errors="replace",
+            timeout=5
         )
         if result.returncode == 0 and result.stdout.strip():
             username = result.stdout.strip().split("@")[0]
@@ -77,7 +78,8 @@ def get_current_user(username: Optional[str] = None) -> Optional[str]:
     try:
         result = subprocess.run(
             ["git", "config", "user.name"],
-            capture_output=True, text=True, timeout=5
+            capture_output=True, text=True, encoding="utf-8", errors="replace",
+            timeout=5
         )
         if result.returncode == 0 and result.stdout.strip():
             username = result.stdout.strip()
@@ -112,7 +114,8 @@ def get_git_diff_summary(max_diff_lines: int = DEFAULT_MAX_DIFF_LINES) -> Option
     try:
         stat_result = subprocess.run(
             ["git", "diff", "HEAD", "--stat"],
-            capture_output=True, text=True, timeout=10
+            capture_output=True, text=True, encoding="utf-8", errors="replace",
+            timeout=10
         )
         if stat_result.returncode != 0 or not stat_result.stdout.strip():
             logger.info("git diff 无变更")
@@ -136,7 +139,8 @@ def get_git_diff_summary(max_diff_lines: int = DEFAULT_MAX_DIFF_LINES) -> Option
     try:
         diff_result = subprocess.run(
             ["git", "diff", "HEAD"],
-            capture_output=True, text=True, timeout=30
+            capture_output=True, text=True, encoding="utf-8", errors="replace",
+            timeout=30
         )
         diff_content = diff_result.stdout if diff_result.returncode == 0 else ""
     except (subprocess.TimeoutExpired, FileNotFoundError):
@@ -178,7 +182,8 @@ def extract_space_ids_from_git_log(
     try:
         result = subprocess.run(
             ["git", "log", "--oneline", "-n", str(max_commits)],
-            capture_output=True, text=True, timeout=10
+            capture_output=True, text=True, encoding="utf-8", errors="replace",
+            timeout=10
         )
         if result.returncode != 0:
             return []

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

@@ -3,13 +3,15 @@
 包含常量、配置类和 API 客户端。
 """
 
+import json as _json
 import os
+import urllib.error
+import urllib.parse
+import urllib.request
 from dataclasses import dataclass
 from pathlib import Path
 from typing import Dict, List, Any, Optional
 
-import requests
-
 from logger import get_logger
 
 logger = get_logger()
@@ -126,34 +128,69 @@ class ICafeQueryClient:
 
     def __init__(self, config: Optional[ICafeQueryConfig] = None):
         self.config = config or ICafeQueryConfig()
-        self.session = requests.Session()
-
-        self.session.headers.update({
-            "Content-Type": "application/json"
-        })
+        self._default_headers: Dict[str, str] = {
+            "Content-Type": "application/json",
+            "User-Agent": "iAPI/1.0.0 (http://iapi.baidu-int.com)",
+        }
 
         auth_token = self.config._get_auth_token()
         if auth_token:
-            self.session.headers["x-ac-Authorization"] = auth_token
+            self._default_headers["x-ac-Authorization"] = auth_token
 
-    def _get_headers(self) -> Dict[str, str]:
-        """获取通用请求 headers"""
-        return {
-            'User-Agent': 'iAPI/1.0.0 (http://iapi.baidu-int.com)'
-        }
+    def _http_request(
+        self,
+        url: str,
+        params: Optional[dict] = None,
+        data: Optional[dict] = None,
+        headers: Optional[Dict[str, str]] = None,
+        timeout: Optional[int] = None,
+    ) -> Any:
+        """发送 HTTP 请求并返回解析后的 JSON
+
+        Args:
+            url: 请求 URL
+            params: GET 查询参数
+            data: POST 请求体（dict，会被序列化为 JSON）
+            headers: 额外 headers（会合并到默认 headers）
+            timeout: 超时时间（秒）
+
+        Returns:
+            解析后的 JSON 对象（dict 或 list）
+
+        Raises:
+            urllib.error.HTTPError: HTTP 状态码非 2xx 时
+            urllib.error.URLError: 网络连接失败时
+        """
+        if timeout is None:
+            timeout = self.config.timeout
+
+        # 合并 headers
+        merged_headers = dict(self._default_headers)
+        if headers:
+            merged_headers.update(headers)
+
+        # 构建完整 URL
+        if params:
+            query_string = urllib.parse.urlencode(params, doseq=True)
+            url = f"{url}?{query_string}" if "?" not in url else f"{url}&{query_string}"
+
+        # 构建 Request
+        body = None
+        if data is not None:
+            body = _json.dumps(data).encode("utf-8")
+
+        req = urllib.request.Request(url, data=body, headers=merged_headers)
+
+        with urllib.request.urlopen(req, timeout=timeout) as resp:
+            return _json.loads(resp.read().decode("utf-8"))
 
-    def _get_with_retry(self, url: str, params: dict, max_retries: int = 3) -> requests.Response:
-        """带重试的 GET 请求"""
+    def _get_with_retry(self, url: str, params: dict, max_retries: int = 3) -> Any:
+        """带重试的 GET 请求，返回解析后的 JSON"""
         import time
         last_exc = None
         for attempt in range(max_retries + 1):
             try:
-                response = self.session.get(
-                    url, params=params, headers=self._get_headers(),
-                    timeout=self.config.timeout
-                )
-                response.raise_for_status()
-                return response
+                return self._http_request(url, params=params)
             except Exception as e:
                 last_exc = e
                 if attempt < max_retries:
@@ -195,7 +232,7 @@ class ICafeQueryClient:
 
         Raises:
             ValueError: 当 space_id 或 iql 为空时
-            requests.RequestException: 请求失败时
+            urllib.error.URLError: 请求失败时
 
         IQL 表达式示例：
             - "类型 = Bug"
@@ -234,8 +271,7 @@ class ICafeQueryClient:
 
         url = f"{self.config.base_url}/api/spaces/{space_id}/cards"
         logger.info("查询卡片: space=%s, iql=%s", space_id, iql)
-        response = self._get_with_retry(url, params)
-        result = response.json()
+        result = self._get_with_retry(url, params)
         cards_count = len(result.get("cards", []))
         logger.info("查询卡片返回: %d 张", cards_count)
         return result
@@ -263,7 +299,7 @@ class ICafeQueryClient:
 
         Raises:
             ValueError: 当 space_id 或 card_id 为空时
-            requests.RequestException: 请求失败时
+            urllib.error.URLError: 请求失败时
         """
         if not space_id or not card_id:
             raise ValueError("space_id 和 card_id 不能为空")
@@ -279,8 +315,7 @@ class ICafeQueryClient:
             params['showAccumulate'] = ''
 
         url = f"{self.config.base_url}/api/spaces/{space_id}/cards/{card_id}"
-        response = self._get_with_retry(url, params)
-        return response.json()
+        return self._get_with_retry(url, params)
 
     # ========================================
     # 3. 查询最近访问的空间列表
@@ -297,7 +332,7 @@ class ICafeQueryClient:
 
         Raises:
             ValueError: 当 current_user 为空时
-            requests.RequestException: 请求失败时
+            urllib.error.URLError: 请求失败时
         """
         if not current_user:
             raise ValueError("current_user 不能为空")
@@ -305,8 +340,7 @@ class ICafeQueryClient:
         logger.info("查询最近访问空间: user=%s, limit=%d", current_user, limit)
         url = f"{self.config.base_url}/api/v2/space/latest"
         params = {'currentUser': current_user}
-        response = self._get_with_retry(url, params)
-        data = response.json()
+        data = self._get_with_retry(url, params)
 
         # 对返回的空间列表截取前 limit 个
         if isinstance(data, dict) and 'result' in data:
@@ -330,14 +364,13 @@ class ICafeQueryClient:
 
         Raises:
             ValueError: 当 space_id 为空时
-            requests.RequestException: 请求失败时
+            urllib.error.URLError: 请求失败时
         """
         if not space_id:
             raise ValueError("space_id 不能为空")
 
         url = f"{self.config.base_url}/api/v2/space/{space_id}/plans"
-        response = self._get_with_retry(url, {})
-        return response.json()
+        return self._get_with_retry(url, {})
 
     # ========================================
     # 5. 获取空间卡片类型列表
@@ -353,14 +386,13 @@ class ICafeQueryClient:
 
         Raises:
             ValueError: 当 space_prefix 为空时
-            requests.RequestException: 请求失败时
+            urllib.error.URLError: 请求失败时
         """
         if not space_prefix:
             raise ValueError("space_prefix 不能为空")
 
         url = f"{self.config.base_url}/api/v2/space/{space_prefix}/issueTypes"
-        response = self._get_with_retry(url, {})
-        return response.json()
+        return self._get_with_retry(url, {})
 
     # ========================================
     # 6. 创建卡片
@@ -421,10 +453,7 @@ class ICafeQueryClient:
                 'Content-Type': 'application/json'
             }
 
-            # 使用 self.session.post 发送请求
-            response = self.session.post(url, json=data, headers=headers, timeout=self.config.timeout)
-            response.raise_for_status()
-            result = response.json()
+            result = self._http_request(url, data=data, headers=headers)
 
             # 检查返回的状态
             if isinstance(result, dict):

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

@@ -1,6 +1,8 @@
 """Farseer API 客户端"""
 
-import requests
+import json
+import urllib.parse
+import urllib.request
 from typing import Dict, List, Any, Optional
 
 from .client import FARSEER_BASE_URL, DEFAULT_TIMEOUT, ISSUE_TYPE_MAP
@@ -25,14 +27,11 @@ def get_binding_card_types(space_id: int, timeout: int = DEFAULT_TIMEOUT) -> Lis
     """
     logger.info("查询 farseer 可绑定类型: space_id=%s", space_id)
     try:
-        url = f"{FARSEER_BASE_URL}/storyRule/getRule"
-        response = requests.get(
-            url,
-            params={'icafeSpaceId': space_id},
-            timeout=timeout
-        )
-        response.raise_for_status()
-        data = response.json()
+        query_string = urllib.parse.urlencode({'icafeSpaceId': space_id})
+        url = f"{FARSEER_BASE_URL}/storyRule/getRule?{query_string}"
+        req = urllib.request.Request(url)
+        with urllib.request.urlopen(req, timeout=timeout) as resp:
+            data = json.loads(resp.read().decode("utf-8"))
 
         rule_data = data.get('data', {}).get('data', {})
         binding_types = rule_data.get('engineeringBindingTypes', [])

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

@@ -622,7 +622,10 @@ def find_matching_card(
             "space_name": "空间名称",
             "final_iql": "...",
             "available_types": [{"id": "5009", "name": "Bug"}, ...],
-            "available_spaces": [{"id": 12345, "prefix": "dkx", "name": "空间名称"}, ...],
+            "available_spaces": [
+                {"id": 12345, "prefix": "dkx", "name": "空间名称",
+                 "types": [{"id": "5009", "name": "Bug"}]}, ...
+            ],
             "defaults": {
                 "title": "",         # 由 Agent 根据 diff 生成
                 "type_id": "5009",   # 默认卡片类型 ID

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

@@ -0,0 +1,37 @@
+"""命令行工具：查询 iCafe 匹配卡片
+
+用法:
+    python3 match_card_cli.py --username "dongkexin01"
+
+输出:
+    JSON 格式的匹配结果，包含 cards、space_prefix、available_types 等字段。
+    失败时输出 {"error": "错误信息"} 或 {"disabled": true, "message": "..."}。
+"""
+
+import argparse
+import json
+import os
+import sys
+
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+
+from icafe.matching import find_matching_card
+
+
+def main():
+    """解析命令行参数并查询匹配卡片。"""
+    parser = argparse.ArgumentParser(description="查询 iCafe 匹配卡片")
+    parser.add_argument("--username", default=None, help="用户名，如 dongkexin01")
+    args = parser.parse_args()
+
+    try:
+        username = args.username or os.environ.get("COMATE_USERNAME")
+        result = find_matching_card(current_user=username)
+        print(json.dumps(result, ensure_ascii=False))
+    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/create-skill-comate/SKILL.md

@@ -273,10 +273,10 @@ When creating a new skill from scratch, always run the `init_skill.py` script. T
 
 Storage:
 
-| Type | Path | Scope |
-|------|------|-------|
-| Personal | ~/.comate/skills/skill-name/ | Available across all your projects |
-| Project | .comate/skills/skill-name/ | Shared with anyone using the repository |
+| Type     | Path                         | Scope                                   |
+| -------- | ---------------------------- | --------------------------------------- |
+| Personal | ~/.comate/skills/skill-name/ | Available across all your projects      |
+| Project  | .comate/skills/skill-name/   | Shared with anyone using the repository |
 
 **IMPORTANT**: Never create or update skills in `~/.comate/skills/skill-name-comate/`. This directory is reserved for Comate's internal built-in skills and is managed automatically by the system.
 
@@ -346,7 +346,6 @@ scripts/quick_validate.py <path/to/skill-folder>
 
 The validation script checks YAML frontmatter format, required fields, and naming rules. If validation fails, fix the reported issues and run the command again.
 
-
 ### Step 6: Iterate
 
 After testing the skill, users may request improvements. Often this happens right after using the skill, with fresh context of how the skill performed.