Neo Skills 是專為現代 AI Agent 設計的全方位能力擴充套件。本專案透過標準化的通訊架構，為 AI 代理安裝可插拔的「技能模組 (Skills)」，使其不僅僅是一個聊天機器人，而是能轉化為具備「感知-推理-行動」能力的多領域專家。

無論是 DevOps 自動化、軟體架構設計，或是未來的資料分析與專案管理，Neo Skills 都能透過掛載不同的知識庫與工具，讓 AI 成為您最強大的全能助手。

本專案作為 AI Agent 的「大腦皮層 (Cortex)」，旨在打造一個全能型 Agent 框架，透過以下機制提升 AI 的專業度：

1. 領域專精 (Skills)：可擴充的專家知識庫 (SKILL.md)。目前已內建 DevOps 模組，未來將持續擴增更多領域。
2. 標準化範本 (Templates)：提供預先驗證的自動化腳本與模板，確保產出的一致性與可靠性。
3. 架構思維：強制執行「感知 (Perceive) -> 推理 (Reason) -> 行動 (Act)」的決策迴圈，避免 AI 產生幻覺，確保解決方案的精準度。

自動化設計與生成符合微軟最佳實踐的 CI/CD 流程。

• CI 自動化：針對 .NET 專案生成建置管線，整合單元測試與構件發佈。
• CD 自動化：
  • Azure App Service：部署至Azure App Service。
  • IIS On-Premises：部署至地端 IIS 伺服器，包含備份與復原機制。

• Smart Commit：根據 git diff 暫存區內容，自動生成符合 Conventional Commits 規範的提交訊息。

• 智能審查：針對程式碼變更進行多面向 (正確性、安全性、效能、可讀性) 的深度審查。

• 技術解析：深入分析原始碼或專案結構，提供高階用途摘要、邏輯流程分解以及核心元件說明。

• C# 現代語法專家 (skills/neo-csharp)：跨版本 C# 專家 (10-14+)，專注於現代化語法、強型別與高效能開發模式。
• .NET 核心路由 (skills/neo-dotnet)：環境偵測與統一入口，自動將任務委派給最合適的子領域專家。
• .NET Minimal APIs 專家 (skills/neo-dotnet-minimal-apis)：專注於高效能微服務、路由群組與 Typed Results。
• .NET Web API 專家 (skills/neo-dotnet-webapi)：提供控制器模式下的架構設計、Problem Details 與異常處理指引。
• .NET MVC 專家 (skills/neo-dotnet-mvc)：處理伺服器端渲染 (SSR)、視圖模型與標籤協助程式的最佳實踐。
• EF Core 專家 (skills/neo-dotnet-ef-core)：專注於資料庫建模、移轉管理與 Linq 查詢優化。
• .NET Tag Helper 專家 (skills/neo-dotnet-tag-helper)：開發 ASP.NET Core 自定義 Tag Helper 的專家指引，專注於純 C# 實作與異步渲染最佳實踐。
• Interface 生成器：針對 C# Class 自動生成符合規範的 Interface，並支援智慧檔案覆蓋功能。

• Python 3.10+ 專家 (skills/neo-python)：專注於 Python 3.10 至 3.14 的現代語法特性、型別安全與非同步開發。
• 環境管理專家 (skills/neo-python-manager)：智慧偵測與管理 Python 專案環境，支援 uv, Poetry, venv/pip 並提供自動化安裝建議。

• Swift 5.0+ 專家 (skills/neo-swift)：支援從基礎語法到 Swift 6 的現代開發模式，涵蓋 SwiftUI、Structured Concurrency、記憶體安全以及高效能 App 開發指引。
• SwiftUI 專家 (skills/neo-swift-ui)：支援 iOS 16.0+ 與 Swift 5.0+ 的現代開發模式，專注於 NavigationStack、Observation 框架、資料流架構及高效能視圖設計。

• JavaScript 現代語法專家 (skills/neo-javascript)：跨版本 JavaScript 專家 (ES6 - ES2025+)，專注於現代化語法、模組系統與高效能開發模式。

• Vue 3 現代開發專家 (skills/neo-vue)：專注於 Vue 3 Composition API (<script setup>)、Pinia 狀態管理與 Vue Router 4。嚴格遵循官方 Style Guide 與最佳實踐，並提供反模式 (Anti-Patterns) 的避坑指引。

• 需求釐清：系統化引導用戶釐清模糊需求，並將其轉化為結構化的規格文件（背景、功能、約束、驗收標準）。

• 主動防護 (secret-guard.ts)：作為 CLI 的中介軟體 (Hook)，自動攔截並掃描所有工具執行的參數。若偵測到敏感資訊（如環境設定檔、私鑰、雲端憑證等）將強制阻擋執行，防止機密外洩。

本專案由三個核心層次組成，支援無限擴充：

Neo Skills 提供兩個 CLI 工具，分別用於安裝技能模組與系統提示詞：

兩個工具皆支援 --ai-agent 與 --project-path 參數，邏輯一致。

Gemini CLI 透過擴充套件機制直接安裝，不需要以下的 npx 指令：

gemini extension install https://github.com/Benknightdark/neo-skills --auto-update

將 skills/ 目錄下的所有技能模組複製到目標 AI Agent 的技能資料夾。

語法：

install-skills [--ai-agent <name>] [--project-path <path>]

參數：

安裝路徑對照：

範例：

# 安裝指定 Agent 至全域
npx -p @moon791017/neo-skills install-skills --ai-agent claude -y

# 安裝指定 Agent 至專案
npx -p @moon791017/neo-skills install-skills --ai-agent copilot --project-path /my/project -y

# 一次安裝全部 Agent
npx -p @moon791017/neo-skills install-skills -y

將預定義的系統提示詞寫入 AI Agent 的指導檔。若指導檔已存在，會附加至最下方；若不存在，則自動建立。

語法：

install-system-instructions --instructions <key> [--ai-agent <name>] [--project-path <path>]

參數：

指導檔路徑對照：

可用的系統提示詞種類：

範例：

# 一次安裝至全部 Agent 的全域指導檔
npx -p @moon791017/neo-skills install-system-instructions \
  --instructions technical-co-founder -y

# 安裝至指定 Agent 的全域指導檔 (~/.claude/CLAUDE.md)
npx -p @moon791017/neo-skills install-system-instructions \
  --ai-agent claude --instructions technical-co-founder -y

# 安裝至專案的 CLAUDE.md
npx -p @moon791017/neo-skills install-system-instructions \
  --ai-agent claude --instructions technical-co-founder --project-path /my/project -y

# 安裝至專案的 .github/copilot-instructions.md
npx -p @moon791017/neo-skills install-system-instructions \
  --ai-agent copilot --instructions technical-co-founder --project-path /my/project -y

💡 重複執行相同指令不會重複寫入，系統會自動偵測並跳過已安裝的提示詞。

您可以直接對 AI 代理下達以下指令或在對話中描述需求：

本專案使用 Bun 進行開發與建置。

• Node.js (v18+)：基本執行環境。
• Bun：僅在開發、建置或執行 Gemini MCP Server 時需要。

1. 安裝依賴

   npm install

2. 開發模式 (Watch Mode) 直接執行原始碼進行測試：

   bun src/server.ts

3. 建置專案 將 TypeScript 編譯並打包至 dist/ 目錄：

   bun run build

4. 類型檢查

   bun run typecheck