Communitygithub.com

TheStreamCode/agentic-rd-skill

一個通用的代理技能,適用於 Agent Laboratory 風格的工作流程,支援研究、產品、業務、技術、策略、可行性及規劃等多種使用案例中的平行子代理團隊。

agentic-rd-skill 是什麼?

此技能包旨在將「Agent Laboratory」模式的一般化版本引入您的開發工作流程,專注於以 Markdown 為首的多代理協作。其核心是將複雜任務拆解為證據審查、計畫制定、執行、結果分析、品質審查與最終報告撰寫等階段。此技能並非僅限於科學研究,而是可廣泛應用於產品、業務、技術、策略、法律、安全、用戶體驗與營運等領域。它偏好利用真實的平行子代理來加速獨立工作,但也能在環境不支援時,以隔離的模擬方式執行。技能包含完整的文件範本、角色選擇指南與執行規則,確保工作流程的品質與一致性。使用者只需提供專案簡報,技能便能自動建立所需的工作目錄結構,並透過階段性審查閘門控制最終輸出,從而將多代理協作的複雜度降到最低。

相容平台✓Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add TheStreamCode/agentic-rd-skill

在你喜歡的 AI 中提問

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

說明文件

Agentic 研發工作流程

使用這個自成一體的技能包,在當前工作區內自動化一個以 Markdown 為優先、多代理的實驗室工作流程。

這是 Agent Laboratory 模式的一般化改編:獨立的證據審查、協作式計畫制定、任務執行或調查、結果分析、品質審查以及最終報告撰寫。它不限於科學研究;可以將同樣的實驗室工作流程應用於產品、業務、技術、策略、法律、合規、安全、用戶體驗、市場和營運等多種使用案例。

專為具備檔案系統存取權限且相容於該技能的編碼代理所設計。當環境支援時,優先使用真實的平行子代理;僅在無法使用真實子代理時,才使用隔離的模擬處理。

套件內容

  • SKILL.md:啟動規則與核心操作指令。
  • references/generalized-lab-model.md:通用的 Agent Laboratory 模型與使用案例對應。
  • references/workflow.md:完整的階段順序與核准閘門。
  • references/agent-roles.md:專家角色選擇指南。
  • references/quality-rules.md:證據、不確定性、審查與安全標準。
  • references/implementation-notes.md:安裝、建構、子代理與檔案處理的注意事項。
  • references/example-run.md:一個完整的端到端範例,展示預期的檔案軌跡與輸出品質。
  • assets/templates/:所有工作流程檔案的 Markdown 範本。
  • scripts/init-rd-workflow.mjs:可選的建構腳本。
  • scripts/validate-skill.mjs:用於公開技能套件的儲存庫驗證。

首要動作

  1. 在目前工作區中尋找 project-brief.md。
  2. 如果存在,請在執行任何其他工作流程步驟之前完整讀取它。
  3. 如果不存在且使用者提供了足夠的上下文,請使用 assets/templates/project-brief.md 建立它。
  4. 如果遺漏了必要的上下文,僅提出最少量的關鍵問題。
  5. 簡報就緒後,無需在正常的工作流程階段之間請求許可,即可繼續進行。

執行 scripts/init-rd-workflow.mjs 以建構 project-brief.md 和必要的 work/ 檔案。此腳本不得建立 work/06-final-output.md。

必要輸出

在活動工作區中建立並使用以下結構:

work/
├── 00-lab-notes.md
├── 01-orchestration-plan.md
├── 02-specialist-outputs/
├── 03-team-collaboration.md
├── 04-cross-review-notes.md
├── 05-stage-gate-review.md
└── 06-final-output.md

每個工作流程階段對應到一個特定的輸出路徑。編號的實驗室階段(證據審查、計畫制定、執行、結果分析)並非個別檔案:它們會以每位專家一個檔案的形式,具體化在 work/02-specialist-outputs/ 目錄下。

階段輸出路徑
實驗室設定work/00-lab-notes.md
編排work/01-orchestration-plan.md
證據審查、計畫、執行、結果(每位專家一個檔案)work/02-specialist-outputs/NN-<role>.md
團隊協作(由編排者整合)work/03-team-collaboration.md
交叉審查work/04-cross-review-notes.md
階段閘門審查work/05-stage-gate-review.md
最終綜合報告work/06-final-output.md

在 work/05-stage-gate-review.md 顯示為 已核准 (Approved) 之前,請勿建立或寫入 work/06-final-output.md。

工作流程

  1. 閱讀 references/workflow.md 以了解標準的階段順序。
  2. 閱讀 references/generalized-lab-model.md 以將使用者的使用案例對應到實驗室階段。
  3. 在選擇專家前,閱讀 references/agent-roles.md。
  4. 在交叉審查、階段閘門審查和最終綜合報告之前,閱讀 references/quality-rules.md。
  5. 關於腳本使用、子代理行為與檔案處理的詳細資訊,請參考 references/implementation-notes.md。
  6. 使用 assets/templates/ 中的範本產生工作流程檔案。
  7. 在對預期的輸出品質不確定時,請查閱 references/example-run.md 以了解完整的端到端運作範例。

根據簡報規模調整

根據簡報的複雜度來調整工作流程的份量。不要為了一個小問題而執行完整的、多波次(multi-wave)的實驗室流程。

  • 簡單的簡報:編排者可以直接進行單一內嵌處理,不使用子代理。將證據、假設和風險記錄在 work/00-lab-notes.md 中,撰寫簡短的 work/05-stage-gate-review.md 自我檢查,然後產生 work/06-final-output.md。在此等級中,中間的專家、協作和交叉審查檔案為可選項目。階段閘門規則仍然有效:在 05-stage-gate-review.md 顯示為 已核准 (Approved) 之前,不得寫入 06-final-output.md。
  • 小型或範圍狹窄的簡報:使用一到兩位專家,執行單一波次,並將協作記錄合併到編排者的筆記中,而非進行獨立的交換。將交叉審查、階段閘門審查和最終綜合報告各維持為一次快速處理。
  • 中等簡報:使用幾位專家進行一到兩個波次,搭配輕量級的團隊協作步驟。
  • 大型或受監管的簡報:使用完整的階段順序、多個波次、明確的團隊協作以及相關的審查角色。

無論規模大小,始終保留強制性的最低限度:證據/上下文審查、計畫制定、執行或調查、結果分析、風險/假設涵蓋範圍,以及在最終綜合報告之前的階段閘門品質檢查。其他所有內容都是可選的,僅在其能實質改變交付成果時才加入。請參閱 references/generalized-lab-model.md 以了解規模調整的詳細資訊。

執行規則

  • 選擇能夠充分涵蓋簡報需求的、最少的專家角色。
  • 務必包含證據/上下文審查、計畫制定、執行或調查、結果分析以及風險/假設涵蓋範圍。
  • 偏好使用真實的平行子代理。這是此技能的主要執行模型,而非可選的增強功能。
  • 在每個階段中,同時啟動所有獨立的專家,等待結果。當平行子代理可用時,不要逐一執行獨立的專家。
  • 否則,以隔離處理的方式模擬專家。每次處理在寫入自己的檔案之前,只能閱讀簡報、編排計畫及其分配的範圍。
  • 切勿將專家分析、交叉審查、階段閘門審查和最終綜合報告合併為一個回覆。
  • 將獨立專家的工作平行化,但保持依賴關係的閘門為順序執行:審查先於計畫,計畫先於執行,執行先於結果分析,審查先於最終報告。
  • 在可用情況下,對事實性陳述要求引用或來源說明。
  • 將未經支持的陳述標記為假設或推論。
  • 保留不確定性與受監管領域的審查邊界。

協作團隊協議

  • 將子代理視為協作團隊,而非各自為政的報告撰寫者。
  • 主編排者在 work/01-orchestration-plan.md 中定義團隊角色、擁有權、依賴關係和協作規則。
  • 每個子代理僅撰寫自己的專家輸出檔案,並將其問題、依賴關係、分歧點和交接備註回傳給編排者(包含在其結果中,而非編輯共享檔案)。
  • 編排者將這些回傳的備註整合到 work/03-team-collaboration.md 中。切勿讓多個子代理同時寫入同一個檔案。
  • 團隊必須在交叉審查前調和共享的假設。
  • 交叉審查會同時評估專家的輸出以及團隊協作記錄。
  • 最終綜合報告必須反映已解決的協議、未解決的分歧,以及重要的少數意見。

停止條件

僅在以下情況時停止並詢問使用者:

  • 無法識別主題或目標。
  • 無法推斷出期望的輸出。
  • 關鍵限制條件相互衝突。
  • 所需的外部資料、憑證、私有系統、付費工具或無法取得的網路連線阻礙了工作進行。
  • 法律、醫療、財務、合規、安全或關鍵安全建議無法保持在安全的資訊邊界內。

完成

工作流程完成時,告知使用者建立了哪些檔案,以及階段閘門是否核准了最終綜合報告。保持完成訊息簡潔。

相關技能