setup

Workframe 项目初始化

定位

Workframe 的唯一入口：在任意目录发起，创建新项目或接入存量项目，完成后由 core 插件接管项目内的日常工作。

本 skill 属用户级 workframe-launcher 插件，与项目级 core 插件分层：launcher 管「怎么开局」，core 管「项目里怎么干活」。

依赖方向（硬约束）

launcher 只能单向依赖 core，且只能通过 marketplace 注册信息定位 core。 两扇门各有自己的注册信息，所以定位器有两个：

CC 门：   读 ~/.claude/plugins/known_marketplaces.json  → 取本市场 installLocation
Codex 门：读 codex plugin marketplace list --json        → 取本市场 root
  → 拼 <installLocation 或 root>/plugins/core/...

不要去探测「我现在跑在哪扇门里」，按结果判：两个定位器按序各跑一次，谁解析得到用谁。 框架自己就是拒绝探测的——_harness.harness() 的判据是命令行 --harness（两份 hooks.json 各自传），它的 docstring 逐字写着探测法在嵌套启动时 CLAUDE_* 会泄漏进 Codex 的 hook 环境、 恒判成 CC；而本 skill 根本没有 hooks.json、没人给它传 --harness。 定位器跑不通（命令不存在 / 文件不在 / 解析失败）就是「这扇门没有」，不是错误，不要报错停下。

禁止用 ../ 一类相对路径向上找 core：插件安装时按插件逐个复制到缓存 （cache/<市场>/<插件>/<版本>/），launcher 的安装目录旁边不存在 core。 目录源（开发期）碰巧有兄弟目录，GitHub 源（用户侧）没有——该写法开发期能跑、发布后必坏。

定位脚本 A（CC 门的注册表）——每次执行前跑一次，一次拿到 CORE 根路径和市场源：

python - <<'PY'
import json, pathlib
km = json.loads((pathlib.Path.home()/".claude/plugins/known_marketplaces.json").read_text(encoding="utf-8"))
for name, meta in km.items():
    loc = pathlib.Path(meta.get("installLocation", ""))
    mf = loc/".claude-plugin"/"marketplace.json"
    if not mf.exists():
        continue
    names = {p.get("name") for p in json.loads(mf.read_text(encoding="utf-8")).get("plugins", [])}
    if not ({"core", "workframe-launcher"} <= names):
        continue
    src = meta.get("source") or {}
    kind = src.get("source") or ("directory" if src.get("path") else "?")
    origin = src.get("repo") or src.get("url") or src.get("path") or "?"
    print(f"MARKET={name}\tCORE={loc/'plugins'/'core'}\tSOURCE={origin}\tKIND={kind}\tVIA=cc")
PY

定位脚本 B（Codex 门的注册表）——A 一条都没输出、或要核对是不是同一个市场时跑：

python - <<'PY'
import json, os, pathlib, shutil, subprocess
try:
    # 必须先 which 出全路径：Windows 上 npm 装的是 codex.CMD，而 CreateProcess 不按
    # PATHEXT 找——直接给 "codex" 会抛 FileNotFoundError，看起来就像「没装 codex」
    exe = os.environ.get("WF_CODEX_EXE") or shutil.which("codex")
    r = subprocess.run([exe, "plugin", "marketplace", "list", "--json"],
                       capture_output=True, text=True, encoding="utf-8", timeout=90)
    rows = json.loads(r.stdout).get("marketplaces", []) if r.returncode == 0 else []
except Exception:
    rows = []                      # 没装 codex / 命令失败 ⇒ 这扇门没有，不是错误
cfg = {}
try:
    import tomllib
    home = pathlib.Path(os.environ.get("CODEX_HOME") or (pathlib.Path.home()/".codex"))
    cfg = tomllib.loads((home/"config.toml").read_text(encoding="utf-8")).get("marketplaces", {})
except Exception:
    pass
UNC = chr(92)*2 + "?" + chr(92)    # Windows 扩展长度前缀，写成 chr() 免得被 shell 吃掉反斜杠
for row in rows:
    root = pathlib.Path(row.get("root") or "")
    mf = root/".claude-plugin"/"marketplace.json"
    if not mf.exists():
        continue
    names = {p.get("name") for p in json.loads(mf.read_text(encoding="utf-8")).get("plugins", [])}
    if not ({"core", "workframe-launcher"} <= names):
        continue
    name = row.get("name") or "?"
    entry = cfg.get(name) or {}
    origin = str(entry.get("source") or "?")
    if origin.startswith(UNC):
        origin = origin[len(UNC):]
    st = entry.get("source_type") or "?"
    print(f"MARKET={name}\tCORE={root/'plugins'/'core'}\tSOURCE={origin}\tKIND="
          + ("directory" if st == "local" else st) + "\tVIA=codex")
PY