Communitygithub.com

tangjuyo/reels-blocker

根據現有的設計文件,生成一份可執行、具有依賴順序的 tasks.md 檔案。

reels-blocker 是什麼?

這個技能會根據專案中的設計文件(如 plan.md、spec.md 等)自動生成一份結構化的 tasks.md 檔案,並依照使用者故事的優先級和任務之間的依賴關係進行組織。它支援指定擴充套件鉤子(hooks),可在任務生成前後觸發自訂指令,例如自動提交程式碼或執行檢查。生成的 tasks.md 遵循嚴格的清單格式,包含任務 ID、可並行標記、所屬使用者故事標籤以及明確的檔案路徑,確保每個任務都能獨立執行與測試。這個技能適用於 Claude Code、Cursor 等支援代理模式的開發工具,能有效提升功能開發的規劃與執行效率。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tangjuyo/reels-blocker/tree/HEAD/.claude/skills/speckit-tasks

在你喜歡的 AI 中提問

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

說明文件

使用者輸入

$ARGUMENTS

在繼續之前,你必須考慮使用者輸入(若非空白)。

執行前檢查

檢查擴充套件鉤子(任務產生前):

  • 檢查專案根目錄是否存在 .specify/extensions.yml。
  • 若存在,讀取其內容並尋找 hooks.before_tasks 鍵下的條目。
  • 若 YAML 無法解析或無效,請勿默默跳過:告知使用者 .specify/extensions.yml 無法讀取(包含解析器錯誤),且未檢查任何鉤子(包含其中註冊的強制性鉤子 optional: false),然後繼續正常流程。
  • 過濾掉 enabled 明確設為 false 的鉤子。將沒有 enabled 欄位的鉤子視為預設啟用。
  • 對每個剩餘鉤子,不要嘗試解釋或評估鉤子的 condition 表達式:
    • 若鉤子沒有 condition 欄位,或該欄位為 null/空白,則將該鉤子視為可執行。
    • 若鉤子定義了非空的 condition,則跳過該鉤子,將條件評估留給 HookExecutor 實作。
  • 在從鉤子指令名稱建構指令呼叫時,將點號 (.) 替換為連字號 (-)。例如,speckit.git.commit → /speckit-git-commit。
  • 對每個可執行的鉤子,根據其 optional 旗標輸出以下內容:
    • 可選鉤子 (optional: true):
      ## 擴充套件鉤子
      
      **可選前置鉤子**:{extension}
      指令:`/{command}`
      描述:{description}
      
      提示:{prompt}
      若要執行:`/{command}`
      
    • 強制鉤子 (optional: false):
      ## 擴充套件鉤子
      
      **自動前置鉤子**:{extension}
      正在執行:`/{command}`
      EXECUTE_COMMAND:{command}
      
      在繼續進行大綱之前,請等待鉤子指令的結果。
      
      在輸出上述區塊之後,你必須實際呼叫該鉤子並等待其完成,然後才能繼續。以你在此代理/會話中執行指令的相同方式執行它(呼叫方式可能與上面顯示的文字 {command} ID 不同,例如技能模式代理會以 /skill:speckit-... 或 $speckit-... 執行)。僅僅輸出區塊並不會執行鉤子。
  • 若沒有註冊任何鉤子或 .specify/extensions.yml 不存在,則默默跳過。

大綱

  1. 設定:從儲存庫根目錄執行 .specify/scripts/bash/setup-tasks.sh --json,並解析 FEATURE_DIR、TASKS_TEMPLATE_CONTENT、TASKS_TEMPLATE 和 AVAILABLE_DOCS 清單。FEATURE_DIR 和 TASKS_TEMPLATE 在提供時必須是絕對路徑。AVAILABLE_DOCS 是 FEATURE_DIR 下可用的文件名稱/相對路徑清單(例如 research.md 或 contracts/)。對於引數中的單引號(例如 "I'm Groot"),請使用跳脫語法:例如 'I'''m Groot'(或盡可能使用雙引號:"I'm Groot")。

  2. 載入設計文件:從 FEATURE_DIR 讀取:

    • 必要:plan.md(技術棧、函式庫、結構)、spec.md(附優先級的使用者故事)
    • 可選:data-model.md(實體)、contracts/(介面合約)、research.md(決策)、quickstart.md(測試情境)
    • 若存在:載入 .specify/memory/constitution.md 以了解專案原則與治理限制
    • 注意:並非所有專案都有所有文件。根據可用的文件來產生任務。
  3. 執行任務產生工作流程:

    • 載入 plan.md 並提取技術棧、函式庫、專案結構
    • 載入 spec.md 並提取使用者故事及其優先級(P1、P2、P3 等)
    • 若 data-model.md 存在:提取實體並對應到使用者故事
    • 若 contracts/ 存在:將介面合約對應到使用者故事
    • 若 research.md 存在:提取設定任務的決策
    • 按使用者故事組織產生任務(請參閱下方的任務產生規則)
    • 產生依賴關係圖,顯示使用者故事完成順序
    • 為每個使用者故事建立並行執行範例
    • 驗證任務完整性(每個使用者故事都有所有需要的任務,且可獨立測試)
  4. 產生 tasks.md:使用 TASKS_TEMPLATE_CONTENT(來自上述 JSON 輸出)作為結構。為了與省略 TASKS_TEMPLATE_CONTENT 的舊版設定腳本相容,請改為讀取 TASKS_TEMPLATE。填入以下內容:

    • 來自 plan.md 的正確功能名稱
    • 階段 1:設定任務(專案初始化)
    • 階段 2:基礎任務(所有使用者故事的阻礙性先決條件)
    • 階段 3+:每個使用者故事一個階段(依照 spec.md 中的優先級順序)
    • 每個階段包含:故事目標、獨立測試標準、測試(若要求)、實作任務
    • 最終階段:修飾與跨領域關注點
    • 所有任務必須遵循嚴格的清單格式(請參閱下方的任務產生規則)
    • 每個任務的清晰檔案路徑
    • 顯示故事完成順序的依賴關係章節
    • 每個故事的並行執行範例
    • 實作策略章節(先 MVP,增量交付)

強制性執行後鉤子

在向使用者報告完成之前,你必須完成此章節。

檢查專案根目錄是否存在 .specify/extensions.yml。

  • 若不存在,或 hooks.after_tasks 下沒有註冊任何鉤子,則跳到完成報告。
  • 若存在,讀取其內容並尋找 hooks.after_tasks 鍵下的條目。
  • 若 YAML 無法解析或無效,請勿默默跳過:告知使用者 .specify/extensions.yml 無法讀取(包含解析器錯誤),且未檢查任何鉤子(包含其中註冊的強制性鉤子 optional: false),然後繼續進行完成報告。
  • 過濾掉 enabled 明確設為 false 的鉤子。將沒有 enabled 欄位的鉤子視為預設啟用。
  • 對每個剩餘鉤子,不要嘗試解釋或評估鉤子的 condition 表達式:
    • 若鉤子沒有 condition 欄位,或該欄位為 null/空白,則將該鉤子視為可執行。
    • 若鉤子定義了非空的 condition,則跳過該鉤子,將條件評估留給 HookExecutor 實作。
  • 在從鉤子指令名稱建構指令呼叫時,將點號 (.) 替換為連字號 (-)。例如,speckit.git.commit → /speckit-git-commit。
  • 對每個可執行的鉤子,根據其 optional 旗標輸出以下內容:
    • 強制鉤子 (optional: false) — 你必須為每個強制鉤子輸出 EXECUTE_COMMAND: :
      ## 擴充套件鉤子
      
      **自動鉤子**:{extension}
      正在執行:`/{command}`
      EXECUTE_COMMAND:{command}
      
      在輸出上述區塊之後,你必須實際呼叫該鉤子並等待其完成,然後才能繼續。以你在此代理/會話中執行指令的相同方式執行它(呼叫方式可能與上面顯示的文字 {command} ID 不同,例如技能模式代理會以 /skill:speckit-... 或 $speckit-... 執行)。僅僅輸出區塊並不會執行鉤子。
    • 可選鉤子 (optional: true):
      ## 擴充套件鉤子
      
      **可選鉤子**:{extension}
      指令:`/{command}`
      描述:{description}
      
      提示:{prompt}
      若要執行:`/{command}`
      

完成報告

輸出所產生 tasks.md 的路徑與摘要:

  • 任務總數
  • 每個使用者故事的任務數量
  • 已識別的並行機會
  • 每個故事的獨立測試標準
  • 建議的 MVP 範圍(通常僅使用者故事 1)
  • 格式驗證:確認所有任務都遵循清單格式(核取方塊、ID、標籤、檔案路徑)

任務產生的上下文:$ARGUMENTS

tasks.md 應立即可執行——每個任務必須足夠具體,以便 LLM 無需額外上下文即可完成。

任務產生規則

關鍵:任務必須按使用者故事組織,以實現獨立的實作與測試。

測試為可選:僅在功能規格中明確要求,或使用者要求 TDD 方法時,才產生測試任務。

清單格式(必要)

每個任務必須嚴格遵循以下格式:

- [ ] [TaskID] [P?] [Story?] 帶有檔案路徑的描述

格式組成部分:

  1. 核取方塊:始終以 - [ ] 開頭(Markdown 核取方塊)
  2. 任務 ID:按執行順序的序號(T001、T002、T003……)
  3. [P] 標記:僅在任務可並行化時包含(不同的檔案,無依賴於未完成任務的依賴)
  4. [Story] 標籤:僅對使用者故事階段的任務為必要
    • 格式:[US1]、[US2]、[US3] 等(對應 spec.md 中的使用者故事)
    • 設定階段:無故事標籤
    • 基礎階段:無故事標籤
    • 使用者故事階段:必須有故事標籤
    • 修飾階段:無故事標籤
  5. 描述:包含確切檔案路徑的明確動作

範例:

  • ✅ 正確:- [ ] T001 依實作計劃建立專案結構
  • ✅ 正確:- [ ] T005 [P] 在 src/middleware/auth.py 實作認證中介軟體
  • ✅ 正確:- [ ] T012 [P] [US1] 在 src/models/user.py 建立 User 模型
  • ✅ 正確:- [ ] T014 [US1] 在 src/services/user_service.py 實作 UserService
  • ❌ 錯誤:- [ ] 建立 User 模型(缺少 ID 和故事標籤)
  • ❌ 錯誤:T001 [US1] 建立模型(缺少核取方塊)
  • ❌ 錯誤:- [ ] [US1] 建立 User 模型(缺少任務 ID)
  • ❌ 錯誤:- [ ] T001 [US1] 建立模型(缺少檔案路徑)

任務組織

  1. 來自使用者故事 (spec.md) - 主要組織方式:

    • 每個使用者故事(P1、P2、P3……)都有自己的階段
    • 將所有相關元件對應到其故事:
      • 該故事所需的模型
      • 該故事所需的服務
      • 該故事所需的介面/UI
      • 若要求測試:該故事專屬的測試
    • 標記故事依賴關係(大多數故事應彼此獨立)
  2. 來自合約:

    • 將每個介面合約對應到其所服務的使用者故事
    • 若要求測試:每個介面合約 → 在該故事階段中,於實作之前的[P]合約測試任務
  3. 來自資料模型:

    • 將每個實體對應到需要它的使用者故事
    • 若實體服務於多個故事:放入最早的故事或設定階段
    • 關係 → 在適當故事階段的服務層任務
    • 對於 data-model.md 中具有約束的每個欄位(最大長度、可為 null/必要、列舉值、驗證規則),在任務描述中逐字引用該約束,以免留待實作時自行決定
  4. 來自設定/基礎設施:

    • 共享基礎設施 → 設定階段(階段 1)
    • 基礎/阻礙性任務 → 基礎階段(階段 2)
    • 故事專屬設定 → 在該故事的階段內

階段結構

  • 階段 1:設定(專案初始化)
  • 階段 2:基礎(阻礙性先決條件——必須在使用者故事之前完成)
  • 階段 3+:按優先級順序的使用者故事(P1、P2、P3……)
    • 在每個故事內:測試(若要求)→ 模型 → 服務 → 端點 → 整合
    • 每個階段應為一個完整、可獨立測試的增量
  • 最終階段:修飾與跨領域關注點

完成條件

  • 已產生包含所有階段、任務 ID 和檔案路徑的 tasks.md
  • 已根據上述「強制性執行後鉤子」章節中的規則分派或跳過擴充套件鉤子
  • 已向使用者報告完成,包含任務數量、故事細分和 MVP 範圍

Individual skills in this repo

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

相關技能