Skip to content

Verdent 适配五层级模型

Verdent 适配五层级模型 是一套將 Agent Skills 工作流理念映射並實施到 Verdent 工具環境中的結構化框架^[001-TODO__Agent_Skills_-结构化AI编码工作流框架.md]。該模型通過五個遞進的配置層級，將工程師的最佳實踐（如規格定義、代碼審查和測試驗證）轉化為 AI 代理的強制行為約束，從而解決 AI 代理易於跳過關鍵工程步驟的問題^[001-TODO__Agent_Skills-_结构化AI编码工作流框架.md]。

其核心思想是從全局通用原則到項目特定規則，再到具體的執行模式、專家角色分配，最終通過並行工作空間隔離不同關注點，實現高質量的代碼交付^[001-TODO__Agent_Skills_-_结构化AI编码工作流框架.md]。

層級結構

該模型將適配過程分為五個具體層級，每一層都對應 Verdent 中的一個特定配置或功能點^[001-TODO__Agent_Skills_-_结构化AI编码工作流框架.md]。

層級 1：全局原則 (verdant.md)

這是最底層的基礎配置，對用戶的所有項目生效。它定義了不可妥協的工程基準^[001-TODO__Agent_Skills_-_结构化AI编码工作流框架.md]。

  • 配置位置：verdant.md
  • 核心行為：
    • 代碼前規格 (Spec before code)：強制要求在編寫代碼前先明確規格定義^[001-TODO__Agent_Skills_-_结构化AI编码工作流框架.md]。
    • 變更驗證 (Verify changes)：所有修改必須經過驗證^[001-TODO__Agent_Skills_-_结构化AI编码工作流框架.md]。
    • 禁止跳過測試 (Don't skip testing)：不允許為了速度而犧牲測試環節^[001-TODO__Agent_Skills_-_结构化AI编码工作流框架.md]。
    • 簡單性優先 (Prefer simpler solutions)：傾向於簡單、可維護的方案，而非過度設計^[001-TODO__Agent_Skills_-_结构化AI编码工作流框架.md]。
    • 拒絕合理化草率工作 (Avoid rationalizing sloppy work)：防止代理為低質量的代碼尋找藉口^[001-TODO__Agent_Skills_-_结构化AI编码工作流框架.md]。

層級 2：項目級規則 (agents.md)

此層級針對特定項目進行配置，其優先級高於全局配置，用於定義該項目的特定工作流標準^[001-TODO__Agent_Skills_-_结构化AI编码工作流框架.md]。

  • 配置位置：agents.md
  • 核心行為：
    • 清晰的規格 (Always create clear spec)：確保每次需求都有明確的文檔說明^[001-TODO__Agent_Skills_-_结构化AI编码工作流框架.md]。
    • 任務拆解 (Always break into small tasks)：將大任務分解為可管理的小單元^[001-TODO__Agent_Skills_-_结构化AI编码工作流框架.md]。
    • 實證驗證 (Always verify with real evidence)：要求通過實際運行結果證明功能正確性，而非僅憑斷言^[001-TODO__Agent_Skills_-_结构化AI编码工作流框架.md]。
    • 合併前審查 (Always review before merge)：將代碼審查設為合併的必經門檻^[001-TODO__Agent_Skills_-_结构化AI编码工作流框架.md]。

層級 3：規劃規則 (Plan Rules)

此層級強化了規劃 階段的行為，確保在開始實現之前，計劃是完整且可執行的^[001-TODO__Agent_Skills_-_结构化AI编码工作流框架.md]。

  • 配置位置：Verdent Plan Mode (規劃模式)
  • 核心行為：
    • 範圍澄清 (Scope clarification)：明確邊界，防止需求蔓延^[001-TODO__Agent_Skills_-_结构化AI编码工作流框架.md]。
    • 驗收標準 (Acceptance criteria)：定義明確的「完成」定義^[001-TODO__Agent_Skills_-_结构化AI编码工作流框架.md]。
    • 任務排序 (Sequencing)：確定任務的依賴關係和執行順序^[001-TODO__Agent_Skills_-_结构化AI编码工作流框架.md]。
    • 驗證步驟 (Verification steps)：在計劃階段即預先考慮如何驗證結果^[001-TODO__Agent_Skills_-_结构化AI编码工作流框架.md]。
    • 回滾考量 (Rollback thoughts)：預設失敗場景及回滾方案^[001-TODO__Agent_Skills_-_结构化AI编码工作流框架.md]。

層級 4：專家子代理 (Custom Sub-agents)

對應 Agent Skills 中的「專家人設」，通過定義專門的代理來處理特定的工程關注點，而不是讓一個代理處理所有事情^[001-TODO__Agent_Skills_-_结构化AI编码工作流框架.md]。

  • 配置位置：Sub-agent 定義
  • 角色劃分：
    • 審查者 (Reviewer sub-agent)：專注於代碼質量、可讀性和複雜度^[001-TODO__Agent_Skills_-_结构化AI编码工作流框架.md]。
    • 測試工程師 (Testing sub-agent)：專注於測試覆蓋率和邊界條件^[001-TODO__Agent_Skills_-_结构化AI编码工作流框架.md]。
    • 安全審計員 (Security sub-agent)：專注於漏洞檢測和權限管理^[001-TODO__Agent_Skills_-_结构化AI编码工作流框架.md]。
  • 執行方式：在主代理完成實現後，並行啟動這些專家代理進行各項檢查^[001-TODO__Agent_Skills_-_结构化AI编码工作流框架.md]。

層級 5：並行工作區 (Parallel Workspaces)

最高層級的適配涉及物理隔離不同的工作流，以避免干擾並提高效率^[001-TODO__Agent_Skills_-_结构化AI编码工作流框架.md]。

  • 配置位置：Git Worktree (工作樹隔離)
  • 工作區劃分：
    • 工作區 A (Feature Implementation)：功能實現區^[001-TODO__Agent_Skills_-_结构化AI编码工作流框架.md]。
    • 工作區 B (Tests & Verification)：測試與驗證區^[001-TODO__Agent_Skills_-_结构化AI编码工作流框架.md]。
    • 工作區 C (Review/Alternate)：代碼審查或替代方案實現區^[001-TODO__Agent_Skills_-_结构化AI编码工作流框架.md]。
  • 執行邏輯：在範圍確定後，這些工作區並行運行，互不幹擾，最後再合併結果^[001-TODO__Agent_Skills_-_结构化AI编码工作流框架.md]。

應用邏輯

這五個層級並非孤立存在，而是形成了一個從通用到具體、從串行到並行的漏斗式適配過程^[001-TODO__Agent_Skills_-_结构化AI编码工作流框架.md]。

  1. 基礎約束：無論做什麼項目，verdant.md 確保基本工程素養^[001-TODO__Agent_Skills_-_结构化AI编码工作流框架.md]。
  2. 項目定制：agents.md 根據具體項目需求，可能會覆蓋或強調某些特定行為^[001-TODO__Agent_Skills_-_结构化AI编码工作流框架.md]。
  3. 流程強化：在進入具體編碼前，Plan Rules 確保思考的完整性^[001-TODO__Agent_Skills_-_结构化AI编码工作流框架.md]。
  4. 角色分離：通過 Sub-agents 將「寫代碼」、「測試」和「審查」分離，模擬專業團隊協作^[001-TODO__Agent_Skills_-_结构化AI编码工作流框架.md]。
  5. 隔離執行：利用 Parallel Workspaces 實現真正的並行工程，提高穩定性和效率^[001-TODO__Agent_Skills_-_结构化AI编码工作流框架.md]。

相關概念

  • Agent Skills：Verdent 適配模型的理論來源，強調將軟體生命週期作為 AI 的行為準則。
  • Verdent：實施該五層級模型的具體開發工具或環境。
  • [[專家人設]]：層級 4 中使用的 Sub-agents 設計理念。

Sources

  • 001-TODO__Agent_Skills_-_结构化AI编码工作流框架.md