Community寫作與編輯github.com

dofastted/AgentDock

在開始實作之前,自動探索並注入專案特定編碼規範。讀取目標套件的 spec 索引、開發前檢查清單和共享思考指南。請於開始新的編碼任務、撰寫任何程式碼之前、切換至不同套件時,或需要重新整理專案慣例與標準時使用。

AgentDock 是什麼?

AgentDock 是一個專為 AI 代理(例如 Claude Code)設計的技能,能確保任何程式碼變更都符合專案的編碼標準。它會強制執行一個結構化的預開發流程:首先讀取任務成品(prd.md、design.md、implement.md),接著透過 Python 腳本發現相關套件及其規範層,然後要求代理讀取特定套件的 spec 索引與開發前檢查清單。此技能特別重視邊界陳述(boundary-stating),對於涉及多個檔案、跨越層級或修改公共介面的非簡單任務,AgentDock 會要求代理在撰寫程式碼前,以書面方式描述變更的範圍、影響的檔案及刻意不處理的部分。透過強制閱讀 `.trellis/spec/` 目錄下的共享指南(如錯誤處理習慣、模擬策略等),此技能能有效減少因忽略專案慣例所導致的重構與錯誤。它支援基於 Python 的工具鏈,非常適合使用 `get_context.py` 腳本進行專案探索的團隊。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/dofastted/AgentDock/tree/HEAD/.claude/skills/trellis-before-dev

Installed? Explore more 寫作與編輯 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜歡的 AI 中提問

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

說明文件

開始執行任務之前,請先閱讀相關的開發指南。

請執行以下步驟:

  1. 讀取當前任務成品:

    • prd.md:了解需求和驗收標準
    • design.md(如存在):了解技術設計
    • implement.md(如存在):了解執行順序與驗證計畫
  2. 探索套件及其規範層:

    python3 ./.trellis/scripts/get_context.py --mode packages
    
  3. 根據以下條件,判斷哪些規範適用於你的任務:

    • 你正在修改哪個套件(例如 cli/、docs-site/)
    • 工作類型為何(後端、前端、單元測試、文件等)
    • 任務成品是否引用了任何 spec/research 路徑
  4. 讀取每個相關模組的規範索引:

    cat .trellis/spec/<package>/<layer>/index.md
    

    請遵循索引中的 「Pre-Development Checklist」(開發前檢查清單) 部分。

  5. 讀取開發前檢查清單中所列、且與你任務相關的特定規範檔案。索引本身並非目標——它會指向實際的規範檔案(例如 error-handling.md、conventions.md、mock-strategies.md)。請閱讀這些檔案以了解編碼標準與模式。

  6. 務必閱讀共享指南:

    cat .trellis/spec/guides/index.md
    
  7. 對於非簡單的任務,請在撰寫程式碼之前,先陳述變更邊界 (change boundary)。 非簡單任務指的是會觸及一個以上的檔案、跨越層級、變更公開介面,或修改非你剛撰寫的程式碼。請寫下:

    • 當前行為與預期行為之間最小的行為差距
    • 該行為實際存在的位置(而非最容易攔截的位置)
    • 你預計會變更哪些檔案,以及為什麼需要變更這些檔案
    • 你在本次任務中明確不處理的事項
    • 如果需要在本地進行重構,你將如何證明重構並未改變行為

    一個小範圍、邊界明確的變更不需要這麼做 —— 直接進行即可。

    如果實際範圍明顯大於上述預估,請先說明情況及原因,再繼續進行。請不要自行擴大變更範圍。

  8. 了解你需要遵循的編碼標準和模式,然後繼續你的開發計畫。

此步驟在撰寫任何程式碼之前,皆為強制性。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

相關技能