Communitygithub.com

設計一個流程

將一個純語言目標(如「製作一個計算文字中單字數量的流程」)拆解為有序步驟和嵌套的子流程,從而規劃出一個新的 toy_process 流程。在編寫任何程式碼之前,每當使用者要求建立新流程、工作流程或管道時,請優先使用此技能。

設計一個流程 是什麼?

此技能旨在將使用者提出的高層次流程需求(例如「建立一個統計文字單字數量的流程」)系統性地拆解為結構化的步驟規劃。它引導使用者在編寫任何程式碼之前,先闡明流程的整體目標,將其分解為一系列有序的小步驟,並決定哪些步驟應該實現為簡單的方法步驟,哪些應該實現為可重複使用的子流程。此技能支援定義每個步驟的類別名稱、參數、執行的具體方法或子流程,以及它們在共享 context 字典中讀寫的資料鍵。它特別強調保持嵌套層次淺(最多兩層),並確保每個步驟使用的 context 鍵都已被先前的步驟定義。最後,它會生成一個清晰的計劃,並建議在需求模糊時向使用者展示該計劃,然後再使用 create-process 技能來實現程式碼。此技能適用於任何需要建立複雜流程的使用場景,尤其適合 Claude Code 等 AI Agent 平台。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/PaeoniaCommon/SkillsOdea/tree/HEAD/.opencode/skills/design-process

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

設計一個流程 是做什麼的?

使用此技能將一個請求(例如「製作一個計算文字中單字數量的流程」)轉換為步驟計劃。然後再使用 create-process 技能來建構它。

套件位於 process_package/。父類別位於 process_package/toy_process/process.py。

1. 列出步驟

將目標寫成一個有序的清單,每個項目是一個簡短的動作(動詞片語):

WordReport
  1. 清理文字
  2. 計算單字數量
  3. 建立報告

每個步驟應只做一件事,並將其結果放入共享的 context 字典中。

2. 決定每個步驟的類型

對於每個步驟,請選擇:

當...時,使用方法步驟當...時,使用子流程步驟
它是一個小動作它是由幾個相關動作組成
它只在這裡使用它可以在其他流程中重複使用
它不需要自己的設定它有自己的參數

子流程可以包含子流程。保持嵌套層次淺:對於大多數玩具流程來說,兩層就足夠了。

3. 寫下計劃

對於每個流程(父流程和每個子流程),記錄:

  • 類別名稱:使用駝峰式命名法(CamelCase)的名詞或動詞片語,例如 CleanText。
  • 參數:名稱 → 預設值。這些放在 set_parameters 中。
  • 步驟:按順序排列。方法使用蛇形命名法(snake_case);子流程使用其類別名稱。
  • Context 鍵:每個步驟讀取和寫入的內容。

計劃範例:

CleanText            參數: lowercase=True
  - strip_punctuation  讀取 text   寫入 text
  - normalise_case     讀取 text   寫入 text

WordReport           參數: text="", lowercase=True, top_n=3
  - load_text          讀取 -      寫入 text
  - CleanText(lowercase=...)   (子流程)
  - count_words        讀取 text   寫入 counts
  - build_report       讀取 counts 寫入 report

4. 檢查計劃

  • 每個步驟讀取的 context 鍵都必須由較早的步驟寫入。
  • 每個步驟使用的參數都必須存在於該流程的參數中。
  • 子流程從父流程接收參數作為關鍵字參數,例如 CleanText(lowercase=self.params["lowercase"])。

如果請求不明確,請向使用者顯示計劃,然後遵循 create-process 技能。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相關技能