需求到驗收
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 示例,僅保留實際適用、可驗證的條款。