菜单
Use when the user needs cache-first or live-search access to Shuiyuan topics through the external shuiyuan_exporter repository.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Use as the workspace-level entry skill for this repository when responses should follow BetterGPT defaults. This skill routes by default to BetterLanguage for language shaping, then applies task-specific enhancements only when needed, such as BetterFrontend for frontend presentation work, BetterVibe for full-stack engineering boundary and maintainability guidance, BetterTrellis for Trellis workflow, Codex soft integration, initialization, spec, task, and hooks-related guidance, and BetterSubagents for subagent delegation, orchestration, wait handling, and takeover guardrails. Use when a single main entry skill should coordinate default loading order and on-demand sub-skill activation.
Use when tasks involve reading, creating, or reviewing PDF files where rendering and layout matter; prefer MinerU API first for parsing/extraction, then use visual checks with Poppler and Python tools such as `reportlab`, `pdfplumber`, and `pypdf` for generation or fallback extraction.
Use when generating, revising, polishing, or reviewing frontend UI, landing pages, dashboards, app screens, marketing pages, or other presentation-layer output that should look like a production-ready product instead of a demo, draft, wireframe, showcase, or developer-facing mockup. Especially use when the request mentions removing AI-like UI, avoiding demo feel, preventing TODO or note text, hiding reasoning or design commentary from users, eliminating placeholder explanations, or making the final interface feel shippable, real, and user-facing.
Use when GPT-5.4 style answers need to be rewritten into concise, natural Chinese with minimal filler, no internet slang or habitual phrasing, and a strict two-part structure that users can scan top-to-bottom at a glance. Especially use when the output should preserve two-part reasoning and solution flow without always printing rigid section titles, allow light line breaks for readability, remove translation-like Chinese, and switch to terminal-friendly rendering when the current surface is CLI or shell rather than an app-style chat surface.
Use when the task involves subagent selection, delegation strategy, parallel execution, wait and timeout handling, fallback takeover, or how to correctly use the project's local agents together with repository skills and MCP tools. Especially use when the user asks how to orchestrate explorer, worker, reviewer, docs-researcher, code-mapper, frontend-developer, browser-debugger, refactoring-specialist, or other local subagents, or when the main agent needs stronger delegation guardrails.
Use when working with Trellis in Codex, especially for soft integration, project initialization, workflow entry, spec and task organization, hooks, generated command structure, or reducing the need to remember Trellis commands manually. Use when the request mentions Trellis init, Codex integration, workflow, spec, task, workspace logs, hooks, update, onboarding, or agent command mapping.
| name | shuiyuan-cache-skill |
| description | Use when the user needs cache-first or live-search access to Shuiyuan topics through the external shuiyuan_exporter repository. |
这是一个 thin wrapper。真正的运行时代码位于外部 WncFht/shuiyuan_exporter 仓库中；cache、auth 和导出目录都位于当前 skill 目录之外。
WncFht/shuiyuan_exporter$HOME/Desktop/src/shuiyuan_exporterSHUIYUAN_EXPORTER_REPOrepo:WncFht/shuiyuan_exporteragent-basic-skill 仓根目录运行 python scripts/install_skill.py shuiyuan-cache-skill安装器会读取同目录下的 external-repos.json；它只在显式安装时检查或 clone 外部仓，运行时 resolver 仍然只做检测不做安装。
优先级：
--repo-rootSHUIYUAN_EXPORTER_REPOrepo:WncFht/shuiyuan_exporter$HOME/Desktop/src/shuiyuan_exporter解析示例：
python scripts/resolve_shuiyuan_paths.py --json
如果你需要具体运行细节，按需读取：
references/runbook.mdreferences/runtime_layout.mdreferences/output_schema.mdreferences/topic-study-workflow.mdreferences/troubleshooting.mdSHUIYUAN_CACHE_ROOT 默认回退到 ~/.local/share/shuiyuan-cache-skillREPO_ROOT="$(python scripts/resolve_shuiyuan_paths.py --print repo_root)"
CACHE_ROOT="${SHUIYUAN_CACHE_ROOT:-$HOME/.local/share/shuiyuan-cache-skill}"
uv run --project "$REPO_ROOT" python -m shuiyuan_cache.cli.auth_cli status \
--cache-root "$CACHE_ROOT/cache" \
--cookie-path "$CACHE_ROOT/cookies.txt" \
--check-live
cache/、auth.json、browser_profile/ 或导出结果塞进 skill 目录python scripts/install_skill.py shuiyuan-cache-skill，或自行 clone WncFht/shuiyuan_exporter 后再设置 SHUIYUAN_EXPORTER_REPO