add-task

add-task 技能概覽

add-task 的用途

add-task 技能會根據使用者的原始需求，在 .specs/tasks/draft/ 產生一份草稿任務檔。當你需要先有一個一致的任務工件，再進入規劃或實作階段，而不只是隨手記下想法時，它特別有用。這讓 add-task skill 很適合用在 Project Management 工作流程中，因為任務需要清楚的標題、類型、相依性，並且保留原始意圖。

誰適合安裝

如果你的團隊採用以規格為導向的任務追蹤、把草稿與執行分開，或希望代理把零散需求轉成結構化任務檔，就很適合安裝 add-task。它在任務收件流程很重要時最有價值：例如產品營運、工程主管、AI 輔助 PM 工作流程，以及需要可重複「草稿 → 待辦」流程的 repo 維護者。

為什麼它特別

add-task 的核心價值在於結構化。它不只是摘要需求：它還會幫你分類任務、找出相依檔案，並把輸出放到正確的目錄。和一般可能會忘記命名慣例、任務類型或資料夾規則的通用提示相比，這能大幅減少猜測。

如何使用 add-task 技能

安裝並啟用 add-task

請在 NeoLabHQ/context-engineering-kit 外掛組合的脈絡中使用這個技能，接著把你要整理成草稿的任務需求交給代理。Repository 中展示的安裝流程如下：

npx skills add NeoLabHQ/context-engineering-kit --skill add-task

安裝後，代理應該收到使用者的任務標題或描述，以及任何相依任務檔。add-task install 這一步很重要，因為這個技能預期會使用具備 repo 認知的路徑與資料夾結構，包括 .specs/tasks/draft/。

撰寫技能能解析的輸入

最好的 add-task usage 是簡潔但具體的需求。請包含結果、範圍，以及任何已知相依性。好的輸入例如：

• Add validation to form inputs
• Create login rate limiting; depends on auth cleanup task
• Refactor task creation flow for mobile users

不好的輸入會太模糊，迫使模型自行猜測：

• Improve app
• Fix stuff
• Make tasks better

如果需求本身暗示了類型，請直接說明；如果沒有，就讓技能根據動詞與範圍自行推斷。

先讀對的檔案

先從 SKILL.md 開始，因為它定義了角色、目標、輸入與操作說明。接著再查看任何會影響任務命名、工作流程或慣例的 repo 檔案。在這個 repository preview 裡，SKILL.md 是主要來源；沒有像 rules/ 或 references/ 這類支援資料夾，因此最大的風險不是這裡缺文件，而是你的工作區本身可能有本地慣例卻沒被讀到。

能產出更好草稿的工作流程

當你的目標是把模糊需求轉成之後可移到待辦或實作的草稿時，就用 add-task。第一步，提供精確的任務意圖與相依性。第二步，讓技能把草稿檔建立到預期的資料夾。最後，檢查輸出是否有清楚的標題、正確的相依關係，以及描述是否保留了使用者原意而沒有過度編修。

add-task 技能常見問答

add-task 是給 Project Management 還是寫程式用的？

兩者都可以，但主要用途是工程工作的 Project Management。它會產出可供規劃與實作接續使用的任務工件。如果你只需要一則快速提醒，直接用一般提示會更簡單。

我需要先懂 repository 結構嗎？

不用，但你應該知道專案是否使用 .specs/tasks/ 或類似的慣例。如果你的 repo 有不同的任務資料夾，請先調整輸出路徑，再依賴預設的 add-task 行為。

什麼情況下不該用 add-task？

如果你已經有完整定義好的實作工單、任務應該直接進入寫程式階段，或者你的 repo 根本不使用草稿任務檔，就不要用它。在這些情況下，直接提示或其他工作流程通常會更快。

這個技能適合初學者嗎？

可以，只要你能用一句話描述任務，並理解基本的相依性命名就行。主要的學習門檻不在 AI 那一步，而是要知道團隊對草稿檔內容的期待是什麼。

如何改進 add-task 技能

讓技能少填一些空白

提升品質最大的關鍵，在於更好的來源輸入。請包含動作、目標區域，以及任何阻礙因素。例如，Add password reset email retry handling; depends on email queue stability task 就明顯比 Improve reset flow 更好。這能幫助 add-task 保留原意，並正確指派相依關係。

檢查標題、類型與相依性

大多數品質不佳的輸出，通常來自三個問題：標題太寬、類型標籤太籠統、以及缺少相依連結。先檢查這三項。如果標題不是「動詞 + 具體物件」的形式，就改寫它。如果類型不明確，就先補上一句釐清說明，再重新執行 add-task skill。

透過修正提示詞迭代，不要直接硬改檔案

如果第一版草稿不對，先改善輸入內容，而不是自己把整份檔案逐段補丁式修掉。告訴代理哪些內容要保留、哪些內容要重新分類、以及應該依賴哪些檔案。這是拿到可供下游規劃使用草稿的最快 add-task guide 做法。