編輯日曆操作指南
概述
維護一個可長期使用的編輯待辦事項佇列,並根據證據而非直覺來選擇下一項工作。此技能能平衡已設定的主題群組與文章格式,預留發布時段,並在更動佇列前將本地狀態與真實的內容管理系統(CMS)進行比對。
它負責協調 blog-topic-research 和 seo-blog-writer;但不會取代它們的調研、撰寫、審核或發布控制功能。
必要條件
- 一個已核准的
config.json,其中定義了target_platform、作者、UTC 排程節奏、群組目標、格式目標以及 CMS 標籤對應 - 一個可寫入的
backlog.json,包含穩定的 ID、標題、群組、格式、證據網址、優先級、狀態和排程時間戳記 - 唯讀的 CMS 列表存取權限用於
sync;只有在使用者要求排程或發布時,才需要獨立的核准寫入權限 blog-topic-research用於補充待辦事項佇列,seo-blog-writer用於產生草稿- 主題和格式目標權重各自總和大約為
1.0
工具紀律
使用 Read 來檢查設定和待辦事項佇列狀態。僅使用 WebSearch 和 WebFetch 來確認公開證據或讀取授權的 CMS 庫存。使用 Write 或 Edit 進行已審查、不含機密資訊的狀態更新;切勿將憑證、原始存取權杖或未發布的敏感內容寫入操作記錄中。
操作說明
- 解析請求的動作:
status、next、add、mark-done或sync。拒絕未知的動作以及互相矛盾的排程旗標。 - 讀取並驗證
config.json和backlog.json。確認唯一的 ID、有效的狀態、可解析的 UTC 時間戳記、非負的優先級,以及接近1.0的目標權重。 - 在選擇前執行一次唯讀的比對。首先使用穩定的 CMS ID 比對 CMS 記錄,其次使用標準網址,最後才使用標準化的 slug。對於模糊的匹配應回報,而不是自行猜測。
- 對於
next動作,僅對符合資格的ready項目進行評分。首先依據群組短缺程度排序,其次為格式短缺程度、證據強度、明確的優先級,最後是建立時間。記錄評分因素,以便選擇結果可被重現。 - 使用一個穩定的執行 ID 來預留被選中的項目。如果使用
--draft旗標,則呼叫寫作工具但不設定發布時間。否則,選擇下一個可用的已設定 UTC 時段,或者驗證每個明確指定的時段。 - 在任何即時發布或排程變更之前,需要先經過審核。將主題架構和已核准的目標傳遞給
seo-blog-writer;不要在交接過程中複製 CMS 憑證。 - 僅在下游操作返回一個持久的草稿 ID、CMS ID 或明確的失敗訊息後,才提交狀態轉換。狀態轉換流程為
ready -> reserved -> drafted -> scheduled -> published;切勿在沒有 CMS 證據的情況下直接跳轉到published。 - 對於
add動作,標準化標題,並與現有的標題、slug、標準網址以及明顯的錯誤/版本標記進行比對。僅添加有證據支持且不重複的主題。 - 對於
mark-done動作,需要一個匹配的即時網址或一個由擁有者核准的手動確認記錄。對於sync動作,在更新僅受 CMS 證據支援的欄位時,保留本地備註。 - 回傳所選的工作、排程、狀態變更、衝突以及下一個可用的時段。讓失敗或模糊的項目保持可恢復的狀態。
選擇合約
每個待辦事項記錄應包含:
{
"id": "topic-0042",
"title": "如何診斷 Webhook 簽名失敗",
"cluster": "integrations",
"format": "how-to-fix",
"status": "ready",
"priority": 2,
"evidence_urls": ["https://example.com/verified-source"],
"scheduled_at": null,
"cms_id": null,
"canonical_url": null
}
對於相同的設定、待辦事項佇列和 CMS 快照,選擇結果必須是可確定的。絕不能捏造流量、需求、可用性或發布證據。
核准邊界
在進行排程、發布、重新排程、刪除、批量修改或覆蓋已比對的待辦事項狀態之前,需要先獲得擁有者的核准。唯讀的 status 或乾執行(dry-run)選擇不需要 CMS 寫入權限。當發布意圖不明確時,預設為草稿模式。
輸出
回傳一份精簡的操作記錄,包含:
- 動作、執行 ID、時間戳記和設定校驗和
- 選中的 ID 和評分因素
- 舊狀態和新狀態
- 草稿、排程、CMS ID 和標準網址(若可用)
- 衝突、跳過的副本、短缺數量和需要核准的事項
- 下一個可用時段和建議的後續行動
錯誤處理
| 條件 | 回應 |
|---|---|
| 設定遺失或無效 | 在進行任何變更前停止,並列出確切的無效鍵或總和。 |
| CMS 庫存不可用 | 標記比對為未驗證;允許本地乾執行狀態,但不可聲稱某時段是空的或某篇文章已發布。 |
| 兩個記錄匹配同一篇 CMS 文章 | 保留兩個記錄,回報衝突,並需要擁有者決定。 |
| 下游草稿生成失敗 | 釋放預留或將其標記為 blocked 並附上失敗記錄;不要占用該時段。 |
| 佇列中沒有符合資格的主題 | 回報短缺,並僅以核准的群組和數量呼叫 blog-topic-research。 |
| 並發更新改變了待辦事項佇列 | 重新讀取、重新計算,如果選中的項目或時段變更,需要確認。 |
範例
乾執行下兩個選擇但不發布:
request: next 2 --draft --dry-run
result: topic-0042 (integrations deficit 0.08), topic-0017 (use-cases deficit 0.05)
mutation: none
next_slot_utc: 2026-09-12T06:00:00Z
比對一篇已發布的文章:
request: sync
matched: topic-0042 -> cms_id=post_918 by canonical_url
transition: scheduled -> published
conflicts: 0
驗證
- 重新執行
status並確認記錄的總數與待辦事項佇列總數相符。 - 確認沒有兩個啟用的記錄共享同一個 CMS ID 或標準網址。
- 確認每個排程時間戳記都落在一個已設定的時段內,且沒有時段被重複預約。
- 確認每個
published記錄都有一個從 CMS 獲得的 ID 或經擁有者核准的確認記錄。 - 確認在輸入不變的情況下,第二次乾執行會回傳相同的排名。
資源
後續步驟
每月根據實際業務優先級和搜尋成效檢視目標權重。在變更比對介接程式之前,重新驗證平台 API。