feat: refactor sync-skills to use --tool choice and add github-copilot/cursor/qoder

Signed-off-by: GitHub <noreply@github.com>

Co-authored-by: OhYee <13498329+OhYee@users.noreply.github.com>

Author: Copilot

docs/en/sync-skills.md

@@ -2,44 +2,58 @@
 
 # ar sync-skills
 
-Sync platform Skills to local AI tool skill directories (Claude Code or Codex).
+Sync platform Skills to a local AI tool skill directory.
 
 ```
-ar sync-skills [tool] [scope] [options]
+ar sync-skills --tool <tool> (--user | --project) [options]
 ```
 
 ## Options
 
 | Flag | Type | Required | Default | Description |
 |------|------|----------|---------|-------------|
-| `--claude-code` | flag | yes* |  | Sync to Claude Code skill directory. |
-| `--codex` | flag | yes* |  | Sync to Codex skill directory. |
-| `--user` | flag | yes** |  | Sync to user-level directory. |
-| `--project` | flag | yes** |  | Sync to project-level directory. |
+| `--tool` | choice | yes |  | Target AI tool. See choices below. |
+| `--user` | flag | yes* |  | Sync to user-level directory. |
+| `--project` | flag | yes* |  | Sync to project-level directory. |
 | `--workspace` | multi | no | all | Workspace filter, repeatable. |
 | `--delete-unmanaged` | flag | no | false | Delete local skills outside selected workspace scope (with confirmation). |
 | `-y`, `--yes` | flag | no | false | Skip confirmation prompts. |
 
-\* Exactly one of `--claude-code` or `--codex` is required.  
-\** Exactly one of `--user` or `--project` is required.
+\* Exactly one of `--user` or `--project` is required.
+
+### `--tool` choices
+
+| Choice | User-level path | Project-level path |
+|--------|----------------|--------------------|
+| `claude-code` | `~/.claude/skills` | `.claude/skills` |
+| `codex` | `~/.codex/skills` | `.codex/skills` |
+| `github-copilot` | `~/.github/copilot/skills` | `.github/copilot/skills` |
+| `cursor` | `~/.cursor/skills` | `.cursor/skills` |
+| `qoder` | `~/.qoder/skills` | `.qoder/skills` |
 
 ## Behavior
 
 - By default, all platform skills are selected (unless `--workspace` is provided).
-- Before downloading/updating skills, the CLI asks for confirmation.
+- Before downloading/updating skills, the CLI asks for confirmation (skip with `-y`).
 - Sync checks local metadata and only downloads skills that are missing or outdated.
 - When `--delete-unmanaged` is enabled, local skill directories not in the selected
-  managed scope can be removed after confirmation.
+  managed scope can be removed after a separate confirmation.
 
 ## Examples
 
 ```bash
 # Sync skills from workspace abc + def into user-level Claude Code skills
-ar sync-skills --claude-code --user --workspace abc --workspace def
+ar sync-skills --tool claude-code --user --workspace abc --workspace def
 
 # Sync skills from workspace abc into project-level Codex skills
-ar sync-skills --codex --project --workspace abc
+ar sync-skills --tool codex --project --workspace abc
+
+# Sync all skills to project-level Cursor directory without prompts
+ar sync-skills --tool cursor --project -y
+
+# Sync to GitHub Copilot user-level directory and remove unmanaged local skills
+ar sync-skills --tool github-copilot --user --delete-unmanaged
 
-# Sync all skills and also remove unmanaged local skills
-ar sync-skills --claude-code --project --delete-unmanaged
+# Sync to Qoder project-level directory
+ar sync-skills --tool qoder --project --workspace my-workspace
 ```

docs/zh/sync-skills.md

@@ -2,43 +2,57 @@
 
 # ar sync-skills
 
-把平台上的 Skill 同步到本地 AI 工具技能目录（Claude Code 或 Codex）。
+把平台上的 Skill 同步到本地 AI 工具技能目录。
 
 ```
-ar sync-skills [tool] [scope] [options]
+ar sync-skills --tool <tool> (--user | --project) [options]
 ```
 
 ## 参数
 
 | Flag | 类型 | 必填 | 默认 | 说明 |
 |------|------|------|------|------|
-| `--claude-code` | flag | 是* |  | 同步到 Claude Code 技能目录。 |
-| `--codex` | flag | 是* |  | 同步到 Codex 技能目录。 |
-| `--user` | flag | 是** |  | 同步到用户级目录。 |
-| `--project` | flag | 是** |  | 同步到项目级目录。 |
+| `--tool` | choice | 是 |  | 目标 AI 工具，见下表。 |
+| `--user` | flag | 是* |  | 同步到用户级目录。 |
+| `--project` | flag | 是* |  | 同步到项目级目录。 |
 | `--workspace` | multi | 否 | 全部 | 工作空间过滤，可重复。 |
 | `--delete-unmanaged` | flag | 否 | false | 删除不在所选管控范围内的本地技能目录（需确认）。 |
 | `-y`、`--yes` | flag | 否 | false | 跳过确认提示。 |
 
-\* `--claude-code` 与 `--codex` 二选一。  
-\** `--user` 与 `--project` 二选一。
+\* `--user` 与 `--project` 二选一。
+
+### `--tool` 可选值
+
+| 选项 | 用户级路径 | 项目级路径 |
+|------|-----------|-----------|
+| `claude-code` | `~/.claude/skills` | `.claude/skills` |
+| `codex` | `~/.codex/skills` | `.codex/skills` |
+| `github-copilot` | `~/.github/copilot/skills` | `.github/copilot/skills` |
+| `cursor` | `~/.cursor/skills` | `.cursor/skills` |
+| `qoder` | `~/.qoder/skills` | `.qoder/skills` |
 
 ## 行为说明
 
 - 默认同步全部平台 Skill（除非传入 `--workspace`）。
-- 在下载/更新 Skill 前会先进行用户确认。
+- 在下载/更新 Skill 前会先进行用户确认（传 `-y` 可跳过）。
 - 同步会检查本地元数据，仅下载缺失或有更新的 Skill。
-- 开启 `--delete-unmanaged` 时，会在确认后删除不在当前管控范围内的本地 Skill 目录。
+- 开启 `--delete-unmanaged` 时，会在再次确认后删除不在当前管控范围内的本地 Skill 目录。
 
 ## 示例
 
 ```bash
 # 将 workspace abc + def 的 skills 同步到用户级 Claude Code 目录
-ar sync-skills --claude-code --user --workspace abc --workspace def
+ar sync-skills --tool claude-code --user --workspace abc --workspace def
 
 # 将 workspace abc 的 skills 同步到项目级 Codex 目录
-ar sync-skills --codex --project --workspace abc
+ar sync-skills --tool codex --project --workspace abc
+
+# 跳过确认，将全部 skills 同步到项目级 Cursor 目录
+ar sync-skills --tool cursor --project -y
+
+# 同步到 GitHub Copilot 用户级目录，并删除不在管控范围的本地 skills
+ar sync-skills --tool github-copilot --user --delete-unmanaged
 
-# 同步全部 skills，并删除不在管控范围内的本地 skills
-ar sync-skills --claude-code --project --delete-unmanaged
+# 同步到 Qoder 项目级目录
+ar sync-skills --tool qoder --project --workspace my-workspace
 ```

src/agentrun_cli/commands/sync_skills_cmd.py

@@ -13,6 +13,14 @@
 
 _META_FILE_NAME = ".agentrun-sync-skills.json"
 
+_TOOL_CHOICES = (
+    "claude-code",
+    "codex",
+    "github-copilot",
+    "cursor",
+    "qoder",
+)
+
 
 def _ctx_cfg(ctx):
     return (ctx.obj or {}).get("profile"), (ctx.obj or {}).get("region")
@@ -72,19 +80,23 @@ def _extract_workspace_values(skill) -> set[str]:
     return values
 
 
+_TOOL_ROOTS: dict[str, tuple[str, str]] = {
+    # (user_root, project_subdir_name)
+    "claude-code": ("~/.claude", ".claude"),
+    "codex": ("~/.codex", ".codex"),
+    "github-copilot": ("~/.github/copilot", ".github/copilot"),
+    "cursor": ("~/.cursor", ".cursor"),
+    "qoder": ("~/.qoder", ".qoder"),
+}
+
+
 def _resolve_target_dir(ai_tool: str, scope: str) -> str:
-    if ai_tool == "claude-code":
-        root = (
-            os.path.expanduser("~/.claude")
-            if scope == "user"
-            else os.path.abspath(".claude")
-        )
-    else:
-        root = (
-            os.path.expanduser("~/.codex")
-            if scope == "user"
-            else os.path.abspath(".codex")
-        )
+    user_root, project_dir = _TOOL_ROOTS[ai_tool]
+    root = (
+        os.path.expanduser(user_root)
+        if scope == "user"
+        else os.path.abspath(project_dir)
+    )
     return os.path.join(root, "skills")
 
 
@@ -148,21 +160,16 @@ def _list_platform_skills(profile, region):
 
 @click.command(
     "sync-skills",
-    help="Sync platform skills to Claude Code or Codex skill directories.",
-)
-@click.option(
-    "--claude-code",
-    "use_claude_code",
-    is_flag=True,
-    default=False,
-    help="Sync to Claude Code skill directory.",
+    help="Sync platform skills to a local AI tool skill directory.",
 )
 @click.option(
-    "--codex",
-    "use_codex",
-    is_flag=True,
-    default=False,
-    help="Sync to Codex skill directory.",
+    "--tool",
+    "ai_tool",
+    type=click.Choice(_TOOL_CHOICES),
+    required=True,
+    help=(
+        "Target AI tool: claude-code, codex, github-copilot, cursor, qoder."
+    ),
 )
 @click.option(
     "--user",
@@ -205,23 +212,17 @@ def _list_platform_skills(profile, region):
 @handle_errors
 def sync_skills(
     ctx,
-    use_claude_code,
-    use_codex,
+    ai_tool,
     user_scope,
     project_scope,
     workspaces,
     delete_unmanaged,
     auto_confirm,
 ):
     """Sync platform skills to local AI tool skill directories."""
-    if use_claude_code == use_codex:
-        raise click.UsageError(
-            "You must specify exactly one of --claude-code or --codex."
-        )
     if user_scope == project_scope:
         raise click.UsageError("You must specify exactly one of --user or --project.")
 
-    ai_tool = "claude-code" if use_claude_code else "codex"
     scope = "user" if user_scope else "project"
     target_dir = _resolve_target_dir(ai_tool, scope)
     os.makedirs(target_dir, exist_ok=True)

tests/integration/test_sync_skills_cmd.py

@@ -46,19 +46,35 @@ def test_sync_success(self, mock_client_fn, mock_get_tool, _mock_cfg):
             runner = CliRunner()
             result = runner.invoke(
                 cli,
-                ["sync-skills", "--claude-code", "--project", "-y"],
+                ["sync-skills", "--tool", "claude-code", "--project", "-y"],
             )
 
         assert result.exit_code == 0, result.output
         out = json.loads(result.output)
         assert out["ai_tool"] == "claude-code"
         assert out["managed_skill_total"] == 1
 
-    def test_sync_usage_error(self):
+    def test_sync_usage_error_missing_scope(self):
         runner = CliRunner()
         result = runner.invoke(
             cli,
-            ["sync-skills", "--claude-code", "--user", "--project"],
+            ["sync-skills", "--tool", "cursor"],
         )
         assert result.exit_code != 0
         assert "--user or --project" in result.output
+
+    def test_sync_usage_error_both_scopes(self):
+        runner = CliRunner()
+        result = runner.invoke(
+            cli,
+            ["sync-skills", "--tool", "claude-code", "--user", "--project"],
+        )
+        assert result.exit_code != 0
+        assert "--user or --project" in result.output
+
+    def test_sync_help_lists_all_tools(self):
+        runner = CliRunner()
+        result = runner.invoke(cli, ["sync-skills", "--help"])
+        assert result.exit_code == 0
+        for tool in ("claude-code", "codex", "github-copilot", "cursor", "qoder"):
+            assert tool in result.output