defi-protocol-templates

defi-protocol-templates skill 概覽

defi-protocol-templates 實際上能提供什麼

defi-protocol-templates skill 是一個用於常見 DeFi 合約模式的程式碼產生與腳手架輔助工具，涵蓋 staking、AMM、governance、lending，以及 flash-loan 類型的基礎模組。它的核心價值在於速度：你不需要從空白的 Solidity 檔案開始，而是直接從可辨識的協議結構出發，先具備核心 state、events，以及主要函式流程的骨架。

這個 defi-protocol-templates skill 最適合誰

這個 defi-protocol-templates skill 最適合已經清楚知道自己要做什麼產品、只是需要一個穩固合約架構起點的 Web3 開發者。特別適合：

• 需要快速驗證協議機制的 Solidity 開發者
• 用 AI 協作開發 DeFi MVP 的工作流程
• 在進入客製設計前，先比較基準實作的團隊
• 需要快速產出第一版草稿的 hackathon 或內部 R&D 專案

它真正解決的是什麼問題

大多數使用者其實不是抽象地需要「templates」，而是需要把像是「單邊 staking 搭配線性獎勵」或「具 delegation 的簡易 governance token」這種粗略想法，轉成具體的實作方向與起手合約。defi-protocol-templates 幫助的就是這個從概念走向實作的轉換步驟。

defi-protocol-templates 和一般 prompt 有什麼不同

一般 prompt 當然也能描述 DeFi protocol，但如果你的目標是讓模型穩定地貼近已知的 DeFi 合約類型，這個 skill 會更實用。它能降低歧義，並且在 reward accounting、pool math、governance token mechanics 這類常見情境下，更容易產出結構清楚、方向正確的結果。

安裝前一定要先知道的限制

從 repository 的內容來看，這個 skill 本質上幾乎就是單一一份 SKILL.md，裡面嵌入了一些範例；它不是附帶 tests、scripts、audits 或 deployment tooling 的完整 framework。也就是說，defi-protocol-templates for Web3 比較像是起手模板與設計輔助，不是可直接上線的 production package。請不要把它產生的程式碼視為已可通過 audit 的版本。

如何使用 defi-protocol-templates skill

defi-protocol-templates 的安裝情境

請在支援 GitHub-hosted skills 的 AI coding 環境中使用 defi-protocol-templates install。典型的安裝方式如下：

npx skills add https://github.com/wshobson/agents --skill defi-protocol-templates

如果你的 client 支援直接從 GitHub 載入 skill，加入該 repository 後，指向 skill slug defi-protocol-templates 即可。

先讀這個檔案

優先從這裡開始：

• plugins/blockchain-web3/skills/defi-protocol-templates/SKILL.md

目前沒有看到額外的 README、resources、rules 或 helper scripts，因此幾乎所有有用的指引都集中在這一個檔案裡。正式下 prompt 前先讀過，才能知道這個 skill 原本就預設支援哪些 protocol family。

先搞清楚 defi-protocol-templates 涵蓋哪些內容

當你的需求可以明確對應到以下模式之一時，這個 skill 的內容最有發揮空間：

• staking rewards
• AMM contracts
• governance tokens 或 voting structures
• lending and borrowing logic
• flash-loan 相關的 protocol mechanics

如果你的設計涉及 cross-chain、重度依賴 oracle、複雜 liquidation 流程，或是極度講究 gas 最佳化，那這個 skill 比較適合當第一版草稿輔助，而不是完整解法。

下 prompt 前先準備最低限度的輸入

想讓 defi-protocol-templates usage 產出高品質結果，至少要先提供模型以下資訊：

• protocol type
• token standard assumptions
• chain 或 EVM compatibility target
• reward、fee 或 interest model
• admin 與 upgrade assumptions
• security constraints
• 你希望產出什麼：只有 contract、interfaces、tests、docs，還是全部都要

弱的輸入：
Build a DeFi protocol

強的輸入：
Use the defi-protocol-templates skill to draft a Solidity staking rewards contract for an ERC-20 token on Ethereum. Users stake one token and earn rewards in another token at a fixed per-second rate. Include pause controls, owner-funded rewards, events, reward accounting comments, and a list of security risks that still require review.

把模糊目標變成好用的 prompt

一個實用的 defi-protocol-templates guide prompt，通常會包含四個部分：

1. 指出 protocol archetype
2. 說清楚經濟規則
3. 說明操作上的限制條件
4. 要求回傳具體產物，而不只是程式碼

範例：
Use defi-protocol-templates to generate a minimal AMM pair contract and factory outline for an EVM chain. Assume constant-product pricing, 0.3% fee, ERC-20 pairs only, no fee-on-transfer support, and no upgradeability. Return: architecture summary, core Solidity contracts, edge cases, and a checklist for testing swaps, liquidity add/remove, and reserve sync behavior.

明確要求模型列出 assumptions

這個 skill 最大的採用阻力之一，就是隱含假設太多。要讓 DeFi 輸出品質明顯提升，最好強制模型先聲明：

• trust model
• price source assumptions
• token behavior assumptions
• reentrancy 與 access control assumptions
• 數學處理是為了方便說明而簡化，還是打算接近可部署版本

這樣可以避免你收下一份看起來合理、實際上卻默默省略關鍵協議規則的合約。

defi-protocol-templates for Web3 的建議實務流程

一個實際可用的 defi-protocol-templates for Web3 工作流程如下：

1. 在 SKILL.md 中先找最接近的 protocol template
2. 第一輪先要求最小可行版本
3. 檢查 assumptions 與缺少的 invariants
4. 再要求 tests 與 adversarial cases
5. 之後才加入 fees、admin controls 或 upgrade patterns 等功能
6. 在 skill 之外自行執行 static analysis 與人工審查

這種分階段做法，比一次要求「full production DeFi protocol」安全得多。

第一輪應該要求模型產出什麼

第一次生成時，建議要求：

• contract architecture summary
• state variables 說明
• 帶有 access control 的 function list
• event 設計
• 已知 attack surfaces
• 哪些部分是刻意省略的

這樣你會先拿到一層可檢查的設計說明，再決定是否值得投入時間審閱產生出的 Solidity。

實際讀 repo 的路徑

因為這個 skill 只有一個真正有內容的檔案，所以閱讀路徑很簡單：

1. 先掃過 When to Use This Skill
2. 找出哪個內嵌 template 最接近你的 protocol
3. 比對範例結構與你預期的 token flow 是否一致
4. 再要求模型「依照該段調整」，而不是直接照抄

這一步很重要，因為 template 不匹配是劣質輸出的常見來源。像是拿 staking template 去硬改 vesting，或把簡單 AMM 套到 concentrated liquidity，通常誤導會比幫助更多。

哪些不適合的情境要及早辨識

如果你需要以下內容，就不要只依賴 defi-protocol-templates usage：

• 經 audit 的 production contracts
• deployment scripts 與環境設定
• protocol-specific 的經濟模擬
• liquidation engine 設計
• oracle integration 細節
• formal verification artifacts
• 非 EVM 實作

遇到這些情況時，請把這個 skill 當成初始結構工具，並搭配專門工具或已經過審核的參考實作。

defi-protocol-templates skill 常見問題

defi-protocol-templates 適合初學者嗎？

部分適合。它很適合用來理解常見 DeFi 合約大概長什麼樣，但單靠它本身並不算對新手安全。如果你還無法自行審查 Solidity 裡的 access control、算術處理與 token interaction 風險，就應該把所有輸出都視為教學用途的草稿程式碼。

這比直接叫 AI 寫 DeFi 程式碼更好嗎？

通常是，尤其在常見 protocol family 上更明顯，因為 defi-protocol-templates 會把任務範圍收斂到已知的 DeFi 類型，通常能改善輸出的結構與相關性。不過若是很不尋常的協議設計，它不一定自然比較好。

defi-protocol-templates 有包含部署或測試工具嗎？

根據這裡看到的 repository 證據，沒有。沒有顯示出 scripts、resources 或 test harness 相關檔案。你應該預期 deployment、testing 與 CI 步驟都需要自己補上或另外產生。

我可以直接拿 defi-protocol-templates 產生 production contracts 嗎？

不能直接這樣做。比較合理的用法是先用它加快設計與第一版實作，再自行補上：

• 完整測試
• invariant checks
• static analysis
• gas review
• 外部安全審查或 audit

哪些 protocol 想法最適合用 defi-protocol-templates？

最適合的是下列需求的直接變體：

• staking rewards
• 基礎 AMMs
• governance token patterns
• 簡單的 lending/borrowing flows
• flash loan primitives

你的設計越往新型 tokenomics 或複雜 market design 走，這種基於 template 的生成方式就越不可靠。

什麼情況下不該安裝這個 skill？

如果你真正需要的是 turnkey protocol repo、實戰驗證過的 integrations，或已經 audit 過的 base，那就可以跳過 defi-protocol-templates install。這個 skill 最強的定位是 AI prompt 輔助工具，不是端到端的開發工具箱。

如何改善 defi-protocol-templates skill 的使用效果

提供 protocol 規則，不要只丟 protocol 名稱

提升 defi-protocol-templates 輸出品質最快的方法，就是把規則講清楚，例如：

• 誰可以 deposit
• rewards 如何累積
• 使用者何時可以 withdraw
• 誰能更新 rates
• 存在哪些 fees
• 發生 failure cases 時要怎麼處理

Build lending 這種說法太弱。Build overcollateralized lending with ERC-20 collateral, fixed interest, owner-set parameters, and liquidation hooks left as stubs 會好得多。

要求模型把 template code 和 custom logic 分開標示

一種很有效的 prompt 寫法是：
Use defi-protocol-templates and clearly label which parts are generic template structure and which parts are specific to my protocol requirements.

這樣你在審查風險較高的客製區塊時，速度會快很多。

生成後務必再做一次安全檢查

第一版輸出完成後，再要求模型補做以下檢查：

• reentrancy risks
• access control gaps
• accounting edge cases
• fee manipulation paths
• token compatibility assumptions
• griefing vectors

很多時候，這第二輪檢查的重要性甚至高於第一版程式草稿本身。

用明確的輸出格式提升 defi-protocol-templates 結果

你可以要求固定回應結構，例如：

1. assumptions
2. architecture
3. Solidity code
4. missing protections
5. test checklist
6. audit questions

結構化輸出可以降低 defi-protocol-templates skill 只回傳程式碼、卻沒有足夠審查脈絡的風險。

要特別注意的常見失敗模式

這個 skill 所在領域常見的問題包括：

• reward accounting 不完整
• 缺少 access restrictions
• 不安全的外部 token calls
• 漏掉 reserve 或 balance sync logic
• 不切實際的 flash loan repayment checks
• governance model 忽略 delegation 或 vote snapshots

如果上述任何一項剛好是你協議的核心，就不要假設 template 已經處理好了，請直接明確要求。

迭代時一次只收緊一個變數

不要一次修改所有東西。第一版草稿之後，建議每次 prompt 只調整一個維度：

• 加入 upgradeability
• 加入 emergency pause
• 更改 fee model
• 加入 multi-token rewards
• 增加 test coverage
• 把 owner model 改成 roles

這樣更容易看出設計究竟是在哪一步開始失效。

把 defi-protocol-templates for Web3 和你自己的標準一起用

實務上，改善 defi-protocol-templates for Web3 最有效的方法，是把你自己的 house rules 一起提供進去：例如 Solidity version、是否使用 OpenZeppelin、event naming、NatSpec 要求、upgrade pattern，以及 testing framework。這個 skill 給你的是起始骨架；真正讓它變得可用的，是你的開發標準。