---
name: maintain
description: SDLC maintenance stage. Gate on model capability tags, read projects still inside their maintenance window from MAINTAIN_CONTENTS, then run one sub agent per project: switch to develop or master, propose at least five maintenance actions, commit to a new branch, push, and PR. Update the last-maintained timestamp afterward. Use for periodic upkeep of delivered projects.
---

# maintain — 維護

目標：逐項完成維護目錄內專案的例行維護。
所有 wiki 讀寫一律經由 `jsc-gitea:wiki`。

## 流程

1. **模型能力檢查**：依 `jsc-cli:models` 的「SDLC 階段需求」表確認目前模型適合維護階段（維護接受任意標籤，但模型必須列於對照表）。不適合就阻擋流程，並告知使用者建議改用的模型。
2. 經由 `jsc-gitea:wiki` 讀取 `MAINTAIN_CONTENTS`，篩出**仍在維護期間內**的專案：維護起始日 ≤ 今天，且（維護截止日為 NULL 或 ≥ 今天）。
3. 每一個專案**必須啟動一個 sub agent** 依以下流程執行：
   1. 將專案切換到 `develop` 分支，沒有就切 `master`，並更新到最新。
   2. 提供**至少五種**建議的維護方法，依專案狀況取捨執行，例如：
      - 相依套件更新（複用 `jsc-pkg:pkg-update`）
      - 安全性弱點掃描與修補
      - 死碼與過期註解清理
      - 測試覆蓋率補強
      - 文件與 README 同步
      - 建置警告消除
   3. 依 `jsc-git:commit` 把變更 commit 到新分支，push 後依 `jsc-git:pr` 建立 PR 回 develop 或 master。
   4. 更新 `MAINTAIN_CONTENTS` 中該專案的「前次維護時間」為今天。
4. 主 agent 彙整回報：每個專案執行了哪些維護方法、PR 連結、失敗原因。