pipeline-architecture
Installation
SKILL.md
Pipeline Architecture
選擇語言參考檔（動手前先做這件事）
本檔案只描述與語言無關的架構規則。所有程式碼範例都放在 references/ 底下。
寫任何程式碼之前，先判斷專案語言與基底框架，然後只讀對應的那一列：
| 判斷依據 | 語言 | 讀哪一份 |
|---|---|---|
有 pyproject.toml / requirements.txt，或要改的檔案是 .py |
Python / FastAPI | references/python.md |
有 package.json / tsconfig.json，或要改的檔案是 .ts |
TypeScript / Node.js | references/typescript.md |
上述 TypeScript 條件成立，且有 payload.config.ts（或 package.json 依賴 payload） |
TypeScript on Payload CMS | references/typescript.md 與 references/payload-cms.md，兩份都讀 |
三份 reference 描述的是同一套架構，本檔案的所有規則一律適用。
- ❌ 禁止混用命名慣例：不要在 Python 專案裡寫出
runWorkflow，也不要在 TypeScript 專案裡寫出run_workflow。 - ❌ 禁止跨語言混讀：
python.md與typescript.md只讀專案實際使用的那一份，避免把另一種語言的寫法帶進來。 - ✅
payload-cms.md是例外：它是typescript.md的補充而非替代，Payload 專案必須兩份都讀。兩者衝突時以payload-cms.md為準；payload-cms.md沒提到的一律照typescript.md。 - ⚠️ 唯一的結構性差異是 transaction 邊界（見下方「跨語言差異」一節），其餘都只是語法不同。