📚職涯停看聽・知識庫← 總部儀表板
📅最後更新:2026/06/09
📑 目錄

RCF-076 — 系統狀態異動規則五:自動化部署事件同步(IMP-160 升規)

類型:規則變更 日期:2026-06-09 觸發條件:條件 1 — 修改 HARD STOP 規則(系統狀態異動硬性記錄規則新增規則五) 相關文件

  • CLAUDE.md(系統狀態異動硬性記錄規則 → 規則五)
  • knowledge/improvements.md(IMP-160)

問題背景

IMP-160 記錄(出現次數 2):GAS 腳本 / 自動化任務完成驗收後,automations.md 未即時同步更新。

第 1 次(2026-05-23):GAS 腳本二(A-12)完整驗收通過,但 automations.md 仍保留「⏳ 規劃中 + 錯誤技術描述」,隔天 Tim 詢問才發現。 第 2 次(2026-06-03):GAS 腳本四部署評估時發現 inventory.json 和 automations.md 狀態與實際不符。

現有「系統狀態異動硬性記錄規則」(規則一~四)涵蓋一般系統狀態,但未明確規定自動化腳本/Cron/Hook 的事件同步。


考慮過的方案

方案 描述 優點 缺點 採用?
方案 A:在 automations.md 維護說明中加提醒 只改 automations.md 本身文件說明 改動最小 對話中無法觸發自查,只有主動讀 automations.md 才看到 ❌ 未採用
方案 B:納入收尾七件事步驟 收尾七件事第 3 步驟加「確認 automations.md 同步」 每次收尾都提醒 非自動化任務也會看到,增加無謂認知負荷 ❌ 未採用
方案 C(最終採用):系統狀態異動規則新增規則五 在既有規則一~四框架下新增規則五,定義自動化部署三類事件 → 必須同步 automations.md + inventory.json 觸發條件精確;與現有規則體系一致 文件長度增加 ✅ 採用

最終決策

在「系統狀態異動硬性記錄規則」新增「規則五:自動化部署事件同步(HARD STOP)」,定義觸發三類事件:

  1. 部署完成(新腳本或現有腳本新版本上線)
  2. 狀態變更(規劃中→已部署/已停用)
  3. 架構升規(觸發條件/輸出目標重大修改)

→ 同次對話必須同步:automations.md(對應 A-XX 條目)+ inventory.json(對應 _gas_automations / _cron_jobs

理由:自動化腳本狀態最容易「完成驗收但忘記同步記錄」,且兩個 SOT(automations.md + inventory.json)需同步,漏一個就造成記錄不一致。


影響範圍

影響類型 具體項目
修改文件 CLAUDE.md — 系統狀態異動硬性記錄規則新增規則五
修改文件 knowledge/improvements.md — IMP-160 狀態更新為 ✅ 已升規
觸發部門同步 主 CLAUDE.md 修改;dev/CLAUDE.md(若有自動化章節需確認)— 本次確認無需額外同步
影響的 SKILL 「部署 [系統]」SKILL + 收尾自查 SKILL(自動化任務收尾時觸發)

驗證方式

下次 GAS 腳本/GitHub Actions/Vercel Cron/Hook 完成部署或狀態變更時:

  1. Claude 在同次對話中更新 automations.md 對應 A-XX 條目(狀態、技術描述、最後驗收日)
  2. 同步更新 inventory.json _gas_automations_cron_jobs 對應欄位
  3. 不等 Tim 詢問「有沒有寫入知識庫」才補同步
← 返回 決策記錄