itismyskillmarket 1.3.0 → 1.3.2

package/docs/plans/2026-04-16-keyword-search-design.md

@@ -0,0 +1,143 @@
+# SkillMarket 关键字搜索功能设计方案
+
+**版本**: 1.0  
+**日期**: 2026-04-16  
+**状态**: 待开发
+
+## 1. 功能概述
+
+为 SkillMarket CLI 添加关键字搜索功能，支持在 npm registry 和本地已安装 skills 中按关键字检索。
+
+## 2. 推荐方案
+
+### 2.1 新增命令
+
+```bash
+# 搜索 npm registry（默认行为，与现有 skm ls 等效但带过滤）
+skm search <keyword>
+
+# 搜索本地已安装的 skills
+skm search <keyword> --installed
+
+# 组合：分页 + 搜索关键字
+skm search <keyword> --page 1 --limit 20
+```
+
+### 2.2 搜索字段
+
+支持匹配以下字段：
+- `id`: skill 包名（精确匹配 + 模糊匹配）
+- `displayName`: 显示名称
+- `description`: 描述
+
+### 2.3 实现方式
+
+复用现有 `skm ls` 命令，添加 `--search` / `-s` 选项：
+
+| 命令 | 说明 |
+|------|------|
+| `skm ls --search <keyword>` | 在 npm registry 中搜索 |
+| `skm ls --search <keyword> --installed` | 在本地已安装 skills 中搜索 |
+| `skm ls -s <keyword>` | 简写形式 |
+
+**推荐**：将搜索功能作为 `skm ls` 的选项，而不是新增独立命令。原因：
+- 代码复用度高
+- 用户学习成本低
+- 与分页功能自然组合
+
+## 3. 技术方案
+
+### 3.1 代码修改
+
+**文件**: `src/commands/ls.ts`
+
+```typescript
+interface LsOptions {
+  // ... 现有字段
+  search?: string;  // 新增：搜索关键字
+}
+```
+
+### 3.2 npm search 实现
+
+修改 `searchSkillmarketPackages` 函数，添加关键字过滤参数：
+
+```typescript
+interface SearchOptions {
+  from: number;
+  size: number;
+  keyword?: string;  // 新增
+}
+```
+
+**注意**：npm search API 本身支持通过 `q` 参数进行关键字搜索，可以直接传入。
+
+### 3.3 本地搜索实现
+
+在已有本地 skills 列表上进行内存过滤：
+
+```typescript
+function filterInstalledSkills(skills: InstalledSkill[], keyword: string): InstalledSkill[] {
+  const lower = keyword.toLowerCase();
+  return skills.filter(s => 
+    s.id.toLowerCase().includes(lower) ||
+    s.displayName?.toLowerCase().includes(lower) ||
+    s.description?.toLowerCase().includes(lower)
+  );
+}
+```
+
+### 3.4 UI 输出
+
+```
+# npm 搜索结果
+$ skm ls -s "brainstorm"
+
+📦 brainstorming@1.0.0 (Found 1 match for "brainstorm")
+   名称: Brainstorming
+   描述: 多智能体头脑风暴能力
+   平台: opencode
+   链接: https://npmjs.com/package/brainstorming
+
+# 本地搜索结果
+$ skm ls --installed -s "test"
+
+🟢 test-skill-1@1.0.0
+   Platforms: opencode
+   Installed: 2026-04-16
+
+🟢 test-skill-2@1.0.0
+   Platforms: opencode
+   Installed: 2026-04-15
+```
+
+## 4. 实施步骤
+
+1. **修改 `ls.ts` 命令模块**
+   - 添加 `search` 选项到 `LsOptions` 接口
+   - 实现关键字过滤逻辑
+   - 支持 npm search API 和本地过滤
+
+2. **修改 `cli.ts`**
+   - 在 `ls` 命令中添加 `--search` / `-s` 选项
+
+3. **测试**
+   - `skm ls -s <keyword>`
+   - `skm ls --installed -s <keyword>`
+   - 边界情况：无结果、分页
+
+## 5. 优先级
+
+**P1 - 高**
+- 核心搜索功能
+- npm registry 搜索
+
+**P2 - 中**
+- 本地已安装 skills 搜索
+- 搜索结果高亮（可选）
+
+## 6. 风险与注意事项
+
+- npm search API 有速率限制，生产环境考虑缓存
+- 中文关键字搜索需要确认 npm API 支持
+- 大结果集需要分页处理

package/docs/plans/2026-04-29-weekly-update.md

@@ -0,0 +1,57 @@
+# SkillMarket 本周更新日志 (2026-04-23 ~ 2026-04-29)
+
+## 📦 版本发布
+
+### v1.3.1 - 2026-04-29
+
+**新功能：**
+- ✨ 新增独立 `skm search` 命令，支持关键词匹配搜索技能
+- 🔍 优化搜索精度，增加本地过滤支持
+
+**修复：**
+- 🐛 修复 GitHub Actions workflow 中版本重复更新的问题
+- 🔧 改进 `publish-npm.yml` 的版本判断逻辑
+
+**发布详情：**
+- npm: https://www.npmjs.com/package/itismyskillmarket/v/1.3.1
+- GitHub Release: https://github.com/wxc2004/market/releases/tag/v1.3.1
+- 对比: https://github.com/wxc2004/market/compare/v1.2.9...v1.3.1
+
+---
+
+## 📊 本周统计
+
+| 指标 | 数据 |
+|------|------|
+| 新增功能 | 1 个 |
+| Bug 修复 | 1 个 |
+| 版本发布 | 1 个 (v1.3.1) |
+| Commits | 2 个 |
+| 代码行变更 | ~150 行 |
+
+---
+
+## 🔜 下周计划
+
+- [ ] 增加技能评分/评论功能
+- [ ] 支持更多 AI 编码工具平台
+- [ ] 优化安装速度（增量更新）
+- [ ] 增加技能依赖检查
+
+---
+
+## 📝 详细变更
+
+### feat: add independent search command with keyword matching (1e91352)
+- 新增 `skm search <keyword>` 命令
+- 支持按名称、描述关键词搜索已安装和远程技能
+- 本地缓存优先，减少网络请求
+
+### fix: skip npm version when version unchanged in workflow (2213d4a)
+- 修复 GitHub Actions 发布时 `npm version` 报错问题
+- 增加版本号判断逻辑，避免重复设置
+- 优化 CI/CD 流程稳定性
+
+---
+
+*生成时间: 2026-04-29*

package/package.json

@@ -1,13 +1,8 @@
 {
   "name": "itismyskillmarket",
-  "version": "1.3.0",
+  "version": "1.3.2",
   "description": "Cross-platform skill manager for AI coding tools",
   "type": "module",
-  "files": [
-    "dist",
-    "src",
-    "README.md"
-  ],
   "bin": {
     "skm": "dist/index.js"
   },

package/skills/README.md

@@ -0,0 +1,54 @@
+# SkillMarket Skills
+
+This directory contains the skill packages that can be published to npm.
+
+## Adding a New Skill
+
+1. Create a new directory under `skills/<skill-name>/`
+2. Add the required files:
+   - `package.json` - Package configuration with `skillmarket` metadata
+   - `SKILL.md` - Skill documentation
+   - `metadata.json` - Skill metadata (optional)
+   - `index.js` - Main entry point (OpenCode plugin)
+
+3. Publish via GitHub Actions or manually
+
+## Publishing a Skill
+
+### Option 1: GitHub Actions (Recommended)
+1. Go to repository Actions tab
+2. Select "Publish Skill" workflow
+3. Click "Run workflow"
+4. Enter skill name (e.g., `test-skill`)
+5. Optionally specify version
+
+### Option 2: Manual Publish
+```bash
+cd skills/<skill-name>
+npm install
+npm publish --access=public
+```
+
+## Skill Package Requirements
+
+```json
+{
+  "name": "@itismyskillmarket/<skill-name>",
+  "version": "1.0.0",
+  "type": "module",
+  "main": "index.js",
+  "keywords": ["skillmarket"],
+  "skillmarket": {
+    "id": "<skill-name>",
+    "displayName": "Display Name",
+    "description": "Description",
+    "platforms": ["opencode", "cursor", "vscode", "claude", "codex", "antigravity"]
+  }
+}
+```
+
+## Current Skills
+
+- `test-skill` - Test skill for validating the installation flow
+- `test-skill-1` - Test skill for validating uninstall and update flows
+- `test-skill-2` - Test skill for validating multi-platform installation

package/skills/test-skill/SKILL.md

@@ -0,0 +1,25 @@
+# Test Skill
+
+这是一个用于测试 SkillMarket 安装流程的 skill。
+
+## 功能
+
+- `test.greet` - 向用户打招呼
+- `test.randomNumber` - 生成随机数
+- `test.systemInfo` - 获取系统信息
+
+## 使用方法
+
+```bash
+skm install test-skill
+skm info test-skill
+```
+
+## 平台支持
+
+- OpenCode
+- Cursor
+- VSCode
+- Claude Code
+- Codex
+- Antigravity

package/skills/test-skill/index.js

@@ -0,0 +1,66 @@
+/**
+ * Test Skill - SkillMarket 测试技能
+ * 
+ * 这是一个用于验证 SkillMarket 安装流程的示例 skill
+ */
+
+import { tool } from "@opencode-ai/plugin";
+
+export default async function TestSkill() {
+  console.log("✅ Test Skill 加载成功!");
+
+  return {
+    tool: {
+      // 1. 简单的问候工具
+      greet: tool({
+        description: "向用户打招呼",
+        args: {
+          name: tool.schema.string().describe("你的名字")
+        },
+        async execute({ name }, context) {
+          const { agent, sessionID } = context;
+          return `你好 ${name}！我是 ${agent} 代理，欢迎使用测试插件！会话ID: ${sessionID}`;
+        }
+      }),
+
+      // 2. 随机数生成工具
+      randomNumber: tool({
+        description: "生成指定范围的随机数",
+        args: {
+          min: tool.schema.number().describe("最小值").default(1),
+          max: tool.schema.number().describe("最大值").default(100)
+        },
+        async execute({ min, max }, context) {
+          const randomNum = Math.floor(Math.random() * (max - min + 1)) + min;
+          return `随机数（${min}-${max}）: ${randomNum}`;
+        }
+      }),
+
+      // 3. 系统信息工具
+      systemInfo: tool({
+        description: "获取系统信息",
+        args: {},
+        async execute(args, context) {
+          const { sessionID, agent } = context;
+          const info = {
+            agent: agent,
+            sessionID: sessionID,
+            timestamp: new Date().toISOString(),
+            platform: process.platform,
+            nodeVersion: process.version
+          };
+          return JSON.stringify(info, null, 2);
+        }
+      })
+    },
+
+    // 钩子示例
+    "tool.execute.before": async (input, output) => {
+      console.log(`🛠️ 工具即将执行: ${input.tool}`);
+    },
+
+    "tool.execute.after": async (input, output) => {
+      console.log(`✅ 工具执行完成: ${input.tool}`);
+    }
+  };
+}

package/skills/test-skill/metadata.json

@@ -0,0 +1,9 @@
+{
+  "id": "test-skill",
+  "displayName": "测试技能",
+  "description": "SkillMarket 测试技能 - 用于验证安装流程",
+  "version": "1.0.0",
+  "author": "SkillMarket",
+  "platforms": ["opencode", "cursor", "vscode", "claude", "codex", "antigravity"],
+  "tags": ["test", "demo"]
+}

package/skills/test-skill/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "@itismyskillmarket/test-skill",
+  "version": "1.0.1",
+  "description": "SkillMarket 测试技能 - 用于验证安装流程",
+  "type": "module",
+  "main": "index.js",
+  "keywords": ["skillmarket", "test"],
+  "author": "SkillMarket",
+  "license": "MIT",
+  "dependencies": {
+    "@opencode-ai/plugin": "^1.1.31"
+  },
+  "skillmarket": {
+    "id": "test-skill",
+    "displayName": "测试技能",
+    "description": "这是一个用于测试 SkillMarket 安装流程的 skill",
+    "platforms": ["opencode", "cursor", "vscode", "claude", "codex", "antigravity"]
+  }
+}

package/skills/test-skill-1/SKILL.md

@@ -0,0 +1,24 @@
+# Test Skill 1
+
+用于测试 SkillMarket 安装和 info 功能的 skill。
+
+## 功能
+
+- 验证 skm install 功能
+- 验证 skm info 功能
+
+## 使用方法
+
+```bash
+skm install test-skill-1
+skm info test-skill-1
+```
+
+## 平台支持
+
+- OpenCode
+- Cursor
+- VSCode
+- Claude Code
+- Codex
+- Antigravity

package/skills/test-skill-1/index.js

@@ -0,0 +1,13 @@
+/**
+ * Test Skill 1 - 用于测试 SkillMarket 安装和 info 功能
+ */
+
+export default async function TestSkill1() {
+  console.log("✅ Test Skill 1 加载成功!");
+  
+  return {
+    name: "test-skill-1",
+    version: "1.0.3",
+    status: "installed"
+  };
+}

package/skills/test-skill-1/metadata.json

@@ -0,0 +1,9 @@
+{
+  "id": "test-skill-1",
+  "displayName": "测试技能1",
+  "description": "用于测试 SkillMarket 安装和 info 功能",
+  "version": "1.0.3",
+  "author": "SkillMarket",
+  "platforms": ["opencode", "cursor", "vscode", "claude", "codex", "antigravity"],
+  "tags": ["test", "install", "info"]
+}

package/skills/test-skill-1/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "@wanxuchen/test-skill-1",
+  "version": "1.0.3",
+  "description": "Test Skill 1 - 用于测试 SkillMarket 安装流程",
+  "type": "module",
+  "main": "index.js",
+  "keywords": ["skillmarket", "test"],
+  "author": "SkillMarket",
+  "license": "MIT",
+  "skillmarket": {
+    "id": "test-skill-1",
+    "displayName": "测试技能1",
+    "description": "用于测试 SkillMarket 安装和 info 功能",
+    "platforms": ["opencode", "cursor", "vscode", "claude", "codex", "antigravity"]
+  }
+}

package/skills/test-skill-2/SKILL.md

@@ -0,0 +1,25 @@
+# Test Skill 2
+
+用于测试 SkillMarket 卸载和更新流程的 skill。
+
+## 功能
+
+- 验证 skm uninstall 功能
+- 验证 skm update 功能
+
+## 使用方法
+
+```bash
+skm install test-skill-2
+skm update test-skill-2
+skm uninstall test-skill-2
+```
+
+## 平台支持
+
+- OpenCode
+- Cursor
+- VSCode
+- Claude Code
+- Codex
+- Antigravity

package/skills/test-skill-2/index.js

@@ -0,0 +1,13 @@
+/**
+ * Test Skill 2 - 用于测试 SkillMarket 卸载和更新功能
+ */
+
+export default async function TestSkill2() {
+  console.log("✅ Test Skill 2 加载成功!");
+  
+  return {
+    name: "test-skill-2",
+    version: "1.0.3",
+    status: "installed"
+  };
+}

package/skills/test-skill-2/metadata.json

@@ -0,0 +1,9 @@
+{
+  "id": "test-skill-2",
+  "displayName": "测试技能2",
+  "description": "用于测试 SkillMarket 卸载和更新功能",
+  "version": "1.0.3",
+  "author": "SkillMarket",
+  "platforms": ["opencode", "cursor", "vscode", "claude", "codex", "antigravity"],
+  "tags": ["test", "uninstall", "update"]
+}

package/skills/test-skill-2/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "@wanxuchen/test-skill-2",
+  "version": "1.0.3",
+  "description": "Test Skill 2 - 用于测试 SkillMarket 卸载和更新流程",
+  "type": "module",
+  "main": "index.js",
+  "keywords": ["skillmarket", "test"],
+  "author": "SkillMarket",
+  "license": "MIT",
+  "skillmarket": {
+    "id": "test-skill-2",
+    "displayName": "测试技能2",
+    "description": "用于测试 SkillMarket 卸载和更新功能",
+    "platforms": ["opencode", "cursor", "vscode", "claude", "codex", "antigravity"]
+  }
+}

package/src/adapters/base.ts

@@ -0,0 +1,87 @@
+/**
+ * =============================================================================
+ * Base Platform Adapter
+ * =============================================================================
+ * 
+ * Abstract base class for platform-specific skill adapters.
+ * Provides common functionality for all platforms.
+ */
+
+import fs from 'fs-extra';
+import path from 'path';
+import type { PlatformAdapter } from '../types.js';
+
+export abstract class BaseAdapter implements PlatformAdapter {
+  abstract readonly id: string;
+  abstract readonly name: string;
+  abstract readonly skillDir: string;
+  
+  /**
+   * Get the path where a specific skill should be installed
+   */
+  protected getSkillPath(skillId: string): string {
+    return path.join(this.skillDir, skillId);
+  }
+  
+  /**
+   * Get the path to the SKILL.md file for a skill
+   */
+  protected getSkillFilePath(skillId: string): string {
+    return path.join(this.getSkillPath(skillId), 'SKILL.md');
+  }
+  
+  async isAvailable(): Promise<boolean> {
+    try {
+      await fs.ensureDir(this.skillDir);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  
+  async isInstalled(skillId: string): Promise<boolean> {
+    const skillFile = this.getSkillFilePath(skillId);
+    return fs.pathExists(skillFile);
+  }
+  
+  async install(skillId: string, sourceDir: string): Promise<void> {
+    const targetDir = this.getSkillPath(skillId);
+    const targetFile = this.getSkillFilePath(skillId);
+    
+    await fs.ensureDir(targetDir);
+    
+    const sourceFile = path.join(sourceDir, 'SKILL.md');
+    if (!(await fs.pathExists(sourceFile))) {
+      throw new Error(`SKILL.md not found in ${sourceDir}`);
+    }
+    
+    await fs.copy(sourceFile, targetFile, { overwrite: true });
+  }
+  
+  async uninstall(skillId: string): Promise<void> {
+    const targetDir = this.getSkillPath(skillId);
+    if (await fs.pathExists(targetDir)) {
+      await fs.remove(targetDir);
+    }
+  }
+  
+  async listInstalled(): Promise<string[]> {
+    if (!(await fs.pathExists(this.skillDir))) {
+      return [];
+    }
+    
+    const entries = await fs.readdir(this.skillDir, { withFileTypes: true });
+    const skills: string[] = [];
+    
+    for (const entry of entries) {
+      if (entry.isDirectory()) {
+        const skillFile = path.join(this.skillDir, entry.name, 'SKILL.md');
+        if (await fs.pathExists(skillFile)) {
+          skills.push(entry.name);
+        }
+      }
+    }
+    
+    return skills;
+  }
+}

package/src/adapters/claude.ts

@@ -0,0 +1,31 @@
+/**
+ * =============================================================================
+ * Claude Code Platform Adapter
+ * =============================================================================
+ * 
+ * Handles skill installation for Claude Code CLI.
+ * Skills are installed to ~/.claude/skills/<skill-id>/
+ */
+
+import path from 'path';
+import os from 'os';
+import fs from 'fs-extra';
+import { BaseAdapter } from './base.js';
+
+export class ClaudeAdapter extends BaseAdapter {
+  readonly id = 'claude';
+  readonly name = 'Claude Code';
+  
+  get skillDir(): string {
+    return path.join(os.homedir(), '.claude', 'skills');
+  }
+  
+  async isAvailable(): Promise<boolean> {
+    // Check for environment variable or directory
+    if (process.env.CLAUDE_CODE) return true;
+    
+    // Check if .claude directory exists
+    const claudeDir = path.join(os.homedir(), '.claude');
+    return fs.pathExists(claudeDir);
+  }
+}

package/src/adapters/index.ts

@@ -0,0 +1,9 @@
+/**
+ * Platform adapters index
+ */
+
+export { BaseAdapter } from './base.js';
+export { OpenCodeAdapter } from './opencode.js';
+export { ClaudeAdapter } from './claude.js';
+export { VSCodeAdapter } from './vscode.js';
+export { detectPlatforms, getPlatformAdapter, getAllAdapters, getAdapterByPlatform } from './registry.js';