# jsc-sdlc — 開發生命週期

jsc 技能組的 sdlc domain：規劃 → 分析 → 實作 → 維護四個階段，全程以 wiki 頁追蹤（`PLAN_*`、`ANALYZE_*`、`REPO_*`、`MAINTAIN_CONTENTS`）。每階段先做模型能力檢查，不適合就阻擋流程。

## 安裝

```bash
claude plugin marketplace add https://gitea.jsc.idv.tw/plugins/sdlc.git
claude plugin install jsc-sdlc@sdlc
```

其他 CLI（codex / copilot / antigravity / kiro）與批次安裝、更新、解除安裝：使用 `/jsc-cli:deploy`。

## Skills 目錄

呼叫方式：Claude / Antigravity `/jsc-sdlc:{name}`；Codex `${name}`；Copilot / Kiro 描述需求自動觸發。

<!-- JSC-SKILLS:START -->

### `plan`

規劃：讀計畫目錄 → 補充或新建計畫 → 決策樹補全目標 / 範圍 / 可行性至共識 → 產生使用者故事 → 寫回 `PLAN_{yyyyMMdd}_{HHmmss}_{HASH}`。純邏輯，禁止程式碼與修改檔案。

### `analyze`

分析：搭配現況（工作目錄 + `REPO_{HASH}` 盤點複用）分析使用者故事 → WBS 產生編號工作包 → CPM 估工時與天數 → TDD 拆待辦 → 寫回 `ANALYZE_{yyyyMMdd}_{HHmmss}_{HASH}`。純邏輯，禁止程式碼與修改檔案。

### `implement`

實作：產生工作證鎖定「未完成、無相依、無工作證」的工作包 → 逐項 TDD 實作、每完成一項立即更新 wiki → 程式碼審查 → 詢問是否加入維護目錄。

### `maintain`

維護：讀取維護期內的專案，每個專案一個 sub agent：切 develop/master → 至少五種建議維護方法 → commit / push / PR → 更新前次維護時間。

<!-- JSC-SKILLS:END -->

## 範本與參考

| 檔案 | 用途 |
| --- | --- |
| `templates/plan-page.md`、`templates/plan-contents.md` | 計畫頁與計畫目錄 |
| `templates/analyze-page.md`、`templates/analyze-contents.md` | 分析頁（WBS / CPM / TDD 待辦）與分析目錄 |
| `templates/repo-page.md`、`templates/repo-contents.md` | 存取庫盤點頁（功能與端點 + commit sha）與盤點目錄 |
| `templates/maintain-contents.md` | 維護目錄（截止日 NULL = 永久維護） |
| `references/tdd.md` | 接縫、紅綠循環規則、反模式 |

## 環境變數

Wiki 位置：`JSC_WIKI_REPO_PLAN` / `JSC_WIKI_REPO_ANALYZE` / `JSC_WIKI_REPO_REPO` / `JSC_WIKI_REPO_MAINTAIN`，未設定退回 `JSC_WIKI_REPO`，再未設定就詢問（見 `jsc-gitea`）。

## 相關 domain

- `jsc-cli`：模型能力標籤（`jsc-cli:models`）
- `jsc-gitea`：wiki 讀寫
- `jsc-review`：實作完成後的程式碼審查
- `jsc-git` / `jsc-pkg`：維護階段的 commit / PR 與套件更新
- `jsc-log`：完工後的工作日誌