EW Golden Baseline Model

View saved version →

---
name: baseline-analysis-builder
description: Create, upgrade, or repair a safe declarative time-series analysis SKILL.md with a machine-readable pipeline Manifest and fixed fixtures for the Golden Baseline Management System. Use when users describe a new process, need a newer algorithm version, or provide backend compilation errors; never self-certify runtime execution.
---

# 黃金基線時序分析算法建置器

把設備與工藝需求轉成黃金基線管理系統可編譯、可測試、可版本化與可稽核的宣告式算法 Skill。使用者只需說明設備、工藝及希望識別的偏差，不需要自己挑選數學模型。

## 工作模式

- **建立**：從自然語言需求建立完整 `SKILL.md`、Manifest 與固定案例。
- **升級**：讀取既有 Skill，保留 `algorithm_id`，依相容性提高語意版本並補齊新契約。
- **修復**：讀取後端的編譯、固定案例、相容性或版本錯誤報告，修正 Skill；不得隱藏、忽略或繞過錯誤。

只詢問缺少的工藝事實：設備、階段、訊號意義與單位、採樣間隔、預期偏差、事件錨點及期望判斷。不得要求使用者命名 RMSE、DTW、Cross-correlation 或其他數學方法。

## 必讀契約

- 建立或修復前先讀 [Manifest 契約](references/manifest-contract.md)。
- 功率類時序需求先讀 [功率時序範例](references/power-timeseries-example.md)，再依實際設備調整，不得直接複製不適用的門檻。

## 必要 Frontmatter

```yaml
---
name: readable-skill-name
description: Clear trigger description for this analysis algorithm.
metadata:
  schema_version: golden-baseline-analysis-algorithm/v1
  skill_role: analysis-algorithm
  algorithm_id: stable_lowercase_identifier
  version: 1.0.0
  engine_api_version: deterministic-feature-api/v1
  implementation_kind: declarative_pipeline
---
```

- `algorithm_id` 必須符合 `^[a-z][a-z0-9_]{2,63}$`。
- `version` 必須是嚴格的 `MAJOR.MINOR.PATCH`。
- 新算法使用 `declarative_pipeline`；只有系統登錄且後端確認可執行的算法可以使用 `builtin_reference`。

## 必要章節

每個章節必須且只能出現一次：

1. `# <Algorithm Name>`
2. `## Purpose`
3. `## Inputs`
4. `## Applicability`
5. `## Calculation Contract`
6. `## Quality Gates`
7. `## Output Contract`
8. `## Golden Fixtures`
9. `## Safety`

## Manifest 要求

`## Calculation Contract` 必須包含且只能包含一個 JSON 程式碼區塊，其內容符合 `golden-baseline-declarative-pipeline/v1`：

- `pipeline_id` 與 `pipeline_version` 必須與 frontmatter 的 `algorithm_id`、`version` 完全一致。
- `signal_roles` 使用角色及相容單位，不得綁定固定 EDC 位址、帳號、SUID 或 CUID。
- `execution_profiles` 分別定義 `historical_closed_event` 與 `realtime_open_event`；即時模式不得使用依賴事件終點的算法。
- `quality_gates` 必須包含完整率、缺值率、最少點數、最大缺口、時間單調性、單位相容及已確認起點。
- `fixtures` 必須包含 `normal`、`abnormal`、`insufficient_data` 三類純資料案例，並聲明 `expected_status`。
- 系統尚未提供的能力必須放入 `proposed_algorithms`，不得假裝已可執行。

完整欄位、允許算法與數值範圍以 Manifest 契約為準。

## 判斷與品質原則

- 使用滿足需求的最小確定性算法組合；不要每次啟動全部算法。
- 缺值與時間對齊是前置品質檢查；品質不足時不得輸出正常結論。
- 歷史封閉事件可以計算完整時長與面積；即時開放事件只執行不依賴終點的分支，事件結束後再重算完整結果。
- `Output Contract` 至少包含 `algorithm_id`、`algorithm_version`、`status`、`score`、`unit`、`evidence_range`、`quality` 與可讀證據。
- 狀態只可為 `normal`、`attention`、`abnormal`、`insufficient_data`、`not_applicable`。

## 編譯與執行邊界

ChatGPT 與本 Skill 負責產生或修復候選規格，不負責宣告候選版本已可執行。唯一有效狀態流程為：

`specification_only → compiled → fixtures_passed → executable`

任一步失敗時只能標示 `requires_revision` 或 `rejected`，並保留後端錯誤證據。只有黃金基線管理系統後端完成 schema 驗證、Manifest 編譯、固定案例執行、版本相容檢查及管理員核准後，才可標示 `executable`。

不得輸出 patch、Python、SQL、Shell、JavaScript、網址、安裝指令或任何可執行內容。不得存取網路或憑證、修改 EDC 資料，且結果不能取代安全關鍵工程判斷。

## 版本規則

- PATCH：文字、案例或相容門檻修正，不改必要輸入與結果語意。
- MINOR：向下相容的新能力、可選輸入或新增執行設定。
- MAJOR：輸入、計算、輸出、單位或判斷語意不相容。
- 不得降低版本，也不得以相同版本承載不同內容。

## 最終檢查與輸出

輸出前確認 frontmatter、九個必要章節、穩定算法識別碼、語意版本、唯一 Manifest、歷史／即時設定、品質閘門、三類固定案例、安全邊界與未實作能力清單一致。

建立或升級時只輸出一份完整 `SKILL.md`。修復時先用簡短文字列出已處理的後端錯誤，再輸出完整 `SKILL.md`；不得聲稱已通過後端編譯或已可執行。

Referenced files: 3

View saved version →

---
name: golden-baseline-algorithm-selector
description: Select backend-confirmed executable deterministic golden-baseline algorithms and generate a reusable process-selector SKILL.md from a plain-language equipment or process description. Use when users should not need to understand RMSE, correlation, DTW, lag, slope, area, stability, or missing-data methods themselves; route unsupported needs to the analysis builder and do not diagnose equipment faults.
---

# 黃金基線算法選擇技能產生器

把使用者對設備、工藝、訊號與比較目的的自然語言描述，轉成一份可重複使用的專用 `SKILL.md`。不要要求使用者自己選擇統計或訊號處理算法，也不得把尚未編譯或未通過固定案例的候選算法當成可執行能力。

## 收集工藝事實

只詢問使用者能以領域知識回答的缺漏資訊：

- 設備用途、正常工藝階段、事件如何開始與結束。
- 訊號名稱、物理意義、單位、採樣間隔與是否跨設備雲。
- 哪些偏差會影響品質、能耗、產量、安全或穩定運轉。
- 是否有 PLC、批次、Tagger 或人工事件錨點。
- 歷史封閉事件、即時開放事件，或兩者都需要。

不得要求使用者指定 RMSE、DTW、Cross-correlation、門檻公式或距離函數。不得自行發明安全極限、法規門檻或設備供應商規格。

## 可執行算法來源

只可從系統提供的 `available_algorithms` 選擇，且每個項目必須同時具備：

- `execution_status: executable`
- 明確 `algorithm_id` 與 `version`
- 相容的 `engine_api_version`
- 適用執行模式、訊號角色、單位及品質要求

`specification_only`、`compiled`、`fixtures_passed`、`requires_revision`、`rejected` 或狀態缺失的算法，一律不得放入執行方案。若需求只能由這些候選能力滿足，政策必須標示 `review_required`，並把需求放入 `proposed_algorithms`。

## 選擇規則

- `missing_deviation`：所有時序都選；品質不足時，其他算法不得輸出正常結論。
- `time_alignment`：跨來源、多通道或需要圖層疊圖時選。
- `value_deviation`：連續數值且單位相容時選。
- `time_deviation`：有可信起點、終點、階段或峰值錨點時選。
- `waveform_deviation`：相同工藝階段且點數足以表達形狀時選；DTW 不得掩蓋真正時間延遲。
- `slope_deviation`：上升／下降速率有物理意義且採樣密度足夠時選。
- `area_deviation`：對時間積分有明確業務意義時選，例如累積能耗或流量。
- `stability_deviation`：穩態或平台階段選；正常升降載階段通常不選。

歷史封閉事件可選依賴終點的算法；即時開放事件只選不依賴終點的算法，事件結束後再重算完整結果。從滿足需求的可執行算法中選最小組合，不得為了看似完整而全部啟動。

## 未支援需求流程

當現有可執行算法不足時：

1. 保留使用者的工藝目的、訊號角色、品質條件及期望判斷。
2. 在 `proposed_algorithms` 說明缺少能力，不指定使用者不懂的數學模型。
3. 建議使用 `$baseline-analysis-builder` 建立或升級候選算法 Skill。
4. 候選 Skill 經後端編譯、固定案例、版本相容檢查與管理員核准成為 `executable` 後，才可重新產生 ready 政策。

## 產生專用 Skill

輸出一個完整 Markdown 文件，包含：

1. `name` 與清楚觸發條件的 `description`。
2. `metadata.schema_version: golden-baseline-algorithm-skill/v1`。
3. `metadata.skill_role: process-selector`。
4. 適用／不適用範圍、工藝階段、訊號角色、必要輸入與品質閘門。
5. 每個算法的選用與不選用規則、原因碼，以及歷史／即時模式差異。
6. 可執行狀態與版本證據、白名單限制、安全邊界及待確認資訊。
7. 固定的候選政策 JSON 輸出契約。

新 Skill 必須自包含，不可依賴本產生器仍在對話中，也不可包含 Python、SQL、Shell、網址或外部工具呼叫。

## 候選政策契約

專用 Skill 被使用時，只輸出一個 JSON 物件，至少包含：

```json
{
  "schema_version": "golden-baseline-algorithm-plan/v1",
  "selector_skill_name": "string",
  "selector_skill_version": "string",
  "equipment_type": "string",
  "process_name": "string",
  "execution_mode": "historical_closed_event",
  "policy_status": "ready",
  "stage_plans": [],
  "quality_gates": {},
  "algorithm_registry_snapshot": [
    {
      "algorithm_id": "value_deviation",
      "version": "1.0.0",
      "execution_status": "executable"
    }
  ],
  "required_information": [],
  "proposed_algorithms": [],
  "assumptions": [],
  "review_notes": []
}
```

`execution_mode` 只能是 `historical_closed_event` 或 `realtime_open_event`。`policy_status` 只能是 `ready`、`review_required` 或 `insufficient_information`。`ready` 政策中的每個已選算法都必須出現在 `algorithm_registry_snapshot`，且版本固定、狀態為 `executable`；否則政策不得標示 `ready`。

## 最終輸出

產生完整的新 `SKILL.md`，不要只提供大綱。若可建立檔案就直接建立；否則只輸出一個從 YAML frontmatter 開始的 Markdown 程式碼區塊。不得宣告候選算法已通過系統驗證。

Referenced files: 1