Community程式設計與開發github.com

YuShenLiu06/yushen-skills

將已確認的軟體需求拆解成小型 PR,協調獨立的 worktree 平行開發、實作者運行自證、程式碼與安全審查、最多三輪收斂、組合驗證與人類驗收。用於開發任務,不為一般討論自動啟動實作。

yushen-skills 是什麼?

此技能專注於將已確認的軟體需求系統性地拆解為小型、可獨立測試的 PR,並協調多個獨立的 worktree 進行平行開發。它定義了一套嚴謹的流程,包括實作者實際運行並提供證據(如截圖、API 回應)以證明功能正確、程式碼與安全審查獨立進行,以及最多三輪的審查回饋收斂機制。技能支援如 Claude Code、Cursor 等 AI 代理平台,透過明確的階段(需求確認、拆分、實作、審查、收斂、組合驗證、人類驗收)確保高品質交付,同時管控成本與風險。其核心優勢在於減少溝通浪費、強制實作者自行驗證,並透過嚴格的合併前檢查(如行數限制、SHA 記錄)來維護程式庫穩定性。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/YuShenLiu06/yushen-skills/tree/HEAD/skills/yushen-pr-cycle

Installed? Explore more 程式設計與開發 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜歡的 AI 中提問

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

說明文件

需求到驗收

1. 複述並確認

複述用戶目標、非目標、可觀察驗收條件、風險與預算約束。確認後進入實作;已有明確確認可以沿用,不重複索取授權。只補問真正影響實作的缺口。此流程不擴大工具、費用、推送、合併或部署權限。

2. 協調者直接拆分

  • 協調者直接給出功能邊界、依賴、介面、負責人和驗收項,不再增加一層拆分代理。獨立任務並行,依賴任務按介面和順序推進。
  • 一個可獨立測試、回滾的功能對應一個獨立 worktree、分支和真實 PR。固定目標分支及 base/head SHA;不同實作者不共寫工作目錄,不借用其他任務的分支。
  • 單功能 PR 的最終 additions + deletions 盡量不超過 1000 行,含測試、文件及生成檔案。超出先合理拆分;無法拆分則說明原因和規模,不能隱藏生成檔案或硬拆半個功能。
  • 多功能批次記錄子 PR URL、依賴和獨立驗收項。可按項目已支援的堆疊 PR 或集成分支組織,核實實際能力;文件中的任務編號不能冒充真實 PR。

3. 實作者實際運行並自證

  • 實作者完成實作、自檢和關鍵用戶路徑運行後再交獨立審查,不把主要運行驗證和截圖工作轉交審查者。
  • 記錄精確 SHA、命令、環境、實際結果、未測項與風險。Bug 提供修復前復現及同路徑修復後結果。建構、mock、真實服務驗收分開報告。
  • UI 變更給出關鍵步驟和結果的實際運行截圖。截圖放 PR 評論或附件,不提交程式碼分支。先核實上傳工具支援的參數;上傳受阻就報告阻塞,不編造附件 URL。
  • 後端權限、資料或資金行為給出相應 API / 資料證據。測試使用隔離環境與合成資料,不洩漏憑證和個人資料。
  • 無 UI 的規則或文件變更不偽造截圖;檢查範圍、連結、規則一致性與 diff 即可。容器驗證使用獲授權的隔離環境,不擅自回退用戶個人機器。
  • PR 使用 四節模板,每項證據關聯實際提交。

4. 程式碼與安全分別審查

  • 優先複用倉庫已配置的自動程式碼及安全審查,分別核實完成狀態、覆蓋 SHA 和未結發現。不額外派重複審查,也不重複手動觸發。
  • 未配置、未觸發或未覆蓋目標 SHA 時報告缺口;按已授權的備用方案處理,無備用授權時取得決策。沒有評論不等於審查完成。
  • 程式碼品質按需讀取已安裝的 yushen-code-quality-review;安全按需讀取 yushen-security-review。路徑以實際安裝位置為準,缺失或未讀取就說明。
  • 審查只提出有證據的問題;外部實作可以比較和建議,未經用戶採納不改方案、遷移或加依賴。

5. 最多三輪收斂

一輪為審查回饋 → 修復或有證據的處置 → 驗證。程式碼和安全匯總計輪,合計最多三輪;換代理、模型、重試、restack 或重開同一工作 PR 不重置。

首輪結合需求審完整 diff;第二、三輪檢查新增 diff、已有問題閉環和受影響回歸。以穩定問題 ID 合併同根因發現,記錄位置、證據、首次輪次、狀態、修復 SHA 與驗證。誤報用證據說明,不能為了消除評論做無意義修改。未經複核不標已解決。

同一問題兩輪有效修復仍無進展可以提前升級。第三輪仍有未解問題時停止自動收斂,交協調者匯總證據、重新考慮方案並請求決策;不得降門檻、自動通過或合併。

6. 組合版本檢查

協調者核實最終必要 CI、衝突解決、共享狀態和組合用戶路徑,記錄每個子 PR SHA 與組合候選 SHA。各層通過不代表組合通過。rebase、衝突處理或實作變化後更新 SHA 映射,補受影響回歸;舊證據不能冒充當前版本結果。

7. 人類驗收

提供候選 SHA、可運行產物、最短測試步驟、預期結果和殘餘風險。用戶本人測試並明確確認對應版本後,才按實際授權合入。程式碼改變後重新確認受影響部分;自動測試和機器人批准不替代本人驗收。發布、部署按各自授權處理。

交付安裝器、桌面應用或其他實際發布產物時,按需讀取已安裝的 yushen-release-acceptance,驗證最終下載檔案到可用的完整路徑,並區分平台結論與預覽限制。純文案或內部小改動不強制執行整套發布驗收。

模型和成本策略

按可配置的任務難度、風險、預算與可用能力選擇模型:確定性檢查優先腳本;明確局部實作優先低成本檔;複雜診斷、設計和高風險判斷選擇能力適配檔;證據整理使用較低成本檔。開始時說明所選角色、成本邊界與升級條件,不把特定型號視為公開環境預設可用。

先排除環境故障與缺上下文,再決定是否升級。超過預算、增加付費調用或越出授權能力時先取得對應決策;不無限重試。批次結束按需使用 返工總結,規則更新走正常驗收流程。

項目規則接入

在項目 AGENTS.md 中明確要求按任務讀取相關技能和 REVIEW.md;不假定連結自動展開。REVIEW.md 只放可判斷的長期項目規則,逐輪發現與證據留在 PR。缺檔案或約束衝突應報告,不臆造機制。

創建項目規則時可按需參考 通用 REVIEW 示例,僅保留實際適用、可驗證的條款。

Individual skills in this repo

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

相關技能