Codex Prompt Library

本文件保存常用 Codex 任務 Prompt。實際使用時，需先要求 Codex 閱讀：

• README.md
• AGENTS.md
• 架構方向文件
• 第一階段開工規格

建立 C# 專案骨架

【任務名稱】
建立智慧設備順序控制系統共用骨架的 C# Solution。

【目前背景】
第一階段使用 .NET 5.0、xUnit、ConsoleHost、Mock Adapter。
代表流程為「燈號導引 + Sensor 驗證」。

【不可變更事項】
不得把 UI 邏輯寫進 Core。
不得把硬體通訊寫進 WorkflowEngine。
Host 不得包含核心流程邏輯。
第一階段不得接真實硬體。

【請完成的內容】
建立以下專案：
- HS.DeviceControl.Core
- HS.DeviceControl.Adapters
- HS.DeviceControl.ConsoleHost
- HS.DeviceControl.Core.Tests
- HS.DeviceControl.Adapters.Tests
- HS.DeviceControl.WorkflowSimulation.Tests

【完成標準】
Solution 可編譯。
ConsoleHost 可啟動。
dotnet test 可執行。

建立 WorkflowEngine

【任務名稱】
建立 WorkflowNode / WorkflowEngine。

【目前背景】
Workflow 需支援節點狀態、Timeout、Retry、Cancel、FailNextNodeId、SuccessNextNodeId。

【不可變更事項】
WorkflowEngine 不得直接操作硬體。
WorkflowEngine 不得引用 UI。
不得使用 Thread.Sleep 作為流程核心等待。
不得省略 ErrorCode 與 Log。

【完成標準】
可使用 Mock Adapter 跑燈號導引 + Sensor 驗證流程。
包含 success、failed、timeout、retry、cancelled 測試。

建立 Mock Adapter

【任務名稱】
建立 IDeviceAdapter 與 Mock Adapter。

【目前背景】
第一階段不接真實硬體，所有設備行為透過 Mock 模擬。

【請完成的內容】
建立 IDeviceAdapter、DeviceCommand、ExecuteResult。
Mock Adapter 需可模擬成功、失敗、逾時、離線。

【完成標準】
主流程不需知道底層通訊方式。
所有錯誤回傳標準 ErrorCode。