chore: release v0.6.0

Author: yeasy

CHANGELOG.md

@@ -5,38 +5,36 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [Unreleased]
+## [0.6.0] - 2026-01-16
 
 ### Added
+- `ask repo list [name]` command to inspect repository skills
 - Shell completion support for bash, zsh, fish, and powershell
 - Comprehensive test coverage for `internal/git`, `internal/skill`, `internal/deps`, and `internal/ui` packages
 - CI/CD quality gates: linting, test coverage reporting, and security scanning
 - Documentation: troubleshooting guide and architecture diagrams
 - Git author extraction from git config for `ask skill create` command
 
 ### Changed
+- `ask repo list` now supports optional arguments to list skills in a specific repository
 - Enhanced command help text with practical examples
 - Improved error messages with actionable suggestions
 
-## [0.4.0] - 2026-01-15
+## [0.5.0] - 2026-01-17
 
 ### Added
-- Offline mode support with `--offline` flag
-- Performance benchmarking command `ask benchmark`
-- Search result caching leveraged for offline usage
+- **Multi-Tool Support** (`--agent` / `-a` flag)
+  - Automatically detects and installs skills for: Claude Code, Cursor, OpenAI Codex, OpenCode
+  - Supports installing to multiple agents simultaneously
+- **Global Installation Support** (`--global` / `-g` flag)
+  - Install skills globally to `~/.ask/skills/` for sharing across all projects
+  - Global configuration stored in `~/.ask/config.yaml`
+  - Global lock file at `~/.ask/ask.lock`
+  - `ask skill list --all` to show both project and global skills
+- All skill commands now support `--global` flag: `install`, `uninstall`, `list`, `update`, `outdated`, `info`
 
 ### Changed
-- `ask skill install` now prevented in offline mode
-- `ask skill outdated` skips remote checks in offline mode
-
-## [0.3.0] - 2026-01-15
-
-### Changed
-- Updated version structure (skipped public release of 0.3.0 features directly into 0.4.0 or this is a retrospective update if 0.3.0 was skipped)
-- *Note: Assuming 0.3.0 was a planned release. Adjusting to reflect current state.*
-
-Actually, looking at previous steps, I implemented features on top of 0.2.0 directly to 0.4.0.
-Let's just release as 0.4.0.
+- Skill commands now display installation scope (project/global) in output messages
 
 ## [0.4.0] - 2026-01-15
 

README.md

@@ -67,8 +67,12 @@ Real-time progress bars during installation and updates. Clear feedback on what'
 ### 🔌 Offline Mode
 Use `--offline` flag to work without network. Search uses cached results; perfect for air-gapped environments.
 
-### ⏱️ Performance Benchmarking
-Run `ask benchmark` to measure CLI performance (cold/hot search, config loading).
+### 🤖 Multi-Tool Support
+Automatically detects and supports skills directories for **Claude Code** (`.claude/skills`), **Cursor** (`.cursor/skills`), **OpenAI Codex** (`.codex/skills`), and **OpenCode** (`.opencode/skills`).
+Simply run `ask skill install` and it will install to all detected tool directories.
+
+### 🌍 Global Installation
+Install skills globally with `--global` flag to share across all projects. Local project installations take precedence over global ones.
 
 ---
 
@@ -96,7 +100,8 @@ ask init    # Creates ask.yaml in current directory
 
 ```bash
 ask skill search browser      # Search across all sources
-ask skill install browser-use # Install a skill
+ask skill install browser-use           # Install a skill
+ask skill install skill1 skill2 skill3  # Install multiple skills
 ask skill list                # View installed skills
 ```
 
@@ -109,7 +114,7 @@ ask skill list                # View installed skills
 | `ask init` | Initialize project, create `ask.yaml` |
 | **Skill Management** | |
 | `ask skill search <keyword>` | Search skills across all sources |
-| `ask skill install <skill>` | Install a skill to `./skills/` |
+| `ask skill install <skill...>` | Install skill(s) to `./skills/` |
 | `ask skill install skill@v1.0` | Install specific version |
 | `ask skill uninstall <skill>` | Remove a skill |
 | `ask skill list` | List installed skills |
@@ -118,14 +123,15 @@ ask skill list                # View installed skills
 | `ask skill outdated` | Check for updates |
 | `ask skill create <name>` | Create new skill template |
 | **Repository Management** | |
-| `ask repo list` | List skill sources |
+| `ask repo list [name]` | List repos or skills in repo |
 | `ask repo add <url>` | Add custom source |
 | `ask repo remove <name>` | Remove a source |
 | **Shell Completion** | |
 | `ask completion <shell>` | Generate completion script |
 | **Utilities** | |
 | `ask benchmark` | Run performance benchmarks |
 | `--offline` | Global flag: run without network |
+| `--global, -g` | Global flag: use global installation (~/.ask/skills) |
 
 ---
 
@@ -164,11 +170,41 @@ my-agent/
 ├── ask.lock          # Version lock file
 ├── main.py           # Your agent code
 └── .agent/
-    └── skills/       # Managed skills
+    └── skills/       # Project-level skills
         ├── browser-use/
         └── web-surfer/
+
+# Global skills (shared across projects)
+~/.ask/
+├── config.yaml       # Global config
+├── ask.lock          # Global version lock
+└── skills/           # Global skills
+    └── shared-skill/
 ```
 
+### Installation Scopes
+
+```bash
+# Project-level (default) - stored in .agent/skills/
+ask skill install browser-use
+
+# Multi-Agent Installation
+ask skill install browser-use --agent claude --agent cursor
+
+# Global - stored in ~/.ask/skills/, available to all projects
+ask skill install --global shared-skill
+ask skill install -g shared-skill
+
+# Global for specific agent
+ask skill install browser-use --agent claude --global
+# Installs to ~/.claude/skills/
+
+# List both
+ask skill list --all
+
+# List for specific agent
+ask skill list --agent claude
+
 ---
 
 ## 🛠 Development

README_zh.md

@@ -55,8 +55,8 @@
 ### 🔌 离线模式
 使用 `--offline` 标志无需网络即可工作。搜索使用缓存结果，适用于无网络环境。
 
-### ⏱️ 性能基准测试
-运行 `ask benchmark` 测量 CLI 性能（冷/热搜索、配置加载）。
+### 🌍 全局安装
+使用 `--global` 标志全局安装技能，可在所有项目间共享。项目级安装优先于全局安装。
 
 ---
 
@@ -84,7 +84,8 @@ ask init    # 在当前目录创建 ask.yaml
 
 ```bash
 ask skill search browser      # 从所有来源搜索
-ask skill install browser-use # 安装技能
+ask skill install browser-use           # 安装技能
+ask skill install skill1 skill2 skill3  # 批量安装多个技能
 ask skill list                # 查看已安装技能
 ```
 
@@ -97,7 +98,7 @@ ask skill list                # 查看已安装技能
 | `ask init` | 初始化项目，创建 `ask.yaml` |
 | **技能管理** | |
 | `ask skill search <关键词>` | 从所有来源搜索技能 |
-| `ask skill install <技能>` | 安装技能到 `./skills/` |
+| `ask skill install <技能...>` | 安装技能到 `./skills/` |
 | `ask skill install skill@v1.0` | 安装指定版本 |
 | `ask skill uninstall <技能>` | 移除技能 |
 | `ask skill list` | 列出已安装技能 |
@@ -113,6 +114,7 @@ ask skill list                # 查看已安装技能
 | `ask benchmark` | 运行性能基准测试 |
 | `ask completion <shell>` | 生成 shell 补全脚本 |
 | `--offline` | 全局标志：无网络模式 |
+| `--global, -g` | 全局标志：使用全局安装 (~/.ask/skills) |
 
 ---
 
@@ -151,9 +153,30 @@ my-agent/
 ├── ask.lock          # 版本锁定文件
 ├── main.py           # 您的智能体代码
 └── .agent/
-    └── skills/       # 托管技能目录
+    └── skills/       # 项目级技能目录
         ├── browser-use/
         └── web-surfer/
+
+# 全局技能（跨项目共享）
+~/.ask/
+├── config.yaml       # 全局配置
+├── ask.lock          # 全局版本锁定
+└── skills/           # 全局技能
+    └── shared-skill/
+```
+
+### 安装范围
+
+```bash
+# 项目级（默认）- 存储在 .agent/skills/
+ask skill install browser-use
+
+# 全局 - 存储在 ~/.ask/skills/，所有项目可用
+ask skill install --global shared-skill
+ask skill install -g shared-skill
+
+# 列出全部
+ask skill list --all
 ```
 
 ---

SPEC.md

@@ -40,7 +40,17 @@ v0.4.0 已实现:
 - [x] 性能基准测试 (`ask benchmark`)
 - [x] 离线模式 (`--offline`)
 
-v0.5.0 建议功能:
+v0.5.0 已实现:
+- [x] 全局安装支持 (`--global` / `-g`)
+  - 全局技能目录: `~/.ask/skills/`
+  - 全局配置文件: `~/.ask/config.yaml`
+  - 全局锁定文件: `~/.ask/ask.lock`
+- [x] 多 Agent 支持 (`--agent` / `-a`)
+  - 支持将技能安装到特定 Agent 目录
+  - 支持的 Agent: Claude, Cursor, Codex, OpenCode
+  - 示例: `ask skill install <skill> --agent claude --agent cursor`
+
+v0.6.0 建议功能:
 - [ ] 插件系统
 
 ---
@@ -256,6 +266,7 @@ ask/
 
 | 日期 | 版本 | 变更 |
 |------|------|------|
+| 2026-01-16 | 0.5.0 | 新增多 Agent 支持 (`--agent`), 全局安装 (`--global`), 以及智能目录检测 |
 | 2026-01-16 | 0.4.0 | 新增离线模式 (`--offline`) 和性能基准测试 (`ask benchmark`) |
 | 2026-01-15 | 0.2.0 | CLI 重构：技能命令移至 `ask skill` 子命令；技能安装路径改为 `.agent/skills/`；新增 OpenAI 等默认仓库 |
 | 2026-01-15 | 0.1.0 | 初始版本，基本功能实现 |

cmd/benchmark.go

@@ -22,12 +22,12 @@ var benchmarkCmd = &cobra.Command{
 		fmt.Println()
 
 		w := tabwriter.NewWriter(os.Stdout, 0, 0, 2, ' ', 0)
-		fmt.Fprintln(w, "OPERATION\tTIME\tNOTES")
+		_, _ = fmt.Fprintln(w, "OPERATION\tTIME\tNOTES")
 
 		// 1. Search (Cold) - Clear cache first
 		c, err := cache.New("", cache.DefaultTTL)
 		if err == nil {
-			c.Clear()
+			_ = c.Clear()
 		}
 
 		start := time.Now()
@@ -46,27 +46,27 @@ var benchmarkCmd = &cobra.Command{
 		// We'll search for "browser" which should trigger network requests
 		repo := cfg.Repos[0] // Use first repo
 		if repo.Type == "topic" {
-			github.SearchTopic(repo.URL, "browser")
+			_, _ = github.SearchTopic(repo.URL, "browser")
 		}
 		duration := time.Since(start)
-		fmt.Fprintf(w, "Search (Cold)\t%v\tFirst repo only\n", duration.Round(time.Millisecond))
+		_, _ = fmt.Fprintf(w, "Search (Cold)\t%v\tFirst repo only\n", duration.Round(time.Millisecond))
 
 		// 2. Search (Hot) - Should be cached
 		start = time.Now()
 		if repo.Type == "topic" {
-			github.SearchTopic(repo.URL, "browser")
+			_, _ = github.SearchTopic(repo.URL, "browser")
 		}
 		duration = time.Since(start)
-		fmt.Fprintf(w, "Search (Hot)\t%v\tCached\n", duration.Round(time.Millisecond))
+		_, _ = fmt.Fprintf(w, "Search (Hot)\t%v\tCached\n", duration.Round(time.Millisecond))
 
 		// 3. List - Local operation
 		start = time.Now()
 		// Simulate list parsing
-		config.LoadConfig()
+		_, _ = config.LoadConfig()
 		duration = time.Since(start)
-		fmt.Fprintf(w, "List\t%v\tConfig load\n", duration.Round(time.Millisecond))
+		_, _ = fmt.Fprintf(w, "List\t%v\tConfig load\n", duration.Round(time.Millisecond))
 
-		w.Flush()
+		_ = w.Flush()
 		fmt.Println()
 		fmt.Println("Done.")
 	},

cmd/cmd_test.go

@@ -120,3 +120,95 @@ func TestInitCommandHelp(t *testing.T) {
 		t.Error("expected init help to contain 'Initialize'")
 	}
 }
+
+func TestParseGitHubBrowserURL(t *testing.T) {
+	tests := []struct {
+		name          string
+		input         string
+		wantRepoURL   string
+		wantBranch    string
+		wantSubDir    string
+		wantSkillName string
+		wantOK        bool
+	}{
+		{
+			name:          "full URL with subdirectory",
+			input:         "https://github.com/anthropics/skills/tree/main/skills/mcp-builder",
+			wantRepoURL:   "https://github.com/anthropics/skills.git",
+			wantBranch:    "main",
+			wantSubDir:    "skills/mcp-builder",
+			wantSkillName: "mcp-builder",
+			wantOK:        true,
+		},
+		{
+			name:          "URL with different branch",
+			input:         "https://github.com/owner/repo/tree/develop/path/to/skill",
+			wantRepoURL:   "https://github.com/owner/repo.git",
+			wantBranch:    "develop",
+			wantSubDir:    "path/to/skill",
+			wantSkillName: "skill",
+			wantOK:        true,
+		},
+		{
+			name:          "URL without subdirectory - just branch",
+			input:         "https://github.com/owner/repo/tree/main",
+			wantRepoURL:   "https://github.com/owner/repo.git",
+			wantBranch:    "main",
+			wantSubDir:    "",
+			wantSkillName: "repo",
+			wantOK:        true,
+		},
+		{
+			name:          "URL with trailing slash",
+			input:         "https://github.com/anthropics/skills/tree/main/skills/mcp-builder/",
+			wantRepoURL:   "https://github.com/anthropics/skills.git",
+			wantBranch:    "main",
+			wantSubDir:    "skills/mcp-builder",
+			wantSkillName: "mcp-builder",
+			wantOK:        true,
+		},
+		{
+			name:   "non-tree URL (regular git URL)",
+			input:  "https://github.com/owner/repo.git",
+			wantOK: false,
+		},
+		{
+			name:   "shorthand format - not a browser URL",
+			input:  "owner/repo/path/to/skill",
+			wantOK: false,
+		},
+		{
+			name:   "empty string",
+			input:  "",
+			wantOK: false,
+		},
+	}
+
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			gotRepoURL, gotBranch, gotSubDir, gotSkillName, gotOK := parseGitHubBrowserURL(tt.input)
+
+			if gotOK != tt.wantOK {
+				t.Errorf("parseGitHubBrowserURL() ok = %v, want %v", gotOK, tt.wantOK)
+				return
+			}
+
+			if !tt.wantOK {
+				return // No need to check other fields if we expected failure
+			}
+
+			if gotRepoURL != tt.wantRepoURL {
+				t.Errorf("parseGitHubBrowserURL() repoURL = %v, want %v", gotRepoURL, tt.wantRepoURL)
+			}
+			if gotBranch != tt.wantBranch {
+				t.Errorf("parseGitHubBrowserURL() branch = %v, want %v", gotBranch, tt.wantBranch)
+			}
+			if gotSubDir != tt.wantSubDir {
+				t.Errorf("parseGitHubBrowserURL() subDir = %v, want %v", gotSubDir, tt.wantSubDir)
+			}
+			if gotSkillName != tt.wantSkillName {
+				t.Errorf("parseGitHubBrowserURL() skillName = %v, want %v", gotSkillName, tt.wantSkillName)
+			}
+		})
+	}
+}