Communitygithub.com

MarkTripoli/skills

透過本地 API 合約、生成的客戶端、Patrol/影片審查和 Pull Request 循環,執行由協調器指定的已驗證端到端任務,但不做任何交付決策。

skills 是什麼?

此技能作為 `video-iterative-orchestration` 的實作工作人員,嚴格執行指定的後端、前端或跨層範圍,而不重新解釋範圍。它使用 Figma 視覺捆綁包作為實作參考,並遵循儲存庫的 UI 軌道,包括 `AGENTS.md`、工程指南和元件庫存。該技能強制執行一個權限邊界,僅允許可逆的實作機制,並要求對任何缺少或衝突的任務資訊使用結構化的 `decision_request` YAML。它記錄了嚴格的提交和推送規範,例如 `final_verified_batch` 政策,並在最終批次通過本地驗證後自動推送一次,無需進一步批准。支援的平台包括 Claude Code 和 CODEQ 等其他基於 AI 的開發工具,側重於以開發人員為中心的工作流程。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/MarkTripoli/skills/tree/HEAD/skills/delivery/video-iterative-development

在你喜歡的 AI 中提問

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

說明文件

在起草、修改或回覆前,請閱讀寫作指南和集合慣例;該集合的檢出內容位於 shared/ 下。

影片迭代式開發

使用此技能作為來自 video-iterative-orchestration 的完整任務的實作工作人員。嚴格執行指定的僅後端、僅前端或跨層範圍,而不重新解釋。當存在使用者可見的流程時,證明真實的本地合約——從後端回應,通過生成的客戶端,到 Android 互動——然後擷取視覺證據以供審查。

權限邊界與決策請求

實作代理人執行任務;它不做重大的交付決策。它不得選擇或更改來源解釋、任務範圍、產品或設計行為、參與的儲存庫或層、依賴順序、分支或 PR 拓撲、所需證據、偏差、阻塞處理或最終任務狀態。它不得要求提示者或其他外部擁有者做決定。

代理人可以選擇不改變任務的可逆、儲存庫慣例的實作機制,包括本地程式碼組織、命令順序、確定的選擇器詳細資訊,以及針對範圍內失敗的診斷或重試。如果任務缺少必要資訊,與權威來源或儲存庫事實衝突,或需要做出重大選擇,則將此結構化請求返回給協調器,並繼續不受影響的工作:

decision_request:
  observed_condition: <事實>
  assignment_clause: <缺少或衝突的條款>
  evidence: <路徑、指令或編輯過的輸出>
  decision_needed: <一個針對協調器的確切問題>
  affected_work: <因該決策而暫停的工作>
  unaffected_work_continued: <仍在進行的未受影響工作>

請勿在請求中建議或默默選擇替代方案。如果任務缺少其選定的範圍、撰寫表面、分支和 PR 目標、驗收行為或證據關卡,請在實作前返回一個 decision_request。

使用提供的 Figma 視覺捆綁包

當任務包含一個 extract-figma-visuals 捆綁包時,請在更改 UI 程式碼之前檢查其 metadata.json、screen.png 和命名的子圖片。使用清單的規範節點 ID 和 URL 透過 Figma MCP 擷取狹隘的實作細節;在從該上下文實作時,首先遵循 Figma 強制性的 figma-design-to-code 指南,並為相關的根或節點呼叫 get_design_context。不要重新匯出框架、丟棄捆綁包或僅從文字推斷設計。記錄哪些根和子圖片影響了實作和視覺審查。應用協調器記錄的 Figma 解析。如果擷取的上下文與該解析衝突或揭露了一個未解決的產品選擇,則返回一個 decision_request;不要重新解釋來源。

該捆綁包是一個實作參考,不是最終證據。它不能取代下面要求的真實 Android 錄製、使用者流程證明或視覺審查。

遵循儲存庫 UI 軌道

在編輯之前,請閱讀參與儲存庫的 AGENTS.md、工程指南、UI/元件庫存、本地化規則和記錄的驗證命令。重複使用公開的設計系統控制項和標記;不要沒有具體需求就匯入內部元件或引入功能本地替代品。在可用時檢查儲存庫的唯讀元件庫存,包括替代合約和公開參數。缺少會改變任務範圍的元件將返回一個 decision_request。

為受影響的互動式動作和狀態報告元素提供穩定的語義識別碼,而不是為一個包含多個動作的容器提供一個識別碼。將服務存取保留在其擁有的層中,使用儲存庫本地化,並遵循其記錄的端到端金鑰慣例。新的公開元件僅在儲存庫要求時才接收所需的合約註解、元件故事和審查過的金色覆蓋率。運行完整的記錄變更行和元件驗證;僅使用分析器並不能取代已設定的 lint 外掛。在交接報告中報告庫存選擇、指令結果、適用的故事、審查過的圖片和合理的例外情況。

使用指定的功能符合性行

當任務包含一個功能合約路徑和相關行時,將這些行視為此票證的驗收目標。將生成的客戶端或服務邊界證明以及旅程或視覺證據附加到交接報告中的相應行。只有協調器可以建立或更改 agent_decided、decision_needed 或偏差記錄。如果某行無法按指定方式實作,則返回一個 decision_request 並繼續處理未受影響的行。不要在沒有所需證據或協調器記錄的 approved_deviation 的情況下聲稱已交付某行。

執行指定的變更範圍

在實作之前,檢查兩個儲存庫、其當前的 API 合約、生成的客戶端依賴項和相關的 UI 流程,以驗證指定的範圍並確定其機制。不要重新分類:

  • 僅後端: 更改並直接驗證伺服器合約;不要發明前端更改。僅在任務要求將其作為證據時使用現有的 UI 流程。
  • 僅前端: 使用現有的生成的客戶端和合約;不要重新生成客戶端或更改後端。如果實作暴露了合約差距,則返回一個 decision_request。
  • 跨層: 進行最小的後端合約更改,重新生成客戶端,然後實作依賴的前端行為。

端到端證明必須涵蓋指定的已更改層及其真實的依賴邊界。對於沒有有意義的使用者可見流程的僅限 API 更改,合約導向的有效和無效請求/回應證據就足夠了;不要製造僅影片的 UI 更改。如果儲存庫檢查表明指定的範圍無法產生所需的行為,則返回一個 decision_request,而不是新增另一個層。

保持 PR 描述以審查者為焦點,並遵循儲存庫的 PR 範本。對於 Jira 史詩工作,在存在時連結實作子任務及其父故事;QA 驗收仍保留在故事上。說明票證、最終實作的行為以及適用的證明連結。對於已對應 Figma 的 UI 更改,命名每個更改的區域以及其審查結果是否與對應的框架匹配。不要新增負面範圍的樣板,例如「無 OpenAPI/用戶端變更」或「無發明的 UI/影片證明」;迭代歷史記錄,例如「已應用修正」;本地測試計數、lint、格式化或 pipeline 已報告的 hook 結果;或內部來源分支、依賴項和版本影響的記帳。僅在例外情況會產生具體的審查者動作、相容性問題或版本協調需求時才包括例外情況。

提交與推送規範

遵循任務的提交計劃和命名的推送邊界。需要 push_policy: final_verified_batch、final_push_authorized: true、checkpoint_pushes: prohibited、additional_boundary_authority: orchestrator 和 missing_boundary_state: decision_request_not_blocked。如果其中之一缺失或不同且無明確的替代政策,則返回一個 decision_request 並繼續進行不受影響的本地工作。請勿將票證標記為阻塞。

最終驗證的批次邊界是一個常態授權,指示在任務的本地驗證和證據關卡通過後推送一次。不要要求提示者或協調器再次批准它。在那些關卡通過之前,保持以 active 或 recovery 狀態在本地工作;尚未推送是預期中的,絕不是一個阻塞因素。

保留採用的歷史記錄,並僅執行指定的血統協調;保留歷史記錄不需要提交或推送每次復原嘗試。現有的遠端提交保持不變,但已發佈的分支不需要後續的實驗也變成提交或推送。

將選擇器實驗、暫時等待、除錯記錄、測試工具探針和其他診斷編輯保留在工作樹中,直到它們的結果已知。在提交之前移除已取代的嘗試。不要僅僅因為分支已經有遠端而提交復原嘗試;僅提交會保留在最終最終 diff 中的變更:一個連貫的產品或合約變更及其持久的回歸覆蓋率、一個必需的生成工件,或一個證明該功能所需的最終測試工具變更。當需要一個可中斷的檢查點時,將編輯過的修補程式或筆記記錄在忽略的證據目錄下,而不是建立分支提交。永遠不要包含機密或短暫的執行時期值。

多個有意義的提交可能會保留在本地並一起推送。在沒有再次取得權限的情況下推送最終驗證的批次一次。僅在任務命名的邊界處提前或再次推送:一個遠端依賴項交接或一個連貫的審查修正。執行時期租賃、證據保存或一個成功的診斷步驟不能證明推送合理。在推送之前,檢查傳出提交和最終 diff;不要發佈僅診斷或已取代的提交。如果需要另一個推送邊界,請在推送之前返回一個 decision_request 並繼續進行不受影響的工作;缺失的邊界不是一個阻塞因素。

未經明確授權,請勿修改、變基、強制推送或以其他方式重寫現有的遠端歷史記錄以清理先前的提交序列。當遠端歷史記錄已存在時,繼續使用常規的修正提交。

執行授權的外部動作

任務命名的推送和提交邊界是針對指定分支、PR 和證據的工作流程授權。它們不會繞過執行時期管理的批准關卡。當命令執行器需要批准授權的推送、PR 操作或證據上傳時,立即通過執行器的管理批准或升級機制重試該相同狹窄範圍的操作,命名確切的目的地和目的。讓執行時期在其需要時顯示其批准控制。

不要用提示者說「繼續」的對話請求來取代該機制,並且不要僅僅因為需要管理批准就返回 decision_request、recovery_exhausted 或阻塞因素。切勿削弱、規避或擴大執行時期的批准。只有由管理批准嘗試返回的明確拒絕才是外部動作失敗;保留其確切的編輯過工具響應,保持票證非終端狀態,並將其返回給協調器進行有針對性的復原。警告、推斷的私人資訊問題或未嘗試的升級不是拒絕。

在每次外部動作之後,驗證結果的遠端狀態,而不是僅信任指令退出代碼:解析遠端分支提交,通過 GitHub 提取 PR,並從 PR 描述和已驗證的下載中驗證上傳的證明。在交接中將這些事實返回給協調器的提交關閉關卡。

更正未合併的 PR

對於審查修正任務,在更改工件之前將 PR 來源分支與其目標進行比較。僅由未合併的 PR 引入的任何內容——包括遷移、路由、生成的客戶端、API 欄位、UI 元件、測試或測試工具——都是可變的。更正、重新命名或移除原始工件,以使最終的 PR diff 是正確的;不要僅僅為了與 PR 的中間實作保持相容性而新增一個補償性的工件。一個正常的後續提交就足夠了;除非明確授權,否則不要重寫遠端歷史或強制推送。

任何已在目標分支上、已合併、已部署或外部消費的內容,都遵循儲存庫的正常相容性和向前遷移政策。如果工件的來源不明確,請在繼續之前檢查目標/來源 diff 和歷史記錄;不要假設一個未發佈的例外。根據需要重新運行乾淨狀態遷移或生成檢查,然後用更正行為的證據替換受影響的最終證明。

選擇記錄的本地執行時間

一個儲存庫定義的單例全棧容器是可選的,不是集合先決條件。任務指定 runtime_mode: shared_canonical 或 runtime_mode: isolated_local。僅對 shared_canonical 應用下面的租用規則。對於 isolated_local,使用指定的儲存庫記錄的本地設定、埠和擁有的程序;保留來源身份、就緒性、測試固定裝置、驗證和證據檢查,而不發明一個公司主機拓撲。缺少專案特定的設定是一個診斷觸發器,而不是安裝公司預設值的權限。

僅使用協調器授予的規範執行時間

來源工作樹可以並行進行。儲存庫的規範全棧開發容器則不行:它在一個協調器擁有的執行時間租用下,一次只接受一個指定的分支或提交。任務必須明確說明這個工作人員是否持有該租用。

沒有租用時,請勿在規範容器中掛載或切換來源;啟動、停止或重新啟動其服務;對其本地資料應用遷移或固定裝置;對其進行驗證;運行 Android 端到端測試;或記錄證據。完成所有不受影響的僅來源工作,然後返回:

runtime_lease_request:
  ticket: <指定的票證>
  exact_sources: <準備部署的儲存庫工作樹、分支和提交>
  required_runtime_work: <仍需要的遷移、固定裝置、探針、端到端測試和證據>
  unaffected_work_completed: <已完成的實作和非執行時間驗證>

擁有租用時,僅使用任務的儲存庫記錄的開發容器拓撲、標準埠、完整的環境來源、遷移、固定裝置、

...

[已截斷以進行翻譯]

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相關技能