{"id":40087980,"url":"https://github.com/benknightdark/neo-skills","last_synced_at":"2026-05-30T03:01:14.973Z","repository":{"id":333423667,"uuid":"1137161274","full_name":"Benknightdark/neo-skills","owner":"Benknightdark","description":"Neo Skills 是專為現代 AI Agent 設計的全方位能力擴充套件。本專案透過標準化的通訊架構，為 AI 代理安裝可插拔的「技能模組 (Skills)」，使其不僅僅是一個聊天機器人，而是能轉化為具備「感知-推理-行動」能力的多領域專家。","archived":false,"fork":false,"pushed_at":"2026-05-27T09:26:46.000Z","size":14975,"stargazers_count":5,"open_issues_count":0,"forks_count":2,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-27T11:31:16.474Z","etag":null,"topics":["agy-cli","ai-agents","ai-skills","antigravity-skills","claude-skills","codex-cli","skills"],"latest_commit_sha":null,"homepage":"https://neo-blog-iota.vercel.app/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Benknightdark.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-01-19T02:07:30.000Z","updated_at":"2026-05-27T09:26:36.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Benknightdark/neo-skills","commit_stats":null,"previous_names":["benknightdark/neo-skills"],"tags_count":101,"template":false,"template_full_name":null,"purl":"pkg:github/Benknightdark/neo-skills","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Benknightdark%2Fneo-skills","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Benknightdark%2Fneo-skills/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Benknightdark%2Fneo-skills/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Benknightdark%2Fneo-skills/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Benknightdark","download_url":"https://codeload.github.com/Benknightdark/neo-skills/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Benknightdark%2Fneo-skills/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33678271,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-30T02:00:06.278Z","response_time":92,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agy-cli","ai-agents","ai-skills","antigravity-skills","claude-skills","codex-cli","skills"],"created_at":"2026-01-19T10:00:34.747Z","updated_at":"2026-05-30T03:01:14.964Z","avatar_url":"https://github.com/Benknightdark.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Neo Skills\n\n[![test-on-develop](https://github.com/Benknightdark/neo-skills/actions/workflows/test-on-develop.yml/badge.svg)](https://github.com/Benknightdark/neo-skills/actions/workflows/test-on-develop.yml)\n[![npm version](https://img.shields.io/npm/v/@moon791017/neo-skills.svg)](https://www.npmjs.com/package/@moon791017/neo-skills)\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"images/banner.png\" alt=\"leak-hunter repository secret scanner banner\" width=\"100%\"\u003e\n\u003c/p\u003e\n\n**Neo Skills** 是一個專為現代 **AI Agent** 設計的**企業級全方位能力擴充套件**。本專案基於 Model Context Protocol (MCP) 與標準化代理治理架構 (Agent Harness)，為 AI 代理安裝高可靠、可插拔的「專家技能模組 (Skills)」，使其不僅僅是個聊天機器人，而是能深度融入本地開發與運維環境，轉化為具備「感知-推理-行動 (Perceive-Reason-Act)」自主決策能力的**跨領域專家**。\n\n無論是複雜的 DevOps 自動化（Azure Pipelines）、代碼品質安全審查、需求還原與分析釐清，或是多語系的現代化開發，Neo Skills 都能透過模組化的外部知識庫、AI 專用非互動式腳本與品質評估集 (Evals)，讓 AI 代理在安全、受控的 Harness 治理下，成為您最強大的全能數位助手。\n\n## 🚀 核心願景\n\n本專案作為 AI Agent 的「大腦皮層 (Cortex)」，旨在打造一個**全能型 Agent 框架**，透過以下機制提升 AI 的專業度：\n\n1. **領域專精 (Skills)**：可擴充的專家知識庫 (`SKILL.md`)。目前已內建 DevOps 模組，未來將持續擴增更多領域。\n2. **標準化範本 (Templates)**：提供預先驗證的自動化腳本與模板，確保產出的一致性與可靠性。\n3. **架構思維**：強制執行「感知 (Perceive) -\u003e 推理 (Reason) -\u003e 行動 (Act)」的決策迴圈，避免 AI 產生幻覺，確保解決方案的精準度。\n\n## ✨ 目前內建技能 (Built-in Skills)\n\n### 1. Azure Pipelines 架構師\n\n自動化設計與生成符合微軟最佳實踐的 CI/CD 流程。\n\n* **CI 自動化**：針對 .NET 專案生成建置管線，整合單元測試與構件發佈。\n* **CD 自動化**：\n  * **Azure App Service**：部署至Azure App Service。\n  * **IIS On-Premises**：部署至地端 IIS 伺服器，包含備份與復原機制。\n\n### 2. Code Review 專家\n\n* **智能審查**：針對程式碼變更進行多面向 (正確性、安全性、效能、可讀性) 的深度審查。\n\n### 3. .NET / C# 開發專家\n\n* **C# 現代語法專家 (`skills/neo-csharp`)**：跨版本 C# 專家 (10-14+)，專注於現代化語法、強型別與高效能開發模式。\n* **.NET 核心路由 (`skills/neo-dotnet`)**：環境偵測與統一入口，自動將任務委派給最合適的子領域專家。\n* **.NET Minimal APIs 專家 (`skills/neo-dotnet-minimal-apis`)**：專注於高效能微服務、路由群組與 Typed Results。\n* **.NET Web API 專家 (`skills/neo-dotnet-webapi`)**：提供控制器模式下的架構設計、Problem Details 與異常處理指引。\n* **.NET MVC 專家 (`skills/neo-dotnet-mvc`)**：處理伺服器端渲染 (SSR)、視圖模型與標籤協助程式的最佳實踐。\n* **EF Core 專家 (`skills/neo-dotnet-ef-core`)**：專注於資料庫建模、移轉管理與 Linq 查詢優化。\n* **.NET Tag Helper 專家 (`skills/neo-dotnet-tag-helper`)**：開發 ASP.NET Core 自定義 Tag Helper 的專家指引，專注於純 C# 實作與異步渲染最佳實踐。\n* **Interface 生成器**：針對 C# Class 自動生成符合規範的 Interface，並支援智慧檔案覆蓋功能。\n\n### 4. Python 開發與環境管理專家\n\n* **Python 3.10+ 專家 (`skills/neo-python`)**：專注於 Python 3.10 至 3.14 的現代語法特性、型別安全與非同步開發。\n* **環境管理專家 (`skills/neo-python-manager`)**：智慧偵測與管理 Python 專案環境，支援 uv, Poetry, venv/pip 並提供自動化安裝建議。\n\n### 5. Swift 開發專家\n\n* **Swift 5.0+ 專家 (`skills/neo-swift`)**：支援從基礎語法到 Swift 6 的現代開發模式，涵蓋 SwiftUI、Structured Concurrency、記憶體安全以及高效能 App 開發指引。\n* **SwiftUI 專家 (`skills/neo-swift-ui`)**：支援 iOS 16.0+ 與 Swift 5.0+ 的現代開發模式，專注於 NavigationStack、Observation 框架、資料流架構及高效能視圖設計。\n\n### 6. JavaScript 開發專家\n\n* **JavaScript 現代語法專家 (`skills/neo-javascript`)**：跨版本 JavaScript 專家 (ES6 - ES2025+)，專注於現代化語法、模組系統與高效能開發模式。\n\n### 7. TypeScript 開發專家\n\n* **TypeScript 現代語法與型別安全 (`skills/neo-typescript`)**：專注於極致的型別安全、高可維護性與進階元程式設計（Meta-programming）。\n  * **型別系統防線**：涵蓋進階條件型別 (Conditional Types)、映射型別 (Mapped Types) 與樣板字面值型別。\n  * **互通性與配置最佳化**：深入調校 `tsconfig.json` 編譯選項，並徹底解決複雜的 ESM/CJS 互通性陷阱與執行期崩潰問題。\n  * **泛型約束設計**：引導設計高靈活度的泛型與變量 (Variance) 處理。\n\n### 8. Vue 開發專家\n\n* **Vue 3 現代開發專家 (`skills/neo-vue`)**：專注於 Vue 3 Composition API (`\u003cscript setup\u003e`)、Pinia 狀態管理與 Vue Router 4。嚴格遵循官方 Style Guide 與最佳實踐，並提供反模式 (Anti-Patterns) 的避坑指引。\n\n### 9. Rust 開發專家\n\n* **Rust 專家 (`skills/neo-rust`)**：用於開發、重構或審查 Rust 應用程式的專家技能，涵蓋 ownership、borrowing、Result/Option 與現代 Rust 設計模式。\n\n### 10. 需求釐清助手\n\n* **需求釐清**：系統化引導用戶釐清模糊需求，並將其轉化為結構化的規格文件（背景、功能、約束、驗收標準）。\n\n### 11. AI 開發流程健檢\n\n* **AI 助手開發治理 (`skills/neo-agent-harness`)**：檢查專案規則、測試、CI、審查流程與安全防護是否足夠清楚，協助 AI 助手更穩定、更安全地參與開發。\n\n### 12. AI Tells / Slop 贅詞消除專家\n\n* **文字去 AI 腔調 (`skills/neo-stop-slop`)**：消除中英文 AI 腔、贅詞與公式化囉唆句式，還原為乾淨、生動且簡煉的自然語言，並包含工程師註解、Git Commit 及 PR 說明的特化優化。\n\n## 📂 系統架構\n\n本專案主要由標準專家技能模組組成的知識庫所構成：\n\n| 層次 | 目錄 | 描述 |\n| :--- | :--- | :--- |\n| **Knowledge Base** | `skills/` | **\"大腦\"**。包含各領域知識 (`SKILL.md`) 與可重用的模板 (`templates/`)。 |\n\n## 📦 安裝與使用\n\nNeo Skills 已全面升級並支援專屬的極簡安裝器，同時相容於 [agentskills.io](https://agentskills.io) 官方推薦的 **Agent Skills 開源標準規範**。\n\n根據您的使用場景，可以選擇以下兩種最適合您的安裝方式：\n\n---\n\n### 一、一鍵同步全域技能（Antigravity CLI 專用，推薦）\n\n如果您使用的是 **Antigravity CLI**，建議使用專門設計的 `neo-skills` 安裝工具（舊稱 `install-skills`）。這是一個極簡化的工具，會一鍵將本專案所有的專家技能，複製到您的全域路徑 `~/.gemini/antigravity-cli/skills` 中，同時自動過濾無關檔案（如 `.git`、`node_modules`、`.DS_Store` 等）。\n\n#### 透過 npx 直接執行：\n```bash\nnpx -y @moon791017/neo-skills@latest\n```\n\n#### 本地開發手動安裝：\n如果您已複製本專案至本地，也可以直接在專案根目錄下執行：\n```bash\nnode bin/install-skills.js\n```\n\n---\n\n### 二、使用標準 Skills CLI 安裝（通用於專案或其他 AI Agent）\n\n針對其他支援 [agentskills.io](https://agentskills.io) 標準規範的 AI 代理（如 Claude Code, Cursor, Copilot 等），您可以使用標準的 `skills` 包管理器。預設會安裝至當前專案，**若您希望將技能安裝至全域路徑，只需在指令後方加上 `-g` 參數**。\n\n#### 1. 專案一鍵安裝所有技能（免互動勾選）：\n```bash\nnpx skills add Benknightdark/neo-skills --all\n```\n\n\u003e [!TIP]\n\u003e * **全域一鍵安裝**：若要將所有技能安裝至標準全域路徑下，只需加上 `-g`：`npx skills add Benknightdark/neo-skills --all -g`。\n\u003e * **命令行指定**：若只需安裝特定 Skill，可以使用 `--skill \u003c名稱\u003e`（例如 `npx skills add Benknightdark/neo-skills --skill neo-typescript,neo-vue`）。\n\n#### 💡 終端機互動選單操作小秘訣：\n如果您執行了不帶 `--all` 的預設互動選單命令 `npx skills add Benknightdark/neo-skills`：\n1. **一鍵全選 (Select All)**：在選單畫面中直接按下鍵盤上的 **`a`** 鍵，即可立刻自動勾選所有的技能！\n2. **反向選取 (Invert Selection)**：按下鍵盤上的 **`i`** 鍵，反向切換目前的所有勾選狀態。\n3. **確認送出**：全選後按下 `Enter` 鍵即可一次完成安裝。\n\n---\n\n### 三、按需安裝特定技能\n\n如果您只需要其中某幾項特定領域的專家技能，您可以使用 `--skill` 參數指定安裝：\n\n| 內建專家技能 | 一鍵安裝指令 |\n| :--- | :--- |\n| **1. C# 語法專家** | `npx skills add Benknightdark/neo-skills --skill neo-csharp` |\n| **2. .NET 核心路由** | `npx skills add Benknightdark/neo-skills --skill neo-dotnet` |\n| **3. .NET Minimal APIs 專家** | `npx skills add Benknightdark/neo-skills --skill neo-dotnet-minimal-apis` |\n| **4. .NET Web API 專家** | `npx skills add Benknightdark/neo-skills --skill neo-dotnet-webapi` |\n| **5. .NET MVC 專家** | `npx skills add Benknightdark/neo-skills --skill neo-dotnet-mvc` |\n| **6. EF Core 專家** | `npx skills add Benknightdark/neo-skills --skill neo-dotnet-ef-core` |\n| **7. .NET Tag Helper 專家** | `npx skills add Benknightdark/neo-skills --skill neo-dotnet-tag-helper` |\n| **8. C# Interface 生成器** | `npx skills add Benknightdark/neo-skills --skill neo-csharp-interface-generator` |\n| **9. Python 3.10+ 專家** | `npx skills add Benknightdark/neo-skills --skill neo-python` |\n| **10. Python 環境與依賴管理專家** | `npx skills add Benknightdark/neo-skills --skill neo-python-manager` |\n| **11. Swift 5.0+ 專家** | `npx skills add Benknightdark/neo-skills --skill neo-swift` |\n| **12. SwiftUI 專家** | `npx skills add Benknightdark/neo-skills --skill neo-swift-ui` |\n| **13. JavaScript 專家** | `npx skills add Benknightdark/neo-skills --skill neo-javascript` |\n| **14. TypeScript 專家** | `npx skills add Benknightdark/neo-skills --skill neo-typescript` |\n| **15. Vue 3 現代開發專家** | `npx skills add Benknightdark/neo-skills --skill neo-vue` |\n| **16. Rust 開發專家** | `npx skills add Benknightdark/neo-skills --skill neo-rust` |\n| **17. DevOps (Azure Pipelines) 架構師** | `npx skills add Benknightdark/neo-skills --skill neo-azure-pipelines` |\n| **18. Code Review 專家** | `npx skills add Benknightdark/neo-skills --skill neo-code-review` |\n| **19. 需求分析與釐清助手** | `npx skills add Benknightdark/neo-skills --skill neo-clarification` |\n| **20. AI 開發流程治理專家** | `npx skills add Benknightdark/neo-skills --skill neo-agent-harness` |\n| **21. AI Tells/Slop 消除專家** | `npx skills add Benknightdark/neo-skills --skill neo-stop-slop` |\n\n---\n\n### 四、安裝系統提示詞 (`install-system-instructions`)\n\n\u003e [!IMPORTANT]\n\u003e **獨家加值特色功能**：由於 [agentskills.io](https://agentskills.io) 標準僅處理 `.agents/skills` 專案技能的目錄同步，**並未提供將核心系統提示詞（System Instructions）附加至 AI 代理引導檔** 的功能。\n\u003e \n\u003e 為了解決這個問題，Neo Skills 專門保留並提供強大的系統提示詞安裝器 `install-system-instructions`。此 CLI 工具會自動掃描、建立，並在不破壞您既有檔案內容的前提下，將專家提示詞完美附加或更新至各 AI 代理的專屬引導檔中。\n\n**語法：**\n\n```bash\nnpx -p @moon791017/neo-skills install-system-instructions --instructions \u003ckey\u003e [--ai-agent \u003cname\u003e] [--project-path \u003cpath\u003e] [--replace-all]\n```\n\n**參數與引數說明：**\n\n| 參數 | 必填 | 說明 |\n| :--- | :---: | :--- |\n| `--instructions \u003ckey\u003e` | ✅ | 指定要安裝的系統提示詞（可用選項見下方列表）。 |\n| `--ai-agent \u003cname\u003e` | 否 | 指定目標 Agent（`claude` / `copilot` / `codex` / `agy`）。省略時安裝至全部。 |\n| `--project-path \u003cpath\u003e` | 否 | 指定專案根目錄。省略時安裝至使用者的全域路徑。 |\n| `--replace-all` | 否 | 若先前已安裝過該提示詞，則會將其移除後全新重裝，適合用於更新提示詞版本。 |\n\n**系統引導檔路徑對照：**\n\n| Agent | 全域引導檔路徑 | 專案引導檔路徑 |\n| :--- | :--- | :--- |\n| **Claude Code** | `~/.claude/CLAUDE.md` | `\u003cproject\u003e/CLAUDE.md` |\n| **Copilot CLI** | `~/.copilot/copilot-instructions.md` | `\u003cproject\u003e/.github/copilot-instructions.md` |\n| **Codex** | `~/.codex/AGENTS.md` | `\u003cproject\u003e/AGENTS.md` |\n| **Antigravity (AGY)** | `~/.gemini/antigravity-cli/instructions.md` | `\u003cproject\u003e/agents.md` |\n\n**支援的系統提示詞種類：**\n\n| Key | 提示詞名稱 | 核心功能與扮演角色 |\n| :--- | :--- | :--- |\n| `technical-co-founder` | **Technical Co-Founder** | 讓 AI 扮演您的技術共同創辦人，以 Discovery → Planning → Building → Polish → Handoff 五階段框架，協助您從零打造可上線的真實產品。 |\n| `git-commit` | **Git Commit Message Generator** | 智能分析暫存區變更，自動生成符合 Conventional Commits 規範的精確提交訊息，經確認後一鍵提交。 |\n| `fact-check` | **Fact-Check Thinking** | 強制 AI 在回答前先進行「事實檢查思考」，嚴格依據來源與事實回答，避免臆測與捏造內容。 |\n\n**實用範例：**\n\n```bash\n# 1. 一次安裝「技術共同創辦人」提示詞至全部支援的 AI Agent 全域引導檔\nnpx -p @moon791017/neo-skills install-system-instructions --instructions technical-co-founder -y\n\n# 2. 安裝「技術共同創辦人」提示詞至 Claude Code 的專案級 CLAUDE.md\nnpx -p @moon791017/neo-skills install-system-instructions --ai-agent claude --instructions technical-co-founder --project-path . -y\n\n# 3. 如果需要更新/覆蓋已安裝的 git-commit 提示詞，加上 --replace-all 進行重裝\nnpx -p @moon791017/neo-skills install-system-instructions --ai-agent claude --instructions git-commit --replace-all -y\n```\n\n---\n\n## 💡 常用指令範例\n\n您可以根據不同的開發與維運需求場景，快速安裝對應的專家技能，並直接對 AI 代理下達相關指令：\n\n| 需求場景 | 所需專家技能 | 快速安裝指令 | 推薦咒語範例 |\n| :--- | :--- | :--- | :--- |\n| **設定 .NET CI Pipeline** | `neo-azure-pipelines` | `npx skills add Benknightdark/neo-skills --skill neo-azure-pipelines` | `幫這個專案設定 CI 流程` |\n| **部署至 IIS On-Premises** | `neo-azure-pipelines` | `npx skills add Benknightdark/neo-skills --skill neo-azure-pipelines` | `部署到 IIS，站台名稱為 MySite` |\n| **全方位程式碼深度審查** | `neo-code-review` | `npx skills add Benknightdark/neo-skills --skill neo-code-review` | `幫我 code review 剛才的修改` |\n| **生成 C# Interface 介面** | `neo-csharp-interface-generator` | `npx skills add Benknightdark/neo-skills --skill neo-csharp-interface-generator` | `幫我針對這個 class 產生介面` |\n| **TS 型別設計與 CJS/ESM 互通** | `neo-typescript` | `npx skills add Benknightdark/neo-skills --skill neo-typescript` | `解決 tsconfig 還有 ESM/CJS 互通性的問題` |\n| **複雜/模糊需求釐清與規格化** | `neo-clarification` | `npx skills add Benknightdark/neo-skills --skill neo-clarification` | `我想做一個電商網站` |\n| **AI 助手開發治理與流程健檢** | `neo-agent-harness` | `npx skills add Benknightdark/neo-skills --skill neo-agent-harness` | `幫我檢查這個專案怎麼讓 AI 助手開發得更穩、更安全` |\n| **清除文案/註解/Commit 中的 AI 腔** | `neo-stop-slop` | `npx skills add Benknightdark/neo-skills --skill neo-stop-slop` | `消除這段話裡的 AI 腔贅詞，使其極簡直接` |\n\n## 🛠 開發與測試指南\n\n本專案支援本地測試與 NPM 打包。\n\n### 前置需求\n\n* **[Node.js](https://nodejs.org/) (v18+)**：基本執行環境。\n\n### 快速開始\n\n1. **安裝依賴**\n\n    ```bash\n    npm install\n    ```\n\n2. **執行單元測試**\n\n    ```bash\n    npm test\n    ```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbenknightdark%2Fneo-skills","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbenknightdark%2Fneo-skills","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbenknightdark%2Fneo-skills/lists"}