多智能體網頁工作流程
目的
使用此技能來執行連續的多智能體工作流程,以完成網頁生成任務。將每個階段視為一個具有狹義責任、明確交接產物和明確驗收標準的獨立角色。
此技能刻意保持工具輕量化。它不需要特殊腳本;它提供了一種關於智能體身份、階段合約、審查和修復的操作方法。
工作流程
對於大型網頁任務,使用以下預設順序:
Planner -> Architect -> Developer -> Reviewer -> AutoFixer(可選) -> Reviewer(可選) -> Final
僅當任務非常小且使用者明確希望得到直接答案時,才能跳過某些階段。
Planner
在行動之前對請求進行分類:
chat:進行解釋、討論、比較或回答,不進行編輯。inspect:讀取或分析現有檔案、預覽或專案狀態。code:建立、編輯、修復或建置一個網頁或前端專案。
對於模糊不清的對話,優先選擇 chat。僅當使用者要求實作、可見的 UI 變更、錯誤修復或生成時,才進入 code 階段。
Architect
當任務包含一個以上的 UI 元素、互動、頁面區塊或品質限制時,在實作之前使用 Architect 階段。
產生一個簡潔的計畫:
{
"type": "architect_plan",
"goal": "頁面或變更必須達成的目標",
"page_structure": ["主要可見區塊或元件"],
"visual_direction": "與領域相關的風格方向",
"interaction_notes": ["預期的使用者互動"],
"files": [
{"path": "index.html", "purpose": "進入頁面", "required": true}
],
"acceptance_criteria": ["用於判斷成功的可觀察檢查項"],
"risks": ["可能的實作或 UX 風險"]
}
在此階段不要寫入檔案。不要隱藏模糊的需求;要么定義一個保守的假設,要么提出一個聚焦的問題。
Developer
實作 Architect 的計畫。將變更範圍限制在要求的頁面或元件內。
遵循以下順序:
- 在編輯之前,先讀取相關的現有檔案。
- 使用最小可行變更來建立或編輯檔案。
- 在環境支援時進行建置或預覽。
- 總結變更了什麼以及驗證了什麼。
以以下內容結束此階段:
{
"type": "implementation_summary",
"changed_files": ["相對路徑"],
"created_files": [],
"deleted_files": [],
"checks": [
{"name": "build_or_preview", "passed": true, "note": "結果"}
],
"summary": "簡潔的實作結果"
}
Reviewer
以一個獨立角色進行審查。在審查期間不要重寫實作。
檢查:
- 使用者請求的涵蓋範圍。
- Architect 的驗收標準。
- UI 清晰度、響應式佈局和互動完整性。
- 明顯的錯誤狀態、缺失的資源、執行時錯誤或建置失敗。
- 實作是否超出範圍或變更了無關的檔案。
輸出一個結構化的報告:
{
"type": "review_report",
"passed": true,
"severity": "pass",
"summary": "審查結果",
"issues": [
{
"id": "R1",
"severity": "minor|major|blocker",
"area": "ux|functionality|build|scope|content",
"file": "相對路徑",
"message": "具體問題",
"suggested_fix": "可行的修復方案"
}
],
"acceptance_checklist": [
{"item": "標準", "passed": true, "note": "證據"}
]
}
使用 blocker 表示建置失敗、核心互動無法使用、缺少主要輸出或不安全的行為。使用 major 表示缺少必要功能。使用 minor 表示打磨問題。
AutoFixer
僅當 Reviewer 報告問題時才使用 AutoFixer。
規則:
- 僅修復審查中列出的問題。
- 優先使用局部修補,而非大範圍重寫。
- 保留原始設計,除非問題需要設計調整。
- 修復後在可能的情況下再次驗證。
- 修復後回到 Reviewer。
以以下內容結束:
{
"type": "fix_summary",
"fixed_issue_ids": ["R1"],
"changed_files": ["相對路徑"],
"checks": [
{"name": "build_or_preview", "passed": true, "note": "結果"}
],
"summary": "修復了什麼"
}
最終回應
僅向使用者提供高訊噪比的結果:
- 建置或變更了什麼。
- 通過了審查的內容。
- 剩餘的風險或跳過的檢查。
- 如果有的話,可在何處檢視或檢查結果。
不要暴露內部的思考鏈。當階段輸出或審查發現有助於使用者信任結果時,可以提及它們。