setup

Workframe 项目初始化

定位

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

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

依赖方向（硬约束）

launcher 只能单向依赖 core，且只能通过 marketplace 注册信息定位 core：

读 ~/.claude/plugins/known_marketplaces.json  → 取本市场 installLocation
  → 拼 <installLocation>/plugins/core/...

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

定位脚本（每次执行前跑一次，一次拿到 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}")
PY

命中 0 个 → 停下告知用户「未找到 workframe 市场，请先 claude plugin marketplace add <源>」。 命中 ≥2 个（用户同时有开发目录源与 GitHub 源）→ 用 AskUserQuestion 让用户选一个，不要自己挑。

SOURCE 就是 §5 步骤 2 里 claude plugin marketplace add <市场源> 要填的值——不要用 CORE 或 installLocation 顶替。三种形态：KIND=github 时 SOURCE 是 owner/repo； KIND=git 时是仓库 URL；KIND=directory 时是本地绝对路径。 installLocation 对 github / git 源是本地缓存目录（~/.claude/plugins/marketplaces/<市场名>）， 拿它当市场源写进项目 settings，等于把每台机器各不相同的缓存路径当成插件来源—— 协作者 clone 后解析不到，core 装不上（doctor 的 subscription 项会报本地目录源告警， 但那时项目已经建好了）。KIND=directory 时同样要提醒用户该项目对协作者不可自动安装（见 §5.5）。

交互纪律（本 skill 内生效，不依赖项目 rules）

launcher 常在尚未接入 Workframe 的目录运行，此时项目 rules 尚不存在，以下纪律必须由本 skill 自带：