SKILLS 使用指南

概述

Agent Skills 是给 AI 助手阅读的「操作说明书」：以 SKILL.md 为主文件，声明能做什么、何时该用、必须遵守的边界（例如写入前须确认、正文须用文档编辑器 Markdown）。Baklib 官方技能集合托管在开源仓库 baklib-tools/skills，可通过命令行一键安装到 Cursor、Claude Code 等支持技能加载的环境。

技能 不替代 MCP 或 CLI，而是让 AI 更规范地使用这些工具——减少格式错误、越权写入或跳过确认步骤。

操作步骤

步骤一：查看可用技能列表

在终端执行：

npx skills add baklib-tools/skills --list

将输出仓库内所有可通过 CLI 安装的技能 id（目录名），例如 baklib-mcp、baklib-bke-markdown、baklib-cli 等。

预期结果：看到完整技能 id 列表，便于按需选择。

步骤二：安装技能

安装单个技能：

npx skills add baklib-tools/skills --skill baklib-mcp

常用组合（MCP + 文档编辑器正文规范）：

npx skills add baklib-tools/skills --skill baklib-mcp --skill baklib-bke-markdown

通过 Baklib CLI 安装（与上式等价）：

npm install -g @baklib/baklib-cli
baklib skill install --skill baklib-mcp --skill baklib-bke-markdown -g

-g 表示安装到用户级技能目录；具体落盘路径以所用 AI 工具文档为准。

手动安装：从 GitHub 仓库复制 skills/<技能名>/ 整个目录到您项目或编辑器指定的技能目录，须保留其中的 SKILL.md。

预期结果：宿主环境的技能列表中可加载对应技能；对话中涉及 Baklib 读写时 AI 会自动参考其规则。

步骤三：按场景选用技能

下表为 与 Baklib 内容运营 / 开发最相关 的技能摘要；完整列表与更新见仓库 README。

技能 id	适用场景
baklib-mcp	配置 MCP、优先经 MCP 读写 KB/站点/DAM；写入前确认；与 baklib-bke-markdown 配合
baklib-bke-markdown	撰写/解析文档编辑器 Markdown（L1/L2、`dam-id`、文件卡片、链接卡片、片段/分栏等）
baklib-cli	终端执行 `baklib` 子命令（站点/KB/DAM/主题 dev）时的 AI 指引
baklib-theme-dev	Liquid 模板、`settings_schema.json`、`form_tag`、多语言、主题脚手架
baklib-data-import	本地文件批量导入 DAM（基于 baklib-tools/importer）
baklib-intake-assistant	结合 MCP 做录入；本地 Markdown 镜像 + SQLite 台账
requirements-to-published-content	需求 → 方案 → 对外文稿 →（可选）配图 / MCP 发布；多步须先确认
baklib-release-note	根据 CHANGELOG 写对外发布说明
pdf-converter	本地 MinerU：PDF/Office → Markdown，便于入库前处理

图像类（image-generation*、nano-banana-pro-prompting）仅负责提示词或工作流说明，实际出图须您自行配置 API 并确认计费。

预期结果：根据任务类型安装最少必要技能，避免上下文过长。

步骤四：与 MCP / CLI 协同

推荐分工：

对话式查改线上内容 → 配置 MCP 教程 + 安装 baklib-mcp、baklib-bke-markdown
脚本 / CI / 本地主题开发 → 安装 CLI 教程 + baklib-cli；改 Liquid 时再加 baklib-theme-dev
从需求到发布的长流水线 → requirements-to-published-content；AI 会先列出拟执行步骤并征求同意

工作流类技能普遍要求：未确认前不得默认调用计费接口、不得擅自写入线上系统。

预期结果：AI 在正确工具链上执行，且高风险步骤经您确认。

常见问题

Q：技能装在哪里？
A：由 Cursor 等工具定义（如用户目录 .cursor/skills 或项目 .cursor/skills）。npx skills add 会按 CLI 规则写入；详见所用编辑器「创建 Skill」文档。

Q：只装 baklib-mcp 够吗？
A：查询够用；写入知识库或站点富文本 强烈建议同时安装 baklib-bke-markdown，否则扩展语法易写错。

Q：配置密钥放哪？
A：技能约定从工作区 .config/ 或环境变量读取；MCP Token 常见为 ~/.config/BAKLIB_MCP_TOKEN 或 MCP 配置中的 BAKLIB_MCP_TOKEN。与 API 密钥创建的密钥一致。

Q：external-skills / other-skills 是什么？
A：仓库内参考性子模块或补充技能，不在 npx skills add --list 默认安装列表中；需克隆仓库后手动查阅或拷贝。

概述