Add generic Claw skill-template (manifest, CLI, docs, optional snippets)

Made-with: Cursor

optional/paths_snippet.py

@@ -0,0 +1,92 @@
+# -*- coding: utf-8 -*-
+"""
+可选片段：路径与环境变量（请复制到 scripts/ 或作为独立模块使用）
+================================================================
+
+【用途】
+  统一解析「用户数据根」「用户 ID」「本技能私有目录」，避免在业务代码里重复 os.getenv。
+
+【使用步骤】
+  1. 将本文件复制到 skills/your-slug/scripts/paths.py（或任意模块名）。
+  2. 把 SKILL_SLUG 改为与 SKILL.md 中 metadata.skill.slug 一致。
+  3. 在业务代码中: from paths import get_skill_data_dir  （按实际包路径调整）
+
+【可移植性】
+  - 优先读取标准名 CLAW_*（见 docs/RUNTIME.md）。
+  - 若你的组织在宿主侧仍使用历史变量名，可在此文件 _aliases 列表中追加 (标准名, 备选名)，
+    由宿主注入其一即可；不要在业务里再写第三套名字。
+
+【注意】
+  - 未设置 CLAW_DATA_ROOT 时的 fallback 仅适合开发机；生产环境应由宿主注入。
+"""
+
+from __future__ import annotations
+
+import os
+import sys
+
+# TODO: 复制本文件后改为你的 slug（与 SKILL.md metadata.skill.slug 一致）
+SKILL_SLUG = "your-skill-slug"
+
+
+def _getenv_first(names: tuple[str, ...]) -> str:
+    """按顺序读取多个环境变量名，返回第一个非空值。"""
+    for n in names:
+        v = (os.getenv(n) or "").strip()
+        if v:
+            return v
+    return ""
+
+
+def get_data_root() -> str:
+    """
+    用户数据根目录。
+    顺序：CLAW_DATA_ROOT → （可选）宿主别名，见下方元组。
+    若皆空：Windows 默认 D:\\claw-data；其它系统默认 ~/.claw-data —— 仅开发便利，生产请注入 CLAW_DATA_ROOT。
+    """
+    root = _getenv_first(
+        (
+            "CLAW_DATA_ROOT",
+            # 在此追加组织内别名，例如 "MYORG_USER_DATA_ROOT",
+        )
+    )
+    if root:
+        return root
+    if sys.platform == "win32":
+        return r"D:\claw-data"
+    return os.path.join(os.path.expanduser("~"), ".claw-data")
+
+
+def get_user_id() -> str:
+    """当前用户或工作空间 ID；未设置时用 _anon（仅开发）。"""
+    uid = _getenv_first(
+        (
+            "CLAW_USER_ID",
+            # 在此追加别名，例如 "MYORG_WORKSPACE_ID",
+        )
+    )
+    return uid or "_anon"
+
+
+def get_skill_data_dir() -> str:
+    """
+    本技能可写目录：{数据根}/{用户ID}/{skill_slug}/
+    会自动 os.makedirs(..., exist_ok=True)。
+    """
+    path = os.path.join(get_data_root(), get_user_id(), SKILL_SLUG)
+    os.makedirs(path, exist_ok=True)
+    return path
+
+
+def get_skills_root() -> str:
+    """
+    可选：并列安装的多技能根目录。
+    未设置 CLAW_SKILLS_ROOT 时，默认使用本文件所在仓库的上一级目录的上一级
+    （即：.../skill-template/scripts/ → 误推断；复制后请改为 BASE_DIR 逻辑）。
+    """
+    root = _getenv_first(("CLAW_SKILLS_ROOT",))
+    if root:
+        return root
+    # 模板占位：脚本位于 scripts/，仓库根为 dirname(dirname(__file__))
+    here = os.path.dirname(os.path.abspath(__file__))
+    return os.path.dirname(here)