@comate/zulu 1.2.1-beta.2 → 1.3.0

package/comate-engine/assets/skills/get-ugate-token-comate/SKILL.md

@@ -0,0 +1,159 @@
+---
+name: get-ugate-token
+description: 获取并缓存 ugate token，供其他 skill 依赖使用进行API调用（多用户版本，永久有效）
+metadata:
+  enableWhen:
+    - isInternal
+---
+
+# get-ugate-token Skill
+
+## 功能描述
+该 skill 用于获取并缓存 ugate token，供其他 skill 依赖使用进行API调用。支持多用户独立缓存，每个用户有独立的缓存文件。
+
+**核心特性：**
+- 所有 token 都是永久有效的
+- 支持用户手动输入 token
+- 用户名: ${COMATE_USERNAME}
+
+
+## 文件结构
+
+```
+get-ugate-token/
+├── SKILL.md           # 技能说明文档
+└── getUgateToken.py   # Python 主脚本
+```
+
+## 工作流程
+
+### 1. 手动输入 Token
+
+**当用户发送格式为 `ugate token: xxxx` 或 `ugate token：xxxx`（中文冒号）的消息时：**
+
+1. **提取 token** - 从用户消息中提取 token 内容
+2. **保存到缓存** - 将 token 保存到用户的缓存文件
+3. **返回成功消息** - 输出 `TOKEN_SAVED:Token 已保存`
+
+**示例：**
+
+```bash
+# 用户发送消息：ugate token: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...
+USER_MESSAGE="ugate token: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..." python3 getUgateToken.py chenshouqin 2>&1
+TOKEN_SAVED:Token 已保存
+eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...
+```
+
+### 2. 检查缓存的 token
+
+- 检查文件 `~/.config/uuap/.eac_ugate_token_{username}` 是否存在
+- 如果文件存在，直接返回缓存的 token（永久有效）
+
+### 3. 需要手动获取 token
+
+如果缓存不存在：
+
+1. **返回提示消息** - 输出到 stderr，格式为 `NEED_MANUAL_TOKEN:请点击 https://uuap.baidu.com/agent/token 获取token，然后复制内容发送给我`
+2. **退出码为 2** - 表示需要手动获取 token（区别于错误退出码 1）
+
+用户需要：
+- 访问 https://uuap.baidu.com/agent/token
+- 复制页面内容
+- 将内容发送给技能调用者
+
+## 使用方法
+
+```bash
+# 获取 ugate token（需要传入用户名）
+python3 /home/gem/.openclaw/skills/get-ugate-token/getUgateToken.py <username>
+
+# 手动输入 token（通过 USER_MESSAGE 环境变量）
+USER_MESSAGE="ugate token: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..." python3 /home/gem/.openclaw/skills/get-ugate-token/getUgateToken.py <username>
+```
+
+## 输出格式
+
+### 成功场景（缓存有效）
+
+```bash
+$ python3 getUgateToken.py chenshouqin
+eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...
+```
+
+### 手动输入 token 场景
+
+```bash
+$ USER_MESSAGE="ugate token: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..." python3 getUgateToken.py chenshouqin 2>&1
+TOKEN_SAVED:Token 已保存
+eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...
+```
+
+### 需要手动获取场景（缓存无效）
+
+脚本会输出到 stderr 并以退出码 2 退出：
+
+```bash
+$ python3 getUgateToken.py chenshouqin 2>&1
+NEED_MANUAL_TOKEN:请点击 https://uuap.baidu.com/agent/token 获取token，然后复制内容发送给我
+```
+
+## 强制刷新
+
+当用户消息中包含以下关键词时，会忽略缓存：
+
+- 重新生成ugate
+- 刷新ugate
+- 重新生成 ugate
+- 刷新 ugate
+- 强制刷新
+- 重新获取
+- 重新生成token
+- 刷新token
+- 重新生成 token
+- 刷新 token
+- 强制刷新token
+- 忽略缓存
+
+**使用方式：** 在调用脚本时设置环境变量 `USER_MESSAGE`，例如：
+
+```bash
+USER_MESSAGE="刷新ugate" python3 /home/gem/.openclaw/skills/get-ugate-token/getUgateToken.py <username>
+```
+
+## 环境变量依赖
+
+- `USER_MESSAGE` - 用户原始消息（可选，用于判断是否强制刷新或手动输入 token）
+
+## 缓存机制
+
+- **缓存文件:** `~/.config/uuap/.eac_ugate_token_{username}`（多用户独立缓存）
+- **缓存格式:** JSON
+  ```json
+  {
+    "token": "xxx",
+    "permanent": true
+  }
+  ```
+- **缓存时长:** 永久有效
+
+## 多用户支持
+
+每个用户有独立的缓存文件，文件名格式为 `.eac_ugate_token_{username}`，例如：
+
+- 用户 `chenshouqin` → `~/.config/uuap/.eac_ugate_token_chenshouqin`
+- 用户 `zhangjianxing` → `~/.config/uuap/.eac_ugate_token_zhangjianxing`
+
+这样可以避免不同用户的 token 相互干扰。
+
+## 退出码说明
+
+- **0**: 成功，token 已返回
+- **1**: 错误（参数缺失等）
+- **2**: 需要手动获取 token（缓存无效，请提示用户访问 https://uuap.baidu.com/agent/token）
+
+## 注意事项
+
+- token 会缓存到本地文件中，避免重复获取
+- 每个用户有独立的缓存文件，互不干扰
+- 所有 token 都是永久有效的
+- **手动输入 token 格式：** `ugate token: <token内容>` 或 `ugate token：<token内容>`（中文冒号）

package/comate-engine/assets/skills/get-ugate-token-comate/getUgateToken.py

@@ -0,0 +1,150 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+获取并缓存 ugate token（多用户版本，永久有效）
+"""
+
+import os
+import sys
+import json
+import re
+from pathlib import Path
+
+# 配置常量
+CACHE_DIR = Path.home() / ".config" / "uuap"
+
+# 强制刷新的关键词
+FORCE_REFRESH_KEYWORDS = [
+    "重新生成ugate",
+    "刷新ugate",
+    "重新生成 ugate",
+    "刷新 ugate",
+    "强制刷新",
+    "重新获取",
+    "重新生成token",
+    "刷新token",
+    "重新生成 token",
+    "刷新 token",
+    "强制刷新token",
+    "忽略缓存",
+]
+
+
+def get_cache_file(username):
+    """根据用户名获取对应的缓存文件路径"""
+    return CACHE_DIR / f".eac_ugate_token_{username}"
+
+
+def should_force_refresh(user_message):
+    """检查用户消息是否包含强制刷新的关键词"""
+    if not user_message:
+        return False
+
+    user_message_lower = user_message.lower()
+    return any(keyword in user_message_lower for keyword in FORCE_REFRESH_KEYWORDS)
+
+
+def extract_manual_token(user_message):
+    """
+    从用户消息中提取手动输入的 token
+    支持格式：ugate token: xxxx 或 ugate token：xxxx（中文冒号）
+    
+    Returns:
+        str: 提取到的 token，如果格式不匹配则返回 None
+    """
+    if not user_message:
+        return None
+
+    # 支持中英文冒号，支持大小写
+    pattern = r'ugate\s+token\s*[:：]\s*(\S.+)'
+    match = re.search(pattern, user_message, re.IGNORECASE)
+    
+    if match:
+        return match.group(1).strip()
+    
+    return None
+
+
+def get_cached_token(username):
+    """
+    从缓存读取 token
+    
+    如果缓存文件中存在 expires_at 字段，则认为 token 无效，返回 None
+    """
+    cache_file = get_cache_file(username)
+
+    if not cache_file.exists():
+        return None
+
+    try:
+        with open(cache_file, 'r') as f:
+            data = json.load(f)
+
+        # 如果存在 expires_at 字段，认为 token 无效
+        if 'expires_at' in data:
+            return None
+
+        token = data.get('token')
+        if not token:
+            return None
+
+        return token
+    except (json.JSONDecodeError, KeyError):
+        pass
+
+    return None
+
+
+def save_token_to_cache(token, username):
+    """
+    将 token 保存到缓存（永久有效）
+    """
+    CACHE_DIR.mkdir(parents=True, exist_ok=True)
+    cache_file = get_cache_file(username)
+
+    with open(cache_file, 'w') as f:
+        cache_data = {
+            'token': token,
+            'permanent': True,  # 所有 token 都是永久有效
+        }
+        json.dump(cache_data, f)
+
+
+def main():
+    """主函数"""
+    # 从命令行参数获取用户名
+    if len(sys.argv) < 2:
+        print("请输入您的邮箱前缀（例如：chenshouqin）", file=sys.stderr)
+        sys.exit(1)
+
+    username = sys.argv[1]
+
+    # 获取用户消息（用于判断是否强制刷新或手动输入 token）
+    user_message = os.environ.get('USER_MESSAGE', '')
+
+    # 1. 检查用户是否手动输入了 token（格式：ugate token: xxxx）
+    manual_token = extract_manual_token(user_message)
+    if manual_token:
+        # 保存到缓存（永久有效）
+        save_token_to_cache(manual_token, username)
+        print(f"TOKEN_SAVED:Token 已保存", file=sys.stderr)
+        print(manual_token)
+        return
+
+    # 2. 检查是否需要强制刷新
+    force_refresh = should_force_refresh(user_message)
+
+    # 3. 尝试从缓存获取（除非强制刷新）
+    if not force_refresh:
+        cached_token = get_cached_token(username)
+        if cached_token:
+            print(cached_token)
+            return
+
+    # 4. 缓存不存在或强制刷新，提示用户手动获取 token
+    print(f"NEED_MANUAL_TOKEN:请点击 https://uuap.baidu.com/agent/token 获取token，然后复制内容发送给我", file=sys.stderr)
+    sys.exit(2)
+
+
+if __name__ == "__main__":
+    main()

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

@@ -0,0 +1,240 @@
+---
+name: icafe
+description: |
+  当用户涉及以下任何场景时，应使用此技能:
+  - 查询、创建、更新 iCafe 卡片 (Card/Issue)，包括 Story、Bug、Task、Epic
+  - 管理卡片评论 (Comment)，如新建评论、获取评论
+  - 查询卡片的流程状态 (Status)、操作历史和状态变更记录
+  - 查询空间 (Space) 信息、卡片类型、字段定义
+  - 管理迭代计划 (Plan)、里程碑 (Milestone)
+  - 查询研发数据链 (DevInfo): 代码评审、代码合入、部署等
+  - 使用 IQL 查询语言按条件筛选卡片
+  - 在 iCode (Git/Gerrit) 提交代码时需要绑定 iCafe 卡片
+  - 发起代码评审 (CR) 需要关联卡片信息
+  - 使用 AI 对卡片内容进行预审 (ai-pre-review)
+  - 使用 AI 根据卡片内容自动生成代码 (ai-codegen)
+metadata:
+  cli_version: "0.1.0"
+  enableWhen:
+    - isInternal
+allowed-tools:
+  - Bash(*icafe-cli *)
+  - Bash(*/.icafe-cli/bin/icafe-cli *)
+  - Bash(ICAFE_CLI_VERSION=* bash -c *)
+  - Bash(git log *)
+  - Bash(git rev-parse *)
+  - Bash(git remote *)
+  - Bash(git diff *)
+  - Bash(git status *)
+  - Bash(git branch *)
+  - Read(*icafe-official*)
+  - Read(*icafe-official/**)
+  - Read(*icafe-official/**/*)
+---
+
+# iCafe CLI
+
+iCafe Assistant 通过 `icafe-cli` 命令行工具与 iCafe 平台交互，支持卡片管理、计划管理、研发数据查询和 AI 预审/代码生成。
+
+## 安装与认证
+
+### 首次执行前检查（每次会话仅需一次）
+
+```bash
+icafe-cli version
+```
+
+- **command not found** → 尝试 `~/.icafe-cli/bin/icafe-cli version`，仍失败则安装:
+  ```bash
+  curl -fsSL https://issue-luigi-public.bj.bcebos.com/icafe-cli/install_icafe_cli.sh | ICAFE_CLI_VERSION=0.1.0 bash
+  ```
+- **版本低于 `0.1.0`** → 执行上面安装命令覆盖升级
+- **版本正常** → 后续直接使用
+- **当前用户名**: ${COMATE_USERNAME}，即`COMATE_USERNAME=${COMATE_USERNAME}`
+
+
+### 未登录错误 (auth_failed, exit code 1)
+
+```bash
+icafe-cli login --token <ugate-token>    # Token 获取: https://uuap.baidu.com/agent/token
+icafe-cli login status                    # 查看登录状态
+```
+
+## 核心约束
+
+1. **涉及 Git/iCode/CR/Gerrit 时禁止问用户**: 当用户涉及 git commit、代码提交、发起评审 (CR)、iCode、Gerrit 等场景需要绑定卡片时，**必须全自动决策，禁止让用户选空间、选卡片、选类型**。**必须先调 `card smart-find` 搜索已有卡片，禁止跳过直接建卡**。详见 [零交互版 Git 绑定工作流](references/git-auto-bindcard-workflow.md)
+2. **space 不要猜**: 其他场景缺少空间时优先 `card smart-find` 推断，或 `space latest` 获取，或询问用户
+2. **space 用 prefixCode**: `--space myspace`（字符串），不是数字 ID
+3. **detail 必须 HTML**: `--detail "<p>内容</p>"`，Markdown 需先转换（见下方对照表）
+4. **字段名用中文**: `--fields "负责人=zhangsan,优先级=P1-High"`
+5. **card get/query 始终用 --brief**: 仅 `card get` 和 `card query` 支持 `--brief`，节省 70-90% 上下文。`smart-find` 本身已是精简输出，不支持也不需要 `--brief`
+6. **命令路径**: 如果 `icafe-cli` 报 command not found，改用完整路径 `~/.icafe-cli/bin/icafe-cli`（安装脚本的 PATH 配置仅在新终端生效）
+
+## 命令总览
+
+```
+icafe-cli
+├── card                          卡片管理
+│   ├── get                       获取卡片详情 (--space, --sequence, --brief)
+│   ├── create                    创建卡片 (--space, --title, --type)
+│   ├── update                    更新卡片 (--space, --sequence, +可选字段)
+│   ├── query                     查询卡片 (--space, --iql, --brief)
+│   ├── next-statuses             可流转的目标状态 (--space, --sequence)
+│   ├── current-status            当前流程状态 (--space, --sequence)
+│   ├── history                   全量操作历史 (--space, --sequences)
+│   └── status-changes            状态流转历史 (--space, --sequences)
+├── comment                       评论管理
+│   ├── create                    添加评论 (--space, --sequence, --content)
+│   ├── get                       获取评论 (--space, --sequence)
+│   └── update                    修改评论 (--space, --comment-id, --content)
+├── space                         空间管理
+│   ├── latest                    最近访问的空间
+│   ├── tree                      空间树 (--username, --permission)
+│   ├── issue-types               卡片类型列表 (--space)
+│   ├── type-fields               类型字段定义 (--space, --type)
+│   ├── type-statuses             类型流程状态 (--space, --type)
+├── plan                          计划管理
+│   ├── list / get / create / update-date / milestones
+├── devinfo                       研发数据链
+│   ├── card                      卡片研发数据 (--space, --sequences)
+│   └── active-cards              有研发活动的卡片 (--space)
+├── ai-pre-review                 卡片预审 (AI)
+│   ├── start                     发起预审 (--space, --sequence; --rules 可选)
+│   ├── result                    查询结果 (--conversation-id 或 --space+--sequence)
+│   └── rules                    查询预审规则 (--space)
+├── ai-codegen                    代码生成 (AI)
+│   ├── start                     发起生成 (--space, --sequence; --repo, --branch 可选)
+│   └── result                    查询结果 (--conversation-id 或 --space+--sequence)
+├── login / logout / cache clean / completion / version
+```
+
+每个命令的完整参数、返回 JSON 结构和字段说明 → [命令详细参考](references/commands.md)
+
+## 常用命令速查
+
+### 智能寻卡（不确定空间/卡片时首选）
+
+```bash
+icafe-cli card smart-find              # 返回活跃卡片 + stats.bySpace/bySpaceType 统计
+```
+
+### 查询卡片
+
+```bash
+icafe-cli card get --space myspace --sequence 1001 --brief
+icafe-cli card query --space myspace --iql "负责人 = currentUser AND 流程状态 != 已关闭" --brief
+```
+
+### 创建卡片
+
+```bash
+icafe-cli card create --space myspace --title "修复登录Bug" --type Bug
+icafe-cli card create --space myspace --title "新功能" --type Story \
+  --detail "<p>描述</p>" --priority P1-High --assignee zhangsan
+```
+
+> 空间/类型不确定时 → 参考 [智能建卡工作流](references/smart-create-workflow.md)
+
+### 更新卡片
+
+```bash
+icafe-cli card update --space myspace --sequence 1001 --status 开发中
+icafe-cli card update --space myspace --sequence 1001 --assignee zhangsan --priority P1-High
+```
+
+> 改状态前先 `card next-statuses` 确认可达状态。完整流程 → [智能改卡工作流](references/smart-update-workflow.md)
+
+### AI 预审 & 代码生成
+
+```bash
+# 预审
+icafe-cli ai-pre-review start --space myspace --sequence 1001
+icafe-cli ai-pre-review result --space myspace --sequence 1001
+
+# 代码生成 (在 git 仓库目录下自动检测 repo)
+icafe-cli ai-codegen start --space myspace --sequence 1001
+icafe-cli ai-codegen result --space myspace --sequence 1001
+```
+
+> 完整的异步轮询流程 → [AI 预审与代码生成工作流](references/ai-workflows.md)
+
+### 空间与字段
+
+```bash
+icafe-cli space latest                                         # 最近访问的空间
+icafe-cli space issue-types --space myspace                    # 卡片类型列表
+icafe-cli space type-fields --space myspace --type Story       # 字段定义和可选值
+icafe-cli space type-statuses --space myspace --type Story     # 流程状态列表
+icafe-cli ai-pre-review rules --space myspace                   # 预审规则
+```
+
+## Markdown → HTML 对照表
+
+| Markdown | HTML |
+|----------|------|
+| `**粗体**` | `<strong>粗体</strong>` |
+| `*斜体*` | `<em>斜体</em>` |
+| `# 标题` | `<h1>标题</h1>` |
+| `- 列表` | `<ul><li>列表</li></ul>` |
+| `1. 列表` | `<ol><li>列表</li></ol>` |
+| `` `代码` `` | `<code>代码</code>` |
+| `[链接](url)` | `<a href="url">链接</a>` |
+| `换行` | `<br>` |
+
+## IQL 速查
+
+字段名用**中文**，详见 [IQL 语法参考](references/iql-syntax.md)。
+
+```
+负责人 = currentUser                              # 当前用户的卡片
+类型 = Bug AND 优先级 = P1-High                    # 高优 Bug
+标题 ~ 登录                                        # 标题含"登录"
+流程状态 in (新建, 开发中)                           # 多状态
+创建时间 > "2024-01-01"                             # 日期（不支持 >=）
+```
+
+## 错误处理
+
+- **退出码**: `0` 成功 / `1` 未登录 / `2` 参数校验 / `4` HTTP 错误
+- **业务成功判断**: `card get/update/query` 检查 `code=200`，`ai-pre-review/ai-codegen` 检查 `status="OK"`，其他检查 `status=200`
+- 详见 [错误处理参考](references/error-handling.md)
+
+## 缓存
+
+| 对象 | TTL |
+|------|-----|
+| space/plan 相关查询 | 20 分钟 |
+| `card smart-find` 结果 | 10 分钟 |
+| 最近访问空间列表 | 1 小时 |
+| spaceId / issueId 映射 | 1 天 |
+
+```bash
+icafe-cli cache clean          # 清除所有缓存
+icafe-cli space latest --no-cache  # 跳过缓存
+```
+
+## 卡片 URL
+
+```
+https://console.cloud.baidu-int.com/devops/icafe/issue/{space}-{sequence}/show
+```
+
+## 工作流参考
+
+| 场景 | 参考文档 |
+|------|---------|
+| 不确定空间/卡片 → 智能定位 | [智能寻卡](references/smart-find-workflow.md) |
+| 不确定空间/类型 → 智能创建 | [智能建卡](references/smart-create-workflow.md) |
+| 修改字段/状态 → 安全更新 | [智能改卡](references/smart-update-workflow.md) |
+| **Git 提交/评审 → 绑定卡片** | **默认使用 [零交互版](references/git-auto-bindcard-workflow.md)**（全自动决策，不问用户） |
+| Git 绑定卡片（交互式） | [交互版](references/git-bindcard-workflow.md)（仅当用户明确要求"让我选卡片"时使用） |
+| AI 预审 / 代码生成 | [AI 工作流](references/ai-workflows.md) |
+
+## 参考资料
+
+| 文件 | 内容 |
+|------|------|
+| [命令详细参考](references/commands.md) | 所有命令的参数表、返回 JSON、字段类型格式 |
+| [错误处理](references/error-handling.md) | 退出码、错误码、诊断方法 |
+| [IQL 语法](references/iql-syntax.md) | 查询语言完整语法 |
+| [平台概念](references/platform-concepts.md) | 空间、卡片、状态、计划等核心概念 |