LinLin00000000/aiops-vault-template

AIOps Vault 輔助技能

此技能是一個程序層。它不包含使用者的當前資產。當前事實存放在本機的 AIOps vault 中，通常是 $AIOPS_ROOT 或 ~/ai-ops。

真相來源合約

請使用以下分工：

• README.md：穩定的本機規則、檔案角色、安全邊界以及專案特定的慣例。
• resources.md：目前應信任的當前狀態。
• maintenance-log.jsonl：僅附加的決策、維護、檢查、事件與修正歷史記錄。
• secrets-location.md：僅含機密名稱、儲存位置、存取/輪替備註；絕不包含機密值。
• services/<service>/service-card.md：當中央資源檔案過大時，各服務的 runbook 與詳細資訊。
• scripts/aiops.py：用於 vault 的低 token 指令介面。

請勿從此技能推斷當前基礎設施。請讀取 vault 並在安全的情況下檢查即時狀態。

預設讀取順序

1. 解析 vault 路徑：$AIOPS_ROOT（若已設定），否則為 ~/ai-ops。
2. 若任務可能變更檔案、服務、暴露面、憑證或備份，則優先讀取本機 vault 的 README.md。
3. 在完整讀取前，先執行指令層：
   • python3 "$AIOPS_ROOT/scripts/aiops.py" index
   • python3 "$AIOPS_ROOT/scripts/aiops.py" resources --section "<section>"
   • python3 "$AIOPS_ROOT/scripts/aiops.py" service "<name>"
   • python3 "$AIOPS_ROOT/scripts/aiops.py" host "<name>"
   • python3 "$AIOPS_ROOT/scripts/aiops.py" log --tail 20 --summary
4. 僅在切片輸出不足時，才讀取完整的 resources.md、服務卡或日誌行。
5. 僅在即時狀態與 vault 文件無法回答問題時，才使用會話歷史。

安全邊界

• 請勿讀取、列印、複製或儲存機密值。secrets-location.md 是元資料，而非機密轉儲。
• 請勿將機密寫入 resources.md、日誌、服務卡、提示、問題評論、提交或聊天摘要中。
• 對於不可逆或高風險操作，需先確認：刪除、覆寫、輪替、還原、開放公開埠、變更 DNS、遷移資料、停用備份，或觸及第三方/友人擁有的資源。
• 保持資源池明確。除非使用者特別授權該目標，否則不得操作第三方或友人擁有的基礎設施。
• 偏好最小暴露：管理路徑應透過反向代理或私有網路使用 localhost；僅在預期且經過驗證的情況下才使用公開 HTTPS。

維護工作流程

1. 分類目標：主機、服務、網域/DNS、反向代理、資料/備份、機密位置、自動化，或 vault 本身。
2. 識別資源池與權限邊界。
3. 透過 aiops.py 與服務卡載入最小當前上下文。
4. 必要時使用安全指令檢查即時狀態。
5. 規劃最小的可逆操作，並標示高風險步驟。
6. 以最小權限執行。
7. 使用消費端的真實輸出進行驗證：健康檢查、日誌、HTTP 請求、systemctl、docker ps、備份清單或等效方式。
8. 更新正確的層：
   • 當前事實 → resources.md 或服務卡；
   • 重要歷史 → 一個附加的 maintenance-log.jsonl 物件；
   • 機密位置 → secrets-location.md（不含值）；
   • 服務本地詳細資訊 → 服務 README/卡。
9. 若變更改善了可重複使用的 AIOps 工作流程/工具而非僅限於私有本地事實，則將通用部分同步到 ~/projects/aiops-vault-template 的模板倉庫，執行其測試/檢查，然後提交並推送，以便下游的 AIOS Kit 使用者能收到改善。切勿將私有資源、日誌或機密複製到公開模板中。
10. vault 變更後，執行 python3 "$AIOPS_ROOT/scripts/aiops.py" check。
11. 報告已變更的檔案、指令、驗證、跳過/封鎖的項目以及後續行動。

寫回規則

• 當前狀態應歸屬於 resources.md 或服務卡，而非僅在歷史記錄中。
• 歷史記錄應歸屬於 maintenance-log.jsonl，每行一個有效的 JSON 物件。
• 修正應為新的 correction 或 supersede 條目；除非使用者要求遷移，否則請勿重寫歷史。
• 避免在 README、resources、服務卡與日誌中重複相同的事實。請選擇歸屬層。
• 大量原始證據應存放於 evidence/ 或 vault 外部，並附上路徑參考。

驗證清單

最終確定前：

• python3 "$AIOPS_ROOT/scripts/aiops.py" check 通過，或失敗原因已說明。
• JSONL 檔案可解析。
• 未新增明顯的機密值。
• 當前狀態的變更不僅存在於維護日誌中。
• 回應中的聲明有 vault 檔案或即時指令輸出支援。
• 任何高風險行動已確認或明確列為建議步驟。

若 vault 遺失

若不存在 AIOps vault 且使用者需要，請安裝模板倉庫或建立最小佈局：

aio-ops/
  README.md
  resources.md
  maintenance-log.jsonl
  maintenance-log.schema.md
  secrets-location.md        # 私有，Git 忽略
  secrets-location.example.md
  scripts/aiops.py

然後執行 python3 scripts/aiops.py check。