@moon791017/neo-skills

v1.0.21

Published

25 minutes ago

Neo Skills: A Universal Expert Agent Extension

0High
0Medium
0Low

moon791017

gemini cli claude code copilot cli ai agent skills

Neo Skills

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

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

🚀 核心願景

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

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

✨ 目前內建技能 (Built-in Skills)

1. Azure Pipelines 架構師

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

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

2. 智慧 Git 助手

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

3. Code Review 專家

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

4. 程式碼解釋助手

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

5. .NET / C# 開發專家

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 查詢優化。
Interface 生成器：針對 C# Class 自動生成符合規範的 Interface，並支援智慧檔案覆蓋功能。

6. Python 開發與環境管理專家

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

7. Swift 開發專家

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 框架、資料流架構及高效能視圖設計。

8. 需求釐清助手

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

9. 安全守衛 (Security Guard)

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

📂 系統架構

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

📦 安裝與使用

本套件支援多種 AI Agent 環境。請依據您的 CLI 工具執行對應指令：

Gemini CLI

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

安裝指定 AI Agent 技能

使用 --ai-agent 指定要安裝的 agent（可用值：claude、copilot、codex）：

npx -p @moon791017/neo-skills install-skills --ai-agent claude
npx -p @moon791017/neo-skills install-skills --ai-agent copilot
npx -p @moon791017/neo-skills install-skills --ai-agent codex

安裝至指定專案

搭配 --project-path 可將技能安裝至指定專案目錄（技能子目錄會自動附加）：

# 安裝至 /my/project/.claude/skills
npx -p @moon791017/neo-skills install-skills --ai-agent claude --project-path /my/project

# 安裝至 /my/project/.github/skills
npx -p @moon791017/neo-skills install-skills --ai-agent copilot --project-path /my/project

# 安裝至 /my/project/.codex/skills
npx -p @moon791017/neo-skills install-skills --ai-agent codex --project-path /my/project

若未指定 --project-path，則安裝至全域路徑（~/.claude/skills、~/.copilot/skills、~/.codex/skills）。

安裝全部 AI Agent 技能

不帶 --ai-agent 即可一次安裝全部：

npx -p @moon791017/neo-skills install-skills

💡 常用指令範例

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

🛠 開發指南

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

前置需求

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

快速開始

安裝依賴
```
npm install
```
開發模式 (Watch Mode) 直接執行原始碼進行測試：
```
bun src/server.ts
```
建置專案 將 TypeScript 編譯並打包至 dist/ 目錄：
```
bun run build
```
類型檢查
```
bun run typecheck
```