@moon791017/neo-skills 1.0.42 → 1.1.0

package/AGENTS.md

@@ -3,58 +3,58 @@
 **Neo Skills** 是一個專為 **Antigravity CLI (AGY)** 設計的擴充外掛，旨在將 Agent 轉化為**全方位專家代理 (Universal Expert Agent)**。它利用 Model Context Protocol (MCP) 提供特定領域的專業知識 (Skills)。目前配備了專業的 **DevOps**（Azure Pipelines）與 **Frontend/Backend** 多語系（.NET, Python, Swift, TypeScript/JavaScript, Rust, Vue）等領域的模組，其架構設計可託管任何領域的技能。
 
 ## 回應風格
-使用「繁體中文 (台灣)」
+- 使用「繁體中文 (台灣)」
+- commit訊息必須是「繁體中文 (台灣)」
 
 ---
 
 # Repository Guidelines
 
 ## Project Structure & Module Organization
-`src/` contains runtime TypeScript: [`src/server.ts`](file:///C:/Users/ben_kung/projects/neo-skills/src/server.ts) is the MCP entrypoint and `src/hooks/` holds CLI safety hooks such as `secret-guard.ts`. `bin/` contains the installer CLI and shared helpers. `skills/<skill-name>/` is the main content surface for contributors; each skill centers on a `SKILL.md` file and may also include `reference/` docs or reusable `templates/`. Tests live in `test/*.test.js`. `dist/` is generated output from Bun builds and should not be edited manually.
+`bin/` contains the installer CLI `install-system-instructions.js` and shared helpers. `skills/<skill-name>/` is the main content surface for contributors; each skill centers on a `SKILL.md` file and may also include `reference/` or `references/` docs, `assets/` templates, or reusable helper `scripts/`. Tests live in `test/*.test.js`.
 
 ## Build, Test, and Development Commands
-Use `npm install` for local setup; CI uses `npm ci`. Run `bun run dev` for quick local iteration against `src/server.ts`. Run `bun run build` to bundle the server and hooks into `dist/`, and `bun run typecheck` for strict TypeScript validation without emitting files. Use `npm test` to run the Node test suite (`node --test`). After a build, `npm start` smoke-tests the bundled server from `dist/server.js`.
+Use `npm install` for local setup; CI uses `npm ci`. Use `npm test` to run the Node test suite (`node --test`).
 
 ## Coding Style & Naming Conventions
-Use ESM modules, 2-space indentation, and keep code ASCII unless a file already uses localized text. Follow the existing style of the file you touch instead of reformatting unrelated lines; current JS utilities mostly use single quotes, while some TS sources use double quotes. Prefer `camelCase` for functions and variables, `UPPER_SNAKE_CASE` for shared constants, and `kebab-case` for skill directories and hook filenames (for example, `neo-python`, `secret-guard.ts`). Keep comments brief and only where intent is not obvious.
+Use ESM modules, 2-space indentation, and keep code ASCII unless a file already uses localized text. Follow the existing style of the file you touch instead of reformatting unrelated lines; current JS utilities mostly use single quotes. Prefer `camelCase` for functions and variables, `UPPER_SNAKE_CASE` for shared constants, and `kebab-case` for skill directories and hook filenames (for example, `neo-python`). Keep comments brief and only where intent is not obvious.
+
+### AI Helper Script Specifications (scripts/)
+When writing scripts under `skills/<skill-name>/scripts/` or global helper scripts:
+1.  **STRICTLY Non-Interactive**: Accept inputs only via command-line arguments (using `argparse`), environment variables, or stdin. **Do NOT use interactive prompts (like `input()` or TTY confirmation dialogs), as they will hang the agent indefinitely.**
+2.  **Stdout & Stderr Separation**: Write diagnostic messages, progress logs, and errors to `stderr`. Write only clean, programmatically parseable data (such as JSON or CSV) to `stdout`.
+3.  **Inline Dependencies (PEP 723)**: Python scripts must include an inline PEP 723 dependency block (e.g., `# /// script ...`) to enable self-contained runs via `uv run`.
 
 ## Testing Guidelines
-Add or update tests whenever you change installer behavior, filesystem layout, or hook logic. Place tests in `test/` and name them `*.test.js`. Mirror existing patterns: use temp directories, assert on exit codes, and verify real files were created. There is no published coverage threshold, but PR CI must pass both `npm test` and `bun run build`.
+Add or update tests whenever you change installer behavior, filesystem layout, or hook logic. Place tests in `test/` and name them `*.test.js`. Mirror existing patterns: use temp directories, assert on exit codes, and verify real files were created. PR CI must pass `npm test`.
 
 ## Commit & Pull Request Guidelines
 Follow the Conventional Commits pattern already used in history: `feat:`, `fix:`, `docs:`, `test(ci):`, `refactor(skills):`. Keep subjects short and imperative; add a scope when it clarifies impact. PRs against `develop` trigger the validation workflow, while merges to `main` feed the `release-please` release flow. In each PR, summarize behavior changes, list the commands you ran, and link the related issue when applicable.
 
 ## Security & Content Notes
-Do not commit secrets, sample credentials, or unsafe prompts. If you change secret-detection behavior, review both `src/hooks/secret-guard.ts` and `hooks/hooks.json`. When updating a skill, keep its `SKILL.md`, references, and any user-facing docs aligned.
+Do not commit secrets, sample credentials, or unsafe prompts. When updating a skill, keep its `SKILL.md`, references, and any user-facing docs aligned.
 
 ---
 
 ## 📂 系統架構
 
-專案組織為三個主要層次：
-
-### 1. MCP 伺服器 (`src/server.ts`)
-擴充套件的進入點。提供了一個 MCP 伺服器，負責：
-*   註冊 **工具 (Tools)**（例如：`fetch_web_content` 用於網頁擷取）。
-*   *注意：若要在 AGY CLI 中使用此工具，需手動在 AGY 的 MCP 設定中配置此伺服器。*
+專案組織為主要核心層次：
 
-### 2. 知識庫 (`skills/` & `.agents/skills`)
+### 知識庫 (`skills/` & `.agents/skills`)
 每個子目錄代表一個包含專家知識的「技能模組」。
-*   **結構：**
-    *   `SKILL.md`：**大腦**。定義該領域的 **Perceive-Reason-Act** 迴圈。指引 Agent 如何分析環境並做出決策。
-    *   `templates/`：**雙手**。Agent 應優先使用的可重用資產庫。
-*   **載入邏輯：**
-    *   **全域技能**: 載入自 `~/.gemini/antigravity-cli/plugins/`。
-    *   **專案專屬技能**: 載入自專案根目錄下的 `.agents/skills/`（遷移自舊有的 `.gemini/skills/`）。
-*   **範例：** `skills/neo-azure-pipelines/` 包含設計 CI/CD 管線的邏輯，`skills/neo-typescript/` 包含 TypeScript 強型別與互通性最佳實踐。
-
-### 3. 安全層 (`src/hooks/`)
-確保操作安全與數據隱私的機制。
-*   **安全守衛 (`secret-guard.ts`)**：一個即時分析工具執行參數的攔截掛鉤 (Hook)。它會阻斷涉及敏感檔案（如 `.env`, 私鑰, 憑證）的操作，以防止意外洩漏。
+*   **結構與漸進式揭露 (Progressive Disclosure) 規範：**
+    *   `SKILL.md`：**大腦**。定義該領域的 **Perceive-Reason-Act** 迴圈。**其第一行必須是 YAML frontmatter 分界符 `---`**，並包含正確 the `name`（必須與其父目錄名稱完全一致以利 Discovery 自動偵測）與 trigger-focused 的 `description`。
+    *   `references/`：**深度知識**。將詳細的檢核表、分析框架或長文檔放於此處，僅在 Reason 階段依需求由 Agent 動態載入。
+    *   `assets/`：**輸出範本**。提供標準的 Markdown 結構範本，降低 Token 開銷。
+    *   `evals/`：**評估集**。必須包含 `evals.json` 與 `eval_queries.json` 用於檢測技能的觸發率與輸出品質。
+*   **載入邏輯（對齊 npx skills add 標準）：**
+    *   **全域技能**: 載入自 `~/.gemini/skills/`，可透過 `npx skills add -g Benknightdark/neo-skills` 安裝。
+    *   **專案專屬技能**: 載入自專案根目錄下的 `.agents/skills/`，可透過 `npx skills add Benknightdark/neo-skills` 安裝。
+*   **範例：** `skills/neo-azure-pipelines/` 包含設計 CI/CD 管線的邏輯， `skills/neo-typescript/` 包含 TypeScript 強型別與互通性最佳實踐。
 
 ## 💡 使用哲學
 
-在使用此程式碼庫或外掛程式時，Agent 遵循 **Perceive-Reason-Act** 協定：
+在使用此程式碼庫時，Agent 遵循 **Perceive-Reason-Act** 協定：
 
 1.  **感知 (Perceive)**：分析使用者的專案上下文（語言、框架、現有設定）。
 2.  **推理 (Reason)**：諮詢內部知識庫 (`SKILL.md`) 以制定策略。

package/README.md

@@ -7,9 +7,9 @@
   <img src="images/banner.png" alt="leak-hunter repository secret scanner banner" width="100%">
 </p>
 
-**Neo Skills** 是專為現代 **AI Agent** 設計的**全方位能力擴充套件**。本專案透過標準化的通訊架構，為 AI 代理安裝可插拔的「技能模組 (Skills)」，使其不僅僅是一個聊天機器人，而是能轉化為具備「感知-推理-行動」能力的**多領域專家**。
+**Neo Skills** 是一個專為現代 **AI Agent** 設計的**企業級全方位能力擴充套件**。本專案基於 Model Context Protocol (MCP) 與標準化代理治理架構 (Agent Harness)，為 AI 代理安裝高可靠、可插拔的「專家技能模組 (Skills)」，使其不僅僅是個聊天機器人，而是能深度融入本地開發與運維環境，轉化為具備「感知-推理-行動 (Perceive-Reason-Act)」自主決策能力的**跨領域專家**。
 
-無論是 DevOps 自動化、軟體架構設計，或是未來的資料分析與專案管理，Neo Skills 都能透過掛載不同的知識庫與工具，讓 AI 成為您最強大的全能助手。
+無論是複雜的 DevOps 自動化（Azure Pipelines）、代碼品質安全審查、需求還原與分析釐清，或是多語系的現代化開發，Neo Skills 都能透過模組化的外部知識庫、AI 專用非互動式腳本與品質評估集 (Evals)，讓 AI 代理在安全、受控的 Harness 治理下，成為您最強大的全能數位助手。
 
 ## 🚀 核心願景
 
@@ -86,176 +86,156 @@
 
 * **AI 助手開發治理 (`skills/neo-agent-harness`)**：檢查專案規則、測試、CI、審查流程與安全防護是否足夠清楚，協助 AI 助手更穩定、更安全地參與開發。
 
-### 13. 安全守衛 (Security Guard)
-
-* **主動防護 (`secret-guard.ts`)**：作為 CLI 的中介軟體 (Hook)，自動攔截並掃描所有工具執行的參數。若偵測到敏感資訊（如環境設定檔、私鑰、雲端憑證等）將強制阻擋執行，防止機密外洩。
-
 ## 📂 系統架構
 
-本專案由三個核心層次組成，支援無限擴充：
+本專案主要由標準專家技能模組組成的知識庫所構成：
 
 | 層次 | 目錄 | 描述 |
 | :--- | :--- | :--- |
-| **Server** | `src/server.ts` | 擴充套件的進入點，負責註冊 Tool，處理與 AI Agent CLI 的通訊。 |
 | **Knowledge Base** | `skills/` | **"大腦"**。包含各領域知識 (`SKILL.md`) 與可重用的模板 (`templates/`)。 |
-| **Security Layer** | `src/hooks/` | **"安全守衛"**。攔截並掃描工具執行參數，防止敏感資訊外洩。 |
 
 ## 📦 安裝與使用
 
-### 支援的 AI Agent
+Neo Skills 已全面升級並採用 [agentskills.io](https://agentskills.io) 官方推薦的 **Agent Skills 開源標準規範**。
 
-| Agent | CLI 工具 | 技能目錄 | 指導檔 |
-| :--- | :--- | :--- | :--- |
-| **Antigravity** | [Antigravity CLI](https://antigravity.google) | 透過外掛程式自動載入 | `agents.md` |
-| **Claude** | [Claude Code](https://docs.anthropic.com/en/docs/claude-code) | `.claude/skills/` | `CLAUDE.md` |
-| **Copilot** | [GitHub Copilot CLI](https://docs.github.com/en/copilot) | `.copilot/skills/`（全域）<br>`.github/skills/`（專案） | `.copilot/copilot-instructions.md`（全域）<br>`.github/copilot-instructions.md`（專案） |
-| **Codex** | [OpenAI Codex CLI](https://github.com/openai/codex) | `.codex/skills/` | `AGENTS.md` |
+透過標準的 **Skills CLI**，您不需要手動下載、複製或在 `CLAUDE.md` 等檔案中手動附加長篇大論的系統提示詞。現代的 AI Coding Agents（如 Claude Code, Cursor, Copilot 等）已原生支持從 `.agents/skills/` 自動發現與加載這些高度專業的技能。
 
-Neo Skills 提供兩個 CLI 工具，分別用於安裝**技能模組**與**系統提示詞**：
-
-| 工具 | 用途 | 安裝目標 |
-| :--- | :--- | :--- |
-| `install-skills` | 將技能模組（`skills/`）複製到 Agent 的技能目錄 | 資料夾（如 `.claude/skills`） |
-| `install-system-instructions` | 將系統提示詞寫入 Agent 的指導檔 | 單一檔案（如 `CLAUDE.md`） |
-
-> 兩個工具皆支援 `--ai-agent` 與 `--project-path` 參數，邏輯一致。
+> [!NOTE]
+> 技能下載管理工具底層使用由 Vercel Labs 開源的全球 package manager `skills` (即 `@vercel/skills`)。這使得技能的安裝與管理如同 npm 安裝套件般優雅、快速。
 
 ---
 
-### 一、Antigravity CLI (AGY)
+### 一、一鍵安裝所有技能
 
-Antigravity CLI 現在支援透過標準的 `install-skills` 工具安裝技能模組。
+如果您希望將 Neo Skills 專案內建的所有專家技能一次性安裝至您的當前專案中，只需在專案根目錄下執行：
 
 ```bash
-# 安裝 Neo Skills 至 AGY 全域技能目錄
-npx -p @moon791017/neo-skills install-skills --ai-agent agy -y
+npx skills add Benknightdark/neo-skills
 ```
 
-或者手動將專案連結至 `~/.gemini/antigravity-cli/plugins/neo-skills`。
-
 ---
 
-### 二、安裝技能模組 (`install-skills`)
-
-將 `skills/` 目錄下的所有技能模組複製到目標 AI Agent 的技能資料夾。
-
-**語法：**
+### 二、按需安裝特定技能
 
-```
-install-skills [--ai-agent <name>] [--project-path <path>]
-```
+如果您只需要其中某幾項特定領域的專家技能，您可以使用 `--skill` 參數指定安裝：
 
-**參數：**
-
-| 參數 | 必填 | 說明 |
-| :--- | :---: | :--- |
-| `--ai-agent <name>` | 否 | 指定目標 Agent（`claude` / `copilot` / `codex`）。省略時安裝全部。 |
-| `--project-path <path>` | 否 | 指定專案根目錄。省略時安裝至 `$HOME` 全域路徑。 |
-
-**安裝路徑對照：**
+| 內建專家技能 | 一鍵安裝指令 |
+| :--- | :--- |
+| **1. C# 語法專家** | `npx skills add Benknightdark/neo-skills --skill neo-csharp` |
+| **2. .NET 核心路由** | `npx skills add Benknightdark/neo-skills --skill neo-dotnet` |
+| **3. .NET Minimal APIs 專家** | `npx skills add Benknightdark/neo-skills --skill neo-dotnet-minimal-apis` |
+| **4. .NET Web API 專家** | `npx skills add Benknightdark/neo-skills --skill neo-dotnet-webapi` |
+| **5. .NET MVC 專家** | `npx skills add Benknightdark/neo-skills --skill neo-dotnet-mvc` |
+| **6. EF Core 專家** | `npx skills add Benknightdark/neo-skills --skill neo-dotnet-ef-core` |
+| **7. .NET Tag Helper 專家** | `npx skills add Benknightdark/neo-skills --skill neo-dotnet-tag-helper` |
+| **8. C# Interface 生成器** | `npx skills add Benknightdark/neo-skills --skill neo-csharp-interface-generator` |
+| **9. Python 3.10+ 專家** | `npx skills add Benknightdark/neo-skills --skill neo-python` |
+| **10. Python 環境與依賴管理專家** | `npx skills add Benknightdark/neo-skills --skill neo-python-manager` |
+| **11. Swift 5.0+ 專家** | `npx skills add Benknightdark/neo-skills --skill neo-swift` |
+| **12. SwiftUI 專家** | `npx skills add Benknightdark/neo-skills --skill neo-swift-ui` |
+| **13. JavaScript 專家** | `npx skills add Benknightdark/neo-skills --skill neo-javascript` |
+| **14. TypeScript 專家** | `npx skills add Benknightdark/neo-skills --skill neo-typescript` |
+| **15. Vue 3 現代開發專家** | `npx skills add Benknightdark/neo-skills --skill neo-vue` |
+| **16. Rust 開發專家** | `npx skills add Benknightdark/neo-skills --skill neo-rust` |
+| **17. DevOps (Azure Pipelines) 架構師** | `npx skills add Benknightdark/neo-skills --skill neo-azure-pipelines` |
+| **18. Code Review 專家** | `npx skills add Benknightdark/neo-skills --skill neo-code-review` |
+| **19. 程式碼解釋助手** | `npx skills add Benknightdark/neo-skills --skill neo-explain` |
+| **20. 需求分析與釐清助手** | `npx skills add Benknightdark/neo-skills --skill neo-clarification` |
+| **21. AI 開發流程治理專家** | `npx skills add Benknightdark/neo-skills --skill neo-agent-harness` |
 
-| Agent | 全域路徑 | 專案路徑 |
-| :--- | :--- | :--- |
-| Antigravity | `~/.gemini/skills/` | `<project>/.agents/skills/` |
-| Claude | `~/.claude/skills/` | `<project>/.claude/skills/` |
-| Copilot | `~/.copilot/skills/` | `<project>/.github/skills/` |
-| Codex | `~/.codex/skills/` | `<project>/.codex/skills/` |
+---
 
-**範例：**
+### 三、主流 AI Agent 對齊說明
 
-```bash
-# 安裝指定 Agent 至全域
-npx -p @moon791017/neo-skills install-skills --ai-agent claude -y
+在安裝技能後，主流的 AI 代理會遵循以下載入機制，無須任何額外手動配置：
 
-# 安裝指定 Agent 至專案
-npx -p @moon791017/neo-skills install-skills --ai-agent copilot --project-path /my/project -y
+> [!TIP]
+> **全域安裝選項**：若您希望將技能安裝至全域路徑以供所有專案使用，可以在上述指令後面加上 `-g` 參數（例如 `npx skills add -g Benknightdark/neo-skills`）。
 
-# 一次安裝全部 Agent
-npx -p @moon791017/neo-skills install-skills -y
-```
+| AI Agent | 專案載入目錄 (Project-level) | 全域載入目錄 (Global-level) | 系統提示載入方式 |
+| :--- | :--- | :--- | :--- |
+| **Antigravity (AGY)** | `<project>/.agents/skills/` | `~/.gemini/skills/` | 自動掃描並動態感知載入（Perceive 階段） |
+| **Claude Code** | `<project>/.agents/skills/` | `~/.claude/skills/` | 原生載入並透過 trigger-phrases 自動觸發 |
+| **Copilot CLI / Cursor** | `<project>/.agents/skills/` | `~/.copilot/skills/` | 自動偵測專案下的 `.agents/` 設定檔案 |
 
 ---
 
-### 三、安裝系統提示詞 (`install-system-instructions`)
+### 四、安裝系統提示詞 (`install-system-instructions`)
 
-將預定義的系統提示詞寫入 AI Agent 的指導檔。若指導檔已存在，會附加至最下方；若不存在，則自動建立。
+> [!IMPORTANT]
+> **獨家加值特色功能**：由於 [agentskills.io](https://agentskills.io) 標準僅處理 `.agents/skills` 專案技能的目錄同步，**並未提供將核心系統提示詞（System Instructions）附加至 AI 代理引導檔** 的功能。
+> 
+> 為了解決這個問題，Neo Skills 專門保留並提供強大的系統提示詞安裝器 `install-system-instructions`。此 CLI 工具會自動掃描、建立，並在不破壞您既有檔案內容的前提下，將專家提示詞完美附加或更新至各 AI 代理的專屬引導檔中。
 
 **語法：**
 
-```
-install-system-instructions --instructions <key> [--ai-agent <name>] [--project-path <path>]
+```bash
+npx -p @moon791017/neo-skills install-system-instructions --instructions <key> [--ai-agent <name>] [--project-path <path>] [--replace-all]
 ```
 
-**參數：**
+**參數與引數說明：**
 
 | 參數 | 必填 | 說明 |
 | :--- | :---: | :--- |
-| `--instructions <key>` | ✅ | 指定要安裝的系統提示詞（見下方種類表）。 |
-| `--ai-agent <name>` | 否 | 指定目標 Agent（`claude` / `copilot` / `codex`）。省略時安裝至全部。 |
-| `--project-path <path>` | 否 | 指定專案根目錄。省略時安裝至 `$HOME` 全域路徑。 |
-| `--replace-all` | 否 | 若先前已安裝過該提示詞，則先將其移除後重裝。 |
+| `--instructions <key>` | ✅ | 指定要安裝的系統提示詞（可用選項見下方列表）。 |
+| `--ai-agent <name>` | 否 | 指定目標 Agent（`claude` / `copilot` / `codex` / `agy`）。省略時安裝至全部。 |
+| `--project-path <path>` | 否 | 指定專案根目錄。省略時安裝至使用者的全域路徑。 |
+| `--replace-all` | 否 | 若先前已安裝過該提示詞，則會將其移除後全新重裝，適合用於更新提示詞版本。 |
 
-**指導檔路徑對照：**
+**系統引導檔路徑對照：**
 
-| Agent | 全域路徑 | 專案路徑 |
+| Agent | 全域引導檔路徑 | 專案引導檔路徑 |
 | :--- | :--- | :--- |
-| Claude | `~/.claude/CLAUDE.md` | `<project>/CLAUDE.md` |
-| Copilot | `~/.copilot/copilot-instructions.md` | `<project>/.github/copilot-instructions.md` |
-| Codex | `~/.codex/AGENTS.md` | `<project>/AGENTS.md` |
+| **Claude Code** | `~/.claude/CLAUDE.md` | `<project>/CLAUDE.md` |
+| **Copilot CLI** | `~/.copilot/copilot-instructions.md` | `<project>/.github/copilot-instructions.md` |
+| **Codex** | `~/.codex/AGENTS.md` | `<project>/AGENTS.md` |
+| **Antigravity (AGY)** | `~/.gemini/antigravity-cli/instructions.md` | `<project>/agents.md` |
 
-**可用的系統提示詞種類：**
+**支援的系統提示詞種類：**
 
-| Key | 名稱 | 說明 |
+| Key | 提示詞名稱 | 核心功能與扮演角色 |
 | :--- | :--- | :--- |
-| `technical-co-founder` | Technical Co-Founder | 讓 AI 扮演技術共同創辦人，以 Discovery → Planning → Building → Polish → Handoff 五階段框架，協助您從零打造可上線的真實產品。 |
-| `git-commit` | Git Commit Message Generator | 分析暫存區變更，自動生成符合 Conventional Commits 規範的提交訊息，經確認後執行。 |
-| `fact-check` | Fact-Check Thinking | 強制 AI 在回答前先進行「事實檢查思考」，嚴格依據來源與事實回答，避免臆測與捏造內容。 |
+| `technical-co-founder` | **Technical Co-Founder** | 讓 AI 扮演您的技術共同創辦人，以 Discovery → Planning → Building → Polish → Handoff 五階段框架，協助您從零打造可上線的真實產品。 |
+| `git-commit` | **Git Commit Message Generator** | 智能分析暫存區變更，自動生成符合 Conventional Commits 規範的精確提交訊息，經確認後一鍵提交。 |
+| `fact-check` | **Fact-Check Thinking** | 強制 AI 在回答前先進行「事實檢查思考」，嚴格依據來源與事實回答，避免臆測與捏造內容。 |
 
-**範例：**
+**實用範例：**
 
 ```bash
-# 一次安裝至全部 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
+# 1. 一次安裝「技術共同創辦人」提示詞至全部支援的 AI Agent 全域引導檔
+npx -p @moon791017/neo-skills install-system-instructions --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
+# 2. 安裝「技術共同創辦人」提示詞至 Claude Code 的專案級 CLAUDE.md
+npx -p @moon791017/neo-skills install-system-instructions --ai-agent claude --instructions technical-co-founder --project-path . -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
+# 3. 如果需要更新/覆蓋已安裝的 git-commit 提示詞，加上 --replace-all 進行重裝
+npx -p @moon791017/neo-skills install-system-instructions --ai-agent claude --instructions git-commit --replace-all -y
 ```
 
-> **💡** 重複執行相同指令不會重複寫入，系統會自動偵測並跳過已安裝的提示詞。若您希望覆蓋或更新之前安裝的提示詞，可以加上 `--replace-all` 參數進行重裝。
+---
 
 ## 💡 常用指令範例
 
-您可以直接對 AI 代理下達以下指令或在對話中描述需求：
+您可以根據不同的開發與維運需求場景，快速安裝對應的專家技能，並直接對 AI 代理下達相關指令：
 
-| 需求場景 | 推薦咒語範例 |
-| :--- | :--- |
-| **設定 .NET CI Pipeline** | `幫這個專案設定 CI 流程` |
-| **部署至 IIS** | `部署到 IIS，站台名稱為 MySite` |
-| **需求釐清與規格化** | `我想做一個電商網站` |
-| **全方位程式碼審查** | `幫我 code review 剛才的修改` |
-| **生成 C# Interface** | `幫我針對這個 class 產生介面` |
-| **TypeScript 型別設計與互通性** | `解決 tsconfig 還有 ESM/CJS 互通性的問題`、`幫我寫一個強型別的泛型工具` |
-| **技術解析與架構洞察** | `分析這個專案的架構` |
-| **AI 開發流程健檢** | `幫我檢查這個專案怎麼讓 AI 助手開發得更穩、更安全` |
+| 需求場景 | 所需專家技能 | 快速安裝指令 | 推薦咒語範例 |
+| :--- | :--- | :--- | :--- |
+| **設定 .NET CI Pipeline** | `neo-azure-pipelines` | `npx skills add Benknightdark/neo-skills --skill neo-azure-pipelines` | `幫這個專案設定 CI 流程` |
+| **部署至 IIS On-Premises** | `neo-azure-pipelines` | `npx skills add Benknightdark/neo-skills --skill neo-azure-pipelines` | `部署到 IIS，站台名稱為 MySite` |
+| **全方位程式碼深度審查** | `neo-code-review` | `npx skills add Benknightdark/neo-skills --skill neo-code-review` | `幫我 code review 剛才的修改` |
+| **技術解析與架構洞察** | `neo-explain` | `npx skills add Benknightdark/neo-skills --skill neo-explain` | `分析這個專案的架構` |
+| **生成 C# Interface 介面** | `neo-csharp-interface-generator` | `npx skills add Benknightdark/neo-skills --skill neo-csharp-interface-generator` | `幫我針對這個 class 產生介面` |
+| **TS 型別設計與 CJS/ESM 互通** | `neo-typescript` | `npx skills add Benknightdark/neo-skills --skill neo-typescript` | `解決 tsconfig 還有 ESM/CJS 互通性的問題` |
+| **複雜/模糊需求釐清與規格化** | `neo-clarification` | `npx skills add Benknightdark/neo-skills --skill neo-clarification` | `我想做一個電商網站` |
+| **AI 助手開發治理與流程健檢** | `neo-agent-harness` | `npx skills add Benknightdark/neo-skills --skill neo-agent-harness` | `幫我檢查這個專案怎麼讓 AI 助手開發得更穩、更安全` |
 
-## 🛠 開發指南
+## 🛠 開發與測試指南
 
-本專案使用 **Bun** 進行開發與建置。
+本專案支援本地測試與 NPM 打包。
 
 ### 前置需求
 
 * **[Node.js](https://nodejs.org/) (v18+)**：基本執行環境。
-* **[Bun](https://bun.sh/)**：僅在**開發**、**建置**或執行 **Gemini MCP Server** 時需要。
 
 ### 快速開始
 
@@ -265,22 +245,8 @@ npx -p @moon791017/neo-skills install-system-instructions \
     npm install
     ```
 
-2. **開發模式 (Watch Mode)**
-    直接執行原始碼進行測試：
-
-    ```bash
-    bun src/server.ts
-    ```
-
-3. **建置專案**
-    將 TypeScript 編譯並打包至 `dist/` 目錄：
-
-    ```bash
-    bun run build
-    ```
-
-4. **類型檢查**
+2. **執行單元測試**
 
     ```bash
-    bun run typecheck
+    npm test
     ```

package/bin/_utils.js

@@ -1,14 +1,6 @@
 /**
  * Shared utilities for agent skill installers.
  */
-import { cp, mkdir, access } from 'node:fs/promises';
-import { join, resolve, dirname } from 'node:path';
-import { homedir } from 'node:os';
-import { fileURLToPath } from 'node:url';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const packageRoot = resolve(__dirname, '..');
-const sourceDir = join(packageRoot, 'skills');
 
 /**
  * Agent 設定中心 — 所有 agent 的安裝參數集中管理於此。
@@ -61,82 +53,3 @@ export const AGENTS = {
     hint: 'Neo Skills 已安裝。請確保 AGY 已載入 instructions.md 或 agents.md 作為上下文檔案。',
   },
 };
-
-/**
- * 根據 agent config 建立 installer 函式。
- *
- * 路徑解析邏輯：
- *   1. 決定根目錄 (baseDir)：
- *      - 有 --project-path → 使用者指定的絕對路徑
- *      - 無 --project-path → $HOME
- *   2. 決定子目錄 (subDir)：
- *      - 有 --project-path 且 config 定義了 projectPath → 使用 projectPath
- *      - 其餘情況 → 使用 homePath
- *   3. 最終安裝路徑 = baseDir + subDir
- *
- * 範例（以 Copilot 為例）：
- *   預設:                          ~/.copilot/skills              （homedir + homePath）
- *   --project-path /my/project:   /my/project/.github/skills     （projectPath + projectPath）
- *
- * @param {object} config - AGENTS 中的 agent 設定物件
- * @param {string} [targetPath] - 使用者透過 --project-path 指定的自訂根目錄
- */
-export function createInstaller({ name: agentName, homePath, projectPath, sourceDir: customSourceDir, hint }, cliBasePath) {
-  return async function install() {
-    console.log(`🚀 [${agentName}] 開始同步 Neo Skills...`);
-
-    const effectiveSourceDir = customSourceDir ? resolve(packageRoot, customSourceDir) : sourceDir;
-
-    try {
-      await access(effectiveSourceDir);
-    } catch {
-      const msg = `在 ${effectiveSourceDir} 找不到來源目錄。`;
-      console.error(`❌ 錯誤: ${msg}`);
-      return { success: false, message: msg };
-    }
-
-    // 根目錄：--project-path 優先，否則 $HOME
-    const baseDir = cliBasePath ? resolve(cliBasePath) : homedir();
-    // 子目錄：專案層級有獨立路徑時採用 projectPath，否則用預設的 homePath
-    const subDir = cliBasePath && projectPath ? projectPath : homePath;
-    const targetSkillsDir = join(baseDir, subDir);
-
-    console.log(`📁 來源路徑: ${effectiveSourceDir}`);
-    console.log(`🎯 目標路徑: ${targetSkillsDir}`);
-
-    await mkdir(targetSkillsDir, { recursive: true });
-
-    let copyCount = 0;
-    await cp(effectiveSourceDir, targetSkillsDir, {
-      recursive: true,
-      force: true,
-      filter: (src) => {
-        const relativePath = src.replace(effectiveSourceDir, '');
-        const isIgnored = 
-          relativePath.includes('node_modules') || 
-          relativePath.includes('.git') ||
-          relativePath.includes('dist') ||
-          relativePath.includes('.antigravitycli') ||
-          relativePath.includes('.agents');
-        
-        if (!isIgnored) { 
-          // 只有當 src 不是目錄時才增加計數，或者簡化計數邏輯
-          copyCount++; 
-          return true; 
-        }
-        return false;
-      }
-    });
-
-    if (copyCount === 0) {
-      console.warn('⚠️ 警告: 沒有任何檔案被複製。請檢查來源目錄是否正確。');
-      return { success: true, message: '沒有任何檔案被複製' };
-    }
-
-    const displayPath = cliBasePath || homePath;
-    const msg = `已同步 ${copyCount} 個檔案/資料夾至 ${displayPath}`;
-    console.log(`✅ [${agentName}] 安裝成功！${msg}`);
-    if (hint) console.log(`💡 提示: ${hint}`);
-    return { success: true, message: msg };
-  };
-}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moon791017/neo-skills",
-  "version": "1.0.42",
+  "version": "1.1.0",
   "type": "module",
   "description": "Neo Skills: A Universal Expert Agent Extension",
   "homepage": "https://neo-blog-iota.vercel.app/",
@@ -13,41 +13,25 @@
     "ai agent skills"
   ],
   "bin": {
-    "neo-skills": "./bin/install-skills.js",
-    "install-skills": "./bin/install-skills.js",
     "install-system-instructions": "./bin/install-system-instructions.js"
   },
   "files": [
-    "dist",
     "bin",
     "skills",
-    "AGENTS.md",
-    ".antigravityignore"
+    "AGENTS.md"
   ],
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Benknightdark/neo-skills.git"
   },
   "scripts": {
-    "build": "bun run clean && bun run build:server && bun run build:hooks",
-    "build:server": "bun build src/server.ts --outdir dist --target node --minify",
-    "build:hooks": "bun build src/hooks/*.ts --outdir dist/hooks --target node --minify",
+    "build": "echo 'Pure JavaScript and Skills package, no build required.'",
     "install-deps": "npm install",
-    "clean": "rm -rf dist",
-    "start": "node dist/server.js",
-    "dev": "bun src/server.ts",
-    "typecheck": "tsc --noEmit",
     "test": "node --test"
   },
   "devDependencies": {
-    "@types/bun": "^1.3.11",
     "@types/node": "^25.6.0"
   },
   "license": "MIT",
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.29.0",
-    "axios": "^1.15.0",
-    "cheerio": "^1.2.0",
-    "zod": "^4.3.6"
-  }
+  "dependencies": {}
 }

package/skills/neo-azure-pipelines/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: neo-azure-pipeline-architect
+name: neo-azure-pipelines
 version: "1.0.0"
 category: "DevOps"
 description: "根據微軟官方文件與專案需求，設計並生成符合最新標準的 Azure Pipelines YAML 腳本。優先使用模組化範本 (Templates)。"