RWS — 原始資料、Wiki 與 Schema 是做什麼的？
通用指令。若此技能已啟用，請在進行任何動作前完整閱讀此檔案，並在需要決定下一步行動時查閱代理路由器。
1. 30 秒模型概述
| 層級 | 資料夾（位於用戶專案中） | 擁有者 | 黃金法則 |
|---|---|---|---|
| 原始資料 (Raw Sources) | raw/ | 用戶 | 不可變。 代理只能讀取與引用，絕不編輯。 |
| Wiki | wiki/ | 代理 | 代理負責撰寫、連結，並維護整體一致性。 |
| Schema | schema/ | 用戶 + 代理 | 約定與工作流程。需經用戶核准後共同演進。 |
完整細節：core/architecture.md。
2. 強制協議（每次對話）
- 偵測專案狀態：
- 不存在
raw/、wiki/、schema/→ 建議/setup-green-space（新專案）或/setup-brown-space（既有程式碼庫）。 - 已存在 → 讀取
schema/schema.md，接著wiki/index.md，以及wiki/log.md中最新的 5 筆條目。
- 不存在
- 使用 agent-router.md 路由用戶意圖。
- 優先從 Wiki 回答問題（index → 頁面 → 原始資料以確認）。使用
[[wikilinks]]引用頁面，並以raw/<檔案>#<區段>引用來源。 - 每次對 Wiki 的變更都必須更新
wiki/index.md，並在wiki/log.md中新增條目。 - 對 Schema 的任何變更都需要用戶明確核准。
- 優質回答應成為頁面：相關的分析、比較與綜合結果，應提供給
/wiki:add使用。
3. 命令
語法：/<範圍>:<動作> — 範圍 raw-source | wiki | schema | ticket，動作 add | remove | increment | new | tdd | code | review。
| 命令 | 工作流程 |
|---|---|
/rws:summary | core/agent-router.md — 各種情境下該使用哪項技能 |
/setup-brown-space | skills/setup-brown-space |
/setup-green-space | skills/setup-green-space |
/grill (/grill-me) | skills/grill |
/grill-design | skills/grill-design |
/ticket:new · :add | new · add |
/ticket:tdd · :code · :review | tdd · code · review |
/implement | skills/implement — 實作 / 路線圖協調器 |
/raw-source:add · :remove · :increment | add · remove · increment |
/wiki:add · :remove · :increment | add · remove · increment |
/schema:add · :remove · :increment | add · remove · increment |
/rws:lint | node <skill>/bin/lint-rws.js <專案根目錄> + core/lifecycle.md |
4. 參考資料
- core/architecture.md — 三層架構及其運作原理
- core/agent-router.md — 決策摘要
- core/conventions.md — 命名、frontmatter、wikilinks
- core/index-and-log.md —
index.md與log.md的格式 - core/lifecycle.md — 攝取、查詢、檢查、複合
- core/ui-patterns-catalog.md — UI 模式 × 參考應用程式
- templates/ — 頁面模板
5. 禁止事項
- ❌ 編輯或刪除
raw/中的檔案（除非透過經核准的/raw-source:remove移至raw/_archive/）。 - ❌ 建立 Wiki 頁面但未在
index.md和log.md中註冊。 - ❌ 未經明確核准修改
schema/。 - ❌ 陳述無來源的事實：Wiki 中每個非平凡的主張都必須指向
raw/或另一個頁面。