技能架構師

👤 小熊肖恩 📦 v1.0.0 ⭐ 4.6 ⬇️ 76 下載
🤖 AI-Agent 免費

📖 技能介紹


name: skill-architect-professional display_name: 技能架構師 version: 1.0.0 author: office-raccoon tags: [skillhub, skill-architecture, product-design, expert-team, prd, qa] description: "當用戶要把一個能力、業務流程、專家方法論、知識庫或多步驟工作流設計成可安裝 SkillHub 技能包時使用;支援判斷單技能、技能套件、專家、專家團或混合流水線,並輸出可移交 skill-creator 的標準藍圖。不用於一次性提示詞潤色、普通文件寫作、普通程式碼開發或不需要沉澱為技能的任務。"


技能架構師

目標

把模糊的技能建設想法,轉化為可建立、可評審、可測試、可安裝、可迭代的 SkillHub 技能架構藍圖。

本技能不是直接寫最終技能包的主力執行器,而是技能建立前的架構師:先判斷能力應該被設計成單技能、技能套件、專家、專家團,還是混合流水線;再輸出可移交給 skill-creatorskill-creator-optimized-pro 的標準建立藍圖。

什麼時候使用

當用戶表達以下意圖時使用:

  • “這個能力適合做成 Skill 嗎?”
  • “幫我設計一個技能包架構。”
  • “應該做單技能、專家團還是技能套件?”
  • “把這套 SOP / 方法論 / 課程 / 工作流沉澱成 SkillHub 技能。”
  • “我有很多資料,幫我設計成可上架的專業技能包。”
  • “先別寫包,先幫我定技能架構和專家分工。”

不應該使用

以下場景不要觸發本技能:

  • 使用者只要一次性提示詞潤色,不需要形成可複用技能。
  • 使用者只要普通 PRD、文章、資料分析或程式碼實現。
  • 使用者已經明確要求“直接寫 SKILL.md / 打包技能”,且架構已經確定;此時應轉交 skill-creatorskill-creator-optimized-pro
  • 使用者要求建立違規、侵權、隱私洩露、繞過許可權或高風險自動化技能。

輸入檢查

優先識別以下資訊。缺失時不要連續追問,可先給出假設版藍圖,並標註待確認項。

輸入項 用途 缺失處理
技能目標 判斷是否值得沉澱為 Skill 用一句話重述目標並標為待確認
目標使用者 決定觸發語、輸入門檻與輸出深度 先按普通業務使用者/專業使用者分層假設
典型觸發表達 寫 description 與反觸發邊界 給出候選觸發語
輸入材料 判斷是否需要 references、knowledge、assets 標註需要補充資料清單
預期交付物 決定模板、輸出契約和 QA 先給預設交付物結構
複雜度與分支 判斷單技能/套件/專家團 進入架構決策矩陣
釋出目標 決定 SkillHub 上架門禁 預設按上架預審標準設計

架構決策流程

  1. 確認北極星目標:這個技能最終要幫使用者穩定完成什麼交付?
  2. 識別能力型別:判斷它是任務型、工作流型、知識庫型、專家判斷型、工具自動化型還是多專家協作型。
  3. 選擇最輕架構:先評估單技能是否足夠;只有複雜度、證據隔離、專家角色或流程階段明顯需要時,才升級為套件或專家團。
  4. 設計觸發邊界:寫清應該觸發、容易誤觸、不應觸發的表達。
  5. 拆資產結構:定義 SKILL.mdreferences/templates/examples/qa/scripts/ 的必要內容。
  6. 補質量門禁:覆蓋 YAML、路徑、隱私、上傳限制、TRACE/Depth、測試 Prompt 和驗收標準。
  7. 輸出藍圖:給出可直接移交建立器執行的 skill-blueprint

架構選擇規則

架構 適用條件 不適用條件 輸出重點
單技能 單一任務、流程短、輸入輸出穩定 多角色、多階段、證據鏈複雜 精準 description、簡潔流程、明確模板
技能套件 同一主題下多個獨立任務 使用者入口應極簡但被拆得過散 總入口路由、子模組邊界、統一 QA
專家 需要專業判斷和深度方法論 只是固定格式轉換 判斷標準、反例邊界、專業輸出契約
專家團 多專家視角、衝突消解、多階段評審 只是為了顯得高階 總控路由、專家分工、衝突處理、綜合輸出
混合流水線 同時包含判斷、生成、校驗、打包或外部工具 沒有確定性步驟或工具依賴 階段門禁、指令碼介面、異常恢復

輸出契約

預設輸出以下結構:

  1. 架構結論:推薦架構、理由、替代方案與不推薦方案。
  2. 北極星與邊界:技能目標、非目標、觸發/不觸發表達。
  3. 目標使用者與場景:使用者分層、典型任務、輸入材料。
  4. 能力模組圖:模組、職責、輸入、輸出、依賴。
  5. 目錄結構建議:每個檔案/目錄的必要性和內容說明。
  6. skill-blueprint:可移交建立器執行的標準藍圖。
  7. 質量門禁:TRACE、Depth、YAML、隱私、上傳限制、測試 Prompt。
  8. 實施優先順序:P0/P1/P2 任務、驗收標準與風險。

如使用者明確要求文件交付,應同時生成 Markdown 或 Word;如使用者要求建立包,應轉入技能建立流程。

標準資源索引

按需讀取以下資源,不要一次性把所有內容塞進回覆:

  • references/architecture-decision-guide.md:架構決策矩陣與評分規則。
  • references/source-map.md:本技能能力繼承與 PRD 落地對映。
  • references/phrasebook.md:資訊不足追問、降級建議、拒絕邊界與移交話術。
  • templates/skill-blueprint-template.md:標準架構藍圖模板。
  • templates/architecture-review-template.md:架構評審報告模板。
  • examples/trigger-examples.md:正向、反向、灰區觸發樣例。
  • examples/blueprint-cases.md:單技能、套件、專家團藍圖片段案例。
  • examples/real-world-skillhub-scenarios.md:去品牌化真實 SkillHub 使用者場景案例庫。
  • qa/prd-implementation-audit.md:PRD 落地審計。
  • qa/release-gate.md:釋出前質量門禁。
  • qa/smoke-tests.md:冒煙測試 Prompt、預期結果與 runner 使用說明。
  • scripts/validate_package.py:可選本地靜態檢查指令碼。
  • scripts/run_smoke_tests.py:可選本地批次冒煙測試 runner。

異常處理

  • 目標過寬:先拆成能力域,再建議總控技能 + 內部模組,不把所有內容塞進一個入口。
  • 輸入資料不足:輸出假設版藍圖,並列出最少待確認項;不要卡住。
  • 使用者直接要求生成技能包:若架構已清晰,移交技能建立器;若不清晰,先輸出架構藍圖。
  • 發現隱私/絕對路徑/客戶名稱:標為 P0 釋出風險,要求去標識化。
  • 存在違規或危險自動化:拒絕高風險部分,給出安全替代設計。
  • 結構合規但內容很薄:明確區分“可上傳”和“可專業使用”,建議補 source-map、playbook、案例和 QA。

完成標準

一次合格的技能架構輸出必須滿足:

7w4.net提供免費和付費技能下載。

  • 推薦架構與理由清楚,並說明為什麼不選其他架構。
  • 觸發與排除場景明確,能減少誤觸。
  • 目錄結構不是空殼,每個檔案都有必要性說明。
  • skill-blueprint 可以被建立器直接接力。
  • 質量門禁包含 TRACE、Depth、YAML、隱私、上傳限制和測試 Prompt。
  • 對不確定內容有待確認項,不偽造事實。

🤖 AI 評測

這個技能的質量較高,結構清晰、文件齊全,質量門禁和測試覆蓋也比較完善。它的優勢在於給出了明確的觸發邊界、架構決策規則和可移交的藍圖模板,能有效幫助使用者在動手做技能前理清思路。主要不足是某些參考資料內容較少,真實場景的案例支撐還有提升空間。整體上,這是一個偏前期的規劃型工具,適合需要系統性設計技能架構的使用者使用。

📊 多維度評分

適應性4.5
規範性4.7
有效性4.8
可靠性4.1
可信度5

📁 包含檔案 (25 個)

📄 README.md 3.7 KB
📄 SKILL.md 7.3 KB
📄 agents/openai.yaml 502 B
📄 examples/blueprint-cases.md 1.5 KB
📄 examples/real-world-skillhub-scenarios.md 9.4 KB
📄 examples/trigger-examples.md 1.4 KB
📄 package.json 538 B
📄 qa/prd-implementation-audit.md 1.4 KB
📄 qa/release-gate.md 1.7 KB
📄 qa/skill-scorecard.md 1.3 KB
📄 qa/smoke-test-results.json 1.5 KB
📄 qa/smoke-test-results.md 894 B
📄 qa/smoke-tests.md 2.3 KB
📄 qa/trace-depth-review.md 1020 B
📄 references/architecture-decision-guide.md 2.2 KB
📄 references/delivery-contract.md 1.3 KB
📄 references/error-handling.md 827 B
📄 references/expert-playbook.md 1.8 KB
📄 references/metrics-and-events.md 1.3 KB
📄 references/phrasebook.md 6.1 KB
📄 references/source-map.md 2 KB
📄 scripts/run_smoke_tests.py 7.7 KB
📄 scripts/validate_package.py 3.7 KB
📄 templates/architecture-review-template.md 877 B
📄 templates/skill-blueprint-template.md 1.5 KB