context-driven-development

概覽

什麼是 context-driven-development？

context-driven-development 是一項技能，旨在協助開發者與團隊建立、維護並同步關鍵的專案上下文資產。這些資產包含 product.md、tech-stack.md、workflow.md 和 tracks.md 等檔案，全部組織於 conductor/ 目錄下。透過將專案上下文視為一級資產，此技能確保文件、工作流程與技術棧資訊在專案生命週期中保持一致且可操作。

誰適合使用此技能？

此技能非常適合開發者、專案經理及團隊，適用於：

• 以清晰結構化的文件搭建新專案
• 從現有程式碼庫中萃取並組織上下文
• 維持 AI 輔助開發所需的最新上下文
• 高效地讓新成員快速上手
• 隨著需求與程式碼演進，保持專案文件同步

它解決了哪些問題

• 透過集中管理關鍵專案資訊，減少混淆
• 簡化入職流程與團隊協作
• 確保文件隨程式碼同步演進
• 支援一致且具上下文感知的 AI 互動

使用說明

安裝步驟

1. 使用以下指令安裝技能：

   npx skills add https://github.com/wshobson/agents --skill context-driven-development

2. 安裝完成後，前往專案中的 conductor/ 目錄，尋找或建立上下文資產。

快速入門

• 從 SKILL.md 檔案開始，了解 context-driven-development 的原則與工作流程概覽。
• 閱讀 README.md、AGENTS.md 與 metadata.json，獲取更多專案上下文資訊。
• 探索 references/ 資料夾，特別是 artifact-templates.md，取得各種上下文資產的範本。

適應您的工作流程

• 利用提供的範本搭建新專案或從現有專案中萃取上下文。
• 隨著專案演進，定期更新上下文檔案，保持文件與工作流程一致。
• 在重大實作變更前，驗證資產的一致性，避免錯位。

主要檔案與資料夾

• SKILL.md：主要指南與工作流程概覽
• references/artifact-templates.md：所有核心資產的起始範本
• conductor/：所有上下文資產的目錄
• rules/、resources/、scripts/：支援進階工作流程的輔助檔案

常見問題

什麼時候應該使用 context-driven-development？

當您建立新專案、加入現有程式碼庫，或需要更新與驗證專案文件、技術棧或工作流程時，建議使用此技能。對於採用 AI 輔助開發或追求專案上下文一致性的團隊尤其有用。

什麼是上下文資產？

上下文資產是結構化文件，如 product.md 與 tech-stack.md，用以捕捉專案的關鍵資訊，有助於團隊保持一致並支援自動化工具。

我可以在現有專案中使用此技能嗎？

可以。context-driven-development 能從現有程式碼庫中萃取並組織上下文，適用於新專案與既有專案。

我在哪裡可以找到上下文資產的範本？

請參考 references/artifact-templates.md 檔案，裡面有可供複製與自訂的起始範本。

如何保持上下文資產的最新狀態？

將上下文檔案視為活文件，隨著專案需求、技術棧或工作流程變更時更新。建議定期檢視與驗證。

我在哪裡可以找到更多細節？

請瀏覽此倉庫的 Files 標籤，探索完整檔案結構，包括巢狀參考與進階使用的輔助腳本。