Communitygithub.com

tangjuyo/reels-blocker

將現有任務轉換為可操作、具有依賴順序的 GitHub Issues,並根據現有設計工件生成功能。

reels-blocker 是什麼?

此技能能夠自動化地將 `tasks.md` 中的任務清單,轉換為結構化的 GitHub Issues,用於追蹤功能開發。它會先執行前置檢查(包括讀取可擴展掛鉤),然後從 `check-prerequisites.sh` 腳本解析功能目錄與可用文件。技能會從 Git 遠端倉庫取得 URL,並使用 GitHub MCP 伺服器進行去重檢查,避免已存在的 Issue 被重複建立。之後,它會逐一為新任務建立格式為 `T001: <描述>` 的 Issue,並支援 `後置掛鉤` 以擴展工作流程。此工具特別適合需要將設計工件自動化轉換為開發任務的團隊,支援 Specify 擴展系統,並可在支援技能的代理模式(如 Claude Code、Cursor、Codex)中執行。

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

在你喜歡的 AI 中提問

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

說明文件

使用者輸入

$ARGUMENTS

在繼續之前,你必須考慮使用者輸入(如果不為空)。

前置執行檢查

檢查擴展掛鉤(在任務轉換為 Issues 之前):

  • 檢查專案根目錄是否存在 .specify/extensions.yml。
  • 如果存在,讀取它並查找 hooks.before_taskstoissues 鍵下的條目。
  • 如果 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/check-prerequisites.sh --json --require-tasks --include-tasks,並解析 FEATURE_DIR 和 AVAILABLE_DOCS 清單。所有路徑必須是絕對路徑。對於參數中的單引號(例如 "I'm Groot"),請使用轉義語法:例如 'I'''m Groot'(或如果可能,使用雙引號:"I'm Groot")。
  2. 如果存在:載入 .specify/memory/constitution.md 以獲取專案原則和治理約束。
  3. 從執行的腳本中,提取任務的路徑。
  4. 透過運行以下命令獲取 Git 遠端:
git config --get remote.origin.url

[!CAUTION] 僅當遠端是 GitHub URL 時,才繼續下一步。

  1. 獲取現有 Issues 以進行去重:在建立任何內容之前,從 tasks.md 建構你即將處理的任務 ID 集合(每個 ID 是 T 後接至少三位數字,例如 T001——/speckit-converge 使用 T{M+1:03d} 分配新 ID,這是一個下限而非上限,因此一旦文件中的任務超過 999 個,ID 就會變成四位或更長)。然後使用 GitHub MCP 伺服器的 list_issues 工具查找已涵蓋這些 ID 的 Issues。不要傳遞 state 值,因為省略它會使工具同時返回開啟和關閉的 Issues。請求 perPage: 100 以減少調用次數,並且由於該工具使用基於游標的分頁,請使用 after 參數(使用前一個響應中的 endCursor)請求頁面。對於每個 Issue 標題,將其與任務 ID 模式 \bT\d{3,}\b 進行匹配({3,} 接受四位及更長的 ID——使用 \d{3} 時,包含 T1000 的標題根本無法匹配,因為結尾的 \b 不能在兩個數字之間,因此該任務會靜默地既不被去重也不被建立;單詞邊界仍會阻止像 ST001 這樣的 Token 匹配,並強制消耗整個數字串,因此 T100 永遠無法匹配 T1000 內部;這也識別寫為 T001 ...、T001: ... 或 [T001] ... 的標題),當它匹配到你的任務 ID 之一時,將該 ID 標記為已有 Issue。一旦每個任務 ID 都已匹配,或沒有更多頁面時,停止分頁,這樣一旦所有任務 ID 都被考慮到,就不會繼續獲取整個倉庫的 Issue 歷史。這限制了在具有大量 Issue 歷史的倉庫上的調用次數,並且在 tasks.md 重新產生或技能被重新調用後重新運行命令時,仍然可以防止重複。
  2. 對於清單中的每個任務,使用 GitHub MCP 伺服器在代表 Git 遠端的倉庫中建立一個新的 Issue。tasks.md 中的任務行以 Markdown 複選框開頭,因此首先去除前導的 - [ ](以及任何 [P] / [US#] 標記)以恢復任務 ID 及其描述。使用 T001: <描述> 形式的單一規範標題建立 Issue,其中 ID 寫一次,後接任務描述(例如,行 - [ ] T001 建立專案結構 變成標題 T001: 建立專案結構)。
    • 跳過任何其 ID 已存在於上一步現有 Issues 集合中的任務,並報告它(例如,T001 已有一個 Issue,跳過)。
    • 僅為尚未有匹配 Issue 的任務建立 Issues。

[!CAUTION] 在任何情況下,都不得在與遠端 URL 不匹配的倉庫中建立 Issues。

後置執行檢查

檢查擴展掛鉤(在任務轉換為 Issues 之後): 檢查專案根目錄是否存在 .specify/extensions.yml。

  • 如果存在,讀取它並查找 hooks.after_taskstoissues 鍵下的條目。
  • 如果 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 不存在,則靜默跳過。

Individual skills in this repo

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

相關技能