Files
sdlc/skills/implement/SKILL.md
T

2.3 KiB
Raw Blame History

name, description
name description
implement SDLC implementation stage. Gate on model capability tags, claim a ready work package from ANALYZE_CONTENTS with a work ticket, then complete its TDD todos one by one, updating the wiki after every item. Ends with jsc-review code-review and an optional MAINTAIN_CONTENTS entry. Use when analysis is done and code must be written; not for planning or analysis.

implement — 實作

目標:逐項完成分析頁的待辦事項;每完成一項就必須立即更新 WIKI 狀態。 所有 wiki 讀寫一律經由 jsc-gitea:wiki。

流程

  1. 模型能力檢查:依 jsc-cli:models 的能力標籤確認目前模型具備「實作」能力。不適合就阻擋流程,並告知使用者建議改用的模型。
  2. 產生工作證:格式 TICKET_{session id 前 8 碼}_{yyyyMMddHHmmss},並嘗試將目前 session 重新命名為工作證名稱(CLI 不支援時略過)。
  3. 經由 jsc-gitea:wiki 讀取 ANALYZE_CONTENTS,列出未完成的:計畫名稱、HASH、工作包編號、未完成項目數量。可選的工作包必須同時滿足:未完成、無相依(或相依都已完成)、無工作證。
  4. 依 jsc-ask:ask 規則讓使用者選擇要實作的工作包(選項標明未完成項目數與預估工時)。把工作證寫入分析頁該工作包的「工作證」欄位並寫回 wiki,成功標上工作證才可以進入下一步。
  5. 列出該工作包所有未完成項目,逐項實作:
    • 依 TDD 循環:先紅後綠、一次一片;規則與反模式見 references/tdd.md(重構留給審查階段)。
    • 每完成一項,立即把分析頁該項 [ ] 改為 [x] 並寫回 wiki,才可以進行下一項。
  6. 全部完成後呼叫 jsc-review:code-review 等待程式碼審查;審查未過就修正並重新審查。
  7. 依 jsc-ask:ask 規則詢問是否將本專案加入維護:套用 templates/maintain-contents.md 加入 MAINTAIN_CONTENTS。必填:存取庫名稱 {owner}/{repo}、維護方式、維護起始日。選填:維護截止日(NULL = 永久維護)、前次維護時間。

規則

  • 工作證是互斥鎖:看到已有工作證的工作包一律跳過,不可搶占。
  • 不可一次完成多項才批次更新 wiki;一項一更新。