Communitygithub.com

AncientM00N/Skills_for_NLP_huliang6

一套輕量級的 Codex 技能,專為 NLP 期末專案設計。

Skills_for_NLP_huliang6 是什麼?

此技能提供一個結構化的多智能體工作流程,用於網頁生成任務,特別適用於 NLP 期末專案。它定義了 Planner、Architect、Developer、Reviewer 和 AutoFixer 等階段,每個階段都有明確的職責、交接產物和驗收標準。技能的核心在於透過角色分工和階段合約,確保生成過程的可控性與品質,同時保持工具輕量化,無需特殊腳本。支援的平台包括 Codex 等 AI 編碼代理,工作流程透過 JSON 格式的合約進行階段間的溝通與驗證,並在最後提供簡潔的結果摘要給使用者。

相容平台~Claude Code✓Codex CLI~Cursor
npx skills add AncientM00N/Skills_for_NLP_huliang6

在你喜歡的 AI 中提問

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

說明文件

多智能體網頁工作流程

目的

使用此技能來執行連續的多智能體工作流程,以完成網頁生成任務。將每個階段視為一個具有狹義責任、明確交接產物和明確驗收標準的獨立角色。

此技能刻意保持工具輕量化。它不需要特殊腳本;它提供了一種關於智能體身份、階段合約、審查和修復的操作方法。

工作流程

對於大型網頁任務,使用以下預設順序:

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 的計畫。將變更範圍限制在要求的頁面或元件內。

遵循以下順序:

  1. 在編輯之前,先讀取相關的現有檔案。
  2. 使用最小可行變更來建立或編輯檔案。
  3. 在環境支援時進行建置或預覽。
  4. 總結變更了什麼以及驗證了什麼。

以以下內容結束此階段:

{
  "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": "修復了什麼"
}

最終回應

僅向使用者提供高訊噪比的結果:

  • 建置或變更了什麼。
  • 通過了審查的內容。
  • 剩餘的風險或跳過的檢查。
  • 如果有的話,可在何處檢視或檢查結果。

不要暴露內部的思考鏈。當階段輸出或審查發現有助於使用者信任結果時,可以提及它們。

相關技能