编辑日历操作
概述
维护一个持久的编辑积压工作,并基于证据而非直觉选择下一篇工作。该技能平衡已配置的话题簇和文章格式,预留发布槽位,并在更改队列前将本地状态与真实CMS进行协调。
它协调 blog-topic-research 和 seo-blog-writer 的工作;但并不取代它们的研究、起草、审查或发布控制。
前提条件
- 一个已批准的
config.json,定义了target_platform、作者、UTC 发布节奏、话题簇目标、格式目标和 CMS 标签映射 - 一个可写的
backlog.json,包含稳定的 ID、标题、簇、格式、证据 URL、优先级、状态和预定的时间戳 - 用于
sync操作的只读 CMS 列表访问权限;仅当用户请求安排或发布时,才需要单独批准的写入访问权限 - 用于补充积压工作的
blog-topic-research和用于生成草稿的seo-blog-writer - 话题和格式的目标权重各自总和应大约为
1.0
工具规范
使用 Read 来检查配置和积压状态。仅在确认公开证据或读取已授权的 CMS 清单时使用 WebSearch 和 WebFetch。使用 Write 或 Edit 进行经过审查、不含秘密的状态更新;切勿将凭证、原始访问令牌或未发布的敏感内容写入记录中。
操作说明
- 解析请求的操作:
status、next、add、mark-done或sync。拒绝未知操作以及互不兼容的调度标志。 - 读取并验证
config.json和backlog.json。确认唯一的 ID、有效的状态、可解析的 UTC 时间戳、非负的优先级以及接近1.0的目标权重。 - 在选择之前执行一次只读协调。首先通过稳定的 CMS ID 匹配 CMS 记录,其次是通过规范 URL,最后才使用标准化的 slug。报告不明确的匹配项,而不是猜测。
- 对于
next操作,仅对符合条件的ready项进行评分。先按簇缺口排序,然后是格式缺口、证据强度、明确优先级和最早的创建时间。记录评分因子,以确保选择结果可重现。 - 使用稳定的运行 ID 保留所选项目。对于
--draft,调用写作工具时不带发布时间。否则,选择下一个空闲的已配置 UTC 槽位,或验证每个明确的槽位。 - 在实时发布或更改调度之前,需要获得审查。将话题框架和已批准的目标传递给
seo-blog-writer;不要在交接时复制 CMS 凭证。 - 仅在下游操作返回持久的草稿 ID、CMS ID 或明确失败时,才提交状态转换。遵循
ready -> reserved -> drafted -> scheduled -> published的路径;切勿在没有 CMS 证据的情况下直接跳到published状态。 - 对于
add操作,标准化标题并将其与现有标题、slug、规范 URL 以及独特的错误/版本令牌进行比较。仅添加有证据支持且不重复的话题。 - 对于
mark-done操作,需要提供匹配的在线 URL 或所有者批准的人工确认。对于sync操作,在更新仅受 CMS 证据支持的字段时,保留本地注释。 - 返回已选择的工作、调度计划、状态变更、冲突以及下一个符合条件的槽位。让失败或不明确的项目保持可恢复状态。
选择合约
每个积压记录应包含以下内容:
{
"id": "topic-0042",
"title": "如何诊断 webhook 签名失败",
"cluster": "集成",
"format": "修复指南",
"status": "ready",
"priority": 2,
"evidence_urls": ["https://example.com/verified-source"],
"scheduled_at": null,
"cms_id": null,
"canonical_url": null
}
对于相同的配置、积压工作和 CMS 快照,选择结果必须是确定性的。切勿编造流量、需求、可用性或发布证据。
批准边界
在安排、发布、重新安排、删除、批量修改或覆盖已协调的积压状态之前,需要获得所有者批准。只读的 status 或干运行选择无需 CMS 写入权限。当发布意图不明确时,默认为草稿。
输出
返回一个简洁的操作记录,包含以下内容:
- 操作、运行 ID、时间戳和配置校验和
- 选定的 ID 和评分因子
- 旧状态和新状态
- 草稿、调度计划、CMS ID 和规范 URL(如果可用)
- 冲突、跳过的重复项、不足项和所需的批准
- 下一个符合条件的槽位和后续建议
错误处理
| 条件 | 响应 |
|---|---|
| 配置缺失或无效 | 在进行任何修改之前停止,并列出确切无效的键或总和。 |
| CMS 清单不可用 | 标记协调为未验证;允许本地干运行状态,但不要声明槽位是空闲的或帖子是已发布的。 |
| 两条记录匹配同一个 CMS 帖子 | 保留两条记录,报告冲突,并需要所有者决定。 |
| 下游草稿生成失败 | 释放保留或将其标记为 blocked 并附上失败记录;不要占用该槽位。 |
| 队列中没有合格的话题 | 报告不足情况,并仅在获取批准后,使用指定的簇和数量调用 blog-topic-research。 |
| 并发更新更改了积压工作 | 重新读取、重新计算,如果所选项目或槽位发生变化,则需要确认。 |
示例
不进行发布,干运行接下来的两次选择:
请求: next 2 --draft --dry-run
结果: topic-0042 (集成簇缺口 0.08), topic-0017 (用例簇缺口 0.05)
变更: 无
下一个槽位UTC: 2026-09-12T06:00:00Z
协调一个已发布的项:
请求: sync
匹配: topic-0042 -> cms_id=post_918 通过规范URL
转换: scheduled -> published
冲突: 0
验证
- 重新运行
status并确认记录的总数等于积压工作总数。 - 确认没有两条活跃记录共享同一个 CMS ID 或规范 URL。
- 确认每个预定的时间戳都符合已配置的槽位,并且没有槽位被重复预订。
- 确认每个处于
published状态的记录都有来自 CMS 的 ID 或所有者批准的人工确认。 - 确认针对未更改的输入再次进行干运行,会返回相同的排名。
资源
后续步骤
每月根据实际业务重点和搜索性能审查目标权重。在更改协调适配器之前,重新验证平台 API。