drinkzen-admin-cli 0.2.4__tar.gz → 0.3.0__tar.gz

{drinkzen_admin_cli-0.2.4 → drinkzen_admin_cli-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: drinkzen-admin-cli
-Version: 0.2.4
+Version: 0.3.0
 Summary: Standalone CLI client for DrinkZen Admin operations
 Author: DrinkZen Team
 License: MIT
@@ -64,6 +64,34 @@ PYTHONPATH=packages/admin-cli python3 -m drinkzen_admin.cli config show
 
 ---
 
+## Agent Skill 安装
+
+`drinkzen-admin` 提供与具体 AI 工具无关的运营使用手册。默认安装到当前项目的 `.agents/skills`：
+
+```bash
+drinkzen-admin skill install
+```
+
+如需安装到当前用户的全局 Agent Skill 目录：
+
+```bash
+drinkzen-admin skill install --scope global
+```
+
+查询目标路径或更新已有 Skill：
+
+```bash
+drinkzen-admin skill path --scope project --json
+drinkzen-admin skill path --scope global --json
+drinkzen-admin skill install --force
+```
+
+项目级安装默认使用当前目录，也可以指定项目目录：
+
+```bash
+drinkzen-admin skill install --scope project --project-dir /path/to/project
+```
+
 ## 密钥与持久化配置管理 (`config`)
 
 `drinkzen-admin` 提供了内置的密钥持久化管理，避免每次在终端手动输入敏感 Token 或将其留在 Bash 历史记录中。

{drinkzen_admin_cli-0.2.4 → drinkzen_admin_cli-0.3.0}/README.md

@@ -42,6 +42,34 @@ PYTHONPATH=packages/admin-cli python3 -m drinkzen_admin.cli config show
 
 ---
 
+## Agent Skill 安装
+
+`drinkzen-admin` 提供与具体 AI 工具无关的运营使用手册。默认安装到当前项目的 `.agents/skills`：
+
+```bash
+drinkzen-admin skill install
+```
+
+如需安装到当前用户的全局 Agent Skill 目录：
+
+```bash
+drinkzen-admin skill install --scope global
+```
+
+查询目标路径或更新已有 Skill：
+
+```bash
+drinkzen-admin skill path --scope project --json
+drinkzen-admin skill path --scope global --json
+drinkzen-admin skill install --force
+```
+
+项目级安装默认使用当前目录，也可以指定项目目录：
+
+```bash
+drinkzen-admin skill install --scope project --project-dir /path/to/project
+```
+
 ## 密钥与持久化配置管理 (`config`)
 
 `drinkzen-admin` 提供了内置的密钥持久化管理，避免每次在终端手动输入敏感 Token 或将其留在 Bash 历史记录中。

{drinkzen_admin_cli-0.2.4 → drinkzen_admin_cli-0.3.0}/drinkzen_admin/__init__.py

@@ -1,3 +1,3 @@
 """DrinkZen Admin CLI package."""
 
-__version__ = "0.2.4"
+__version__ = "0.3.0"

{drinkzen_admin_cli-0.2.4 → drinkzen_admin_cli-0.3.0}/drinkzen_admin/cli.py

@@ -12,6 +12,7 @@ from .client import AdminCLIClient
 from .config import cmd_config_path, cmd_config_set, cmd_config_show
 from .formatting import format_cli_output
 from .menu_options import normalize_menu_option_config
+from .skill import install_skill, skill_path
 
 
 # ----------------------------------------------------------------------
@@ -404,6 +405,19 @@ def build_parser() -> argparse.ArgumentParser:
     c_show = config_sub.add_parser("show", help="Show active configuration with masked secrets", parents=[common_parser])
     c_path = config_sub.add_parser("path", help="Print configuration file path", parents=[common_parser])
 
+    # skill
+    skill_parser = subparsers.add_parser("skill", help="Install the agent-neutral DrinkZen Admin Skill")
+    skill_sub = skill_parser.add_subparsers(dest="skill_action", required=True)
+    s_install = skill_sub.add_parser("install", help="Download the Skill into .agents/skills")
+    s_install.add_argument("--scope", choices=["project", "global"], default="project")
+    s_install.add_argument("--project-dir", default=None, help="Project directory for project scope (default: current directory)")
+    s_install.add_argument("--force", action="store_true", help="Replace an existing Skill")
+    s_install.add_argument("--json", action="store_true", help="Output JSON format")
+    s_path = skill_sub.add_parser("path", help="Show the target Skill path")
+    s_path.add_argument("--scope", choices=["project", "global"], default="project")
+    s_path.add_argument("--project-dir", default=None)
+    s_path.add_argument("--json", action="store_true", help="Output JSON format")
+
     # brand
     brand_parser = subparsers.add_parser("brand", help="Brand operations", parents=[common_parser])
     brand_sub = brand_parser.add_subparsers(dest="brand_action", required=True)
@@ -470,6 +484,19 @@ def main(args: list[str] | None = None) -> int:
     is_json = getattr(parsed, "json", False)
     dry_run = getattr(parsed, "dry_run", False)
 
+    if parsed.subcommand == "skill":
+        target = skill_path(parsed.scope, parsed.project_dir)
+        if parsed.skill_action == "path":
+            print(format_cli_output({"path": str(target), "scope": parsed.scope}, parsed.json))
+            return 0
+        try:
+            installed = install_skill(parsed.scope, parsed.project_dir, parsed.force)
+            print(format_cli_output({"installed": True, "path": str(installed), "scope": parsed.scope}, parsed.json))
+            return 0
+        except Exception as exc:
+            print(format_cli_output({"installed": False, "error": str(exc), "path": str(target)}, parsed.json))
+            return 1
+
     # Config commands
     if parsed.subcommand == "config":
         if parsed.config_action == "set":

drinkzen_admin_cli-0.3.0/drinkzen_admin/skill.py

@@ -0,0 +1,35 @@
+"""Install the DrinkZen Admin Agent Skill without binding to a specific agent."""
+
+from __future__ import annotations
+
+import urllib.request
+from pathlib import Path
+
+SKILL_NAME = "drinkzen-admin"
+SKILL_URL = "https://raw.githubusercontent.com/xiaolinstar/drinkzen/main/.agents/skills/drinkzen-admin/SKILL.md"
+
+
+def skill_path(scope: str = "project", project_dir: str | None = None) -> Path:
+    if scope == "global":
+        root = Path.home() / ".agents" / "skills"
+    else:
+        root = Path(project_dir or ".").expanduser().resolve() / ".agents" / "skills"
+    return root / SKILL_NAME / "SKILL.md"
+
+
+def install_skill(
+    scope: str = "project",
+    project_dir: str | None = None,
+    force: bool = False,
+    url: str = SKILL_URL,
+) -> Path:
+    destination = skill_path(scope, project_dir)
+    if destination.exists() and not force:
+        raise FileExistsError(f"Skill already exists: {destination}. Use --force to replace it.")
+    destination.parent.mkdir(parents=True, exist_ok=True)
+    with urllib.request.urlopen(url, timeout=20) as response:
+        content = response.read()
+    if not content:
+        raise RuntimeError("Downloaded Skill is empty")
+    destination.write_bytes(content)
+    return destination

{drinkzen_admin_cli-0.2.4 → drinkzen_admin_cli-0.3.0}/drinkzen_admin_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: drinkzen-admin-cli
-Version: 0.2.4
+Version: 0.3.0
 Summary: Standalone CLI client for DrinkZen Admin operations
 Author: DrinkZen Team
 License: MIT
@@ -64,6 +64,34 @@ PYTHONPATH=packages/admin-cli python3 -m drinkzen_admin.cli config show
 
 ---
 
+## Agent Skill 安装
+
+`drinkzen-admin` 提供与具体 AI 工具无关的运营使用手册。默认安装到当前项目的 `.agents/skills`：
+
+```bash
+drinkzen-admin skill install
+```
+
+如需安装到当前用户的全局 Agent Skill 目录：
+
+```bash
+drinkzen-admin skill install --scope global
+```
+
+查询目标路径或更新已有 Skill：
+
+```bash
+drinkzen-admin skill path --scope project --json
+drinkzen-admin skill path --scope global --json
+drinkzen-admin skill install --force
+```
+
+项目级安装默认使用当前目录，也可以指定项目目录：
+
+```bash
+drinkzen-admin skill install --scope project --project-dir /path/to/project
+```
+
 ## 密钥与持久化配置管理 (`config`)
 
 `drinkzen-admin` 提供了内置的密钥持久化管理，避免每次在终端手动输入敏感 Token 或将其留在 Bash 历史记录中。

{drinkzen_admin_cli-0.2.4 → drinkzen_admin_cli-0.3.0}/drinkzen_admin_cli.egg-info/SOURCES.txt

@@ -6,6 +6,7 @@ drinkzen_admin/client.py
 drinkzen_admin/config.py
 drinkzen_admin/formatting.py
 drinkzen_admin/menu_options.py
+drinkzen_admin/skill.py
 drinkzen_admin_cli.egg-info/PKG-INFO
 drinkzen_admin_cli.egg-info/SOURCES.txt
 drinkzen_admin_cli.egg-info/dependency_links.txt

{drinkzen_admin_cli-0.2.4 → drinkzen_admin_cli-0.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "drinkzen-admin-cli"
-version = "0.2.4"
+version = "0.3.0"
 description = "Standalone CLI client for DrinkZen Admin operations"
 readme = "README.md"
 requires-python = ">=3.9"