Postiz Agent Skill
一个 CLI 技能，让 AI 代理可以通过命令行向 X、LinkedIn、TikTok、Instagram 等 28+ 平台定时发布内容。
文档透明披露了认证方式(OAuth2/密钥)、凭据存储位置(~/.postiz/credentials.)、API密钥经环境变量传入及数据流向(上传到Postiz CDN后再发布)；无隐瞒、无恶意行为。扣分项：技能授予 Bash(postiz:*) 宽泛权限，发布、删除帖子属不可逆外部效果，SKILL.md 未内置“发布前需用户确认”的门控；draft 模式虽被提及但非强制；未验证发布方身份。
SKILL.md 自身高度自洽，四条硬规则、常见陷阱、错误处理与重试脚本齐全，失败反馈说明清晰(如 TikTok 静默丢弃设置的风险提示)。扣分项：纯静态审查无法执行复现关键路径，无已提交测试证据覆盖该技能路径；SKILL.md 文件在末尾被截断(规则4列表未完)，示例中存在 -d 2000(秒)与 -d 5(分钟)等单位混用易致误读。
受众(需要通过AI代理定时发帖的开发者/营销者)和触发场景描述明确，28+平台列举清楚，参数与输出格式有示例支撑。扣分项：核心功能完全依赖 postiz.com、npm 及各海外社交平台，从中国大陆网络可达性存疑；无中文支持说明；未发布的错误恢复边界(如上传后失败)披露有限。
文档分层好(SKILL.md→深度文档→示例)，有 Keep a Changelog 格式的更新日志和版本号，安装说明完整。扣分项：仓库 license 元数据为 NOASSERTION；文档间版本不一致(PROJECT_STRUCTURE 写 1.0.0，CHANGELOG 已到 2.0.17)；SKILL.md 末尾截断未修复；发布方维护责任与更新路径未明确声明。
核心任务(经CLI定时发布社媒内容)路径描述完整，输出可直接使用，相较手工操作有明显边际价值，draft/重试等模式控制成本。扣分项：静态审查无法验证实际产出可用性，无已执行的代表性输出证据；价值主张部分依赖对 agent-media 等第三方CLI的推广性推荐。
提供了大量可审计一手材料(命令语法、API端点、JSON schema、响应示例)可交叉核对。扣分项：全部为作者自述材料，无独立复现、无第三方执行证据或测试结果，营销性总结(✅全支持)与事实表述混杂。
- 发布/删除帖子为不可逆外部操作，建议使用前先以 draft 模式验证并自行添加确认环节
- 技能授予 Bash(postiz:*) 宽泛权限，请审慎评估授权范围
- 核心功能依赖 postiz.com、npm 及海外社交平台，中国大陆网络可达性未经验证；无中文支持
- 仓库 license 元数据为 NOASSERTION，发布方未经注册表验证，授权状态需自行确认
- 文档存在版本不一致与 SKILL.md 末尾截断；延迟参数单位(秒/分钟)在不同示例中不一致
- 静态审查未执行任何命令，实际可用性与 TikTok 等平台静默失败风险需自行测试
这个 Skill 能做什么，适合哪些场景？
postiz 技能把 Postiz CLI 暴露给 AI 代理，用于在 28+ 社交平台上安排和管理帖文。它覆盖认证、集成发现、媒体上传、发布、草稿管理、平台特定设置和数据分析的完整流程。所有命令输出 JSON，便于代理解析和串联。该仓库同时是 Claude Code 插件、Cursor 插件和 Grok 插件市场条目，并通过 npx skills 安装。
通过 postiz CLI 运行命令：auth:login/auth:status（OAuth2 设备流或 POSTIZ_API_KEY）完成认证；integrations:list 与 integrations:settings 发现已连接的账号及其设置模式；postiz upload 上传媒体并返回 Postiz 验证 URL（TikTok、Instagram、YouTube 等要求必须使用）；posts:create 创建带媒体、评论/线程、平台特定设置的多平台定时帖文；posts:list/status/delete/settings 管理帖文；analytics:platform 与 analytics:post 获取数据，若返回 {"missing": true} 则用 posts:missing + posts:connect 关联发布内容。
- 运营人员让代理每周定时向 X、LinkedIn、Facebook 发布同一内容的多平台活动。
- 视频创作者需要把上传的视频先经 postiz upload 再以 DIRECT_POST 方式发布到 TikTok。
- 社区管理员向指定 subreddit 发帖并自动获取和填充正确的 flair。
- 营销团队批量安排整周内容并按平台截断超长文案。
- 需要查看各平台粉丝、展示量和互动数据，并修复 missing release ID 的代理用户。
这个 Skill 有哪些优点和局限？
- 覆盖 28+ 平台，包括 X、LinkedIn、Reddit、YouTube、TikTok、Instagram、Facebook 等
- 所有命令输出 JSON，便于代理程序化处理
- 支持 OAuth2 设备流认证，无需手动管理 client secret
- 集成工具工作流可动态获取 Reddit flair、YouTube 播放列表等平台数据
- SKILL.md 对常见坑（媒体必须上传、TikTok 静默丢弃无效设置等）有明确警告
- 强依赖 Postiz 服务和 Postiz API（默认 api.postiz.com），不是纯本地工具
- GitHub 仓库 License 字段为 NOASSERTION，Postiz 主项目为 AGPL-3.0，商业使用需自行确认
- 不经过 postiz upload 的媒体会被多数平台拒绝，增加一步必要流程
- 部分平台（如 TikTok）发布后不返回 post ID，需手动 posts:connect 才能看分析数据
- 除仓库自带示例外，未提供独立的测试套件或各平台实测证明
如何安装这个 Skill？
1) 安装 CLI：npm install -g postiz（或 pnpm install -g postiz）。2) 安装技能：npx skills add gitroomhq/postiz-agent。或作为 Claude Code 插件：/plugin marketplace add gitroomhq/postiz-agent 然后 /plugin install postiz@postiz-agent。Cursor 用户可在 Customize 面板安装；Grok Build 用户可从 xAI 插件市场安装（该插件还捆绑托管 MCP 服务器 mcp.postiz.com）。CLI 也可从 GitHub 的 .cursor-plugin/plugin. 等清单手动安装。
如何使用这个 Skill？
先认证：postiz auth:login（设备流）或 export POSTIZ_API_KEY=your_api_key；可选 export POSTIZ_API_URL 指向自托管 API。然后按流程执行：postiz auth:status → postiz integrations:list 获取集成 ID → postiz integrations:settings <id> 查看规则与设置 → postiz upload <file> 上传媒体并用 jq 提取 .path → postiz posts:create -c "内容" -s "2024-12-31T12:00:00Z" -i "集成ID" -m "上传后的URL"。注意：传给 -m 的值必须是 upload 返回的 .path，不能是本地文件或外部 URL；发 TikTok 必须设置 content_posting_method 为 DIRECT_POST；发布日期为必填的 ISO 8601 格式。