Communitygithub.com

tangjuyo/reels-blocker

根據互動式或提供的原則輸入,創建或更新專案章程。

reels-blocker 是什麼?

這個技能會根據用戶輸入(可以是一組管理原則或互動式對話)來建立或更新 `.specify/memory/constitution.md` 中的專案章程。它會從模板解析、處理預留位置、並根據語意版本控制規範自動增加版本號。此外,該技能會區分屬於章程內容的輸入與非管理性質的意圖(例如功能實作要求),並將後者延遲處理。它支援在章程更新前後執行鉤子(hooks),這些鉤子定義在 `.specify/extensions.yml` 中,藉此擴充工作流程。最終,它會產生一份同步影響報告,總結版號變更、修改的原則區段,以及任何待辦事項。

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

在你喜歡的 AI 中提問

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

說明文件

用戶輸入

$ARGUMENTS

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

範圍守衛

此指令本身的工作僅限於更新專案章程。相依的模板和指令在運行時讀取章程,因此不在此處修改。

  • 將用戶輸入的每個部分分類為章程內容或是獨立、非治理的意圖。
  • 如果輸入包含功能實作、程式碼生成、重構、建置或部署請求,你不得執行它們。請將其提取為延遲意圖。
  • 你不得建立、修改或刪除應用程式原始碼檔案、功能路由、元件、測試、部署檔案,或與章程工作流程無關的其他產物。
  • 如果不確定某個指令是否屬於章程內容,請先要求澄清再進行修改。
  • 完成章程更新後,為每個延遲意圖加入一個「下一步行動」區段。列出原始意圖並建議適當的後續 Spec Kit 指令,例如 /speckit-specify,但不要實際執行它。
  • 如果沒有非治理的意圖,則省略「下一步行動」區段。

執行前檢查

檢查擴充鉤子(在章程更新前):

  • 檢查專案根目錄下是否存在 .specify/extensions.yml。
  • 如果存在,讀取它並查找 hooks.before_constitution 鍵下的條目。
  • 如果無法解析 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 不存在,則默默跳過。

大綱

你正在更新 .specify/memory/constitution.md 中的專案章程。有效的章程樣板是在指令執行時,透過 Spec Kit 預設集/模板解析堆疊,從 constitution-template 解析而來。

請遵循以下執行流程:

  1. 從儲存庫根目錄執行 .specify/scripts/bash/resolve-template.sh constitution-template --json,並將 TEMPLATE_CONTENT 解析為有效模板。

    • 共享解析器會套用專案覆寫,在核心模板備用方案之前組合預設集層和擴充層。在繼續之前,它必須成功。
    • 如果失敗,請停止並報告解析錯誤;不要僅使用一個貢獻模板層繼續。
    • 如果 .specify/memory/constitution.md 存在,將其載入為當前專案特定值和修訂的來源。在套用新解析的樣板時,保留仍然適用的資訊。
    • 如果不存在,則使用解析後的模板作為初始文件。
    • 不要寫回任何版本化的模板層。
    • 識別所有格式為 [ALL_CAPS_IDENTIFIER] 的預留位置令牌。 重要提示:用戶可能需要比模板中使用的更少或更多的原則。如果指定了數字,請遵守該數字 - 遵循一般模板。你將相應地更新文件。
  2. 收集/推導預留位置的值:

    • 如果用戶輸入(對話)提供了值,則使用它。
    • 否則,從現有儲存庫上下文(README、文件、先前的章程版本(如果嵌入))推斷。
    • 對於治理日期:RATIFICATION_DATE 是原始採用日期(如果未知則詢問或標記 TODO),LAST_AMENDED_DATE 如果進行了更改則為今天,否則保留先前日期。
    • CONSTITUTION_VERSION 必須根據語意版本控制規則遞增:
      • MAJOR:向後不相容的治理/原則移除或重新定義。
      • MINOR:新增的原則/區段或大幅擴展的指導。
      • PATCH:澄清、措辭、錯字修正、非語意性改進。
    • 如果版本提升類型不明確,請在最終確定之前提出推理。
  3. 使用解析後的模板作為必要結構,草擬更新的章程內容:

    • 將每個預留位置替換為具體文字(沒有留下括號令牌,除非是專案選擇尚未定義但故意保留的模板插槽 - 明確說明任何保留的理由)。
    • 保留標題層次,註解在替換後可以移除,除非它們仍然提供明確的指導。
    • 確保每個原則區段:簡潔的名稱行、段落(或項目符號列表)捕捉不可協商的規則、不明顯的地方提供明確理由。
    • 確保治理區段列出修訂程序、版本控制政策和合規審查期望。
  4. 在更新後的文件頂部,以 HTML 註解的形式產生同步影響報告。 此報告是供人工審查修訂的暫時草稿材料,而非治理內容;預計在修訂後的章程文件提交之前將其移除。

    • 版本變更:舊 → 新
    • 修改的原則列表(如果重新命名,則為舊標題 → 新標題)
    • 新增的區段
    • 移除的區段
    • 如果故意延遲了任何預留位置,則列出後續待辦事項。
  5. 最終輸出前的驗證:

    • 沒有未說明的殘留括號令牌。
    • 版本行與報告相符。
    • 日期為 ISO 格式 YYYY-MM-DD。
    • 原則是宣告性的、可測試的,且不含模糊語言(「should」→ 在適當時用 MUST/SHOULD 理由取代)。
  6. 將完成的章程寫回 .specify/memory/constitution.md(覆寫)。

  7. 向用戶輸出最終摘要,包含:

    • 新版本和版本提升理由。
    • 任何 TODO 預留位置或需要手動跟進的延遲項目。
    • 建議的提交訊息(例如 docs: amend constitution to vX.Y.Z (principle additions + governance update))。
    • 針對任何延遲的非治理意圖的「下一步行動」區段。

格式與風格要求:

  • 完全按照模板使用 Markdown 標題(不要降低/提升層級)。
  • 包裝長理由行以保持可讀性(理想情況下 < 100 字元),但不要強制使用尷尬的斷行。
  • 在區段之間保留一個空白行。
  • 避免尾隨空白。

如果用戶提供部分更新(例如僅一個原則修訂),仍然執行驗證和版本決策步驟。

如果遺失關鍵資訊(例如批准日期確實未知),插入 TODO(<FIELD_NAME>):explanation 並在同步影響報告中將其包含在延期項目下。

僅寫入 .specify/memory/constitution.md;不要建立或修改模板原始檔。

執行後檢查

檢查擴充鉤子(在章程更新後): 檢查專案根目錄下是否存在 .specify/extensions.yml。

  • 如果存在,讀取它並查找 hooks.after_constitution 鍵下的條目。
  • 如果無法解析 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.

相關技能