Skip to content

PhilRobinluo/ai-coevolution-skills / skills/lls-skill-lifecycle-manager

lls-skill-lifecycle-manager

Verified

管理相互隔离的私有 Skill 母库与公开 Skill 分享库。用于在选定仓库内新建、升级、查重、审计、打包、发布或恢复 Skill,并维护该仓库自己的版本、来源、许可证、GitHub Release、飞书说明、WorkBuddy 与 SkillHub 状态。两库各自是真源,公开版只能独立创作和审核;不建立复制、镜像、同步、自动导出或一键公开链路。

scripts/audit-repository.py

View on GitHub
#!/usr/bin/env python3
"""只读审计一个 Skill 真源仓库;刻意不接受另一个仓库作为输入。"""

from __future__ import annotations

import argparse
import json
import subprocess
from pathlib import Path


def git(repo: Path, *args: str) -> str:
    result = subprocess.run(
        ["git", "-C", str(repo), *args],
        check=False,
        capture_output=True,
        text=True,
    )
    return result.stdout.strip() if result.returncode == 0 else ""


def skill_dirs(root: Path) -> dict[str, Path]:
    if not root.is_dir():
        return {}
    return {
        child.name: child
        for child in root.iterdir()
        if child.is_dir() and (child / "SKILL.md").is_file()
    }


def symlink_paths(root: Path) -> list[str]:
    """符号链接可能绕过双库边界,因此单独列出供发布前拦截。"""
    if not root.is_dir():
        return []
    return sorted(
        path.relative_to(root).as_posix()
        for path in root.rglob("*")
        if path.is_symlink()
    )


def main() -> int:
    parser = argparse.ArgumentParser()
    parser.add_argument("--repository", type=Path, required=True)
    parser.add_argument("--role", choices=("private", "public"), required=True)
    parser.add_argument("--runtime", type=Path)
    parser.add_argument("--json", action="store_true")
    args = parser.parse_args()

    repository = args.repository.expanduser().resolve()
    skills = skill_dirs(repository / "skills")
    links = symlink_paths(repository)
    report: dict[str, object] = {
        "role": args.role,
        "repository": {
            "path": str(repository),
            "exists": repository.is_dir(),
            "branch": git(repository, "branch", "--show-current"),
            "clean": git(repository, "status", "--porcelain") == "",
            "remote": git(repository, "remote", "get-url", "origin"),
            "head": git(repository, "rev-parse", "--short", "HEAD"),
        },
        "skill_count": len(skills),
        "symlinks": links,
        "isolation_pass": not links,
    }

    if args.runtime:
        runtime = args.runtime.expanduser().resolve()
        runtime_skills = skill_dirs(runtime)
        report["runtime"] = {
            "path": str(runtime),
            "installed_top_level": len(runtime_skills),
            "overlap": sorted(runtime_skills.keys() & skills.keys()),
        }

    if args.json:
        print(json.dumps(report, ensure_ascii=False, indent=2))
    else:
        repo = report["repository"]
        assert isinstance(repo, dict)
        print(f"Role: {args.role}")
        print(f"Repository: {repo['path']}")
        print(f"Skills: {len(skills)}")
        print(f"Git clean: {repo['clean']}")
        print(f"Symlinks: {len(links)}")
        print(f"Isolation: {'PASS' if not links else 'REWORK'}")
        if "runtime" in report:
            runtime_report = report["runtime"]
            assert isinstance(runtime_report, dict)
            print(f"Runtime overlap: {len(runtime_report['overlap'])}")
    return 0 if not links else 1


if __name__ == "__main__":
    raise SystemExit(main())
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall