运维与自动化
让 AI 成为内容运营助手：gcms Skill 使用指南
从后台下载专属 AI 接入包，交给 Codex、Claude Code 或 Cursor，让 AI 按权限诊断、巡检、写草稿、补 SEO 和上传图片。
如果说自动化接口解决的是「AI 能不能安全访问网站」，那么 gcms Content Assistant Skill 解决的是下一步：AI 到底该按什么规则工作。
它不是一个在线服务，也不是 gcms 主动调用的大模型 API。它是一份可以下载的接入包，里面包含权限专用密钥、OpenAPI 描述、AI 使用说明、Skill 文件和一个命令行脚本。你把它交给 AI 工具，AI 就能按你的权限边界处理文章、页面、链接和媒体。
先准备 gcms 本体
如果你还没有运行 gcms，先从发布仓库下载正式包：
- 下载发布包：GitHub Releases；
- 一键安装：
curl -fsSL https://raw.githubusercontent.com/ccvar/gcms-releases/main/install.sh | sh； - 本地启动后进入
/admin，先修改默认后台密码。
Skill 不是单独安装到服务器上的插件。它是给外部 AI 工具使用的，所以要先有一个已经能访问的 gcms 站点，再给 AI 创建受限访问权限。
在哪里下载 Skill
进入后台「设置 → 自动化接口」，点击「创建访问权限」。给它起一个清楚的名字，例如「内容运营助手」或「SEO 草稿助手」，然后勾选需要的能力。
创建成功后，页面会显示一次访问密钥，并提供「AI技能包」。这就是最推荐的下载入口，因为包里已经写好当前站点的 GCMS_API_BASE 和这一条权限对应的 GCMS_API_KEY。
如果你只是开发或本地调试，也可以参考源码里的 skills/gcms-content-assistant 模板；但正式使用时，仍然建议从自己的后台下载专属包。密钥和权限属于你的站点，不应该从公共仓库复制。
怎么安装到 AI 工具
下载后解压，你会看到一个快速说明 README.md，以及一个完整的 gcms-content-assistant 文件夹。这个文件夹里包含：
AI助手说明.md：给 AI 看的任务边界、内容模型和安全规则；SKILL.md：支持 Skills 的工具可以直接读取；references/openapi.json：当前站点自动化接口的完整描述；scripts/gcms.js：可选命令行脚本，用来做 doctor 检查和常见读写操作；- 隐藏的
.env或.env.example：保存GCMS_API_BASE和GCMS_API_KEY。
安装方式取决于你使用的工具：
- Codex / Claude Code / Cursor：把整个
gcms-content-assistant文件夹交给工具读取，或在项目中打开这个文件夹； - 支持 Skills 的工具：把
gcms-content-assistant作为一个 Skill 目录使用； - 普通 AI 工具：让它先读取
README.md、AI助手说明.md、隐藏的.env和references/openapi.json，再按接口说明发 HTTP 请求； - 开发者脚本：在
gcms-content-assistant目录里运行node scripts/gcms.js doctor，脚本会读取.env并检查连接。
第一次接入后，先让 AI 读取说明文件、.env 和 OpenAPI，并运行：
node scripts/gcms.js doctor
如果不用脚本，也可以先请求 GET /languages。这个检查可以确认接口地址、密钥、OpenAPI、启用语种和基础权限。检查通过后，再让 AI 写内容，会少很多来回排错。
它适合做什么
这个 Skill 适合承担内容运营里的重复和整理工作：
- 检查最近一批文章是否缺标题、摘要、SEO 描述、关键词、分类或封面图；
- 根据资料创建文章草稿，并自动查询
category_id； - 上传 WebP 封面图或正文图片，把返回 URL 写入
cover_image或 Markdown 图片； - 维护链接资源，补充介绍、摘要、SEO 字段和分类；
- 按
trans_group找到多语种版本，分别优化各语种标题和描述； - 新增自定义语种，或启用越南语
vi、印尼语id、泰语th等预设语种； - 置顶或取消置顶文章和链接，用于调整首页精选内容；
- 发布前复核草稿是否具备上线条件。
它不应该默认发布内容，也不应该改站点设置、主题、安全、导航和分类结构。这些仍然由后台人工操作更稳。
给 AI 的任务要怎么说
不要只说「帮我优化一下网站」。更好的说法是把范围、对象、动作、边界和输出讲清楚：
先读取 README、.env 和 OpenAPI，检查连接和权限。
检查最近 50 篇中文文章，重点看标题、摘要、SEO 描述、关键词、分类和封面图。
只输出问题列表和建议，不要修改内容。
如果发现多个相似标题，先列出 ID 让我确认。
最后按优先级给我一个表格：id、标题、问题、建议动作。
创建内容时也一样明确：先查分类、保持草稿、上传图片后写入封面、完成后回读确认字段。AI 越清楚边界，越像一个可靠的运营助理。
权限建议
刚开始只给 languages:read、分类读取、内容读取和草稿写入。等你确认流程稳定后，再考虑给某个专用助手增加发布权限。发布权限最好单独创建一条密钥，不要和日常巡检助手混在一起。
如果密钥泄露、任务结束或工具不用了，直接回到后台吊销对应访问权限。gcms 会记录最近使用时间，方便你判断哪些权限已经闲置。
好的 Skill 不是让 AI 无所不能，而是让它在清楚的边界里稳定做事。