{
  "markdown": "# 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<p align=\"center\">\n  <img src=\"images/banner.png\" alt=\"Neo Skills extension banner\" width=\"100%\">\n</p>\n\n**Neo Skills** 提供可安裝的 AI Agent 技能模組。每個技能以 `SKILL.md` 定義，涵蓋語言、框架、DevOps、Code Review、需求釐清、Agent 治理與文字潤飾。支援 Agent Skills 的工具可以在需要時載入完整規則，不必把所有規則放進單一系統提示詞。\n\n專案包含：\n\n- `skills/`：內建技能模組。\n- `bin/install-skills.js`：將技能同步至 Antigravity CLI 的全域技能目錄。\n- `bin/install-system-instructions.js`：將系統提示詞安裝至 Claude Code、Copilot CLI、Codex 或 Antigravity 的指導檔。\n- `scripts/check-skills-syntax.py`：非互動式技能結構與語法驗證工具。\n\n## 適合誰\n\n- 希望 AI Agent 遵守專案規範的開發者。\n- 希望將常用工作流程整理成可重複觸發技能的團隊。\n- 使用 Antigravity CLI、Codex、Claude Code、Copilot CLI 或其他相容 Agent Skills 工具的人。\n- 需要以知識庫、範本、腳本和驗證支援 AI 輔助開發的人。\n\n## 核心設計\n\n| 機制 | 說明 |\n| :--- | :--- |\n| 漸進式揭露 | Agent 啟動時只讀取 `name` 與 `description`；需要技能時才載入完整 `SKILL.md` 與 references。 |\n| 觸發導向描述 | 每個 skill 的 `description` 都標明使用時機，供 Agent 判斷何時載入。 |\n| 外部知識庫 | 詳細規則放在 `references/` 或 `reference/`，避免主技能檔過長。 |\n| 可重用資源 | `assets/`、`templates/` 與 `scripts/` 提供可直接使用的資源。 |\n| 可驗證結構 | 使用 `scripts/check-skills-syntax.py` 檢查技能名稱、frontmatter 與基本規格。 |\n\n## 內建技能\n\n| 類別 | Skill | 使用時機 |\n| :--- | :--- | :--- |\n| Agent 治理 | `neo-harness` | 自動掃描專案環境，產生或更新專案專用的 AGENTS.md，並整合 Harness 評估、Workflow 與編排架構。 |\n| Agent 治理 | `neo-harness-project` | 盤點目前專案並依證據建立完整 Harness 知識、計畫、驗證與工程治理資產。 |\n| 資訊安全 | `neo-iso-27001` | 依 ISO/IEC 27001 進行 ISMS 範圍、風險、證據、差距分析、稽核準備與改善計畫。 |\n| 隱私管理 | `neo-iso-27701` | 依 ISO/IEC 27701 進行 PIMS、PII 角色、處理活動、隱私風險、證據與稽核準備。 |\n| DevOps | `neo-azure-pipelines` | 建立、審查、除錯或現代化 Azure Pipelines YAML，尤其是 .NET build、Azure App Service 或 IIS 部署。 |\n| 需求釐清 | `neo-clarification` | 將模糊、情緒化、片段式或截圖式需求整理成規格、驗收條件和待釐清問題。 |\n| Code Review | `neo-code-review` | 檢查程式碼、PR/diff、bug 風險、安全性、效能與可維護性。 |\n| 系統架構 | `neo-clean-architecture` | 依 Clean Architecture 原則設計、實作、審查或重構系統，劃分層級並移除特定技術依賴。 |\n| C# | `neo-csharp` | 撰寫、審查、除錯或現代化 C#/.NET 程式碼，包含語言版本、NRT、records、pattern matching 與 async。 |\n| C# | `neo-csharp-interface-generator` | 從 C# class 產生或更新 interface，並安全建立、追加或替換 interface block。 |\n| .NET | `neo-dotnet` | 處理一般 .NET 問題；當子領域尚未確定時，先偵測 SDK/project shape，再導向合適技能。 |\n| .NET | `neo-dotnet-minimal-apis` | 建置或審查 ASP.NET Core Minimal APIs、route groups、endpoint filters、typed results 或 OpenAPI metadata。 |\n| .NET | `neo-dotnet-webapi` | 建置或審查 controller-based ASP.NET Core Web API、Problem Details、API versioning 與 DTO。 |\n| .NET | `neo-dotnet-mvc` | 建置或審查 ASP.NET Core MVC、Razor views、ViewModels、Tag Helpers、View Components 與 SSR workflows。 |\n| .NET | `neo-dotnet-tag-helper` | 設計、實作或審查 ASP.NET Core custom Tag Helpers、TagBuilder、強型別屬性與 `ProcessAsync`。 |\n| .NET | `neo-dotnet-ef-core` | 處理 EF Core models、DbContext、migrations、LINQ、change tracking、provider 與 data access review。 |\n| JavaScript | `neo-javascript` | 撰寫、審查、除錯或現代化 browser、Node.js 或 pure JS 程式碼與 ESM/CJS、async、DOM/runtime 問題。 |\n| Python | `neo-python` | 撰寫、審查、除錯或架構 Python 3.10+ 程式碼、型別、dataclasses、async、測試與可維護性。 |\n| Python | `neo-python-manager` | 判斷 uv、Poetry、venv 或 pip，安裝/更新依賴、同步虛擬環境或診斷 lock file。 |\n| Rust | `neo-rust` | 撰寫、重構、除錯或審查 Rust、Cargo、ownership、borrowing、lifetime、Result/Option、unsafe 或效能問題。 |\n| Swift | `neo-swift` | 撰寫、審查、除錯或現代化 Swift、structured concurrency、memory safety、protocols/generics 與 SwiftUI integration。 |\n| SwiftUI | `neo-swift-ui` | 建置、重構或審查 SwiftUI apps/views、NavigationStack、Observation/state flow、previews、accessibility 與效能。 |\n| TypeScript | `neo-typescript` | 處理 TypeScript、tsconfig、strict mode、泛型、conditional/mapped/template literal types、ESM/CJS 與 runtime boundaries。 |\n| Vue | `neo-vue` | 建置、除錯、重構或審查 Vue 3、SFC、Composition API、Pinia、Vue Router、Vite 與 Vue+TypeScript。 |\n| Agent 架構 | `neo-sub-agent` | 設計、建立、審查或轉換 sub-agent、custom agent、worker/reviewer/planner agent 或 multi-agent workflow。 |\n| 技能開發 | `generate-skill` | 建立、更新、審查或最佳化 Agent Skill，包括規格、觸發描述、延伸資源、評估資料和設計模式。 |\n| 可觀測性 | `neo-opentelemetry` | 解釋 OpenTelemetry 概念、規劃或審查 Collector 架構與設定、處理維運排障、安全、零程式 instrumentation 及相容性遷移。 |\n| queue | `neo-rabbitmq` | 以 RabbitMQ 4.3 為預設，提供語言中立的訊息拓撲、Broker 營運、監控排障與效能優化指引。 |\n| 文字潤飾 | `neo-stop-slop` | 去除繁中或英文中的 AI 腔、贅詞和公式化句式，適用於文件、註解、commit message 和 PR 說明。 |\n| PR 產出 | `neo-pr` | 詢問或自動偵測 Repository 的來源與目標分支，擷取變更，產生重點式且自然的 PR Title 和 PR Description。 |\n\n`generate-skill` 位於 `.agents/skills/`，可由 Agent Skills CLI 探索和安裝；其餘技能位於 `skills/`。\n\n## 安裝\n\n### Antigravity CLI 全域安裝\n\n將 `skills/` 下的技能同步至 `~/.gemini/antigravity-cli/skills`：\n\n```bash\nnpx -y @moon791017/neo-skills@latest\n```\n\n本地開發：\n\n```bash\nnode bin/install-skills.js\n```\n\n### Agent Skills CLI 安裝\n\n在目前專案安裝全部技能：\n\n```bash\nnpx skills add Benknightdark/neo-skills --skill --all -y\n```\n\n在全域安裝全部技能：\n\n```bash\nnpx skills add Benknightdark/neo-skills --skill --all -g -y\n```\n\n## 系統提示詞安裝\n\nAgent Skills 規格會同步技能目錄；`AGENTS.md`、`CLAUDE.md`、Copilot instructions 或 Antigravity `agents.md` 等指導檔需要另外安裝。\n\n```bash\nnpx -p @moon791017/neo-skills install-system-instructions --instructions technical-co-founder\n```\n\n指定 Agent 和專案路徑：\n\n```bash\nnpx -p @moon791017/neo-skills install-system-instructions \\\n  --ai-agent codex \\\n  --instructions technical-co-founder \\\n  --project-path .\n```\n\n更新已安裝的提示詞：\n\n```bash\nnpx -p @moon791017/neo-skills install-system-instructions \\\n  --ai-agent codex \\\n  --instructions git-commit \\\n  --project-path . \\\n  --replace-all\n```\n\n### 支援的 Agent 指導檔\n\n| Agent | 全域路徑 | 專案路徑 |\n| :--- | :--- | :--- |\n| Claude Code | `~/.claude/CLAUDE.md` | `<project>/CLAUDE.md` |\n| Copilot CLI | `~/.copilot/copilot-instructions.md` | `<project>/.github/copilot-instructions.md` |\n| Codex | `~/.codex/AGENTS.md` | `<project>/AGENTS.md` |\n| Antigravity CLI | `~/.gemini/antigravity-cli/instructions.md` | `<project>/agents.md` |\n\n### 支援的系統提示詞\n\n| Key | 用途 |\n| :--- | :--- |\n| `technical-co-founder` | 讓 Agent 依 Discovery、Planning、Building、Polish、Handoff 流程協助交付產品。 |\n| `git-commit` | 要求 commit message 遵守 Conventional Commits 1.0.0，並使用使用者偏好的語言。 |\n| `fact-check` | 要求 Agent 根據來源與證據回答，資料不足時明確說不能確定。 |\n| `minimal-output` | 要求 Agent 在執行建置、部署、測試和格式化時使用最小輸出，保留 Context 空間。 |\n\n## 常用情境\n\n| 想做的事 | 安裝技能 | 可以對 Agent 這樣說 |\n| :--- | :--- | :--- |\n| 設計 Azure Pipelines CI/CD | `neo-azure-pipelines` | `幫我建立 .NET 專案的 Azure Pipelines CI` |\n| 審查目前變更 | `neo-code-review` | `請 review 目前 git diff` |\n| 釐清模糊需求 | `neo-clarification` | `把這些零散需求整理成規格與待確認問題` |\n| 設計乾淨架構 | `neo-clean-architecture` | `幫我用 Clean Architecture 設計訂單管理模組` |\n| 寫 TypeScript 型別 | `neo-typescript` | `幫我設計這個 API response 的泛型型別` |\n| 建 Vue 3 元件 | `neo-vue` | `幫我重構這個 SFC，避免響應式踩坑` |\n| 建立 Agent 治理 | `neo-harness` | `幫我針對這個專案評估並產生 AGENTS.md` |\n| 建立完整專案 Harness | `neo-harness-project` | `盤點目前專案並建立可驗證、可恢復的 Harness 工程環境` |\n| 建立 sub-agent | `neo-sub-agent` | `幫我新增一個 Codex code-reviewer sub agent` |\n| 規劃 OpenTelemetry | `neo-opentelemetry` | `幫我審查 Collector 架構、韌性、安全與零程式觀測方案` |\n| 設計 RabbitMQ 系統 | `neo-rabbitmq` | `請分析 RabbitMQ Queue 堆積、叢集營運與效能瓶頸` |\n| 去掉 AI 腔 | `neo-stop-slop` | `把這段 PR 說明改得自然、直接一點` |\n",
  "bytes": 7078,
  "sha": "6be94e9ccdf677150d5ecbecacf18c7d9a245ce84c4fb4780e4f7da35b441434",
  "repo_slug": "benknightdark/neo-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_benknightdark_neo_skills_neo_skills_1e675750/readme"
}