chore: auto release commit (2026-07-03 18:50:07)

tools/scaffold_skill.py

@@ -0,0 +1,106 @@
+#!/usr/bin/env python3
+"""跨平台 skill-template 脚手架（与 scaffold_skill.ps1 行为一致）。"""
+from __future__ import annotations
+
+import argparse
+import re
+import shutil
+import sys
+from pathlib import Path
+
+EXCLUDE_DIR_NAMES = {".git", ".pytest_cache", "__pycache__"}
+EXCLUDE_FILE_NAMES = {".env", ".env.local"}
+KEBAB_SLUG = re.compile(r"^[a-z0-9]+(-[a-z0-9]+)*$")
+
+
+def _ignore_copy(_dir: str, names: list[str]) -> set[str]:
+    ignored: set[str] = set()
+    for name in names:
+        if name in EXCLUDE_DIR_NAMES or name in EXCLUDE_FILE_NAMES:
+            ignored.add(name)
+        elif name.endswith(".pyc"):
+            ignored.add(name)
+    return ignored
+
+
+def _print_next_steps(target: Path) -> None:
+    print()
+    print("=== 脚手架复制完成 ===")
+    print(f"目标目录: {target}")
+    print()
+    print("请在本机继续执行（未自动 git init，避免误操作）：")
+    print(f'  cd "{target}"')
+    print("  Remove-Item -Recurse -Force .git -ErrorAction SilentlyContinue   # 若曾手工复制漏删")
+    print("  git init")
+    print("  git remote add origin <你的新技能仓库 URL>")
+    print("  git remote -v    # 确认 remote 不是 skill-template")
+    print("  python tests/run_tests.py -v")
+    print()
+
+
+def main(argv: list[str] | None = None) -> int:
+    parser = argparse.ArgumentParser(description="从 skill-template 脚手架复制新技能目录")
+    parser.add_argument("--slug", required=True, help="kebab-case slug，须与目标目录名一致")
+    parser.add_argument("--destination", required=True, help="新技能完整目标路径")
+    parser.add_argument("--force", action="store_true", help="目标非空时允许覆盖（目标不得含 .git）")
+    args = parser.parse_args(argv)
+
+    slug = args.slug.strip()
+    if not KEBAB_SLUG.match(slug):
+        print(f"ERROR: Slug 必须是 kebab-case，当前: {slug}", file=sys.stderr)
+        return 1
+
+    target = Path(args.destination).resolve()
+    if target.name != slug:
+        print(
+            f"ERROR: 目标目录末段 '{target.name}' 与 slug '{slug}' 不一致。",
+            file=sys.stderr,
+        )
+        return 1
+
+    parent = target.parent
+    if not parent.is_dir():
+        print(f"ERROR: 父目录不存在: {parent}", file=sys.stderr)
+        return 1
+
+    if (target / ".git").exists():
+        print(
+            f"ERROR: 目标已存在 .git，请先删除: {target / '.git'}",
+            file=sys.stderr,
+        )
+        return 1
+
+    template_root = Path(__file__).resolve().parent.parent
+    if target.exists():
+        entries = list(target.iterdir())
+        if entries and not args.force:
+            print(
+                f"ERROR: 目标目录已存在且非空: {target}\n请加 --force 或换空目录。",
+                file=sys.stderr,
+            )
+            return 1
+
+    target.mkdir(parents=True, exist_ok=True)
+    print(f"复制模板: {template_root} -> {target}")
+    for item in template_root.iterdir():
+        name = item.name
+        if name in EXCLUDE_DIR_NAMES or name in EXCLUDE_FILE_NAMES:
+            continue
+        if name.endswith(".pyc"):
+            continue
+        dest = target / name
+        if item.is_dir():
+            shutil.copytree(item, dest, ignore=_ignore_copy, dirs_exist_ok=True)
+        else:
+            shutil.copy2(item, dest)
+
+    marker = target / ".openclaw-skill-template"
+    if marker.is_file():
+        marker.unlink()
+
+    _print_next_steps(target)
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())