@moon791017/neo-skills 1.1.28 → 1.1.29

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 (2) hide show
  1. package/README.md +30 -30
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -7,46 +7,46 @@
7
7
  <img src="images/banner.png" alt="Neo Skills extension banner" width="100%">
8
8
  </p>
9
9
 
10
- **Neo Skills** 是一組給 AI Agent 使用的專家技能模組。它把語言、框架、DevOps、Code Review、需求釐清、Agent 治理與文字潤飾等工作流程包成可安裝的 `SKILL.md`，讓支援 Agent Skills 的工具能在需要時載入精準知識，而不是把所有規則塞進一段大型系統提示詞。
10
+ **Neo Skills** 提供可安裝的 AI Agent 技能模組。每個技能以 `SKILL.md` 定義，涵蓋語言、框架、DevOps、Code Review、需求釐清、Agent 治理與文字潤飾。支援 Agent Skills 的工具可以在需要時載入完整規則，不必把所有規則放進單一系統提示詞。
11
11
 
12
- 目前專案提供：
12
+ 專案包含：
13
13
 
14
- - `skills/`：內建多個專家技能。
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`：非互動式技能結構驗證工具。
14
+ - `skills/`：內建技能模組。
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`：非互動式技能結構與語法驗證工具。
18
18
 
19
19
  ## 適合誰
20
20
 
21
- - 想讓 AI Agent 穩定遵守專案規範的開發者。
22
- - 想把常用工作流程整理成可重複觸發技能的團隊。
21
+ - 希望 AI Agent 遵守專案規範的開發者。
22
+ - 希望將常用工作流程整理成可重複觸發技能的團隊。
23
23
  - 使用 Antigravity CLI、Codex、Claude Code、Copilot CLI 或其他相容 Agent Skills 工具的人。
24
- - 需要把 AI 輔助開發從「靠提示詞」提升到「有知識庫、範本、腳本、驗證」的人。
24
+ - 需要以知識庫、範本、腳本和驗證支援 AI 輔助開發的人。
25
25
 
26
26
  ## 核心設計
27
27
 
28
28
  | 機制 | 說明 |
29
29
  | :--- | :--- |
30
- | 漸進式揭露 | Agent 啟動時只讀 `name` 與 `description`；真正需要時才讀完整 `SKILL.md` 與 references。 |
31
- | 觸發導向描述 | 每個 skill 的 `description` 都說明「何時使用」，提升自動觸發準確度。 |
30
+ | 漸進式揭露 | Agent 啟動時只讀取 `name` 與 `description`；需要技能時才載入完整 `SKILL.md` 與 references。 |
31
+ | 觸發導向描述 | 每個 skill 的 `description` 都標明使用時機，供 Agent 判斷何時載入。 |
32
32
  | 外部知識庫 | 詳細規則放在 `references/` 或 `reference/`，避免主技能檔過長。 |
33
- | 可重用資源 | 透過 `assets/`、`templates/` 與 `scripts/` 提供可實踐的產出基礎。 |
33
+ | 可重用資源 | `assets/`、`templates/` 與 `scripts/` 提供可直接使用的資源。 |
34
34
  | 可驗證結構 | 使用 `scripts/check-skills-syntax.py` 檢查技能名稱、frontmatter 與基本規格。 |
35
35
 
36
36
  ## 內建技能
37
37
 
38
38
  | 類別 | Skill | 使用時機 |
39
39
  | :--- | :--- | :--- |
40
- | Agent 治理 | `neo-harness` | 掃描專案環境，自動產生或升級專屬且合規的 AGENTS.md 檔，整合 Harness 評估、閉環 Workflow 與編排架構。 |
40
+ | Agent 治理 | `neo-harness` | 自動掃描專案環境，產生或更新專案專用的 AGENTS.md，並整合 Harness 評估、Workflow 與編排架構。 |
41
41
  | 資訊安全 | `neo-iso-27001` | 依 ISO/IEC 27001 進行 ISMS 範圍、風險、證據、差距分析、稽核準備與改善計畫。 |
42
42
  | 隱私管理 | `neo-iso-27701` | 依 ISO/IEC 27701 進行 PIMS、PII 角色、處理活動、隱私風險、證據與稽核準備。 |
43
43
  | DevOps | `neo-azure-pipelines` | 建立、審查、除錯或現代化 Azure Pipelines YAML，尤其是 .NET build、Azure App Service 或 IIS 部署。 |
44
- | 需求釐清 | `neo-clarification` | 將模糊、情緒化、片段式、截圖式需求轉成規格、驗收條件或釐清問題。 |
45
- | Code Review | `neo-code-review` | 進行程式碼審查、PR/diff review、bug 風險掃描、安全性、效能或可維護性檢查。 |
46
- | 系統架構 | `neo-clean-architecture` | 設計、實作、審查或重構符合 Clean Architecture 原則的系統，劃分層級並排除特定技術依賴。 |
44
+ | 需求釐清 | `neo-clarification` | 將模糊、情緒化、片段式或截圖式需求整理成規格、驗收條件和待釐清問題。 |
45
+ | Code Review | `neo-code-review` | 檢查程式碼、PR/diff、bug 風險、安全性、效能與可維護性。 |
46
+ | 系統架構 | `neo-clean-architecture` | 依 Clean Architecture 原則設計、實作、審查或重構系統，劃分層級並移除特定技術依賴。 |
47
47
  | C# | `neo-csharp` | 撰寫、審查、除錯或現代化 C#/.NET 程式碼，包含語言版本、NRT、records、pattern matching 與 async。 |
48
48
  | C# | `neo-csharp-interface-generator` | 從 C# class 產生或更新 interface，並安全建立、追加或替換 interface block。 |
49
- | .NET | `neo-dotnet` | 廣泛 .NET 問題或尚未確定子領域時，先偵測 SDK/project shape 並導向合適技能。 |
49
+ | .NET | `neo-dotnet` | 處理一般 .NET 問題；當子領域尚未確定時，先偵測 SDK/project shape，再導向合適技能。 |
50
50
  | .NET | `neo-dotnet-minimal-apis` | 建置或審查 ASP.NET Core Minimal APIs、route groups、endpoint filters、typed results 或 OpenAPI metadata。 |
51
51
  | .NET | `neo-dotnet-webapi` | 建置或審查 controller-based ASP.NET Core Web API、Problem Details、API versioning 與 DTO。 |
52
52
  | .NET | `neo-dotnet-mvc` | 建置或審查 ASP.NET Core MVC、Razor views、ViewModels、Tag Helpers、View Components 與 SSR workflows。 |
@@ -61,25 +61,25 @@
61
61
  | TypeScript | `neo-typescript` | 處理 TypeScript、tsconfig、strict mode、泛型、conditional/mapped/template literal types、ESM/CJS 與 runtime boundaries。 |
62
62
  | Vue | `neo-vue` | 建置、除錯、重構或審查 Vue 3、SFC、Composition API、Pinia、Vue Router、Vite 與 Vue+TypeScript。 |
63
63
  | Agent 架構 | `neo-sub-agent` | 設計、建立、審查或轉換 sub-agent、custom agent、worker/reviewer/planner agent 或 multi-agent workflow。 |
64
- | 技能開發 | `generate-skill` | 建立、更新、審查或最佳化 Agent Skill，包含規格、觸發描述、延伸資源、評估資料與設計模式。 |
64
+ | 技能開發 | `generate-skill` | 建立、更新、審查或最佳化 Agent Skill，包括規格、觸發描述、延伸資源、評估資料和設計模式。 |
65
65
  | 可觀測性 | `neo-opentelemetry` | 解釋 OpenTelemetry 概念、規劃或審查 Collector 架構與設定、處理維運排障、安全、零程式 instrumentation 及相容性遷移。 |
66
66
  | queue | `neo-rabbitmq` | 以 RabbitMQ 4.3 為預設，提供語言中立的訊息拓撲、Broker 營運、監控排障與效能優化指引。 |
67
- | 文字潤飾 | `neo-stop-slop` | 去除繁中或英文中的 AI 腔、贅詞、公式化句式，支援文件、註解、commit message 與 PR 說明。 |
68
- | PR 產出 | `neo-pr` | 詢問或自動偵測 Repository 來源與目標分支，擷取變更並產生重點式且去 AI 腔的 PR Title 與 PR Description。 |
67
+ | 文字潤飾 | `neo-stop-slop` | 去除繁中或英文中的 AI 腔、贅詞和公式化句式，適用於文件、註解、commit message 和 PR 說明。 |
68
+ | PR 產出 | `neo-pr` | 詢問或自動偵測 Repository 的來源與目標分支，擷取變更，產生重點式且自然的 PR Title 和 PR Description。 |
69
69
 
70
- `generate-skill` 位於 `.agents/skills/`，可由 Agent Skills CLI 探索與安裝；其餘技能位於 `skills/`。
70
+ `generate-skill` 位於 `.agents/skills/`，可由 Agent Skills CLI 探索和安裝；其餘技能位於 `skills/`。
71
71
 
72
72
  ## 安裝
73
73
 
74
74
  ### Antigravity CLI 全域安裝
75
75
 
76
- 同步 `skills/` 下的技能到 `~/.gemini/antigravity-cli/skills`：
76
+ 將 `skills/` 下的技能同步至 `~/.gemini/antigravity-cli/skills`：
77
77
 
78
78
  ```bash
79
79
  npx -y @moon791017/neo-skills@latest
80
80
  ```
81
81
 
82
- 本地開發時可直接執行：
82
+ 本地開發：
83
83
 
84
84
  ```bash
85
85
  node bin/install-skills.js
@@ -87,13 +87,13 @@ node bin/install-skills.js
87
87
 
88
88
  ### Agent Skills CLI 安裝
89
89
 
90
- 安裝全部技能到目前專案：
90
+ 在目前專案安裝全部技能：
91
91
 
92
92
  ```bash
93
93
  npx skills add Benknightdark/neo-skills --skill --all -y
94
94
  ```
95
95
 
96
- 安裝全部技能到全域：
96
+ 在全域安裝全部技能：
97
97
 
98
98
  ```bash
99
99
  npx skills add Benknightdark/neo-skills --skill --all -g -y
@@ -101,13 +101,13 @@ npx skills add Benknightdark/neo-skills --skill --all -g -y
101
101
 
102
102
  ## 系統提示詞安裝
103
103
 
104
- Agent Skills 規格同步的是技能目錄；`AGENTS.md`、`CLAUDE.md`、Copilot instructions 或 Antigravity `agents.md` 這類指導檔需要另外安裝。
104
+ Agent Skills 規格會同步技能目錄；`AGENTS.md`、`CLAUDE.md`、Copilot instructions 或 Antigravity `agents.md` 等指導檔需要另外安裝。
105
105
 
106
106
  ```bash
107
107
  npx -p @moon791017/neo-skills install-system-instructions --instructions technical-co-founder
108
108
  ```
109
109
 
110
- 指定 Agent 與專案路徑：
110
+ 指定 Agent 和專案路徑：
111
111
 
112
112
  ```bash
113
113
  npx -p @moon791017/neo-skills install-system-instructions \
@@ -116,7 +116,7 @@ npx -p @moon791017/neo-skills install-system-instructions \
116
116
  --project-path .
117
117
  ```
118
118
 
119
- 更新已安裝過的同一段提示詞：
119
+ 更新已安裝的提示詞：
120
120
 
121
121
  ```bash
122
122
  npx -p @moon791017/neo-skills install-system-instructions \
@@ -139,10 +139,10 @@ npx -p @moon791017/neo-skills install-system-instructions \
139
139
 
140
140
  | Key | 用途 |
141
141
  | :--- | :--- |
142
- | `technical-co-founder` | 讓 Agent 以 Discovery、Planning、Building、Polish、Handoff 流程協助打造可交付產品。 |
142
+ | `technical-co-founder` | 讓 Agent 依 Discovery、Planning、Building、Polish、Handoff 流程協助交付產品。 |
143
143
  | `git-commit` | 要求 commit message 遵守 Conventional Commits 1.0.0，並使用使用者偏好的語言。 |
144
144
  | `fact-check` | 要求 Agent 根據來源與證據回答，資料不足時明確說不能確定。 |
145
- | `minimal-output` | 約束 Agent 在執行建置、部署、測試與格式化時採用最小化輸出參數，保護 Context 空間。 |
145
+ | `minimal-output` | 要求 Agent 在執行建置、部署、測試和格式化時使用最小輸出，保留 Context 空間。 |
146
146
 
147
147
  ## 常用情境
148
148
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@moon791017/neo-skills",
3
- "version": "1.1.28",
3
+ "version": "1.1.29",
4
4
  "type": "module",
5
5
  "description": "Neo Skills: A Universal AI Agent Skills Extension",
6
6
  "homepage": "https://neo-blog-iota.vercel.app/",