对齐参考仓库移除临时技能

scripts/install_codex_runtime.py

@@ -0,0 +1,159 @@
+#!/usr/bin/env python3
+"""Install Codex Game Studios runtime files into a game project.
+
+Current runtime scope:
+- Copy bundled Codex custom agents from this plugin's `runtime/agents/`
+  directory into the target project's `.codex/agents/` directory.
+
+This installer intentionally does not install hooks, rules, MCP servers, apps,
+or AGENTS.md templates yet.
+"""
+
+from __future__ import annotations
+
+import argparse
+import filecmp
+import shutil
+import sys
+from dataclasses import dataclass
+from pathlib import Path
+
+
+def find_plugin_root(start: Path) -> Path:
+    """Walk upward until the Codex plugin manifest is found."""
+    for candidate in [start, *start.parents]:
+        if (candidate / ".codex-plugin" / "plugin.json").is_file():
+            return candidate
+    raise FileNotFoundError(
+        f"Could not find .codex-plugin/plugin.json above: {start}"
+    )
+
+
+PLUGIN_ROOT = find_plugin_root(Path(__file__).resolve())
+SOURCE_AGENTS_DIR = PLUGIN_ROOT / "runtime" / "agents"
+
+
+@dataclass(frozen=True)
+class InstallResult:
+    installed: list[Path]
+    unchanged: list[Path]
+    conflicts: list[Path]
+
+
+def relative_to_target(path: Path, target: Path) -> str:
+    try:
+        return str(path.relative_to(target))
+    except ValueError:
+        return str(path)
+
+
+def discover_agent_files() -> list[Path]:
+    if not SOURCE_AGENTS_DIR.exists():
+        raise FileNotFoundError(f"Source agent directory not found: {SOURCE_AGENTS_DIR}")
+
+    agent_files = sorted(SOURCE_AGENTS_DIR.glob("*.toml"))
+    if not agent_files:
+        raise FileNotFoundError(f"No custom agent TOML files found in: {SOURCE_AGENTS_DIR}")
+
+    return agent_files
+
+
+def install_agents(target: Path, *, force: bool, dry_run: bool) -> InstallResult:
+    agent_files = discover_agent_files()
+    target_agents_dir = target / ".codex" / "agents"
+
+    planned: list[tuple[Path, Path]] = []
+    unchanged: list[Path] = []
+    conflicts: list[Path] = []
+
+    for source in agent_files:
+        destination = target_agents_dir / source.name
+
+        if source.resolve() == destination.resolve():
+            unchanged.append(destination)
+            continue
+
+        if destination.exists():
+            if filecmp.cmp(source, destination, shallow=False):
+                unchanged.append(destination)
+                continue
+
+            if not force:
+                conflicts.append(destination)
+                continue
+
+        planned.append((source, destination))
+
+    if conflicts and not force:
+        return InstallResult(installed=[], unchanged=unchanged, conflicts=conflicts)
+
+    installed = [destination for _, destination in planned]
+    if not dry_run:
+        target_agents_dir.mkdir(parents=True, exist_ok=True)
+        for source, destination in planned:
+            shutil.copy2(source, destination)
+
+    return InstallResult(installed=installed, unchanged=unchanged, conflicts=conflicts)
+
+
+def print_path_list(label: str, paths: list[Path], target: Path) -> None:
+    if not paths:
+        return
+    print(f"{label}:")
+    for path in paths:
+        print(f"- {relative_to_target(path, target)}")
+
+
+def parse_args() -> argparse.Namespace:
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument(
+        "target",
+        nargs="?",
+        default=".",
+        help="Target game project root. Defaults to the current directory.",
+    )
+    parser.add_argument(
+        "--force",
+        action="store_true",
+        help="Overwrite existing agent files when their content differs.",
+    )
+    parser.add_argument(
+        "--dry-run",
+        action="store_true",
+        help="Show what would be installed without writing files.",
+    )
+    return parser.parse_args()
+
+
+def main() -> int:
+    args = parse_args()
+    target = Path(args.target).expanduser().resolve()
+
+    print("Codex Game Studios runtime installer")
+    print(f"Plugin root: {PLUGIN_ROOT}")
+    print(f"Target project: {target}")
+    print("Runtime scope: custom agents only")
+
+    try:
+        result = install_agents(target, force=args.force, dry_run=args.dry_run)
+    except FileNotFoundError as error:
+        print(f"ERROR: {error}", file=sys.stderr)
+        return 1
+
+    print_path_list("Installed" if not args.dry_run else "Would install", result.installed, target)
+    print_path_list("Unchanged", result.unchanged, target)
+    print_path_list("Conflicts", result.conflicts, target)
+
+    if result.conflicts:
+        print(
+            "ERROR: Existing agent files differ. Re-run with --force to overwrite them.",
+            file=sys.stderr,
+        )
+        return 2
+
+    print("Done.")
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

scripts/validate_plugin.py

@@ -12,10 +12,8 @@ from pathlib import Path
 ROOT = Path(__file__).resolve().parents[1]
 FORBIDDEN_NAMES = {".DS_Store", ".env", "plan.md"}
 FORBIDDEN_PARTS = {".git", "__pycache__"}
-REQUIRED_SKILLS = {
+EXPECTED_SKILLS = {
     "brainstorm",
-    "setup-runtime",
-    "using-codex-game-studios",
 }
 REQUIRED_RUNTIME_AGENTS = {
     "art-director.toml",
@@ -78,6 +76,20 @@ def assert_skill(skill_name: str) -> None:
         fail(f"Missing skill description in {skill_path.relative_to(ROOT)}")
 
 
+def assert_skill_set() -> None:
+    present = {
+        path.parent.name
+        for path in (ROOT / "skills").glob("*/SKILL.md")
+    }
+    if present != EXPECTED_SKILLS:
+        fail(
+            "Skill set mismatch. Expected exactly: "
+            + ", ".join(sorted(EXPECTED_SKILLS))
+            + "; found: "
+            + ", ".join(sorted(present))
+        )
+
+
 def assert_runtime_agents() -> None:
     agent_dir = ROOT / "runtime" / "agents"
     if not agent_dir.is_dir():
@@ -113,7 +125,8 @@ def assert_package_hygiene() -> None:
 
 def main() -> int:
     assert_manifest()
-    for skill_name in sorted(REQUIRED_SKILLS):
+    assert_skill_set()
+    for skill_name in sorted(EXPECTED_SKILLS):
         assert_skill(skill_name)
     assert_runtime_agents()
     assert_package_hygiene()