玩法案例库 (gameplay-kb) — LLM Wiki

一个 给 AI 写新活动用的实现 recipe wiki。拿到新需求不知如何下手时，按索引导航到类似玩法的卡，照着卡里的 master 文件:行号 抄。设计遵循 LLM Wiki（参考 Karpathy LLM Wiki / SamurAIGPT llm-wiki-agent）：靠索引导航，不靠向量检索；渐进式披露（根索引→家族→叶子卡→代码）；卡间 [[id]] 互链；编译一次、持续维护。

0. 先定位库根（每次必做）

本 skill 自包含：skill 目录即玩法库根（含 index.md + cards/ + tools/）。用 Claude Code 提供的 ${CLAUDE_SKILL_DIR} 变量定位（它指向本 skill 安装目录，跨机器可移植，不要写死绝对路径）：

KB="${CLAUDE_SKILL_DIR}"                       # skill 目录就是库根
python3 "$KB/tools/kb_lib.py" >/dev/null || KB="$(python3 "$KB/tools/kb_lib.py")"   # 校验/规范化
echo "$KB"

兜底：若环境没有 ${CLAUDE_SKILL_DIR}，export GAMEPLAY_KB=<库根绝对路径> 后所有 tools/*.py 都优先认它；或直接在库根目录下跑 python3 tools/kb_lib.py（它会向上回溯定位 cards/+index.md）。 查询只需读卡（任何机器可用）；新增/维护要校验/取行号——代码直接读 master 代码工作区（环境变量 WESPY_AI_WORKSPACE_MASTER 指向的 git worktree，不走 git show origin/master）；校验前先 git -C "$WESPY_AI_WORKSPACE_MASTER" pull --ff-only 拉最新。新增另需 act-cli + 飞书凭证。

模式路由