npm - cvte-skills-cli - Versions diffs - 1.0.0 - Mend

cvte-skills-cli 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (12) hide show

package/README.md +173 -0
package/bin/cli.js +62 -0
package/lib/index.js +141 -0
package/lib/installers/claude.js +83 -0
package/lib/installers/codex.js +44 -0
package/lib/installers/copilot.js +38 -0
package/lib/installers/cursor.js +43 -0
package/lib/installers/gemini.js +44 -0
package/lib/installers/windsurf.js +40 -0
package/package.json +37 -0
package/skills/analysis-opensdk-api/SKILL.md +161 -0
package/skills/gitlab-commit-message/SKILL.md +95 -0

package/README.md ADDED Viewed

@@ -0,0 +1,173 @@
+# CVTE Skills CLI
+一个用于安装自定义 AI 编程助手 Skills 的 CLI 工具，支持多种 AI 助手。
+## 支持的 AI 助手
+| 助手 | 配置文件位置 |
+|------|-------------|
+| Claude Code | `~/.claude/settings.json` (全局) / `CLAUDE.md` (项目) |
+| Cursor | `~/.cursor/rules` (全局) / `.cursorrules` (项目) |
+| Windsurf | `~/.windsurf/rules` (全局) / `.windsurfrules` (项目) |
+| GitHub Copilot | `.github/copilot-instructions.md` |
+| Codex CLI | `~/.codex/instructions.md` (全局) / `codex.md` (项目) |
+| Gemini CLI | `~/.gemini/instructions.md` (全局) / `GEMINI.md` (项目) |
+## 包含的 Skills
+| Skill | 描述 |
+|-------|------|
+| `gitlab-commit-message` | Git commit message 模板规范，强制使用标准化的提交信息格式 |
+| `analysis-opensdk-api` | OpenSDK API 调用链分析工具，用于追踪 SDK 调用流程 |
+## 安装
+### 通过 npm 全局安装
+```bash
+npm install -g cvte-skills-cli
+```
+### 从源码安装
+```bash
+git clone https://github.com/YOUR_USERNAME/skills.git
+cd skills
+npm install
+npm link
+```
+## 使用方法
+### 初始化 Skills
+```bash
+# 进入你的项目目录
+cd /path/to/your/project
+# 为指定 AI 助手安装 skills
+cvte-skills init --ai claude      # Claude Code
+cvte-skills init --ai cursor      # Cursor
+cvte-skills init --ai windsurf    # Windsurf
+cvte-skills init --ai copilot     # GitHub Copilot
+cvte-skills init --ai codex       # Codex CLI
+cvte-skills init --ai gemini      # Gemini CLI
+cvte-skills init --ai all         # 所有助手
+```
+### 全局安装
+```bash
+# 安装到全局配置（而非项目级）
+cvte-skills init --ai claude --global
+cvte-skills init --ai cursor --global
+```
+### 选择特定 Skills
+```bash
+# 只安装指定的 skills
+cvte-skills init --ai claude -s gitlab-commit-message
+cvte-skills init --ai cursor -s gitlab-commit-message analysis-opensdk-api
+```
+### 查看可用 Skills
+```bash
+cvte-skills list
+```
+### 移除 Skills
+```bash
+cvte-skills remove --ai claude
+```
+## 命令参考
+```
+cvte-skills init [options]
+  --ai <assistant>       目标 AI 助手 (claude, cursor, windsurf, copilot, codex, gemini, all)
+  --global               安装到全局配置
+  -s, --skills <names>   指定要安装的 skills
+cvte-skills list         列出所有可用的 skills
+cvte-skills remove       移除已安装的 skills
+  --ai <assistant>       目标 AI 助手
+```
+## 项目结构
+```
+skills/
+├── package.json
+├── bin/
+│   └── cli.js              # CLI 入口
+├── lib/
+│   ├── index.js            # 核心逻辑
+│   └── installers/         # 各 AI 助手的安装器
+│       ├── claude.js
+│       ├── cursor.js
+│       ├── windsurf.js
+│       ├── copilot.js
+│       ├── codex.js
+│       └── gemini.js
+└── skills/                 # Skill 定义
+    ├── gitlab-commit-message/
+    │   └── SKILL.md
+    └── analysis-opensdk-api/
+        └── SKILL.md
+```
+## 创建新 Skill
+1. 在 `skills/` 目录下创建新文件夹
+2. 添加 `SKILL.md` 文件，格式如下：
+```markdown
+---
+name: my-skill
+description: "Skill 的简短描述"
+---
+# Skill 标题
+## 使用说明
+...
+## 示例
+...
+```
+3. 重新发布或本地 link 后即可使用
+## 手动安装（不使用 CLI）
+如果不想使用 CLI，也可以手动配置：
+### Claude Code
+```bash
+# 方式1: 使用 claude 命令
+claude config add skills /path/to/skills/skills/gitlab-commit-message
+# 方式2: 编辑 ~/.claude/settings.json
+{
+  "skills": [
+    "/path/to/skills/skills/gitlab-commit-message"
+  ]
+}
+```
+### Cursor
+将 skill 内容复制到项目根目录的 `.cursorrules` 文件中。
+### GitHub Copilot
+将 skill 内容复制到 `.github/copilot-instructions.md` 文件中。
+## 许可证
+MIT

package/bin/cli.js ADDED Viewed

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { initSkills, listSkills, removeSkills } from '../lib/index.js';
+const program = new Command();
+program
+  .name('cvte-skills')
+  .description('Install custom skills for AI coding assistants')
+  .version('1.0.0');
+program
+  .command('init')
+  .description('Initialize skills for an AI assistant')
+  .option('--ai <assistant>', 'Target AI assistant (claude, cursor, windsurf, copilot, codex, all)')
+  .option('--global', 'Install to global config instead of project')
+  .option('-s, --skills <skills...>', 'Specific skills to install (default: all)')
+  .action(async (options) => {
+    if (!options.ai) {
+      console.log(chalk.red('Error: Please specify an AI assistant with --ai'));
+      console.log(chalk.gray('Available: claude, cursor, windsurf, copilot, codex, gemini, all'));
+      process.exit(1);
+    }
+    try {
+      await initSkills(options);
+      console.log(chalk.green('✓ Skills installed successfully!'));
+    } catch (error) {
+      console.error(chalk.red('Error:'), error.message);
+      process.exit(1);
+    }
+  });
+program
+  .command('list')
+  .description('List available skills')
+  .action(() => {
+    listSkills();
+  });
+program
+  .command('remove')
+  .description('Remove installed skills')
+  .option('--ai <assistant>', 'Target AI assistant')
+  .action(async (options) => {
+    if (!options.ai) {
+      console.log(chalk.red('Error: Please specify an AI assistant with --ai'));
+      process.exit(1);
+    }
+    try {
+      await removeSkills(options);
+      console.log(chalk.green('✓ Skills removed successfully!'));
+    } catch (error) {
+      console.error(chalk.red('Error:'), error.message);
+      process.exit(1);
+    }
+  });
+program.parse();

package/lib/index.js ADDED Viewed

@@ -0,0 +1,141 @@
+import fs from 'fs-extra';
+import path from 'path';
+import chalk from 'chalk';
+import { fileURLToPath } from 'url';
+import { installForClaude } from './installers/claude.js';
+import { installForCursor } from './installers/cursor.js';
+import { installForWindsurf } from './installers/windsurf.js';
+import { installForCopilot } from './installers/copilot.js';
+import { installForCodex } from './installers/codex.js';
+import { installForGemini } from './installers/gemini.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+// 获取 skills 目录
+export function getSkillsDir() {
+  return path.join(__dirname, '..', 'skills');
+}
+// 获取所有可用的 skills
+export function getAvailableSkills() {
+  const skillsDir = getSkillsDir();
+  const skills = [];
+  if (!fs.existsSync(skillsDir)) {
+    return skills;
+  }
+  const dirs = fs.readdirSync(skillsDir, { withFileTypes: true });
+  for (const dir of dirs) {
+    if (dir.isDirectory()) {
+      const skillPath = path.join(skillsDir, dir.name, 'SKILL.md');
+      if (fs.existsSync(skillPath)) {
+        const content = fs.readFileSync(skillPath, 'utf-8');
+        const meta = parseSkillMeta(content);
+        skills.push({
+          name: dir.name,
+          path: path.join(skillsDir, dir.name),
+          skillFile: skillPath,
+          content: content,
+          ...meta
+        });
+      }
+    }
+  }
+  return skills;
+}
+// 解析 SKILL.md 的 frontmatter
+function parseSkillMeta(content) {
+  const match = content.match(/^---\s*\n([\s\S]*?)\n---/);
+  if (!match) return {};
+  const frontmatter = match[1];
+  const meta = {};
+  const nameMatch = frontmatter.match(/name:\s*(.+)/);
+  if (nameMatch) meta.displayName = nameMatch[1].trim();
+  const descMatch = frontmatter.match(/description:\s*["']?(.+?)["']?\s*$/m);
+  if (descMatch) meta.description = descMatch[1].trim();
+  return meta;
+}
+// 获取 skill 的纯内容（去掉 frontmatter）
+export function getSkillContent(skill) {
+  return skill.content.replace(/^---\s*\n[\s\S]*?\n---\s*\n?/, '').trim();
+}
+// 列出所有 skills
+export function listSkills() {
+  const skills = getAvailableSkills();
+  console.log(chalk.bold('\nAvailable Skills:\n'));
+  if (skills.length === 0) {
+    console.log(chalk.gray('  No skills found'));
+    return;
+  }
+  for (const skill of skills) {
+    console.log(chalk.cyan(`  ${skill.name}`));
+    if (skill.description) {
+      console.log(chalk.gray(`    ${skill.description}`));
+    }
+    console.log();
+  }
+}
+// 安装器映射
+const installers = {
+  claude: installForClaude,
+  cursor: installForCursor,
+  windsurf: installForWindsurf,
+  copilot: installForCopilot,
+  codex: installForCodex,
+  gemini: installForGemini,
+};
+// 初始化 skills
+export async function initSkills(options) {
+  const { ai, global: isGlobal, skills: selectedSkills } = options;
+  let allSkills = getAvailableSkills();
+  // 过滤指定的 skills
+  if (selectedSkills && selectedSkills.length > 0) {
+    allSkills = allSkills.filter(s => selectedSkills.includes(s.name));
+  }
+  if (allSkills.length === 0) {
+    throw new Error('No skills found to install');
+  }
+  console.log(chalk.blue(`\nInstalling ${allSkills.length} skill(s)...\n`));
+  const targets = ai === 'all' ? Object.keys(installers) : [ai];
+  for (const target of targets) {
+    const installer = installers[target];
+    if (!installer) {
+      console.log(chalk.yellow(`  ⚠ Unknown assistant: ${target}, skipping`));
+      continue;
+    }
+    console.log(chalk.gray(`  → Installing for ${target}...`));
+    await installer(allSkills, { isGlobal });
+    console.log(chalk.green(`  ✓ ${target}`));
+  }
+}
+// 移除 skills
+export async function removeSkills(options) {
+  const { ai } = options;
+  // TODO: 实现移除逻辑
+  console.log(chalk.yellow('Remove functionality coming soon...'));
+}

package/lib/installers/claude.js ADDED Viewed

@@ -0,0 +1,83 @@
+import fs from 'fs-extra';
+import path from 'path';
+import os from 'os';
+import { getSkillsDir } from '../index.js';
+/**
+ * Claude Code 安装器
+ *
+ * Claude Code 支持两种方式：
+ * 1. 全局配置: ~/.claude/settings.json 中的 skills 数组（路径引用）
+ * 2. 项目级: .claude/settings.json 或直接写入 CLAUDE.md
+ */
+export async function installForClaude(skills, options = {}) {
+  const { isGlobal = false } = options;
+  if (isGlobal) {
+    // 全局安装：添加 skill 路径到 settings.json
+    await installGlobal(skills);
+  } else {
+    // 项目级安装：写入 CLAUDE.md
+    await installProject(skills);
+  }
+}
+async function installGlobal(skills) {
+  const settingsPath = path.join(os.homedir(), '.claude', 'settings.json');
+  // 确保目录存在
+  await fs.ensureDir(path.dirname(settingsPath));
+  let settings = {};
+  if (await fs.pathExists(settingsPath)) {
+    try {
+      settings = await fs.readJson(settingsPath);
+    } catch {
+      settings = {};
+    }
+  }
+  // 初始化 skills 数组
+  if (!Array.isArray(settings.skills)) {
+    settings.skills = [];
+  }
+  // 添加 skill 路径
+  for (const skill of skills) {
+    if (!settings.skills.includes(skill.path)) {
+      settings.skills.push(skill.path);
+    }
+  }
+  await fs.writeJson(settingsPath, settings, { spaces: 2 });
+}
+async function installProject(skills) {
+  const claudeDir = path.join(process.cwd(), '.claude');
+  const claudeMdPath = path.join(process.cwd(), 'CLAUDE.md');
+  // 方式1: 写入 CLAUDE.md（推荐）
+  let content = '';
+  if (await fs.pathExists(claudeMdPath)) {
+    content = await fs.readFile(claudeMdPath, 'utf-8');
+    content += '\n\n';
+  }
+  // 添加分隔标记
+  content += '<!-- cvte-skills-start -->\n';
+  content += '# Custom Skills\n\n';
+  for (const skill of skills) {
+    const skillContent = await fs.readFile(skill.skillFile, 'utf-8');
+    // 去掉 frontmatter
+    const cleanContent = skillContent.replace(/^---\s*\n[\s\S]*?\n---\s*\n?/, '').trim();
+    content += `## ${skill.displayName || skill.name}\n\n`;
+    content += cleanContent;
+    content += '\n\n';
+  }
+  content += '<!-- cvte-skills-end -->\n';
+  await fs.writeFile(claudeMdPath, content);
+}

package/lib/installers/codex.js ADDED Viewed

@@ -0,0 +1,44 @@
+import fs from 'fs-extra';
+import path from 'path';
+import os from 'os';
+/**
+ * OpenAI Codex CLI 安装器
+ *
+ * Codex 使用:
+ * - 全局: ~/.codex/instructions.md
+ * - 项目级: codex.md 或 AGENTS.md
+ */
+export async function installForCodex(skills, options = {}) {
+  const { isGlobal = false } = options;
+  const targetPath = isGlobal
+    ? path.join(os.homedir(), '.codex', 'instructions.md')
+    : path.join(process.cwd(), 'codex.md');
+  await fs.ensureDir(path.dirname(targetPath));
+  let content = '';
+  if (await fs.pathExists(targetPath)) {
+    content = await fs.readFile(targetPath, 'utf-8');
+    content = content.replace(/<!-- cvte-skills-start -->[\s\S]*?<!-- cvte-skills-end -->\n?/g, '');
+    content = content.trim();
+    if (content) content += '\n\n';
+  }
+  content += '<!-- cvte-skills-start -->\n';
+  content += '# Custom Skills\n\n';
+  for (const skill of skills) {
+    const skillContent = await fs.readFile(skill.skillFile, 'utf-8');
+    const cleanContent = skillContent.replace(/^---\s*\n[\s\S]*?\n---\s*\n?/, '').trim();
+    content += `## ${skill.displayName || skill.name}\n\n`;
+    content += cleanContent;
+    content += '\n\n';
+  }
+  content += '<!-- cvte-skills-end -->\n';
+  await fs.writeFile(targetPath, content);
+}

package/lib/installers/copilot.js ADDED Viewed

@@ -0,0 +1,38 @@
+import fs from 'fs-extra';
+import path from 'path';
+/**
+ * GitHub Copilot 安装器
+ *
+ * Copilot 使用 .github/copilot-instructions.md 文件
+ */
+export async function installForCopilot(skills, options = {}) {
+  const targetDir = path.join(process.cwd(), '.github');
+  const targetPath = path.join(targetDir, 'copilot-instructions.md');
+  await fs.ensureDir(targetDir);
+  let content = '';
+  if (await fs.pathExists(targetPath)) {
+    content = await fs.readFile(targetPath, 'utf-8');
+    content = content.replace(/<!-- cvte-skills-start -->[\s\S]*?<!-- cvte-skills-end -->\n?/g, '');
+    content = content.trim();
+    if (content) content += '\n\n';
+  }
+  content += '<!-- cvte-skills-start -->\n';
+  content += '# Custom Skills\n\n';
+  for (const skill of skills) {
+    const skillContent = await fs.readFile(skill.skillFile, 'utf-8');
+    const cleanContent = skillContent.replace(/^---\s*\n[\s\S]*?\n---\s*\n?/, '').trim();
+    content += `## ${skill.displayName || skill.name}\n\n`;
+    content += cleanContent;
+    content += '\n\n';
+  }
+  content += '<!-- cvte-skills-end -->\n';
+  await fs.writeFile(targetPath, content);
+}

package/lib/installers/cursor.js ADDED Viewed

@@ -0,0 +1,43 @@
+import fs from 'fs-extra';
+import path from 'path';
+import os from 'os';
+/**
+ * Cursor 安装器
+ *
+ * Cursor 使用 .cursorrules 或 .cursor/rules 文件
+ */
+export async function installForCursor(skills, options = {}) {
+  const { isGlobal = false } = options;
+  const targetPath = isGlobal
+    ? path.join(os.homedir(), '.cursor', 'rules')
+    : path.join(process.cwd(), '.cursorrules');
+  // 确保目录存在
+  await fs.ensureDir(path.dirname(targetPath));
+  let content = '';
+  if (await fs.pathExists(targetPath)) {
+    content = await fs.readFile(targetPath, 'utf-8');
+    // 移除旧的 skills 内容
+    content = content.replace(/<!-- cvte-skills-start -->[\s\S]*?<!-- cvte-skills-end -->\n?/g, '');
+    content = content.trim();
+    if (content) content += '\n\n';
+  }
+  // 添加 skills
+  content += '<!-- cvte-skills-start -->\n';
+  for (const skill of skills) {
+    const skillContent = await fs.readFile(skill.skillFile, 'utf-8');
+    const cleanContent = skillContent.replace(/^---\s*\n[\s\S]*?\n---\s*\n?/, '').trim();
+    content += cleanContent;
+    content += '\n\n';
+  }
+  content += '<!-- cvte-skills-end -->\n';
+  await fs.writeFile(targetPath, content);
+}

package/lib/installers/gemini.js ADDED Viewed

@@ -0,0 +1,44 @@
+import fs from 'fs-extra';
+import path from 'path';
+import os from 'os';
+/**
+ * Google Gemini CLI 安装器
+ *
+ * Gemini CLI 使用:
+ * - 全局: ~/.gemini/instructions.md
+ * - 项目级: GEMINI.md
+ */
+export async function installForGemini(skills, options = {}) {
+  const { isGlobal = false } = options;
+  const targetPath = isGlobal
+    ? path.join(os.homedir(), '.gemini', 'instructions.md')
+    : path.join(process.cwd(), 'GEMINI.md');
+  await fs.ensureDir(path.dirname(targetPath));
+  let content = '';
+  if (await fs.pathExists(targetPath)) {
+    content = await fs.readFile(targetPath, 'utf-8');
+    content = content.replace(/<!-- cvte-skills-start -->[\s\S]*?<!-- cvte-skills-end -->\n?/g, '');
+    content = content.trim();
+    if (content) content += '\n\n';
+  }
+  content += '<!-- cvte-skills-start -->\n';
+  content += '# Custom Skills\n\n';
+  for (const skill of skills) {
+    const skillContent = await fs.readFile(skill.skillFile, 'utf-8');
+    const cleanContent = skillContent.replace(/^---\s*\n[\s\S]*?\n---\s*\n?/, '').trim();
+    content += `## ${skill.displayName || skill.name}\n\n`;
+    content += cleanContent;
+    content += '\n\n';
+  }
+  content += '<!-- cvte-skills-end -->\n';
+  await fs.writeFile(targetPath, content);
+}

package/lib/installers/windsurf.js ADDED Viewed

@@ -0,0 +1,40 @@
+import fs from 'fs-extra';
+import path from 'path';
+import os from 'os';
+/**
+ * Windsurf 安装器
+ *
+ * Windsurf 使用 .windsurfrules 文件
+ */
+export async function installForWindsurf(skills, options = {}) {
+  const { isGlobal = false } = options;
+  const targetPath = isGlobal
+    ? path.join(os.homedir(), '.windsurf', 'rules')
+    : path.join(process.cwd(), '.windsurfrules');
+  await fs.ensureDir(path.dirname(targetPath));
+  let content = '';
+  if (await fs.pathExists(targetPath)) {
+    content = await fs.readFile(targetPath, 'utf-8');
+    content = content.replace(/<!-- cvte-skills-start -->[\s\S]*?<!-- cvte-skills-end -->\n?/g, '');
+    content = content.trim();
+    if (content) content += '\n\n';
+  }
+  content += '<!-- cvte-skills-start -->\n';
+  for (const skill of skills) {
+    const skillContent = await fs.readFile(skill.skillFile, 'utf-8');
+    const cleanContent = skillContent.replace(/^---\s*\n[\s\S]*?\n---\s*\n?/, '').trim();
+    content += cleanContent;
+    content += '\n\n';
+  }
+  content += '<!-- cvte-skills-end -->\n';
+  await fs.writeFile(targetPath, content);
+}

package/package.json ADDED Viewed

@@ -0,0 +1,37 @@
+{
+  "name": "cvte-skills-cli",
+  "version": "1.0.0",
+  "description": "CLI tool to install custom skills for AI coding assistants",
+  "type": "module",
+  "main": "lib/index.js",
+  "bin": {
+    "cvte-skills": "./bin/cli.js"
+  },
+  "scripts": {
+    "test": "echo \"No tests yet\""
+  },
+  "keywords": [
+    "claude",
+    "cursor",
+    "copilot",
+    "ai",
+    "skills",
+    "cli"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "commander": "^12.0.0",
+    "chalk": "^5.3.0",
+    "fs-extra": "^11.2.0",
+    "inquirer": "^9.2.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "bin",
+    "lib",
+    "skills"
+  ]
+}

package/skills/analysis-opensdk-api/SKILL.md ADDED Viewed

@@ -0,0 +1,161 @@
+---
+  name: analysis-opensdk-api
+  description: Analyze OpenSDK-initiated API call chains across source app → OpenSDK3.0 → UdiServer → UdiServiceCore. Use when tracing SDKSystemHelper/SDK* calls, Cmd* requests, or
+  UDI API URIs from app side. Produce a call-chain flow diagram and file/line references.
+  ---
+  # OpenSDK API Chain Analysis
+  ## Prerequisites
+  - User must provide or have configured project paths:
+    - SeewoOTA: Android OTA app(other source apps)
+    - OpenSDK3.0: SDK layer
+    - UdiServer: OpenSDK service bridge
+    - UdiServiceCore: UDI implementation
+  - If paths not provided, ask user before proceeding.
+  ## References
+  - OpenSDK3.0: /Users/cvte/Documents/android/project/seewo/OpenSDK3.0/OpenSDK3.0
+  - UdiServer: /Users/cvte/Documents/android/project/udi/UdiServer
+  - UdiServiceCore: /Users/cvte/Documents/android/project/udi/UdiServiceCore
+  ## Scope
+  - Trace forward: App/SeewoOTA → OpenSDK3.0 → UdiServer → UdiServiceCore.
+  - Stop at these boundaries and note the final action:
+    - **Shell**: command string (e.g., `ffp_tool`, `eUpdate2`)
+    - **VMan**: FwUpgradeManager type (e.g., `TYPE_FW_UPGRADE_TOUCHBIN`)
+    - **JNI**: McutouchManager method (e.g., `upgradeTouch`)
+    - **System Service**: Intent/ComponentName (e.g., TouchPanelService)
+    - **TvApi**: ITvApiManager method
+  - Do not assume external services exist; only include if chain explicitly reaches them.
+  ## Inputs to collect
+  - Entry keyword (API name, Cmd class, or URI), e.g. `upgradeTouch`, `CmdUpgradeTouch`, `/v1/touch/ota/upgrade`.
+  - Target app module: SeewoOTA (the usual entry point).
+  ## Workflow
+  ### 0) Check for VMan architecture (Android 14+)
+  - Search for VMan-based tasks:
+    - `Grep pattern="VmanUpdateTask|BaseVmanUpdateTask" path=<SeewoOTA_path>`
+  - If found, note that the chain may use VMan SDK directly for version checking.
+  ### 1) Find app entry points (SeewoOTA)
+  - Search for SDK calls:
+    - `Grep pattern="SDKSystemHelper\.I\.|OpenSDK\.getInstance" path=<SeewoOTA_path>`
+  - If you have a method name, search directly:
+    - `Grep pattern="<keyword>" path=<SeewoOTA_path>`
+  - Record: caller class/method, dialog/trigger path, and any pre-checks.
+  ### 1.5) Check config gates
+  - Search for config flags:
+    - `Grep pattern="R\.bool\.|R\.string\." path=<SeewoOTA_path>/src/main`
+  - Check `strings_config.xml` for defaults and flavor overrides.
+  - Record: config flag name, default value, controlling flavors.
+  ### 2) Map to OpenSDK3.0
+  - Locate SDK method in `SDKSystemHelper.java`:
+    - `Grep pattern="<method>\(" path=<OpenSDK_path>/src/main/java/com/seewo/sdk/SDKSystemHelper.java`
+  - Open the Cmd class and note its fields.
+  - Record: `SDKSystemHelper.<method>` → `Cmd*` → `OpenSDK.postCommand/sendCommand`.
+  ### 3) Map to UdiServer
+  - Search for Cmd class:
+    - `Grep pattern="Cmd<Name>" path=<UdiServer_path>`
+  - Identify handler method (`@HandlePostRequest`, `@HandleGetRequest`, `@HandleRequest`).
+  - Note the UDI URI in `RequestBuilder`.
+  - Record: handler class/method, request URI, event adapters.
+  ### 4) Map to UdiServiceCore
+  - Find URI in `ProtocolDefine.kt`:
+    - `Grep pattern="/v1/.*" path=<UdiServiceCore_path>/.../ProtocolDefine.kt`
+  - Find `@SetterHandler`/`@GetterHandler` in service core.
+  - Trace into implementation class and capture branching logic.
+  - Record: service method, implementation class, branch rules, final action.
+  ### 4.5) Trace result/status notifications
+  - Check for related notify endpoints:
+    - `Grep pattern="<base_uri>/(result|status)" path=<UdiServiceCore_path>`
+  - Record: result URI, notify class, callback mechanism.
+  ### 5) Summarize and diagram
+  - Provide bullet call chain with file paths + line numbers.
+  - Provide ASCII flow diagram.
+  - Include branch rules if applicable.
+  - Note boundary and final action type.
+  ## Output format
+  ### Structure
+  1. Short intro: what chain traced and entry keyword.
+  2. Call-chain bullets (with file:line refs).
+  3. Flow diagram (ASCII).
+  4. Boundary note with final action type.
+  ### Flow diagram templates
+  #### Linear chain
+  ┌───────────────────────────────┐
+  │           SeewoOTA            │
+  │ entry → SDKSystemHelper.*     │
+  └───────────────────────────────┘
+                 ↓
+  ┌───────────────────────────────┐
+  │         OpenSDK3.0            │
+  │ SDKSystemHelper → Cmd*        │
+  │ OpenSDK.postCommand           │
+  └───────────────────────────────┘
+                 ↓
+  ┌───────────────────────────────┐
+  │           UdiServer           │
+  │ Handler.* → POST /v1/...      │
+  └───────────────────────────────┘
+                 ↓
+  ┌───────────────────────────────┐
+  │         UdiServiceCore        │
+  │ Service.* → Impl.*            │
+  └───────────────────────────────┘
+  #### Branching at UdiServiceCore
+  ┌─────────────────────────────────────────────────────────────┐
+  │                         UdiServiceCore                      │
+  │ Service.* → Impl.*                                          │
+  │   ┌──────────────────────────────────────────────────────┐  │
+  │   │ Branch rules:                                         │  │
+  │   │  • IR_HX/FCT/CD → Service: TouchPanelService          │  │
+  │   │  • IR_FF        → Shell: ffp_tool -f USB -i $path     │  │
+  │   │  • CAP_EETI     → Shell: eUpdate2 -f $path ...        │  │
+  │   │  • IR_KTC       → JNI: McutouchManager.upgradeTouch   │  │
+  │   │  • IR_TY_NOAAR  → VMan: TYPE_FW_UPGRADE_TOUCHBIN      │  │
+  │   └──────────────────────────────────────────────────────┘  │
+  └─────────────────────────────────────────────────────────────┘
+  #### VMan direct chain (Android 14+)
+  ┌───────────────────────────────┐
+  │           SeewoOTA            │
+  │ *VmanUpdateTask               │
+  │ FwTouchCtrlManager.fwTouchList│
+  └───────────────────────────────┘
+                 ↓
+  ┌───────────────────────────────┐
+  │         VMan SDK              │
+  │ EntityFwTouch                 │
+  │ otaUpgradeTouchBinPath        │
+  └───────────────────────────────┘
+                 ↓
+  ┌───────────────────────────────┐
+  │ SDKSystemHelper.upgradeTouch  │
+  │ (continues to OpenSDK chain)  │
+  └───────────────────────────────┘
+  ## Quality checklist
+  - [ ] At least one file:line reference per module
+  - [ ] Exact UDI URI and Cmd class named
+  - [ ] Property/config gates noted (if present)
+  - [ ] Result event endpoints named (if used)
+  - [ ] Branch rules documented (if applicable)
+  - [ ] Boundary type and final action specified
+  - [ ] ASCII only in diagrams
+  ---

package/skills/gitlab-commit-message/SKILL.md ADDED Viewed

@@ -0,0 +1,95 @@
+———
+name: gitlab-commit-message
+description: "Enforce the git commit message template and checklist. Use when preparing commit messages or committing."
+---
+# Commit Message Template
+## Overview
+Use this skill to format git commit messages. Keep commits small and cohesive, and always follow the required template below.
+## Workflow
+1. Check recent commit messages for tone and granularity (optional).
+2. Ensure the change set is cohesive; split commits if multiple intents exist.
+3. Write the commit message strictly using the template.
+## Commit Message Template (Mandatory)
+[类型: bugfix | feature | improve | sonar | ...] 简练总结性的描述
+[why] 为什么修改,修复什么场景,优化什么功能
+[how] 怎么做,做了什么,后续维护
+[influence] 受影响功能模块
+[check] 预期 xxx
+[jira] NA 占位
+### Rules
+- Keep the summary short and specific.
+- Use only these tags: [why], [how], [influence], [check], [jira].
+- Make [check] steps reproducible and verifiable.
+## Examples
+### Good
+[bugfix] 修复自定义图片加载问题
+[why] 下次打开没有加载上次上传的自定义背景
+[how] 统一使用 ThemeResHelper 管理，修复数据源不一致的问题
+[influence] Background
+[check] 在菜单-主题-背景，上传自定义图片，关闭应用再打开，看是否还存在，应用到背景是否正常
+[jira] NA
+### Bad (overly broad)
+[feature] 完成 module_formula
+module_rego,module_func 全面重构升级，新增数学计算和图形可视化功能
+[why] 原有公式模块功能单一且存在稳定性问题，需要提升为支持复杂数学计算和可视化的现代化模块，同时修复LaTeX解析、TabLayout切换、图形渲染等关键问题
+[how] 1.完成100% Java→Kotlin迁移
+  2.新增FormulaCalculator数学计算引擎和ExpressionParser表达式解析器
+  3.实现FunctionGraphView函数图形可视化
+  4.重构UI交互：Done按钮替代回车键确认、修复TabLayout切换机制
+  5.优化LaTeX标准化器，修复正则表达式崩溃问
+  6.新增完整测试用例和demo界面 7.完善文档结构和PlantUML类图
+[influence] module_formula, module_demo, 依赖公式功能的所有白板模块
+[check] 验证公式编辑器弹窗是否正常；TabLayout四个分类切换正常；数学表达式计算功能正常（如x^2+2x-1），函数图形绘制显示正常；FormulaShape Canvas集成绘制正常；
+[jira] SXRD-17429
+### Bad (too vague)
+[bugfix] 修复
+[why] 崩溃
+[how] 加判断
+[influence] all
+[check] 无崩溃
+[jira] S15250039-752
+## Output Format
+Use EOF format commit message,keep the code style.
+```
+[bugfix] ..
+[why] ..
+[how] ..
+[influence] ..
+[check] ..
+[jira] ..
+```
+---