@moon791017/neo-skills 1.1.6 → 1.1.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (25) hide show
  1. package/AGENTS.md +63 -42
  2. package/README.md +119 -205
  3. package/package.json +2 -2
  4. package/skills/neo-agent-harness/SKILL.md +5 -1
  5. package/skills/neo-azure-pipelines/SKILL.md +12 -7
  6. package/skills/neo-clarification/SKILL.md +3 -1
  7. package/skills/neo-code-review/SKILL.md +3 -1
  8. package/skills/neo-csharp/SKILL.md +9 -4
  9. package/skills/neo-csharp-interface-generator/SKILL.md +8 -3
  10. package/skills/neo-dotnet/SKILL.md +9 -4
  11. package/skills/neo-dotnet-ef-core/SKILL.md +8 -4
  12. package/skills/neo-dotnet-minimal-apis/SKILL.md +8 -4
  13. package/skills/neo-dotnet-mvc/SKILL.md +8 -4
  14. package/skills/neo-dotnet-tag-helper/SKILL.md +6 -3
  15. package/skills/neo-dotnet-webapi/SKILL.md +8 -4
  16. package/skills/neo-javascript/SKILL.md +10 -5
  17. package/skills/neo-python/SKILL.md +7 -3
  18. package/skills/neo-python-manager/SKILL.md +8 -3
  19. package/skills/neo-rust/SKILL.md +4 -1
  20. package/skills/neo-stop-slop/SKILL.md +4 -5
  21. package/skills/neo-sub-agent/SKILL.md +4 -1
  22. package/skills/neo-swift/SKILL.md +8 -3
  23. package/skills/neo-swift-ui/SKILL.md +8 -3
  24. package/skills/neo-typescript/SKILL.md +4 -1
  25. package/skills/neo-vue/SKILL.md +13 -12
package/AGENTS.md CHANGED
@@ -1,61 +1,82 @@
1
- # Neo Skills Extension (agents.md)
1
+ # Neo Skills
2
2
 
3
- **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）等領域的模組，其架構設計可託管任何領域的技能。
3
+ **Neo Skills** 是給 AI Agent 使用的專家技能套件。核心交付物是 `skills/<skill-name>/SKILL.md` 與其延伸資源，並透過安裝工具同步到 Antigravity CLI 或其他支援 Agent Skills 規格的用戶端。
4
+
5
+ 本專案的目標不是收集提示詞，而是把可重複使用的專業工作流程、參考文件、範本、非互動式腳本與評估資料打包成可維護的技能模組。
4
6
 
5
7
  ## 回應風格
6
- - 使用「繁體中文 (台灣)」
7
- - commit訊息必須是「繁體中文 (台灣)」
8
8
 
9
- ---
9
+ - 使用繁體中文（台灣）。
10
+ - Commit 訊息必須使用繁體中文（台灣）。
11
+ - 需要事實判斷時，只根據使用者提供內容、目前 worktree、專案檔案或已驗證來源回答；資料不足時直接說明不能確定。
12
+
13
+ ## 專案結構
14
+
15
+ | 路徑 | 用途 |
16
+ | :--- | :--- |
17
+ | `skills/<skill-name>/SKILL.md` | 每個技能的主要入口；第一行必須是 `---` frontmatter。 |
18
+ | `skills/<skill-name>/references/` 或 `reference/` | 深度知識、檢核表、反模式、設計規範；只在需要時載入。 |
19
+ | `skills/<skill-name>/assets/` | 文件、程式碼或設定檔範本。 |
20
+ | `skills/<skill-name>/scripts/` | 可重複執行的非互動式輔助腳本。 |
21
+ | `skills/<skill-name>/evals/` | 觸發率與輸出品質評估資料。 |
22
+ | `bin/` | 安裝 CLI 與共用工具。 |
23
+ | `scripts/check-skills-syntax.py` | 技能 frontmatter 與基本結構驗證工具。 |
24
+ | `test/*.test.js` | Node.js 測試。 |
25
+
26
+ ## 開發指令
10
27
 
11
- # Repository Guidelines
28
+ - `npm install`：本地安裝依賴。
29
+ - `npm test`：執行 Node.js 測試。
30
+ - `python3 scripts/check-skills-syntax.py --dir skills`：驗證所有技能目錄與 `SKILL.md` frontmatter。
31
+ - `node bin/install-skills.js`：將技能同步到 Antigravity CLI 全域技能目錄。
12
32
 
13
- ## Project Structure & Module Organization
14
- `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`.
33
+ ## Skill 品質標準
15
34
 
16
- ## Build, Test, and Development Commands
17
- Use `npm install` for local setup; CI uses `npm ci`. Use `npm test` to run the Node test suite (`node --test`).
35
+ 每個技能都必須符合 Agent Skills 的漸進式揭露原則：
18
36
 
19
- ## Coding Style & Naming Conventions
20
- 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.
37
+ 1. `SKILL.md` 第一行必須是 `---`。
38
+ 2. frontmatter 必須包含 `name` 與 `description`。
39
+ 3. `name` 必須與父資料夾名稱完全一致，使用 lowercase kebab-case。
40
+ 4. `description` 要描述「何時使用這個技能」，優先使用 `Use this skill when...` 或等價的明確觸發語。
41
+ 5. 自訂屬性放在 `metadata` 底下；不要在 frontmatter 頂層新增未標準化欄位。
42
+ 6. `SKILL.md` 保持精簡，複雜規則放入 `references/`、`assets/`、`scripts/` 或 `evals/`。
43
+ 7. 涉及版本、官方規格、SDK 或雲端服務的內容，若答案依賴最新狀態，必須查證官方來源；不能查證時要標明不確定。
44
+ 8. 修改技能時，同步檢查 README、evals、references、assets 與 scripts 是否仍一致。
21
45
 
22
- ### AI Helper Script Specifications (scripts/)
23
- When writing scripts under `skills/<skill-name>/scripts/` or global helper scripts:
24
- 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.**
25
- 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`.
26
- 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`.
46
+ ## 腳本規範
27
47
 
28
- ## Testing Guidelines
29
- 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`.
48
+ 寫在 `skills/<skill-name>/scripts/` 或全域 `scripts/` 的輔助腳本必須符合：
30
49
 
31
- ## Commit & Pull Request Guidelines
32
- 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.
50
+ 1. **非互動式**：只透過 CLI 參數、環境變數或 stdin 接收輸入；不要使用 `input()`、TTY prompt 或確認對話。
51
+ 2. **stdout/stderr 分離**：stdout 只輸出可解析資料（JSON、CSV、TSV）；診斷、進度與錯誤輸出到 stderr。
52
+ 3. **可重試**：能支援 dry-run 或安全重跑時要提供；避免同一輸入造成不可預期副作用。
53
+ 4. **PEP 723**：Python 腳本需放入 inline dependency block，方便 `uv run` 直接執行。
33
54
 
34
- ## Security & Content Notes
35
- Do not commit secrets, sample credentials, or unsafe prompts. When updating a skill, keep its `SKILL.md`, references, and any user-facing docs aligned. When deprecating or removing a skill, ensure the skill directory is completely deleted and all references are systematically scrubbed from project documentation (such as `README.md`) to maintain the agent's knowledge database hygiene.
55
+ ## 測試規範
36
56
 
37
- ---
57
+ - 變更 installer、檔案布局、hook 邏輯或驗證腳本時，新增或更新 `test/*.test.js`。
58
+ - 變更技能 frontmatter 或新增技能後，執行 `python3 scripts/check-skills-syntax.py --dir skills`。
59
+ - 變更腳本時，優先加入可由 CI 或本地命令執行的非互動式測試。
60
+ - PR 前至少確認 `npm test` 通過。
38
61
 
39
- ## 📂 系統架構
62
+ ## Commit 與 PR
40
63
 
41
- 專案組織為主要核心層次：
64
+ - Commit 採 Conventional Commits 1.0.0：`<type>[optional scope]: <description>`。
65
+ - 常用 type：`feat`、`fix`、`docs`、`test`、`refactor`、`build`、`ci`、`chore`。
66
+ - Commit 主旨使用繁體中文（台灣），不要加句號。
67
+ - 不要加入 `Co-authored-by` 或任何 AI attribution trailer。
68
+ - 每個 commit 聚焦單一邏輯變更，不混入不相關修改。
69
+ - PR 說明需包含行為變更、已執行指令與相關 issue。
42
70
 
43
- ### 知識庫 (`skills/` & `.agents/skills`)
44
- 每個子目錄代表一個包含專家知識的「技能模組」。
45
- * **結構與漸進式揭露 (Progressive Disclosure) 規範：**
46
- * `SKILL.md`：**大腦**。定義該領域的 **Perceive-Reason-Act** 迴圈。**其第一行必須是 YAML frontmatter 分界符 `---`**，並包含正確 the `name`（必須與其父目錄名稱完全一致以利 Discovery 自動偵測）與 trigger-focused 的 `description`。
47
- * `references/`：**深度知識**。將詳細的檢核表、分析框架或長文檔放於此處，僅在 Reason 階段依需求由 Agent 動態載入。
48
- * `assets/`：**輸出範本**。提供標準的 Markdown 結構範本，降低 Token 開銷。
49
- * `evals/`：**評估集**。必須包含 `evals.json` 與 `eval_queries.json` 用於檢測技能的觸發率與輸出品質。
50
- * **載入邏輯（對齊 npx skills add 標準）：**
51
- * **全域技能**: 載入自 `~/.gemini/skills/`，可透過 `npx skills add -g Benknightdark/neo-skills` 安裝。
52
- * **專案專屬技能**: 載入自專案根目錄下的 `.agents/skills/`，可透過 `npx skills add Benknightdark/neo-skills` 安裝。
53
- * **範例：** `skills/neo-azure-pipelines/` 包含設計 CI/CD 管線的邏輯， `skills/neo-typescript/` 包含 TypeScript 強型別與互通性最佳實踐。
71
+ ## 安全與內容
54
72
 
55
- ## 💡 使用哲學
73
+ - 不提交 secret、token、sample credentials 或可被誤用的危險提示詞。
74
+ - 移除技能時，完整刪除目錄並同步清理 README、安裝文件與任何引用。
75
+ - 不確定某項外部規格是否仍正確時，不要把它寫成確定事實。
56
76
 
57
- 在使用此程式碼庫時，Agent 遵循 **Perceive-Reason-Act** 協定：
77
+ ## Agent 工作流程
58
78
 
59
- 1. **感知 (Perceive)**：分析使用者的專案上下文（語言、框架、現有設定）。
60
- 2. **推理 (Reason)**：諮詢內部知識庫 (`SKILL.md`) 以制定策略。
61
- 3. **行動 (Act)**：執行工作流程，優先使用 `skills/**/templates/` 中的現有範本。
79
+ 1. 先讀目前 worktree，不依賴記憶中的舊狀態。
80
+ 2. 小步修改，保留使用者既有變更。
81
+ 3. 文件、技能與驗證工具要互相對齊。
82
+ 4. 完成後回報修改重點、已跑驗證，以及仍未處理的風險或待辦。
package/README.md CHANGED
@@ -4,261 +4,175 @@
4
4
  [![npm version](https://img.shields.io/npm/v/@moon791017/neo-skills.svg)](https://www.npmjs.com/package/@moon791017/neo-skills)
5
5
 
6
6
  <p align="center">
7
- <img src="images/banner.png" alt="leak-hunter repository secret scanner banner" width="100%">
7
+ <img src="images/banner.png" alt="Neo Skills extension banner" width="100%">
8
8
  </p>
9
9
 
10
- **Neo Skills** 是專為 **AI Agent** 設計的技能擴充套件。本專案基於 Model Context Protocol (MCP) 與 Agent Harness 治理架構，提供高可靠、可插拔的「專家技能模組 (Skills)」，使 AI 代理具備「感知-推理-行動 (Perceive-Reason-Act)」自主決策能力，能深度融入本地開發與運維環境。
10
+ **Neo Skills** 是一組給 AI Agent 使用的專家技能模組。它把語言、框架、DevOps、Code Review、需求釐清、Agent 治理與文字潤飾等工作流程包成可安裝的 `SKILL.md`，讓支援 Agent Skills 的工具能在需要時載入精準知識，而不是把所有規則塞進一段大型系統提示詞。
11
11
 
12
- 支援 DevOps 自動化（Azure Pipelines）、程式碼審查、需求釐清及多語言開發。透過模組化外部知識庫、非互動式腳本與品質評估集 (Evals)，確保 AI 代理在受控的 Harness 架構下安全執行。
12
+ 目前專案提供：
13
13
 
14
- ## 🚀 核心機制
14
+ - `skills/`：22 個內建專家技能。
15
+ - `bin/install-skills.js`：同步技能到 Antigravity CLI 全域技能目錄。
16
+ - `bin/install-system-instructions.js`：把系統提示詞安裝到 Claude Code、Copilot CLI、Codex 或 Antigravity 的指導檔。
17
+ - `scripts/check-skills-syntax.py`：非互動式技能結構驗證工具。
15
18
 
16
- 透過以下機制提升 AI 代理的執行可靠度與專業度：
19
+ ## 適合誰
17
20
 
18
- 1. **領域技能 (Skills)**：基於 `SKILL.md` 規範的專家知識庫。
19
- 2. **標準範本 (Templates)**：提供預先驗證的自動化腳本與模版，確保產出一致性。
20
- 3. **Perceive-Reason-Act 迴圈**：強制執行「感知-推理-行動」決策流程，減少幻覺並提高解決方案精準度。
21
+ - 想讓 AI Agent 穩定遵守專案規範的開發者。
22
+ - 想把常用工作流程整理成可重複觸發技能的團隊。
23
+ - 使用 Antigravity CLI、Codex、Claude Code、Copilot CLI 或其他相容 Agent Skills 工具的人。
24
+ - 需要把 AI 輔助開發從「靠提示詞」提升到「有知識庫、範本、腳本、驗證」的人。
21
25
 
22
- ## ✨ 目前內建技能 (Built-in Skills)
26
+ ## 核心設計
23
27
 
24
- ### 1. Azure Pipelines 架構師
25
-
26
- 自動化設計與生成符合微軟最佳實踐的 CI/CD 流程。
27
-
28
- * **CI 自動化**：針對 .NET 專案生成建置管線，整合單元測試與構件發佈。
29
- * **CD 自動化**：
30
- * **Azure App Service**：部署至 Azure App Service。
31
- * **IIS On-Premises**：部署至地端 IIS 伺服器，包含備份與復原機制。
32
-
33
- ### 2. Code Review 專家
34
-
35
- * **智能審查**：針對程式碼變更進行多面向 (正確性、安全性、效能、可讀性) 的深度審查。
36
-
37
- ### 3. .NET / C# 開發專家
38
-
39
- * **C# 現代語法專家 (`skills/neo-csharp`)**：跨版本 C# 專家 (10-14+)，專注於現代化語法、強型別與高效能開發模式。
40
- * **.NET 核心路由 (`skills/neo-dotnet`)**：環境偵測與統一入口，自動將任務委派給最合適的子領域專家。
41
- * **.NET Minimal APIs 專家 (`skills/neo-dotnet-minimal-apis`)**：專注於高效能微服務、路由群組與 Typed Results。
42
- * **.NET Web API 專家 (`skills/neo-dotnet-webapi`)**：提供控制器模式下的架構設計、Problem Details 與異常處理指引。
43
- * **.NET MVC 專家 (`skills/neo-dotnet-mvc`)**：處理伺服器端渲染 (SSR)、視圖模型與標籤協助程式的最佳實踐。
44
- * **EF Core 專家 (`skills/neo-dotnet-ef-core`)**：專注於資料庫建模、移轉管理與 Linq 查詢優化。
45
- * **.NET Tag Helper 專家 (`skills/neo-dotnet-tag-helper`)**：開發 ASP.NET Core 自定義 Tag Helper 的專家指引，專注於純 C# 實作與異步渲染最佳實踐。
46
- * **Interface 生成器**：針對 C# Class 自動生成符合規範的 Interface，並支援智慧檔案覆蓋功能。
47
-
48
- ### 4. Python 開發與環境管理專家
49
-
50
- * **Python 3.10+ 專家 (`skills/neo-python`)**：專注於 Python 3.10 至 3.14 的現代語法特性、型別安全與非同步開發。
51
- * **環境管理專家 (`skills/neo-python-manager`)**：智慧偵測與管理 Python 專案環境，支援 uv, Poetry, venv/pip 並提供自動化安裝建議。
52
-
53
- ### 5. Swift 開發專家
54
-
55
- * **Swift 5.0+ 專家 (`skills/neo-swift`)**：支援從基礎語法到 Swift 6 的現代開發模式，涵蓋 SwiftUI、Structured Concurrency、記憶體安全以及高效能 App 開發指引。
56
- * **SwiftUI 專家 (`skills/neo-swift-ui`)**：支援 iOS 16.0+ 與 Swift 5.0+ 的現代開發模式，專注於 NavigationStack、Observation 框架、資料流架構及高效能視圖設計。
57
-
58
- ### 6. JavaScript 開發專家
59
-
60
- * **JavaScript 現代語法專家 (`skills/neo-javascript`)**：跨版本 JavaScript 專家 (ES6 - ES2025+)，專注於現代化語法、模組系統與高效能開發模式。
61
-
62
- ### 7. TypeScript 開發專家
63
-
64
- * **TypeScript 現代語法與型別安全 (`skills/neo-typescript`)**：專注於極致的型別安全、高可維護性與進階元程式設計（Meta-programming）。
65
- * **型別系統防線**：涵蓋進階條件型別 (Conditional Types)、映射型別 (Mapped Types) 與樣板字面值型別。
66
- * **互通性與配置最佳化**：深入調校 `tsconfig.json` 編譯選項，並解決複雜的 ESM/CJS 互通性與執行期問題。
67
- * **泛型約束設計**：引導設計高靈活度的泛型與變量 (Variance) 處理。
68
-
69
- ### 8. Vue 開發專家
70
-
71
- * **Vue 3 現代開發專家 (`skills/neo-vue`)**：專注於 Vue 3 Composition API (`<script setup>`)、Pinia 狀態管理與 Vue Router 4。遵循官方 Style Guide 與最佳實踐，並提供反模式 (Anti-Patterns) 避坑指引。
72
-
73
- ### 9. Rust 開發專家
74
-
75
- * **Rust 專家 (`skills/neo-rust`)**：用於開發、重構或審查 Rust 應用程式的專家技能，涵蓋 ownership、borrowing、Result/Option 與現代 Rust 設計模式。
76
-
77
- ### 10. 需求釐清助手
78
-
79
- * **需求釐清**：系統化引導用戶釐清模糊需求，並將其轉化為結構化的規格文件（背景、功能、約束、驗收標準）。
80
-
81
- ### 11. AI 開發流程健檢
82
-
83
- * **AI 助手開發治理 (`skills/neo-agent-harness`)**：檢查專案規則、測試、CI、審查流程與安全防護，協助 AI 助手更穩定地參與開發。
84
-
85
- ### 12. Sub-Agent 建立器
86
-
87
- * **跨 CLI Sub-Agent 建立器 (`skills/neo-sub-agent`)**：設計並生成 Antigravity CLI、Codex、Claude Code 與 Copilot CLI 的 sub-agent/custom agent 設定，包含角色拆分、工具權限、檔案格式與驗證流程。
88
-
89
- ### 13. AI Tells / Slop 贅詞消除專家
90
-
91
- * **文字去 AI 腔調 (`skills/neo-stop-slop`)**：消除中英文 AI 腔、贅詞與公式化囉唆句式，還原為乾淨、生動且簡煉的自然語言，並包含工程師註解、Git Commit 及 PR 說明的特化優化。
92
-
93
- ## 📂 系統架構
28
+ | 機制 | 說明 |
29
+ | :--- | :--- |
30
+ | 漸進式揭露 | Agent 啟動時只讀 `name` 與 `description`；真正需要時才讀完整 `SKILL.md` 與 references。 |
31
+ | 觸發導向描述 | 每個 skill 的 `description` 都說明「何時使用」，提升自動觸發準確度。 |
32
+ | 外部知識庫 | 詳細規則放在 `references/` 或 `reference/`，避免主技能檔過長。 |
33
+ | 可重用資源 | 透過 `assets/`、`templates/` 與 `scripts/` 提供可落地的產出基礎。 |
34
+ | 可驗證結構 | 使用 `scripts/check-skills-syntax.py` 檢查技能名稱、frontmatter 與基本規格。 |
94
35
 
95
- 本專案主要由標準專家技能模組組成的知識庫所構成：
36
+ ## 內建技能
96
37
 
97
- | 層次 | 目錄 | 描述 |
38
+ | 類別 | Skill | 使用時機 |
98
39
  | :--- | :--- | :--- |
99
- | **Knowledge Base** | `skills/` | **"大腦"**。包含各領域知識 (`SKILL.md`) 與可重用的模板 (`templates/`)。 |
100
-
101
- ## 📦 安裝與使用
102
-
103
- Neo Skills 相容於 [agentskills.io](https://agentskills.io) 標準規範。提供以下兩種安裝方式：
104
-
105
- ---
40
+ | Agent 治理 | `neo-agent-harness` | 設計或改善 AI 輔助開發流程、AGENTS.md、技能、測試、CI、hooks、review loops 與人類決策點。 |
41
+ | DevOps | `neo-azure-pipelines` | 建立、審查、除錯或現代化 Azure Pipelines YAML，尤其是 .NET build、Azure App Service 或 IIS 部署。 |
42
+ | 需求釐清 | `neo-clarification` | 將模糊、情緒化、片段式、截圖式需求轉成規格、驗收條件或釐清問題。 |
43
+ | Code Review | `neo-code-review` | 進行程式碼審查、PR/diff review、bug 風險掃描、安全性、效能或可維護性檢查。 |
44
+ | C# | `neo-csharp` | 撰寫、審查、除錯或現代化 C#/.NET 程式碼，包含語言版本、NRT、records、pattern matching 與 async。 |
45
+ | C# | `neo-csharp-interface-generator` | 從 C# class 產生或更新 interface，並安全建立、追加或替換 interface block。 |
46
+ | .NET | `neo-dotnet` | 廣泛 .NET 問題或尚未確定子領域時，先偵測 SDK/project shape 並導向合適技能。 |
47
+ | .NET | `neo-dotnet-minimal-apis` | 建置或審查 ASP.NET Core Minimal APIs、route groups、endpoint filters、typed results 或 OpenAPI metadata。 |
48
+ | .NET | `neo-dotnet-webapi` | 建置或審查 controller-based ASP.NET Core Web API、Problem Details、API versioning 與 DTO。 |
49
+ | .NET | `neo-dotnet-mvc` | 建置或審查 ASP.NET Core MVC、Razor views、ViewModels、Tag Helpers、View Components 與 SSR workflows。 |
50
+ | .NET | `neo-dotnet-tag-helper` | 設計、實作或審查 ASP.NET Core custom Tag Helpers、TagBuilder、強型別屬性與 `ProcessAsync`。 |
51
+ | .NET | `neo-dotnet-ef-core` | 處理 EF Core models、DbContext、migrations、LINQ、change tracking、provider 與 data access review。 |
52
+ | JavaScript | `neo-javascript` | 撰寫、審查、除錯或現代化 browser、Node.js 或 pure JS 程式碼與 ESM/CJS、async、DOM/runtime 問題。 |
53
+ | Python | `neo-python` | 撰寫、審查、除錯或架構 Python 3.10+ 程式碼、型別、dataclasses、async、測試與可維護性。 |
54
+ | Python | `neo-python-manager` | 判斷 uv、Poetry、venv 或 pip，安裝/更新依賴、同步虛擬環境或診斷 lock file。 |
55
+ | Rust | `neo-rust` | 撰寫、重構、除錯或審查 Rust、Cargo、ownership、borrowing、lifetime、Result/Option、unsafe 或效能問題。 |
56
+ | Swift | `neo-swift` | 撰寫、審查、除錯或現代化 Swift、structured concurrency、memory safety、protocols/generics 與 SwiftUI integration。 |
57
+ | SwiftUI | `neo-swift-ui` | 建置、重構或審查 SwiftUI apps/views、NavigationStack、Observation/state flow、previews、accessibility 與效能。 |
58
+ | TypeScript | `neo-typescript` | 處理 TypeScript、tsconfig、strict mode、泛型、conditional/mapped/template literal types、ESM/CJS 與 runtime boundaries。 |
59
+ | Vue | `neo-vue` | 建置、除錯、重構或審查 Vue 3、SFC、Composition API、Pinia、Vue Router、Vite 與 Vue+TypeScript。 |
60
+ | Agent 架構 | `neo-sub-agent` | 設計、建立、審查或轉換 sub-agent、custom agent、worker/reviewer/planner agent 或 multi-agent workflow。 |
61
+ | 文字潤飾 | `neo-stop-slop` | 去除繁中或英文中的 AI 腔、贅詞、公式化句式，支援文件、註解、commit message 與 PR 說明。 |
62
+
63
+ ## 安裝
64
+
65
+ ### Antigravity CLI 全域安裝
66
+
67
+ 同步所有技能到 `~/.gemini/antigravity-cli/skills`：
106
68
 
107
- ### 一、全域安裝（Antigravity CLI 專用，推薦）
108
-
109
- 將本專案所有技能同步至 Antigravity 全域路徑 `~/.gemini/antigravity-cli/skills`，並自動過濾無關檔案（如 `.git`、`node_modules` 等）。
110
-
111
- #### 透過 npx 直接執行：
112
69
  ```bash
113
70
  npx -y @moon791017/neo-skills@latest
114
71
  ```
115
72
 
116
- #### 本地開發手動安裝：
117
- 在專案根目錄下執行：
73
+ 本地開發時可直接執行：
74
+
118
75
  ```bash
119
76
  node bin/install-skills.js
120
77
  ```
121
78
 
122
- ---
79
+ ### Agent Skills CLI 安裝
123
80
 
124
- ### 二、使用標準 Skills CLI 安裝（適用於其他相容 Agent）
81
+ 安裝全部技能：
125
82
 
126
- 適用於 Claude Code、Cursor、Copilot 等相容 Agent。預設安裝至當前專案，加上 `-g` 參數可安裝至全域.
127
-
128
- #### 專案一鍵安裝所有技能：
129
83
  ```bash
130
84
  npx skills add Benknightdark/neo-skills --all
131
85
  ```
132
86
 
133
- > [!TIP]
134
- > * **全域一鍵安裝**：`npx skills add Benknightdark/neo-skills --all -g`
135
- > * **安裝特定技能**：`npx skills add Benknightdark/neo-skills --skill neo-typescript,neo-vue`
136
- > * **互動選單快捷鍵**（執行不帶 `--all` 的指令時）：
137
- > * `a`：全選所有技能
138
- > * `i`：反向選取
139
- > * `Enter`：確認並安裝
140
-
141
- ---
142
-
143
- ### 三、按需安裝特定技能
144
-
145
- 如果您只需要其中某幾項特定領域的專家技能，您可以使用 `--skill` 參數指定安裝：
146
-
147
- | 內建專家技能 | 一鍵安裝指令 |
148
- | :--- | :--- |
149
- | **1. C# 語法專家** | `npx skills add Benknightdark/neo-skills --skill neo-csharp` |
150
- | **2. .NET 核心路由** | `npx skills add Benknightdark/neo-skills --skill neo-dotnet` |
151
- | **3. .NET Minimal APIs 專家** | `npx skills add Benknightdark/neo-skills --skill neo-dotnet-minimal-apis` |
152
- | **4. .NET Web API 專家** | `npx skills add Benknightdark/neo-skills --skill neo-dotnet-webapi` |
153
- | **5. .NET MVC 專家** | `npx skills add Benknightdark/neo-skills --skill neo-dotnet-mvc` |
154
- | **6. EF Core 專家** | `npx skills add Benknightdark/neo-skills --skill neo-dotnet-ef-core` |
155
- | **7. .NET Tag Helper 專家** | `npx skills add Benknightdark/neo-skills --skill neo-dotnet-tag-helper` |
156
- | **8. C# Interface 生成器** | `npx skills add Benknightdark/neo-skills --skill neo-csharp-interface-generator` |
157
- | **9. Python 3.10+ 專家** | `npx skills add Benknightdark/neo-skills --skill neo-python` |
158
- | **10. Python 環境與依賴管理專家** | `npx skills add Benknightdark/neo-skills --skill neo-python-manager` |
159
- | **11. Swift 5.0+ 專家** | `npx skills add Benknightdark/neo-skills --skill neo-swift` |
160
- | **12. SwiftUI 專家** | `npx skills add Benknightdark/neo-skills --skill neo-swift-ui` |
161
- | **13. JavaScript 專家** | `npx skills add Benknightdark/neo-skills --skill neo-javascript` |
162
- | **14. TypeScript 專家** | `npx skills add Benknightdark/neo-skills --skill neo-typescript` |
163
- | **15. Vue 3 現代開發專家** | `npx skills add Benknightdark/neo-skills --skill neo-vue` |
164
- | **16. Rust 開發專家** | `npx skills add Benknightdark/neo-skills --skill neo-rust` |
165
- | **17. DevOps (Azure Pipelines) 架構師** | `npx skills add Benknightdark/neo-skills --skill neo-azure-pipelines` |
166
- | **18. Code Review 專家** | `npx skills add Benknightdark/neo-skills --skill neo-code-review` |
167
- | **19. 需求分析與釐清助手** | `npx skills add Benknightdark/neo-skills --skill neo-clarification` |
168
- | **20. AI 開發流程治理專家** | `npx skills add Benknightdark/neo-skills --skill neo-agent-harness` |
169
- | **21. Sub-Agent 建立器** | `npx skills add Benknightdark/neo-skills --skill neo-sub-agent` |
170
- | **22. AI Tells/Slop 消除專家** | `npx skills add Benknightdark/neo-skills --skill neo-stop-slop` |
171
-
172
- ---
173
-
174
- ### 四、安裝系統提示詞 (`install-system-instructions`)
175
-
176
- > [!IMPORTANT]
177
- > **系統提示詞同步**：[agentskills.io](https://agentskills.io) 規格僅處理技能目錄同步，不包含引導檔（System Instructions）的配置。
178
- >
179
- > 本專案提供 `install-system-instructions` 工具，可自動掃描並在保留既有內容的前提下，將系統提示詞附加或更新至各 AI 代理的引導檔中。
180
-
181
- **語法：**
87
+ 安裝到全域：
182
88
 
183
89
  ```bash
184
- npx -p @moon791017/neo-skills install-system-instructions --instructions <key> [--ai-agent <name>] [--project-path <path>] [--replace-all]
90
+ npx skills add Benknightdark/neo-skills --all -g
185
91
  ```
186
92
 
187
- **參數與引數說明：**
188
-
189
- | 參數 | 必填 | 說明 |
190
- | :--- | :---: | :--- |
191
- | `--instructions <key>` | ✅ | 指定要安裝的系統提示詞（可用選項見下方列表）。 |
192
- | `--ai-agent <name>` | 否 | 指定目標 Agent（`claude` / `copilot` / `codex` / `agy`）。省略時安裝至全部。 |
193
- | `--project-path <path>` | 否 | 指定專案根目錄。省略時安裝至使用者的全域路徑。 |
194
- | `--replace-all` | 否 | 若先前已安裝過該提示詞，則會將其移除後全新重裝，適合用於更新提示詞版本。 |
93
+ 只安裝指定技能：
195
94
 
196
- **系統引導檔路徑對照：**
95
+ ```bash
96
+ npx skills add Benknightdark/neo-skills --skill neo-typescript,neo-vue
97
+ ```
197
98
 
198
- | Agent | 全域引導檔路徑 | 專案引導檔路徑 |
199
- | :--- | :--- | :--- |
200
- | **Claude Code** | `~/.claude/CLAUDE.md` | `<project>/CLAUDE.md` |
201
- | **Copilot CLI** | `~/.copilot/copilot-instructions.md` | `<project>/.github/copilot-instructions.md` |
202
- | **Codex** | `~/.codex/AGENTS.md` | `<project>/AGENTS.md` |
203
- | **Antigravity (AGY)** | `~/.gemini/antigravity-cli/instructions.md` | `<project>/agents.md` |
99
+ ## 系統提示詞安裝
204
100
 
205
- **支援的系統提示詞種類：**
101
+ Agent Skills 規格同步的是技能目錄；`AGENTS.md`、`CLAUDE.md`、Copilot instructions 或 Antigravity `agents.md` 這類指導檔需要另外安裝。
206
102
 
207
- | Key | 提示詞名稱 | 核心功能與扮演角色 |
208
- | :--- | :--- | :--- |
209
- | `technical-co-founder` | **Technical Co-Founder** | 讓 AI 扮演您的技術共同創辦人，以 Discovery → Planning → Building → Polish → Handoff 五階段框架，協助您從零打造可上線的真實產品。 |
210
- | `git-commit` | **Git Commit Message Generator** | 智能分析暫存區變更，自動生成符合 Conventional Commits 規範的精確提交訊息，經確認後一鍵提交。 |
211
- | `fact-check` | **Fact-Check Thinking** | 強制 AI 在回答前先進行「事實檢查思考」，嚴格依據來源與事實回答，避免臆測與捏造內容。 |
103
+ ```bash
104
+ npx -p @moon791017/neo-skills install-system-instructions --instructions technical-co-founder
105
+ ```
212
106
 
213
- **實用範例：**
107
+ 指定 Agent 與專案路徑：
214
108
 
215
109
  ```bash
216
- # 1. 一次安裝「技術共同創辦人」提示詞至全部支援的 AI Agent 全域引導檔
217
- npx -p @moon791017/neo-skills install-system-instructions --instructions technical-co-founder -y
110
+ npx -p @moon791017/neo-skills install-system-instructions \
111
+ --ai-agent codex \
112
+ --instructions technical-co-founder \
113
+ --project-path .
114
+ ```
218
115
 
219
- # 2. 安裝「技術共同創辦人」提示詞至 Claude Code 的專案級 CLAUDE.md
220
- npx -p @moon791017/neo-skills install-system-instructions --ai-agent claude --instructions technical-co-founder --project-path . -y
116
+ 更新已安裝過的同一段提示詞：
221
117
 
222
- # 3. 如果需要更新/覆蓋已安裝的 git-commit 提示詞，加上 --replace-all 進行重裝
223
- npx -p @moon791017/neo-skills install-system-instructions --ai-agent claude --instructions git-commit --replace-all -y
118
+ ```bash
119
+ npx -p @moon791017/neo-skills install-system-instructions \
120
+ --ai-agent codex \
121
+ --instructions git-commit \
122
+ --project-path . \
123
+ --replace-all
224
124
  ```
225
125
 
226
- ---
126
+ ### 支援的 Agent 指導檔
227
127
 
228
- ## 💡 常用指令範例
128
+ | Agent | 全域路徑 | 專案路徑 |
129
+ | :--- | :--- | :--- |
130
+ | Claude Code | `~/.claude/CLAUDE.md` | `<project>/CLAUDE.md` |
131
+ | Copilot CLI | `~/.copilot/copilot-instructions.md` | `<project>/.github/copilot-instructions.md` |
132
+ | Codex | `~/.codex/AGENTS.md` | `<project>/AGENTS.md` |
133
+ | Antigravity CLI | `~/.gemini/antigravity-cli/instructions.md` | `<project>/agents.md` |
229
134
 
230
- 您可以根據不同的開發與維運需求場景，快速安裝對應的專家技能，並直接對 AI 代理下達相關指令：
135
+ ### 支援的系統提示詞
231
136
 
232
- | 需求場景 | 所需專家技能 | 快速安裝指令 | 推薦指令範例 |
233
- | :--- | :--- | :--- | :--- |
234
- | **設定 .NET CI Pipeline** | `neo-azure-pipelines` | `npx skills add Benknightdark/neo-skills --skill neo-azure-pipelines` | `設定 CI 流程` |
235
- | **部署至 IIS On-Premises** | `neo-azure-pipelines` | `npx skills add Benknightdark/neo-skills --skill neo-azure-pipelines` | `部署到 IIS，站台名稱為 MySite` |
236
- | **全方位程式碼深度審查** | `neo-code-review` | `npx skills add Benknightdark/neo-skills --skill neo-code-review` | `進行 Code Review` |
237
- | **生成 C# Interface 介面** | `neo-csharp-interface-generator` | `npx skills add Benknightdark/neo-skills --skill neo-csharp-interface-generator` | `為這個 class 生成介面` |
238
- | **TS 型別設計與 CJS/ESM 互通** | `neo-typescript` | `npx skills add Benknightdark/neo-skills --skill neo-typescript` | `解決 tsconfig 與 ESM/CJS 互通性問題` |
239
- | **複雜/模糊需求釐清與規格化** | `neo-clarification` | `npx skills add Benknightdark/neo-skills --skill neo-clarification` | `規劃一個電商網站` |
240
- | **AI 助手開發治理與流程健檢** | `neo-agent-harness` | `npx skills add Benknightdark/neo-skills --skill neo-agent-harness` | `評估 AI 開發治理流程` |
241
- | **建立跨 CLI Sub-Agent / Custom Agent** | `neo-sub-agent` | `npx skills add Benknightdark/neo-skills --skill neo-sub-agent` | `新增一個 Codex code-reviewer sub agent` |
242
- | **清除文案/註解/Commit 中的 AI 腔** | `neo-stop-slop` | `npx skills add Benknightdark/neo-skills --skill neo-stop-slop` | `消除這段話的 AI 腔贅詞` |
137
+ | Key | 用途 |
138
+ | :--- | :--- |
139
+ | `technical-co-founder` | 讓 Agent 以 Discovery、Planning、Building、Polish、Handoff 流程協助打造可交付產品。 |
140
+ | `git-commit` | 要求 commit message 遵守 Conventional Commits 1.0.0，並使用使用者偏好的語言。 |
141
+ | `fact-check` | 要求 Agent 根據來源與證據回答，資料不足時明確說不能確定。 |
243
142
 
244
- ## 🛠 開發與測試指南
143
+ ## 常用情境
245
144
 
246
- 本專案支援本地測試與 NPM 打包。
145
+ | 想做的事 | 安裝技能 | 可以對 Agent 這樣說 |
146
+ | :--- | :--- | :--- |
147
+ | 設計 Azure Pipelines CI/CD | `neo-azure-pipelines` | `幫我建立 .NET 專案的 Azure Pipelines CI` |
148
+ | 審查目前變更 | `neo-code-review` | `請 review 目前 git diff` |
149
+ | 釐清模糊需求 | `neo-clarification` | `把這些零散需求整理成規格與待確認問題` |
150
+ | 寫 TypeScript 型別 | `neo-typescript` | `幫我設計這個 API response 的泛型型別` |
151
+ | 建 Vue 3 元件 | `neo-vue` | `幫我重構這個 SFC，避免響應式踩坑` |
152
+ | 改善 AI 開發流程 | `neo-agent-harness` | `評估這個專案讓 coding agent 協作的可靠度` |
153
+ | 建立 sub-agent | `neo-sub-agent` | `幫我新增一個 Codex code-reviewer sub agent` |
154
+ | 去掉 AI 腔 | `neo-stop-slop` | `把這段 PR 說明改得自然、直接一點` |
247
155
 
248
- ### 前置需求
156
+ ## 開發
249
157
 
250
- * **[Node.js](https://nodejs.org/) (v18+)**：基本執行環境。
158
+ ```bash
159
+ npm install
160
+ npm test
161
+ python3 scripts/check-skills-syntax.py --dir skills
162
+ ```
251
163
 
252
- ### 快速開始
164
+ ## 維護技能
253
165
 
254
- 1. **安裝依賴**
166
+ 新增或修改 skill 時，請同步檢查：
255
167
 
256
- ```bash
257
- npm install
258
- ```
168
+ 1. `SKILL.md` 第一行是 `---`。
169
+ 2. frontmatter 有 `name` 與觸發導向的 `description`。
170
+ 3. `name` 與資料夾名稱一致。
171
+ 4. 深度內容放進 `references/` 或 `reference/`，範本放進 `assets/` 或 `templates/`，可執行流程放進 `scripts/`。
172
+ 5. 腳本必須非互動式，stdout 只輸出可解析資料，診斷輸出到 stderr。
173
+ 6. README 的技能清單與實際 `skills/` 內容一致。
174
+ 7. 執行 `python3 scripts/check-skills-syntax.py --dir skills` 與 `npm test`。
259
175
 
260
- 2. **執行單元測試**
176
+ ## License
261
177
 
262
- ```bash
263
- npm test
264
- ```
178
+ MIT
package/package.json CHANGED
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "name": "@moon791017/neo-skills",
3
- "version": "1.1.6",
3
+ "version": "1.1.7",
4
4
  "type": "module",
5
- "description": "Neo Skills: A Universal Expert Agent Extension",
5
+ "description": "Neo Skills: A Universal AI Agent Skills Extension",
6
6
  "homepage": "https://neo-blog-iota.vercel.app/",
7
7
  "keywords": [
8
8
  "antigravity cli",
package/skills/neo-agent-harness/SKILL.md CHANGED
@@ -1,6 +1,10 @@
1
1
  ---
2
2
  name: neo-agent-harness
3
- description: 分析專案的 AI agent harnessability，設計 feedforward guides、feedback sensors、驗證流程與人類決策點，用於提升 agent 輔助開發品質。
3
+ description: >
4
+ Use this skill when the user asks to improve AI-assisted development reliability,
5
+ AGENTS.md, skills, tests, CI, hooks, review loops, or agent workflow governance.
6
+ It designs feedforward guides, feedback sensors, verification gates, and human
7
+ decision points from repository evidence.
4
8
  ---
5
9
 
6
10
  # Agent Harness Architect Skill
package/skills/neo-azure-pipelines/SKILL.md CHANGED
@@ -1,15 +1,20 @@
1
1
  ---
2
2
  name: neo-azure-pipelines
3
- version: "1.0.0"
4
- category: "DevOps"
5
- description: "根據微軟官方文件與專案需求，設計並生成符合最新標準的 Azure Pipelines YAML 腳本。優先使用模組化範本 (Templates)。"
3
+ description: >
4
+ Use this skill when the user asks to create, review, debug, or modernize Azure
5
+ Pipelines YAML for CI/CD, especially .NET builds, Azure App Service deploys, or
6
+ IIS/on-premises deploys. Prefer bundled templates and verify task syntax against
7
+ Microsoft docs when version-specific accuracy matters.
6
8
  compatibility: "Supports .NET 6.0 up to .NET 10.0."
9
+ metadata:
10
+ version: "1.0.0"
11
+ category: "DevOps"
7
12
  ---
8
13
 
9
14
  # Azure Pipeline Script Design Specifications
10
15
 
11
16
  ## Perceive
12
- 1. Access and retrieve official documentation at `https://learn.microsoft.com/en-us/azure/devops/pipelines/?view=azure-devops` to obtain the latest YAML syntax architecture, Task update notes, and security best practices.
17
+ 1. When version-specific syntax or task versions matter, verify them against `https://learn.microsoft.com/en-us/azure/devops/pipelines/?view=azure-devops`; if browsing is unavailable, state the uncertainty and rely on bundled templates plus project evidence.
13
18
  2. Identify the application's development language (e.g., .NET, Java, Python, Node.js) and its specific version requirements.
14
19
  3. Identify the target deployment platform (e.g., Azure App Service, Azure Kubernetes Service, Function App, or on-premises servers).
15
20
  4. Detect the project source code structure to confirm build tools (e.g., Maven, Gradle, Npm, NuGet) and testing frameworks.
@@ -21,7 +26,7 @@ compatibility: "Supports .NET 6.0 up to .NET 10.0."
21
26
  * **Utils**: `util/clean-artifact.yml`, `util/extract-artifact.yml`, `util/iis/*.yml`, etc.
22
27
 
23
28
  ## Reason
24
- 1. Compare the latest versions in official documentation with existing configurations to determine if Task versions need updating (e.g., using Checkout@v1 vs. Checkout@v4).
29
+ 1. Compare documented task versions with existing configurations to determine if task versions need updating (e.g., using Checkout@v1 vs. Checkout@v4).
25
30
  2. Determine whether to adopt a multi-stage architecture based on project scale to achieve logical isolation of Build, Test, Staging, and Production.
26
31
  3. Evaluate and design build caching strategies, optimizing dependency package folders to reduce execution time.
27
32
  4. Design trigger mechanisms based on branching strategies, distinguishing trigger paths for Continuous Integration (CI) and Continuous Deployment (CD).
@@ -34,7 +39,7 @@ compatibility: "Supports .NET 6.0 up to .NET 10.0."
34
39
  ## Act
35
40
 
36
41
  ### General Output Standards
37
- 1. Output global YAML configuration scripts that comply with the latest Azure DevOps Schema standards.
42
+ 1. Output YAML configuration scripts that comply with the current project-compatible Azure DevOps schema; state assumptions when exact task versions cannot be verified.
38
43
  2. Provide comprehensive parameter definitions to increase the flexibility and reusability of Pipeline execution.
39
44
  3. Generate configuration recommendations for Environments and Approvals and Checks.
40
45
  4. Output a list of Task resource references used in the script, labeling version numbers to ensure execution environment consistency.
@@ -70,4 +75,4 @@ When configuring a CD process for on-premises IIS:
70
75
  3. Copy the entire `util/iis/` directory and the `deploy/deploy-iis.yml` template to the project's `.pipelines/templates/` directory.
71
76
  4. Generate the deployment script (e.g., `azure-pipelines-cd-iis.yml`) in the project root, referencing `deploy-iis.yml` with parameters like `websiteName` and `physicalPath`.
72
77
  5. Ensure the script integrates `iis-backup.yml` and `iis-rollback.yml` logic.
73
- 6. Explain the requirements for Service Connection permissions and Deployment Group configuration.
78
+ 6. Explain the requirements for Service Connection permissions and Deployment Group configuration.
package/skills/neo-clarification/SKILL.md CHANGED
@@ -1,7 +1,9 @@
1
1
  ---
2
2
  name: neo-clarification
3
3
  description: >
4
- Reconstructs chaotic, emotional, or unstructured user requests and screenshots into structured, professional requirement clarification reports. Use this skill when the user provides vague feedback, fragmented descriptions, error screenshots, or raw complaints, and wants to translate them into actionable specifications or a list of clarifying questions.
4
+ Use this skill when the user gives vague, emotional, fragmented, screenshot-based,
5
+ or complaint-style requirements and wants them converted into structured specs,
6
+ acceptance criteria, or clarifying questions.
5
7
  ---
6
8
 
7
9
  # Requirement Clarification Specifications
package/skills/neo-code-review/SKILL.md CHANGED
@@ -1,7 +1,9 @@
1
1
  ---
2
2
  name: neo-code-review
3
3
  description: >
4
- Systematically reviews source code for quality, performance, security, and style issues. Use this skill when the user submits code for review, asks for feedback or a code audit, wants to identify bugs/vulnerabilities, or requests a review of recent changes (such as git diff, staged changes, or a specific commit).
4
+ Use this skill when the user asks for a code review, audit, PR/diff review, bug
5
+ risk scan, security/performance/style feedback, or validation of recent changes.
6
+ Prioritize actionable findings with file and line evidence.
5
7
  ---
6
8
 
7
9
  # Code Review Specifications
package/skills/neo-csharp/SKILL.md CHANGED
@@ -1,9 +1,14 @@
1
1
  ---
2
2
  name: neo-csharp
3
- version: "1.4.0"
4
- category: "Core"
5
- description: "跨版本 C# 專家技能 (10, 11, 12, 13, 14+)。支援從 .NET 6 (LTS) 到 .NET 10 (LTS) 的現代開發模式，涵蓋 File-scoped namespaces 到 Extension Types 的全方位演進。"
3
+ description: >
4
+ Use this skill when writing, reviewing, debugging, or modernizing C# code in .NET
5
+ projects. Trigger for .cs/.csproj files, C# language-version questions, nullable
6
+ reference types, records, pattern matching, async/cancellation, or version-appropriate
7
+ syntax from C# 10+.
6
8
  compatibility: "Supports C# 10 through 14. Adaptive to .NET 6.0, 7.0, 8.0, 9.0, and 10.0 environments."
9
+ metadata:
10
+ version: "1.4.0"
11
+ category: "Core"
7
12
  ---
8
13
 
9
14
  # Modern C# (10+) Expert Skill
@@ -50,7 +55,7 @@ compatibility: "Supports C# 10 through 14. Adaptive to .NET 6.0, 7.0, 8.0, 9.0,
50
55
  - **`params` Collections:** Method parameters support various collection types.
51
56
  - **Implicit Span Conversion:** Handle memory-safe code more naturally.
52
57
 
53
- ### C# 14+ (Cutting Edge)
58
+ ### C# 14+ (Version-Specific Features)
54
59
  - **Extension Members:** Extension properties, operators, and static members.
55
60
  - **`field` Keyword:** Directly access backing fields in property logic.
56
61
  - **Null-conditional Assignment:** `target?.Property = value;`.
package/skills/neo-csharp-interface-generator/SKILL.md CHANGED
@@ -1,9 +1,14 @@
1
1
  ---
2
2
  name: neo-csharp-interface-generator
3
- version: "1.0.0"
4
- category: "Core"
5
- description: "專注於C#介面生成與檔案結構管理。"
3
+ description: >
4
+ Use this skill when the user asks to generate, update, or place a C# interface
5
+ from an existing class. Trigger for extracting public members, filtering virtual
6
+ or non-public members, enforcing getter-only properties, and safely creating,
7
+ appending, or replacing interface blocks.
6
8
  compatibility: "Supports C# 12/13 and .NET 10.0."
9
+ metadata:
10
+ version: "1.0.0"
11
+ category: "Core"
7
12
  ---
8
13
 
9
14
  # C# Interface Generator Skill Specification
package/skills/neo-dotnet/SKILL.md CHANGED
@@ -1,9 +1,14 @@
1
1
  ---
2
2
  name: neo-dotnet
3
- version: "1.0.0"
4
- category: "Framework"
5
- description: 用於廣泛 .NET 工作的核心路由技能。此技能將偵測本機安裝的 .NET SDK 版本（要求 .NET 6+），並根據使用者的問題，將任務引導或準備載入其他合適的子技能（例如 Minimal APIs, MVC, Web API, EF Core）。
3
+ description: >
4
+ Use this skill when the user asks broad .NET questions or the project contains
5
+ .sln/.csproj files and the exact ASP.NET/EF/C# subdomain is not yet clear. Detect
6
+ the SDK/project shape, run or recommend .NET CLI commands, and route to Minimal
7
+ APIs, Web API, MVC, Tag Helper, EF Core, or C# skills when appropriate.
6
8
  compatibility: "Supports .NET 6.0 and above. Requires .NET SDK installed on the local machine."
9
+ metadata:
10
+ version: "1.0.0"
11
+ category: "Framework"
7
12
  ---
8
13
 
9
14
  # .NET Core Routing Skill
@@ -26,7 +31,7 @@ This skill serves as the unified entry point for the .NET development environmen
26
31
 
27
32
  3. **Requirement Analysis and Dynamic Skill Routing**
28
33
  - Determine the involved domain based on the user's specific problem or project architecture.
29
- - If the user's task falls into the following specific domains, please **prepare to load or suggest the user switch to** the corresponding sub-skill (please note that these sub-skills may not be implemented yet; inform the user of the future implementation direction):
34
+ - If the user's task falls into the following specific domains, prepare to use or recommend the corresponding sub-skill:
30
35
  - **`neo-dotnet-minimal-apis`**: When the requirement is for lightweight routing development, high-performance microservices, and Controllers are not used.
31
36
  - **`neo-dotnet-webapi`**: When the requirement is for traditional RESTful API development following the controller pattern.
32
37
  - **`neo-dotnet-mvc`**: When the requirement involves Server-Side Rendering (SSR), Razor views, and ViewModels.
package/skills/neo-dotnet-ef-core/SKILL.md CHANGED
@@ -1,9 +1,13 @@
1
1
  ---
2
2
  name: neo-dotnet-ef-core
3
- version: "1.0.0"
4
- category: "Framework"
5
- description: "Entity Framework Core (EF Core) 專家指引。支援從 .NET 6 (LTS) 到 .NET 10 (LTS) 的現代開發模式，涵蓋 Code-First 移轉、查詢優化、陰影屬性與複雜資料建模。"
3
+ description: >
4
+ Use this skill when the task involves Entity Framework Core models, DbContext,
5
+ migrations, LINQ queries, change tracking, database providers, performance tuning,
6
+ or data access review in .NET projects.
6
7
  compatibility: "Supports .NET 6.0 through 10.0 environments. Compatible with SQL Server, PostgreSQL, MySQL, and SQLite."
8
+ metadata:
9
+ version: "1.0.0"
10
+ category: "Framework"
7
11
  ---
8
12
 
9
13
  # EF Core Expert Skill
@@ -46,7 +50,7 @@ compatibility: "Supports .NET 6.0 through 10.0 environments. Compatible with SQL
46
50
  - **Auto-compiled Queries**: Further optimize the query compilation process.
47
51
  - **Complex Types**: Better support for Value Objects.
48
52
 
49
- ### .NET 10+ (Cutting Edge)
53
+ ### .NET 10+ (Version-Specific Features)
50
54
  - **Advanced Interceptors**: More query lifecycle hooks.
51
55
  - **Optimized AOT Support**: AOT pre-compilation optimization for cloud-native environments.
52
56
 
package/skills/neo-dotnet-minimal-apis/SKILL.md CHANGED
@@ -1,9 +1,13 @@
1
1
  ---
2
2
  name: neo-dotnet-minimal-apis
3
- version: "1.0.0"
4
- category: "Framework"
5
- description: "開發高效能、輕量級 .NET Minimal API 的專家指引。支援從 .NET 6 (LTS) 到 .NET 10 (LTS) 的現代開發模式，涵蓋路由群組、端點過濾器與符合 OpenAPI 規範的強型別回應。"
3
+ description: >
4
+ Use this skill when building, debugging, refactoring, or reviewing ASP.NET Core
5
+ Minimal APIs, lightweight endpoints, route groups, endpoint filters, typed results,
6
+ OpenAPI metadata, or high-performance .NET API services without controllers.
6
7
  compatibility: "Supports .NET 6.0 through 10.0 environments. Requires .NET SDK installed locally."
8
+ metadata:
9
+ version: "1.0.0"
10
+ category: "Framework"
7
11
  ---
8
12
 
9
13
  # .NET Minimal APIs Expert Skill
@@ -46,7 +50,7 @@ compatibility: "Supports .NET 6.0 through 10.0 environments. Requires .NET SDK i
46
50
  - **HybridCache**: High-performance multi-level caching support.
47
51
  - **OpenAPI Improvements**: Better OpenAPI code generation.
48
52
 
49
- ### .NET 10+ (Cutting Edge)
53
+ ### .NET 10+ (Version-Specific Features)
50
54
  - **Native AOT Optimization**: AOT-optimized compilation tailored for Minimal APIs.
51
55
  - **Enhanced Middleware Patterns**: New middleware designed for lightweight architectures.
52
56
 
package/skills/neo-dotnet-mvc/SKILL.md CHANGED
@@ -1,9 +1,13 @@
1
1
  ---
2
2
  name: neo-dotnet-mvc
3
- version: "1.0.0"
4
- category: "Framework"
5
- description: "開發 ASP.NET Core MVC 應用程式的專家指引。支援從 .NET 6 (LTS) 到 .NET 10 (LTS) 的現代開發模式，涵蓋視圖模型、標籤協助程式、視圖元件與伺服器端渲染的最佳實踐。"
3
+ description: >
4
+ Use this skill when building, debugging, refactoring, or reviewing ASP.NET Core
5
+ MVC apps with Razor views, controllers, ViewModels, validation, Tag Helpers,
6
+ View Components, layouts, or server-rendered workflows.
6
7
  compatibility: "Supports .NET 6.0 through 10.0 environments. Requires .NET SDK installed locally."
8
+ metadata:
9
+ version: "1.0.0"
10
+ category: "Framework"
7
11
  ---
8
12
 
9
13
  # .NET MVC Expert Skill
@@ -46,7 +50,7 @@ compatibility: "Supports .NET 6.0 through 10.0 environments. Requires .NET SDK i
46
50
  - **Keyed Services in Controllers**: Finer-grained dependency injection support.
47
51
  - **Native AOT for MVC**: Metadata compilation optimization tailored for AOT.
48
52
 
49
- ### .NET 10+ (Cutting Edge)
53
+ ### .NET 10+ (Version-Specific Features)
50
54
  - **Extension Members for IHtmlHelper**: Extending view helper functions.
51
55
  - **Advanced Serialization in Views**: Performance optimization for large view models.
52
56
 
package/skills/neo-dotnet-tag-helper/SKILL.md CHANGED
@@ -1,10 +1,13 @@
1
1
  ---
2
2
  name: neo-dotnet-tag-helper
3
- version: "1.0.0"
4
- category: "Framework"
5
- description: "開發 ASP.NET Core 6+ 自定義 Tag Helper 的專家指引。專注於純 C# 實作（無 CSHTML），支援強型別屬性、依賴注入與異步渲染（ProcessAsync）的最佳實踐。"
3
+ description: >
4
+ Use this skill when the user asks to design, implement, refactor, or review custom
5
+ ASP.NET Core Tag Helpers in C#, including TagBuilder usage, strongly typed attributes,
6
+ dependency injection, ProcessAsync, and reusable Razor UI behavior.
6
7
  compatibility: "Supports .NET 6.0 through 10.0+ environments."
7
8
  metadata:
9
+ version: "1.0.0"
10
+ category: "Framework"
8
11
  pattern: generator
9
12
  output-format: csharp
10
13
  ---
package/skills/neo-dotnet-webapi/SKILL.md CHANGED
@@ -1,9 +1,13 @@
1
1
  ---
2
2
  name: neo-dotnet-webapi
3
- version: "1.0.0"
4
- category: "Framework"
5
- description: "開發 ASP.NET Core Web API (Controller-based) 的專家指引。支援從 .NET 6 (LTS) 到 .NET 10 (LTS) 的現代開發模式，涵蓋控制器設計、Problem Details、全域異常處理與 API 版本控制。"
3
+ description: >
4
+ Use this skill when building, debugging, refactoring, or reviewing controller-based
5
+ ASP.NET Core Web APIs, including ControllerBase, ActionResult<T>, Problem Details,
6
+ API versioning, global exception handling, DTOs, and OpenAPI behavior.
6
7
  compatibility: "Supports .NET 6.0 through 10.0 environments. Requires .NET SDK installed locally."
8
+ metadata:
9
+ version: "1.0.0"
10
+ category: "Framework"
7
11
  ---
8
12
 
9
13
  # .NET Web API Expert Skill
@@ -46,7 +50,7 @@ compatibility: "Supports .NET 6.0 through 10.0 environments. Requires .NET SDK i
46
50
  - **Keyed Services**: More flexible dependency injection options.
47
51
  - **HybridCache**: Multi-level caching optimization.
48
52
 
49
- ### .NET 10+ (Cutting Edge)
53
+ ### .NET 10+ (Version-Specific Features)
50
54
  - **Extension Members for Controllers**: Extending base controller functionality.
51
55
  - **Enhanced Serialization**: JSON optimization for large payloads.
52
56
 
package/skills/neo-javascript/SKILL.md CHANGED
@@ -1,9 +1,14 @@
1
1
  ---
2
2
  name: neo-javascript
3
- version: "1.0.0"
4
- category: "Core"
5
- description: "跨版本 JavaScript 專家技能 (ES6 - ES2025+)。支援現代前端與純 JavaScript 開發模式，涵蓋 Arrow Functions 到 Iterator Helpers 的全方位演進。"
3
+ description: >
4
+ Use this skill when writing, reviewing, debugging, or modernizing JavaScript across
5
+ browser, Node.js, and pure JS projects. Trigger for ES module/CommonJS issues,
6
+ async patterns, functional array/set/iterator code, DOM/runtime behavior, or
7
+ version-aware ECMAScript syntax.
6
8
  compatibility: "Supports ES6 (ES2015) through ES2025 and Stage 3+ proposals. Adaptive to modern browser environments and pure JS runtimes."
9
+ metadata:
10
+ version: "1.0.0"
11
+ category: "Core"
7
12
  ---
8
13
 
9
14
  # Modern JavaScript (ES6+) Expert Skill
@@ -84,7 +89,7 @@ compatibility: "Supports ES6 (ES2015) through ES2025 and Stage 3+ proposals. Ada
84
89
  - **Immutable Array Methods:** `toSorted()`, `toReversed()`, `toSpliced()`, `with()` — return new arrays without mutation.
85
90
  - **`Array.findLast()` / `findLastIndex()`:** Search arrays from the end.
86
91
 
87
- ### ES2024 & ES2025+ (Cutting Edge)
92
+ ### ES2024 & ES2025+ (Version-Specific Features)
88
93
  - **`Promise.withResolvers()`:** Destructure `{ promise, resolve, reject }` for cleaner deferred patterns.
89
94
  - **`Object.groupBy()` / `Map.groupBy()`:** Group array elements by a classifier function.
90
95
  - **Set Methods:** `union()`, `intersection()`, `difference()`, `symmetricDifference()`, `isSubsetOf()`, `isSupersetOf()`, `isDisjointFrom()`.
@@ -122,4 +127,4 @@ compatibility: "Supports ES6 (ES2015) through ES2025 and Stage 3+ proposals. Ada
122
127
  ### Internal References
123
128
  - [JavaScript Coding Style and Naming Conventions Guide](reference/coding-style.md)
124
129
  - [JavaScript Anti-Patterns and Best Practices](reference/anti-patterns.md)
125
- - [Modern JavaScript Patterns Guide](reference/patterns.md)
130
+ - [Modern JavaScript Patterns Guide](reference/patterns.md)
package/skills/neo-python/SKILL.md CHANGED
@@ -1,9 +1,13 @@
1
1
  ---
2
2
  name: neo-python
3
- version: "1.0.0"
4
- category: "Core"
5
- description: "用於 Python 3.10+ 開發的核心專家技能。專注於現代 Python 特性（Structural Pattern Matching, Union Types, Async Task Groups）、程式碼品質與架構設計。"
3
+ description: >
4
+ Use this skill when writing, reviewing, debugging, or architecting Python 3.10+
5
+ code, including type hints, structural pattern matching, dataclasses, async/task
6
+ groups, packaging-aware project structure, testability, and maintainability.
6
7
  compatibility: "Supports Python 3.10 to 3.14. Requires a Python project structure (pyproject.toml, requirements.txt, or venv)."
8
+ metadata:
9
+ version: "1.0.0"
10
+ category: "Core"
7
11
  ---
8
12
 
9
13
  # Python 3.10+ Expert Skill
package/skills/neo-python-manager/SKILL.md CHANGED
@@ -1,9 +1,14 @@
1
1
  ---
2
2
  name: neo-python-manager
3
- version: "1.1.0"
4
- category: "Environment"
5
- description: "智慧偵測與管理 Python 專案的虛擬環境與依賴套件工具（支援 uv, Poetry, venv/pip），包含工具安裝導引。"
3
+ description: >
4
+ Use this skill when the user asks how to install, add, remove, update, or run
5
+ Python dependencies; choose between uv, Poetry, venv, or pip; create/sync a virtual
6
+ environment; or diagnose Python package manager setup from pyproject.toml, lock
7
+ files, or requirements.txt.
6
8
  compatibility: "Supports any Python project containing pyproject.toml, requirements.txt, uv.lock, or poetry.lock."
9
+ metadata:
10
+ version: "1.1.0"
11
+ category: "Environment"
7
12
  ---
8
13
 
9
14
  # Python Environment Manager Skill
package/skills/neo-rust/SKILL.md CHANGED
@@ -1,7 +1,10 @@
1
1
  ---
2
2
  name: neo-rust
3
3
  description: >
4
- Develop, refactor, or audit Rust code, covering ownership, borrowing, lifetimes, Result/Option error handling, and modern Rust design patterns. Use this skill when the user needs to write Rust programs, perform Rust Code Reviews, optimize performance (e.g., avoiding unnecessary .clone()), or discuss Rust system architecture, even if they do not explicitly say "Rust" as long as .rs files or a Cargo project are involved.
4
+ Use this skill when writing, refactoring, debugging, or auditing Rust code. Trigger
5
+ for .rs files, Cargo projects, ownership/borrowing/lifetime issues, Result/Option
6
+ error handling, unnecessary clone/performance work, unsafe code review, or modern
7
+ Rust architecture.
5
8
  license: MIT
6
9
  compatibility: Requires environment with Rust toolchain (rustc, cargo) installed
7
10
  metadata:
package/skills/neo-stop-slop/SKILL.md CHANGED
@@ -1,11 +1,10 @@
1
1
  ---
2
2
  name: neo-stop-slop
3
3
  description: >
4
- Remove AI writing patterns, tells, and slop from prose, technical drafts, code comments,
5
- git commit messages, or pull request descriptions. Supports both Traditional Chinese and English.
6
- Use this skill when the user wants to polish, edit, rewrite, or review drafts to make them sound
7
- more natural, concise, and direct, or when they ask to eliminate AI tells/slop, even if they don't
8
- explicitly say "stop-slop".
4
+ Use this skill when the user wants to polish, rewrite, shorten, or review prose so
5
+ it sounds natural rather than AI-generated. Trigger for Traditional Chinese or English
6
+ drafts, technical docs, code comments, commit messages, PR descriptions, sales copy,
7
+ and requests to remove AI tells, slop, fluff, or formulaic phrasing.
9
8
  license: MIT
10
9
  compatibility: Requires Node.js (ESM) to run the analyze-slop.js script.
11
10
  metadata:
package/skills/neo-sub-agent/SKILL.md CHANGED
@@ -1,7 +1,10 @@
1
1
  ---
2
2
  name: neo-sub-agent
3
3
  description: >
4
- 設計、建立、審查或轉換跨 CLI sub-agent、custom agent、worker agent、reviewer agent、planner agent、explorer agent、background agent 與 multi-agent workflow。Use this skill when the user asks to add a sub agent, create a custom agent, design agent delegation, or generate agent files for Antigravity CLI, Codex, Claude Code, or GitHub Copilot CLI.
4
+ Use this skill when the user asks to design, create, review, or convert sub-agents,
5
+ custom agents, worker/reviewer/planner agents, background agents, or multi-agent
6
+ workflows for Antigravity CLI, Codex, Claude Code, GitHub Copilot CLI, or neutral
7
+ agent blueprints.
5
8
  ---
6
9
 
7
10
  # Neo Sub-Agent
package/skills/neo-swift/SKILL.md CHANGED
@@ -1,9 +1,14 @@
1
1
  ---
2
2
  name: neo-swift
3
- version: "1.0.0"
4
- category: "Language"
5
- description: "Swift 專家技能 (5.0+)。支援從基礎語法到 Swift 6 的現代開發模式，涵蓋 SwiftUI、Structured Concurrency、記憶體安全以及高效能 App 開發指引。"
3
+ description: >
4
+ Use this skill when writing, reviewing, debugging, or modernizing Swift code for
5
+ iOS, macOS, server-side Swift, or shared packages. Trigger for Swift 5+ language
6
+ features, structured concurrency, memory safety, protocols/generics, SwiftUI
7
+ integration, and performance-sensitive code.
6
8
  compatibility: "Supports Swift 5.0 through 6.0+. Adaptive to iOS, macOS, and Server-side Swift environments."
9
+ metadata:
10
+ version: "1.0.0"
11
+ category: "Language"
7
12
  ---
8
13
 
9
14
  # Modern Swift (5.0+) Expert Skill
package/skills/neo-swift-ui/SKILL.md CHANGED
@@ -1,9 +1,14 @@
1
1
  ---
2
2
  name: neo-swift-ui
3
- version: "1.0.0"
4
- category: "UI Framework"
5
- description: "SwiftUI 專家技能 (iOS 16.0+)。支援從宣告式 UI 基礎到 iOS 18+ 的現代開發模式，涵蓋 NavigationStack、Observation 框架、資料流架構及高效能視圖設計。"
3
+ description: >
4
+ Use this skill when building, debugging, refactoring, or reviewing SwiftUI apps
5
+ or views for iOS 16+ and related Apple platforms. Trigger for NavigationStack,
6
+ Observation/state flow, view composition, previews, performance, accessibility,
7
+ and SwiftUI architecture.
6
8
  compatibility: "Requires iOS 16.0+, Swift 5.0+. Adaptive to modern iOS, iPadOS, and macOS SwiftUI development."
9
+ metadata:
10
+ version: "1.0.0"
11
+ category: "UI Framework"
7
12
  ---
8
13
 
9
14
  # Modern SwiftUI (iOS 16+) Expert Skill
package/skills/neo-typescript/SKILL.md CHANGED
@@ -1,7 +1,10 @@
1
1
  ---
2
2
  name: neo-typescript
3
3
  description: >
4
- Use this skill when asked to write, review, debug, or architect TypeScript code, configure tsconfig.json compiler options, resolve ESM/CJS interop issues, optimize generics, or apply advanced conditional, mapped, and template literal type operators. Trigger even if the user just asks generic TS compiler or type compatibility questions.
4
+ Use this skill when writing, reviewing, debugging, or architecting TypeScript code.
5
+ Trigger for tsconfig/compiler options, strict mode, generics, conditional/mapped/template
6
+ literal types, structural typing, ESM/CJS interop, decorators, library typing, or
7
+ TypeScript runtime boundary issues.
5
8
  license: MIT
6
9
  metadata:
7
10
  author: ant-gravity-devs
package/skills/neo-vue/SKILL.md CHANGED
@@ -1,9 +1,10 @@
1
1
  ---
2
2
  name: neo-vue
3
3
  description: >
4
- 當建置、調試、重構或審查 Vue.js 應用程式、Vue 3 單一檔案元件 (SFC)、Pinia 狀態管理或 Vue Router 配置時使用此技能。
5
- 當專案包含 *.vue 檔案，或使用者提及「Vue」、「Pinia」、「Composition API」或「Vue Router」時觸發，
6
- 即使他們沒有明確要求 Vue 專家也適用。
4
+ Use this skill when building, debugging, refactoring, or reviewing Vue 3 applications,
5
+ SFCs, Composition API, Pinia stores, Vue Router, Vite, or Vue+TypeScript code.
6
+ Trigger when the project has *.vue files or the user mentions Vue, Pinia, Composition
7
+ API, Router, reactivity, or component architecture.
7
8
  license: MIT
8
9
  compatibility: 支援 Vue 3.x (Composition API), Pinia 2.x, Vue Router 4.x, 以及 Vite 與 TypeScript。
9
10
  metadata:
@@ -14,15 +15,15 @@ metadata:
14
15
 
15
16
  # Modern Vue 3 & Pinia 開發專家 (neo-vue)
16
17
 
17
- 本技能旨在為 Agent 提供現代 Vue 3 (Composition API) 與 Pinia 狀態管理的開發與審查指南。它能確保產出的代碼完全符合官方 Vue Style Guide（優先級 A 與 B 級）的最佳實踐，避免常見的響應性陷阱（Reactivity Gotchas），並生成具備高質感與強型別的單一檔案元件（SFC）。
18
+ 本技能為 Agent 提供 Vue 3 (Composition API) 與 Pinia 狀態管理的開發與審查指南。它協助產出符合 Vue Style Guide 優先級 A/B 規則的程式碼，避開常見響應式陷阱，並生成一致、強型別的單一檔案元件（SFC）。
18
19
 
19
20
  ## Gotchas
20
21
  * **解構 reactive 物件導致響應性丟失**：禁止直接解構 `props` 或由 `reactive()` 定義的物件（例如：`const { name } = props` 或 `const { x } = state`），這會徹底失去 Vue 響應式追蹤！
21
22
  * **防錯機制**：必須使用 `toRefs(props)` 或 `toRef(props, 'name')` 來保持其響應性。
22
23
  * **解構 Pinia Store 導致狀態響應性丟失**：直接解構 Pinia store 的 state（如 `const { user } = useAuthStore()`）會使 state 失去雙向響應！
23
24
  * **防錯機制**：必須使用 `storeToRefs(store)` 來解構 state；而 action 則可以直接正常解構。
24
- * **v-model 手動繁瑣綁定**：在 Vue 3.4 之前，自定義雙向綁定需要手動宣告 `modelValue` 屬性並觸發 `update:modelValue` 事件，這對 AI 而言極易寫錯。
25
- * **防錯機制**：在 Vue 3.4+ 專案中，**強烈推薦**使用 `defineModel()` 巨集進行聲明，這會自動為您處理好屬性與事件，極大簡化程式碼。
25
+ * **v-model 手動繁瑣綁定**：在 Vue 3.4 之前，自定義雙向綁定需要手動宣告 `modelValue` 屬性並觸發 `update:modelValue` 事件，容易寫錯。
26
+ * **防錯機制**：在 Vue 3.4+ 專案中，優先使用 `defineModel()` 巨集宣告雙向綁定，降低屬性與事件不一致的風險。
26
27
  * **v-if 與 v-for 在同一節點混用**：在 Vue 3 中，`v-if` 的優先級高於 `v-for`，這意味著 `v-if` 的條件判斷**無法**存取到 `v-for` 迴圈中的變數，會直接導致編譯或執行期報錯！
27
28
  * **防錯機制**：永遠使用 `<template>` 標籤包裹 `v-for`，再於內部子節點使用 `v-if`，或者預先使用 `computed` 計算屬性對陣列進行過濾。
28
29
 
@@ -31,7 +32,7 @@ Progress:
31
32
  - [ ] 步驟 1：感知專案環境與依賴 (Perceive Setup & Tooling)
32
33
  - [ ] 步驟 2：載入編碼規範與踩坑指南 (Load Guides & Best Practices)
33
34
  - [ ] 步驟 3：架構推理與響應式規劃 (Reasoning & Architecture)
34
- - [ ] 步驟 4：套用範本生成高品質代碼 (Generate SFC & Stores)
35
+ - [ ] 步驟 4：套用範本生成一致的程式碼 (Generate SFC & Stores)
35
36
  - [ ] 步驟 5：程式碼健檢與自我校對 (Code Quality Review)
36
37
 
37
38
  ---
@@ -53,9 +54,9 @@ Progress:
53
54
  1. **Reactivity 選擇**：除非是多個屬性需要高度關聯的複雜物件，否則**優先使用 `ref()`** 而不是 `reactive()`，以確保存取 `.value` 的一致性並避免解構失活。
54
55
  2. **狀態下沉**：評估狀態是屬於組件局部狀態（用 `ref`）還是全局狀態（用 `Pinia Setup Store`）。
55
56
 
56
- ### 步驟 4 — 套用範本生成高品質代碼 (Act)
57
- 1. **SFC 結構**：新建立的元件必須使用 `<script setup>` 語法，並強烈推薦加入 `lang="ts"`。
58
- 2. **套用範本**：讀取並參考 `assets/Vue3SFCComponentTemplate.vue` 作為高質感、標準 Vue 3 元件的排版範例。
57
+ ### 步驟 4 — 套用範本生成一致的程式碼 (Act)
58
+ 1. **SFC 結構**：新建立的元件必須使用 `<script setup>` 語法，並依專案設定優先加入 `lang="ts"`。
59
+ 2. **套用範本**：讀取並參考 `assets/Vue3SFCComponentTemplate.vue` 作為標準 Vue 3 元件的排版範例。
59
60
  3. **強制語言與風格**：所有程式碼註解、說明必須使用 **Traditional Chinese (Taiwan)**。專用術語需對齊（例如：元件、屬性、狀態管理、響應式、雙向綁定、計算屬性）。
60
61
 
61
62
  ### 步驟 5 — 程式碼健檢與自我校對 (Act)
@@ -67,7 +68,7 @@ Progress:
67
68
 
68
69
  ## Output Templates
69
70
 
70
- 在生成新組件時，請嚴格按照以下高質感結構輸出（更多實作細節請參閱 `assets/Vue3SFCComponentTemplate.vue`）：
71
+ 生成新元件時，依照以下一致結構輸出；更多實作細節請參閱 `assets/Vue3SFCComponentTemplate.vue`：
71
72
 
72
73
  ```vue
73
74
  <template>
@@ -110,4 +111,4 @@ function handleAction() {
110
111
  flex-direction: column;
111
112
  }
112
113
  </style>
113
- ```
114
+ ```