AgentTrust 博客发布技能
在此技能中运行整个工作流程：主题 → Markdown 草稿 → 封面图像 → HTML有效负载 → API 提交。
核心规则
始终在提交帖子之前生成封面图像。
始终通过同级技能脚本使用 Nano Banana Gemini 图像生成器。
始终通过 image_base64 和 image_filename 在同一个博客 API 请求中附加生成的图像。
除非用户明确要求，否则永远不会默默地降级为“仅文本博客帖子”。
可接受的起点
A. 主题/说明
如果用户只提供主题、文章简介或原始笔记：
首先草拟文章
将其保存在 blog-drafts/YYYY-MM-DD-slug.md 下
包括完整的前置内容
然后运行发布助手脚本
B. 现有 Markdown 草稿
如果用户已经提供 Markdown 文件：
验证它并从中发布
预期的前置内容形状：
---
title: "文章标题"
description: "150-160 个字符的 SEO 描述"
date: "YYYY-MM-DD"
author: "Gabriel Guidarelli"
tags: ["ai-security", "agenttrust"]
status: "draft"
target_keyword: "主要关键词"
---
使用前置内容作为：
标题
摘要/元描述
焦点关键词
标签
slug
作者
默认工作流程
从主题开始：
以 Gabriel 的声音编写博客帖子
保持清晰、直接和有用
在提交之前将 Markdown 草稿保存在本地
确保在继续之前完成前置内容
使用捆绑的同级脚本间接地：
python3 skills/blog-posting-skill/scripts/publish_agenttrust_blog.py
该助手脚本已经调用：
skills/nano-banana-image-generator/scripts/generate_gemini_image.py
除非 Nano Banana 路径损坏，否则不要发明另一个图像工作流程。
图像提示锁定为 AgentTrust 信任流组合。
阅读 references/cover-branding.md 以获取确切的提示和视觉规则。
助手脚本将文章正文转换为简单的清洁 HTML。
支持的结构：
段落 →
→
→
项目符号列表 →
-
内联链接 → 锚点
基本粗体/斜体/内联代码
使用生产 API：
POST https://agenttrust.ai/api/submitBlogPost
Auth：Authorization: Bearer $AGENTTRUST_API_KEY
Content-Type：application/json
所需的有效负载核心：
标题
slug
内容
推荐的有效负载字段由此技能使用：
摘要
标签
元标题
元描述
焦点关键词
图像替代文本
作者名称
image_base64
image_filename
当 image_base64 存在时，AgentTrust 会上传图像并自动设置博客图像字段。
更喜欢这种方法，而不是尝试手动托管 og_image。
使用助手脚本
标准端到端发布
python3 skills/blog-posting-skill/scripts/publish_agenttrust_blog.py \
blog-drafts/2026-04-14-my-post.md
带有显式主题上下文的发布
python3 skills/blog-posting-skill/scripts/publish_agenttrust_blog.py \
blog-drafts/2026-04-14-my-post.md \
--topic "prompt injection protection for AI email"
干跑
python3 skills/blog-posting-skill/scripts/publish_agenttrust_blog.py \
blog-drafts/2026-04-14-my-post.md \
--dry-run --json-out /tmp/blog-post-preview.json
助手脚本的作用
publish_agenttrust_blog.py：
解析前置内容
验证所需的元数据
如果缺失，推导 slug
构建 Nano Banana 提示
生成封面图像
对生成的图像进行 base64 编码
将 Markdown 转换为 HTML
一起提交文章和图像
返回 API 响应，包括路径和有效负载摘要
报告规则
完成后，报告：
文章标题
Markdown 草稿路径
生成的图像路径
帖子是否实际提交或仅干跑
构建的 post_id
返回状态，通常为审查
任何故障原因，如果图像步骤或 API 步骤中断
实用规则
除非用户明确要求测试，否则使用生产端点。
使用 Bearer 身份验证，而不是 x-api-key。
帖子以审查状态提交；除非确认，否则不要声称它们是实时的。
保持草稿、图像生成和提交作为一个工作流程，当用户要求端到端发布时。
如果 Nano Banana 图像步骤失败，修复或重试该步骤，然后发布。
更喜欢助手脚本而不是手动 curl，因为它保持工作流程的确定性。
输出清单
完成之前，验证：
草稿存在于本地
前置内容是完整的
使用 Nano Banana 生成的封面图像
图像已保存在本地
图像通过 image_base64 附加
HTML 有效负载清洁地构建
文章已提交到 API 或显式干跑
捕获 post_id / 状态
Gabriel 获得最终路径和结果
by