開發流程（OpenSpec）¶
本專案的功能開發走 OpenSpec——spec-driven(規格驅動)流程。每個實質變更都先寫規格,再實作、驗證、封存。
流程¶
| 階段 | 產物 / 動作 |
|---|---|
| explore | 定向、想清楚要做什麼(只思考,不實作)。 |
| new / propose | 建 change,產出 proposal.md(為何)、design.md(如何)、specs/(需求)、tasks.md(步驟)。 |
| apply | 依 tasks 逐項實作。 |
| verify | 驗證實作符合規格。 |
| archive | 完成後封存到 openspec/changes/archive/,並同步主規格。 |
對應的技能:/opsx:explore、/opsx:new、/opsx:propose、/opsx:apply、/opsx:verify、/opsx:archive。
規格在哪¶
- 現有能力規格:
openspec/specs/——例如player-classes、playstyle-mechanics、gear-affixes、dimensional-progression、gathering-professions等。這座 wiki 的內容多數即源自這些規格。 - 已完成的變更:
openspec/changes/archive/——每個變更的來龍去脈、設計決策與踩坑都留在這。
慣例¶
- 繁體中文:proposal / design / specs / tasks 與遊戲內文本一律繁中。
- 不猜:不確定就查(官方文件 / 實機 / 專案檔案)或問,不憑猜試錯。
- 以現場為準:規格若與實機/官方文件衝突,以現場為準並回報,不沿用過時條文。
- 會漂移的細節(版本號、位址、進度)以 auto-memory 為單一真相來源,不寫死在憲法或規格裡。
這座 Wiki 本身¶
本 wiki 也是一個 OpenSpec change(create-server-wiki,capability server-wiki)。內容由可重跑的抽取腳本從規格、本地化文本與實機設定生成——平衡數值一改,重撈設定 + 重跑腳本 + 重新部署即同步。維護流程見 wiki/README.md。