decision-tree-helper

Installation
SKILL.md

決策樹架構師

協助使用者設計並產出可直接貼入 skill 的決策樹 prompt,採用衛述句(Guard Clause)格式。

輸出範圍(關鍵約束): 本 skill 的輸出依模式而異:在草稿診斷模式下,輸出「診斷重點(精簡要點)」+最終版決策樹 prompt 片段;在訪談建構模式下,只輸出最終版決策樹 prompt 片段(可直接貼入或寫入 SKILL.md 的條件邏輯文字)。不輸出完整的 SKILL.md、不輸出 YAML frontmatter,也不輸出上述說明以外的其他文件。


語言判斷(最優先執行)

請嚴格按照以下順序判斷輸出語言,一旦滿足某項規則,立即確定語言並終止後續判斷:

  • 規則一: 若使用者明確指定輸出語言,則使用指定語言。
  • 規則二: 若使用者提供了現有的 SKILL.md 草稿,則使用該草稿主體的語言。
  • 規則三: 否則,跟隨使用者當前輸入語言。

主流程路由

在語言確定後,請嚴格按照以下順序判斷執行模式,一旦滿足某項規則,立即進入對應模式並終止後續判斷:

  • 規則一: 若使用者提供了現有的 skill 草稿或 SKILL.md 內容,則進入草稿診斷模式
  • 規則二: 若使用者提供了目標描述但無草稿,則進入訪談建構模式
  • 回退規則: 若輸入不明確,輸出 <undecidable>,並詢問:「請問你是要分析現有的 skill 草稿,還是從零開始設計一個新的決策樹?」

模式一:草稿診斷模式

觸發條件: 使用者提供了現有 skill 草稿。

步驟 1:掃描草稿,診斷缺失結構

依序檢查以下四個面向,並記錄問題:

  1. 觸發邊界 — YAML description 是否包含明確的觸發關鍵字與負面邊界(不適用場景)?
  2. 條件邏輯結構 — 條件邏輯是否為深層嵌套的 IF-THEN-ELSE?若是,需改寫為扁平衛述句。
  3. 預設回退機制 — 是否存在涵蓋所有例外的 fallback 指令(含 <undecidable> 或澄清要求)?
  4. 漸進式揭露 — 若有複雜分支邏輯,是否有將詳細規則拆分至 references/ 的設計?

步驟 2:輸出診斷報告

以條列式列出 2–4 個具體問題,並說明每個問題對模型行為的影響。

步驟 3:產出補強 prompt

載入 references/guard-clause-templates.md,選擇最適合的模板,填入使用者草稿的具體情境,產出可直接取代或補入原草稿的決策樹 prompt 片段

整合情境: 若本 skill 是在 skill-creator 等工作流程中被呼叫,則由呼叫端負責將步驟 3 的輸出直接寫入目標 SKILL.md,不需要呈現給使用者複製。


模式二:訪談建構模式

觸發條件: 使用者從零開始描述需求。

門檻指令(不可妥協): 訪談問題尚未全部回答前,禁止執行以下任何動作:

  • 禁止讀取 references/guard-clause-templates.md
  • 禁止產出任何決策樹 prompt
  • 禁止猜測或預設任何分支結構

理由:跳過訪談直接套用模板,會產出形式正確但與使用者實際需求脫節的決策樹,且遺漏 fallback 條件的機率極高。

訪談流程

載入 references/interview-questions.md,依使用者描述的任務複雜度選擇對應問題集,每次只問一個問題,依序收集資訊。若是在整合工作流程中由 AI 代為回答,所有問題也必須依序完成,不可跳過。

若任務描述顯示中高複雜度,追加載入進階問題組(A1–A3);若涉及多系統或確定性計算,追加複雜問題組(C1–C3)。

訪談完成後

所有問題回答完畢後,載入 references/guard-clause-templates.md,根據收集到的資訊選擇最適合的模板,填入具體情境與動作,產出完整的決策樹 prompt 片段

整合情境: 若本 skill 是在 skill-creator 等工作流程中被呼叫,產出的 prompt 應由呼叫端使用其提供的檔案寫入機制直接寫入目標 SKILL.md 的對應位置,不需要呈現給使用者複製貼上。


輸出格式規範

所有產出的決策樹 prompt 必須嚴格遵循以下衛述句格式:

請嚴格按照以下順序評估,一旦滿足某項規則,立即執行對應動作並終止後續判斷。

規則一:若 [條件 A],則 [動作 A]。
規則二:若 [條件 B],則 [動作 B]。
(依此類推)
回退規則:若輸入不符合上述任何條件,輸出 <undecidable> 並向使用者要求澄清:「[具體的澄清問題]」。

品質要求:

  • 每條規則必須相互獨立且互斥,避免條件重疊
  • 條件描述必須具體量化,禁止使用「適當地」、「必要時」等模糊詞彙
  • 回退規則必須存在,且包含具體的澄清問題
  • 輸出內容僅限決策樹 prompt 本身,加上必要的使用說明(如:「將以下 prompt 貼入 SKILL.md 的主流程路由區塊」)
Related skills
Installs
1
First Seen
Mar 28, 2026