技能介绍

解决什么问题

部署完灵台后，MCP 工具列表里会挂上 86 个工具。接着你打开 README，读完十几页文档，发现里面没有告诉你：第一次对话到底该调哪个工具、按什么顺序调、每步怎么确认成功。

结果就是典型的"装完即卡住"：知道有 page_create，但不确定路径前缀该写 丹房/ 还是别的；context_load 没返回，不知道是 MCP 配置错了还是知识库目录没建。本技能就是把这段从"部署完成"到"第一次真正用起来"的空白补上——不替代 README，只负责让你在第一轮对话里跑通完整入门流程。

技能如何工作

技能的核心是一条三步引导链路：

确认门开了：先调 context_load 验证连接。返回知识库统计信息（页面数、域数、品级分布）才算连接成功。没返回就检查 MCP 配置——cwd 路径、LINGTAI_VAULT 环境变量、Python 版本三项是高发原因。
留下第一条知识：调 page_create 在 丹房/ 下建页，再用 page_read 读回确认。技能会解释品级体系（草稿 → 下品 → 中品 → 上品），并提示刚建的页面默认可能是草稿，后续可用 refine_quick 或 refine_mark 提级。
按意图找工具：86 个工具不需要全记住。技能维护一张"我想做什么 → 用什么工具"的映射表，覆盖记录、检索、整理、状态查看、任务执行五类意图，比如临时想法用 memory_write，语义检索用 knowledge_search，知识体检用 health_ledger。

触发逻辑分两种：说"带我入门"走完整三步；直接说"帮我记个东西"则跳过前两步，进入按意图选工具。技能还内置了新手常见错误表（路径乱码、目录不存在、工具列表不全等）和每步操作的成功/失败标志对照，工具报错时先读 error 或 hint 字段再排查。

适用边界

本技能不是安装器：必须先按 README 完成部署和 MCP 配置，再回来走向导。检测不到 context_load 返回有效数据时，技能会引导你去部署，不会假装有后端。
不替代完整文档：工具的完整参数列表、深层系统配置（索引重建、语义模型、数据迁移）在灵台仓库的 MCP 文档和 AGENTS.md 里，本技能只负责"在哪找"和"怎么用"。
不替用户做决策：知识该放丹房还是记忆层、品级该给多少，由你判断，技能只解释区别和默认行为。
老用户不需要每次走向导：入门三步走完后，日常直接调工具即可。
只覆盖新手层排障：涉及 Mixin 模块导入失败、Obsidian 库改造等具体操作，技能会给出排查方向，但深层问题仍需查仓库文档。