@moon791017/neo-skills 1.0.16 → 1.0.18

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 (66) hide show
  1. package/GEMINI.md +1 -1
  2. package/README.md +27 -12
  3. package/bin/_utils.js +29 -9
  4. package/commands/neo/cd-app-service.toml +2 -2
  5. package/commands/neo/cd-iis.toml +2 -2
  6. package/commands/neo/ci-dotnet.toml +3 -3
  7. package/commands/neo/clarification.toml +2 -2
  8. package/commands/neo/code-review.toml +2 -2
  9. package/commands/neo/dotnet-gen-interface.toml +1 -1
  10. package/commands/neo/explain.toml +2 -2
  11. package/gemini-extension.json +1 -1
  12. package/package.json +1 -1
  13. package/skills/{azure-pipelines → neo-azure-pipelines}/SKILL.md +4 -4
  14. package/skills/{clarification → neo-clarification}/SKILL.md +1 -1
  15. package/skills/{code-review → neo-code-review}/SKILL.md +1 -1
  16. package/skills/{csharp → neo-csharp}/SKILL.md +1 -1
  17. package/skills/{csharp-interface-generator → neo-csharp-interface-generator}/SKILL.md +1 -1
  18. package/skills/{dotnet → neo-dotnet}/SKILL.md +5 -5
  19. package/skills/{dotnet-ef-core → neo-dotnet-ef-core}/SKILL.md +1 -1
  20. package/skills/{dotnet-minimal-apis → neo-dotnet-minimal-apis}/SKILL.md +1 -1
  21. package/skills/{dotnet-mvc → neo-dotnet-mvc}/SKILL.md +1 -1
  22. package/skills/{dotnet-webapi → neo-dotnet-webapi}/SKILL.md +1 -1
  23. package/skills/{explain → neo-explain}/SKILL.md +1 -1
  24. package/skills/{git-commit → neo-git-commit}/SKILL.md +1 -1
  25. package/skills/{python → neo-python}/SKILL.md +2 -2
  26. package/skills/{python-manager → neo-python-manager}/SKILL.md +1 -1
  27. package/skills/{start-plan → neo-start-plan}/SKILL.md +1 -1
  28. package/skills/{swift → neo-swift}/SKILL.md +1 -1
  29. package/skills/{swift-ui → neo-swift-ui}/SKILL.md +1 -1
  30. /package/skills/{azure-pipelines → neo-azure-pipelines}/templates/build/build-dotnet.yml +0 -0
  31. /package/skills/{azure-pipelines → neo-azure-pipelines}/templates/deploy/deploy-app-service.yml +0 -0
  32. /package/skills/{azure-pipelines → neo-azure-pipelines}/templates/deploy/deploy-iis.yml +0 -0
  33. /package/skills/{azure-pipelines → neo-azure-pipelines}/templates/util/clean-artifact.yml +0 -0
  34. /package/skills/{azure-pipelines → neo-azure-pipelines}/templates/util/extract-artifact.yml +0 -0
  35. /package/skills/{azure-pipelines → neo-azure-pipelines}/templates/util/iis/iis-backup.yml +0 -0
  36. /package/skills/{azure-pipelines → neo-azure-pipelines}/templates/util/iis/iis-deploy-files.yml +0 -0
  37. /package/skills/{azure-pipelines → neo-azure-pipelines}/templates/util/iis/iis-manage-website.yml +0 -0
  38. /package/skills/{azure-pipelines → neo-azure-pipelines}/templates/util/iis/iis-rollback.yml +0 -0
  39. /package/skills/{azure-pipelines → neo-azure-pipelines}/templates/util/iis/iis-start-website.yml +0 -0
  40. /package/skills/{azure-pipelines → neo-azure-pipelines}/templates/util/iis/iis-stop-website.yml +0 -0
  41. /package/skills/{azure-pipelines → neo-azure-pipelines}/templates/util/iis/iis-task.yml +0 -0
  42. /package/skills/{azure-pipelines → neo-azure-pipelines}/templates/util/set-aspnetcore-env.yml +0 -0
  43. /package/skills/{csharp → neo-csharp}/reference/anti-patterns.md +0 -0
  44. /package/skills/{csharp → neo-csharp}/reference/coding-style.md +0 -0
  45. /package/skills/{csharp → neo-csharp}/reference/patterns.md +0 -0
  46. /package/skills/{dotnet-ef-core → neo-dotnet-ef-core}/reference/anti-patterns.md +0 -0
  47. /package/skills/{dotnet-ef-core → neo-dotnet-ef-core}/reference/coding-style.md +0 -0
  48. /package/skills/{dotnet-ef-core → neo-dotnet-ef-core}/reference/patterns.md +0 -0
  49. /package/skills/{dotnet-minimal-apis → neo-dotnet-minimal-apis}/reference/anti-patterns.md +0 -0
  50. /package/skills/{dotnet-minimal-apis → neo-dotnet-minimal-apis}/reference/coding-style.md +0 -0
  51. /package/skills/{dotnet-minimal-apis → neo-dotnet-minimal-apis}/reference/patterns.md +0 -0
  52. /package/skills/{dotnet-mvc → neo-dotnet-mvc}/reference/anti-patterns.md +0 -0
  53. /package/skills/{dotnet-mvc → neo-dotnet-mvc}/reference/coding-style.md +0 -0
  54. /package/skills/{dotnet-mvc → neo-dotnet-mvc}/reference/patterns.md +0 -0
  55. /package/skills/{dotnet-webapi → neo-dotnet-webapi}/reference/anti-patterns.md +0 -0
  56. /package/skills/{dotnet-webapi → neo-dotnet-webapi}/reference/coding-style.md +0 -0
  57. /package/skills/{dotnet-webapi → neo-dotnet-webapi}/reference/patterns.md +0 -0
  58. /package/skills/{python → neo-python}/reference/anti-patterns.md +0 -0
  59. /package/skills/{python → neo-python}/reference/coding-style.md +0 -0
  60. /package/skills/{python → neo-python}/reference/patterns.md +0 -0
  61. /package/skills/{swift → neo-swift}/reference/anti-patterns.md +0 -0
  62. /package/skills/{swift → neo-swift}/reference/coding-style.md +0 -0
  63. /package/skills/{swift → neo-swift}/reference/patterns.md +0 -0
  64. /package/skills/{swift-ui → neo-swift-ui}/reference/anti-patterns.md +0 -0
  65. /package/skills/{swift-ui → neo-swift-ui}/reference/coding-style.md +0 -0
  66. /package/skills/{swift-ui → neo-swift-ui}/reference/patterns.md +0 -0
package/GEMINI.md CHANGED
@@ -30,7 +30,7 @@ Each subdirectory represents a "Skill Module" containing expert knowledge.
30
30
  * **Structure:**
31
31
  * `SKILL.md`: The "Brain". Defines the **Perceive-Reason-Act** loop for the domain. It instructs the agent on how to analyze the environment and make decisions.
32
32
  * `templates/`: The "Hands". A library of reusable assets that the agent should use instead of writing code from scratch.
33
- * **Example:** `skills/azure-pipelines/` contains logic for designing CI/CD pipelines and templates for .NET builds, IIS deployments, etc.
33
+ * **Example:** `skills/neo-azure-pipelines/` contains logic for designing CI/CD pipelines and templates for .NET builds, IIS deployments, etc.
34
34
 
35
35
  ### 3. The Action Registry (`commands/`)
36
36
  Defines rigid, executable workflows triggered by the user.
package/README.md CHANGED
@@ -31,21 +31,21 @@
31
31
  * **技術解析 (`neo:explain`)**:深入分析原始碼或專案結構,提供高階用途摘要、邏輯流程分解以及核心元件說明。
32
32
 
33
33
  ### 5. .NET / C# 開發專家
34
- * **C# 現代語法專家 (`skills/csharp`)**:跨版本 C# 專家 (10-14+),專注於現代化語法、強型別與高效能開發模式。
35
- * **.NET 核心路由 (`skills/dotnet`)**:環境偵測與統一入口,自動將任務委派給最合適的子領域專家。
36
- * **.NET Minimal APIs 專家 (`skills/dotnet-minimal-apis`)**:專注於高效能微服務、路由群組與 Typed Results。
37
- * **.NET Web API 專家 (`skills/dotnet-webapi`)**:提供控制器模式下的架構設計、Problem Details 與異常處理指引。
38
- * **.NET MVC 專家 (`skills/dotnet-mvc`)**:處理伺服器端渲染 (SSR)、視圖模型與標籤協助程式的最佳實踐。
39
- * **EF Core 專家 (`skills/dotnet-ef-core`)**:專注於資料庫建模、移轉管理與 Linq 查詢優化。
34
+ * **C# 現代語法專家 (`skills/neo-csharp`)**:跨版本 C# 專家 (10-14+),專注於現代化語法、強型別與高效能開發模式。
35
+ * **.NET 核心路由 (`skills/neo-dotnet`)**:環境偵測與統一入口,自動將任務委派給最合適的子領域專家。
36
+ * **.NET Minimal APIs 專家 (`skills/neo-dotnet-minimal-apis`)**:專注於高效能微服務、路由群組與 Typed Results。
37
+ * **.NET Web API 專家 (`skills/neo-dotnet-webapi`)**:提供控制器模式下的架構設計、Problem Details 與異常處理指引。
38
+ * **.NET MVC 專家 (`skills/neo-dotnet-mvc`)**:處理伺服器端渲染 (SSR)、視圖模型與標籤協助程式的最佳實踐。
39
+ * **EF Core 專家 (`skills/neo-dotnet-ef-core`)**:專注於資料庫建模、移轉管理與 Linq 查詢優化。
40
40
  * **Interface 生成器 (`neo:dotnet-gen-interface`)**:針對 C# Class 自動生成符合規範的 Interface,並支援智慧檔案覆蓋功能。
41
41
 
42
42
  ### 6. Python 開發與環境管理專家
43
- * **Python 3.10+ 專家 (`skills/python`)**:專注於 Python 3.10 至 3.14 的現代語法特性、型別安全與非同步開發。
44
- * **環境管理專家 (`skills/python-manager`)**:智慧偵測與管理 Python 專案環境,支援 uv, Poetry, venv/pip 並提供自動化安裝建議。
43
+ * **Python 3.10+ 專家 (`skills/neo-python`)**:專注於 Python 3.10 至 3.14 的現代語法特性、型別安全與非同步開發。
44
+ * **環境管理專家 (`skills/neo-python-manager`)**:智慧偵測與管理 Python 專案環境,支援 uv, Poetry, venv/pip 並提供自動化安裝建議。
45
45
 
46
46
  ### 7. Swift 開發專家
47
- * **Swift 5.0+ 專家 (`skills/swift`)**:支援從基礎語法到 Swift 6 的現代開發模式,涵蓋 SwiftUI、Structured Concurrency、記憶體安全以及高效能 App 開發指引。
48
- * **SwiftUI 專家 (`skills/swift-ui`)**:支援 iOS 16.0+ 與 Swift 5.0+ 的現代開發模式,專注於 NavigationStack、Observation 框架、資料流架構及高效能視圖設計。
47
+ * **Swift 5.0+ 專家 (`skills/neo-swift`)**:支援從基礎語法到 Swift 6 的現代開發模式,涵蓋 SwiftUI、Structured Concurrency、記憶體安全以及高效能 App 開發指引。
48
+ * **SwiftUI 專家 (`skills/neo-swift-ui`)**:支援 iOS 16.0+ 與 Swift 5.0+ 的現代開發模式,專注於 NavigationStack、Observation 框架、資料流架構及高效能視圖設計。
49
49
 
50
50
  ### 8. 需求釐清助手
51
51
  * **需求釐清 (`neo:clarification`)**:系統化引導用戶釐清模糊需求,並將其轉化為結構化的規格文件(背景、功能、約束、驗收標準)。
@@ -92,13 +92,29 @@ npx -p @moon791017/neo-skills install-copilot-skills
92
92
  npx -p @moon791017/neo-skills install-codex-skills
93
93
  ```
94
94
 
95
+ ### 自訂安裝根目錄
96
+
97
+ Claude Code、Copilot CLI、Codex CLI 三種安裝指令皆支援 `--target-path` 參數,可指定安裝的根目錄(取代預設的 `$HOME`)。技能子目錄(如 `.claude/skills`)會自動附加:
98
+
99
+ ```bash
100
+ # 安裝至 /my/project/.claude/skills
101
+ npx -p @moon791017/neo-skills install-claude-skills --target-path /my/project
102
+
103
+ # 安裝至 /my/project/.copilot/skills
104
+ npx -p @moon791017/neo-skills install-copilot-skills --target-path /my/project
105
+
106
+ # 安裝至 /my/project/.codex/skills
107
+ npx -p @moon791017/neo-skills install-codex-skills --target-path /my/project
108
+ ```
109
+
110
+ 若未指定 `--target-path`,則使用預設根目錄 `$HOME`(即 `~/.claude/skills`、`~/.copilot/skills`、`~/.codex/skills`)。
111
+
95
112
  ### 安裝全部AI Agent技能
96
113
 
97
114
  ```bash
98
115
  npx -p @moon791017/neo-skills install-skills
99
116
  ```
100
117
 
101
-
102
118
  ## 💡 常用指令範例
103
119
 
104
120
  您可以直接對 AI 代理下達以下指令或在對話中描述需求:
@@ -113,7 +129,6 @@ npx -p @moon791017/neo-skills install-skills
113
129
  | **生成 C# Interface** | `幫我針對這個 class 產生介面` 或 `/neo:dotnet-gen-interface` |
114
130
  | **技術解析與架構洞察** | `分析這個專案的架構` 或 `/neo:explain` |
115
131
 
116
-
117
132
  ## 🛠 開發指南
118
133
 
119
134
  本專案使用 **Bun** 進行開發與建置。
package/bin/_utils.js CHANGED
@@ -23,17 +23,17 @@ const sourceDir = join(packageRoot, 'skills');
23
23
  export const AGENTS = {
24
24
  claude: {
25
25
  name: 'Claude',
26
- targetSubDir: '.claude/skills/neo-skills',
26
+ targetSubDir: '.claude/skills',
27
27
  hint: '請確保您的 Claude Desktop 或相關插件已指向此目錄。',
28
28
  },
29
29
  copilot: {
30
30
  name: 'Copilot',
31
- targetSubDir: '.copilot/skills/neo-skills',
31
+ targetSubDir: '.copilot/skills',
32
32
  hint: '請確保您的 GitHub Copilot CLI 已指向此目錄。',
33
33
  },
34
34
  codex: {
35
35
  name: 'Codex',
36
- targetSubDir: '.codex/skills/neo-skills',
36
+ targetSubDir: '.codex/skills',
37
37
  hint: '請確保您的 Codex CLI 已指向此目錄。',
38
38
  },
39
39
  // gemini: {
@@ -43,6 +43,16 @@ export const AGENTS = {
43
43
  // },
44
44
  };
45
45
 
46
+ /**
47
+ * 從 CLI 參數解析 --target-path 值
48
+ * @returns {string | undefined}
49
+ */
50
+ function parseTargetPath() {
51
+ const idx = process.argv.indexOf('--target-path');
52
+ if (idx === -1 || idx + 1 >= process.argv.length) return undefined;
53
+ return process.argv[idx + 1];
54
+ }
55
+
46
56
  /**
47
57
  * 從檔名解析 agent key: install-{key}-skills.js → key
48
58
  */
@@ -55,8 +65,10 @@ function extractAgentKey(importMetaUrl) {
55
65
 
56
66
  /**
57
67
  * 根據 agent config 建立 installer 函式
68
+ * @param {object} config - agent 設定
69
+ * @param {string} [targetPath] - 使用者透過 --target-path 指定的自訂路徑
58
70
  */
59
- export function createInstaller({ name: agentName, targetSubDir, hint }) {
71
+ export function createInstaller({ name: agentName, targetSubDir, hint }, targetPath) {
60
72
  return async function install() {
61
73
  console.log(`🚀 [${agentName}] 開始同步 Neo Skills...`);
62
74
 
@@ -68,7 +80,8 @@ export function createInstaller({ name: agentName, targetSubDir, hint }) {
68
80
  return { success: false, message: msg };
69
81
  }
70
82
 
71
- const targetSkillsDir = join(homedir(), targetSubDir);
83
+ const baseDir = targetPath ? resolve(targetPath) : homedir();
84
+ const targetSkillsDir = join(baseDir, targetSubDir);
72
85
 
73
86
  console.log(`📁 來源路徑: ${sourceDir}`);
74
87
  console.log(`🎯 目標路徑: ${targetSkillsDir}`);
@@ -92,7 +105,8 @@ export function createInstaller({ name: agentName, targetSubDir, hint }) {
92
105
  return { success: true, message: '沒有任何檔案被複製' };
93
106
  }
94
107
 
95
- const msg = `已同步 ${copyCount} 個檔案/資料夾至 ${targetSubDir}`;
108
+ const displayPath = targetPath || targetSubDir;
109
+ const msg = `已同步 ${copyCount} 個檔案/資料夾至 ${displayPath}`;
96
110
  console.log(`✅ [${agentName}] 安裝成功!${msg}`);
97
111
  if (hint) console.log(`💡 提示: ${hint}`);
98
112
  return { success: true, message: msg };
@@ -102,12 +116,13 @@ export function createInstaller({ name: agentName, targetSubDir, hint }) {
102
116
  /**
103
117
  * 從呼叫端的檔名自動解析 agent,建立對應的 installer。
104
118
  * @param {string} importMetaUrl - 呼叫端的 import.meta.url
119
+ * @param {string} [targetPath] - 使用者透過 --target-path 指定的自訂路徑
105
120
  */
106
- export function createInstallerFromFile(importMetaUrl) {
121
+ export function createInstallerFromFile(importMetaUrl, targetPath) {
107
122
  const key = extractAgentKey(importMetaUrl);
108
123
  const config = AGENTS[key];
109
124
  if (!config) throw new Error(`未知的 agent: "${key}"。請在 _utils.js 的 AGENTS 中註冊。`);
110
- return createInstaller(config);
125
+ return createInstaller(config, targetPath);
111
126
  }
112
127
 
113
128
  /**
@@ -137,7 +152,12 @@ export function runAsMain(installFn, callerUrl) {
137
152
  process.exit(1);
138
153
  });
139
154
 
140
- installFn().then((result) => {
155
+ const targetPath = parseTargetPath();
156
+ const actualInstallFn = targetPath
157
+ ? createInstallerFromFile(callerUrl, targetPath)
158
+ : installFn;
159
+
160
+ actualInstallFn().then((result) => {
141
161
  if (!result.success) process.exit(1);
142
162
  }).catch((error) => {
143
163
  console.error(`❌ [${agentName}] 安裝失敗:`, error.message || error);
@@ -4,12 +4,12 @@ prompt = """
4
4
  Act as a **Senior DevOps Architect** to configure the Continuous Deployment (CD) process for Azure App Service:
5
5
 
6
6
  1. **Perceive**:
7
- - Read `skills/azure-pipelines/SKILL.md` to load design specifications.
7
+ - Read `skills/neo-azure-pipelines/SKILL.md` to load design specifications.
8
8
  - Confirm the Azure App Service name, environment name (e.g., Production/Staging), and Service Connection name with the user or from the project context.
9
9
  - Identify the Build Artifact name.
10
10
 
11
11
  2. **Reason**:
12
- - Plan to copy `skills/azure-pipelines/templates/deploy/deploy-app-service.yml` to the project's `.pipelines/templates/deploy/` directory.
12
+ - Plan to copy `skills/neo-azure-pipelines/templates/deploy/deploy-app-service.yml` to the project's `.pipelines/templates/deploy/` directory.
13
13
  - Design the YAML script referencing the deployment template according to `SKILL.md` standards.
14
14
 
15
15
  3. **Act**:
@@ -4,12 +4,12 @@ prompt = """
4
4
  Act as a **Senior DevOps Architect** to configure the Continuous Deployment (CD) process for On-Premises IIS:
5
5
 
6
6
  1. **Perceive**:
7
- - Read `skills/azure-pipelines/SKILL.md` to load design specifications.
7
+ - Read `skills/neo-azure-pipelines/SKILL.md` to load design specifications.
8
8
  - Confirm IIS parameters: Website Name, Physical Path, Deployment Group name, and target environment.
9
9
  - Verify if the project requires specific ASP.NET Core environment settings.
10
10
 
11
11
  2. **Reason**:
12
- - Plan to copy the entire `skills/azure-pipelines/templates/util/iis/` directory and the `deploy/deploy-iis.yml` template.
12
+ - Plan to copy the entire `skills/neo-azure-pipelines/templates/util/iis/` directory and the `deploy/deploy-iis.yml` template.
13
13
  - Design a pipeline with staged tasks including backup and rollback logic as required by `SKILL.md`.
14
14
 
15
15
  3. **Act**:
@@ -4,18 +4,18 @@ prompt = """
4
4
  Act as a **Senior DevOps Architect** to configure the Azure Pipelines CI process for this .NET project:
5
5
 
6
6
  1. **Perceive**:
7
- - Read `skills/azure-pipelines/SKILL.md` to load design specifications.
7
+ - Read `skills/neo-azure-pipelines/SKILL.md` to load design specifications.
8
8
  - Scan the project directory to identify the .NET version (e.g., .NET 6/8), project name, and solution file (.sln).
9
9
  - Check for any existing pipeline configurations.
10
10
 
11
11
  2. **Reason**:
12
12
  - Determine the build strategy based on `SKILL.md` guidelines.
13
- - Plan to copy `skills/azure-pipelines/templates/build/build-dotnet.yml` and relevant `util` templates to the `.pipelines/templates/` directory within the project.
13
+ - Plan to copy `skills/neo-azure-pipelines/templates/build/build-dotnet.yml` and relevant `util` templates to the `.pipelines/templates/` directory within the project.
14
14
  - Design the main pipeline file (e.g., `azure-pipelines-ci.yml`) to reference these templates with the correct parameters.
15
15
 
16
16
  3. **Act**:
17
17
  - Create the `.pipelines/templates/build/` and `.pipelines/templates/util/` directories.
18
- - Copy `skills/azure-pipelines/templates/build/build-dotnet.yml` and `skills/azure-pipelines/templates/util/clean-artifact.yml` to their respective locations.
18
+ - Copy `skills/neo-azure-pipelines/templates/build/build-dotnet.yml` and `skills/neo-azure-pipelines/templates/util/clean-artifact.yml` to their respective locations.
19
19
  - Generate `azure-pipelines-ci.yml` in the project root, ensuring the structure complies with `SKILL.md` and uses proper `template` syntax.
20
20
  - Provide a brief explanation of the configuration and how to use it.
21
21
  """
@@ -14,7 +14,7 @@ You must analyze this input and decide whether to ask clarifying questions or ge
14
14
  ## Operational Protocol (Perceive-Reason-Act)
15
15
 
16
16
  1. **Perceive (Context Awareness)**:
17
- - **Read and internalize the guidelines in `skills/clarification/SKILL.md`.**
17
+ - **Read and internalize the guidelines in `skills/neo-clarification/SKILL.md`.**
18
18
  - Identify the professional domain context.
19
19
  - Extract confirmed objectives, constraints, and stakeholder information.
20
20
 
@@ -26,7 +26,7 @@ You must analyze this input and decide whether to ask clarifying questions or ge
26
26
  - **Phase 2 (Convergence)**: If information is sufficient for a specification.
27
27
 
28
28
  3. **Act (Execution Phase)**:
29
- - Follow the execution phase rules and formatting defined in `skills/clarification/SKILL.md`.
29
+ - Follow the execution phase rules and formatting defined in `skills/neo-clarification/SKILL.md`.
30
30
  - **If Phase 1**: Output a maximum of 3 structured questions. Provide example options for each to reduce the user's cognitive load.
31
31
  - **If Phase 2**: Consolidate information and output a standardized requirement specification document.
32
32
 
@@ -8,7 +8,7 @@ You are an expert Senior Software Engineer and Architect. Your task is to perfor
8
8
  The user has requested a code review. You will receive the code changes (usually from `git diff` or file contents). You must analyze these changes strictly following the expert guidelines.
9
9
 
10
10
  ## Process
11
- 1. **Perceive**: Read and internalize the guidelines in `skills/code-review/SKILL.md`.
11
+ 1. **Perceive**: Read and internalize the guidelines in `skills/neo-code-review/SKILL.md`.
12
12
  2. **Analyze**: Examine the input code changes in `{{args}}`.
13
13
  - If `{{args}}` is empty or generic, assume the input is the current staged and unstaged changes (you may need to ask the user to provide them or run `git diff` yourself if the context isn't automatically provided, but typically the tool wrapper handles this. *Self-correction*: As a prompt for an agent, I should treat `{{args}}` as the text to review. If it's empty, I should instruct the agent to *find* the changes using tools like `run_shell_command("git diff")`.)
14
14
  3. **Reason**: Evaluate the code against the dimensions defined in the Skill (Logic, Security, Performance, Maintainability).
@@ -26,7 +26,7 @@ If `{{args}}` is NOT empty:
26
26
  3. Proceed with the review.
27
27
 
28
28
  ## Output Format
29
- Strictly follow the "Act (Reporting Phase)" section in `skills/code-review/SKILL.md`.
29
+ Strictly follow the "Act (Reporting Phase)" section in `skills/neo-code-review/SKILL.md`.
30
30
 
31
31
  ## Input Data
32
32
  User Arguments: {{args}}
@@ -10,7 +10,7 @@ The user has provided a C# Class, and you need to generate an Interface for it.
10
10
  Target Content: {{args}}
11
11
 
12
12
  ## Step 1: Perceive & Reason (Generation Phase)
13
- 1. Refer to the specifications in `skills/csharp-interface-generator/SKILL.md`.
13
+ 1. Refer to the specifications in `skills/neo-csharp-interface-generator/SKILL.md`.
14
14
  2. **Strict Filtering**:
15
15
  - Extract only `public` properties.
16
16
  - **Absolutely no** `virtual` properties.
@@ -11,7 +11,7 @@ The user has requested an explanation for:
11
11
 
12
12
  ## Process
13
13
  1. **Perceive**:
14
- - Read and internalize the guidelines in `skills/explain/SKILL.md`.
14
+ - Read and internalize the guidelines in `skills/neo-explain/SKILL.md`.
15
15
  - Identify the target files, directories, or code segments from `{{args}}`.
16
16
  - If `{{args}}` is empty, analyze the current active file or project structure as context.
17
17
 
@@ -22,7 +22,7 @@ The user has requested an explanation for:
22
22
  - **Design Alignment**: Explain the implementation motivation from the perspective of design patterns.
23
23
 
24
24
  3. **Act**:
25
- - Provide a structured explanation according to the guidelines in `skills/explain/SKILL.md`.
25
+ - Provide a structured explanation according to the guidelines in `skills/neo-explain/SKILL.md`.
26
26
  - **The output MUST be in Traditional Chinese (Taiwan).**
27
27
 
28
28
  ## Output Format
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "neo-skills",
3
3
  "description": "A universal capability extension for Gemini CLI",
4
- "version": "0.46.3",
4
+ "version": "0.47.0",
5
5
  "mcpServers": {
6
6
  "neo-skills": {
7
7
  "command": "node",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@moon791017/neo-skills",
3
- "version": "1.0.16",
3
+ "version": "1.0.18",
4
4
  "type": "module",
5
5
  "description": "Neo Skills: A Universal Expert Agent Extension",
6
6
  "homepage": "https://neo-blog-iota.vercel.app/",
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: azure-pipeline-architect
2
+ name: neo-azure-pipeline-architect
3
3
  version: "1.0.0"
4
4
  category: "DevOps"
5
5
  description: "根據微軟官方文件與專案需求,設計並生成符合最新標準的 Azure Pipelines YAML 腳本。優先使用模組化範本 (Templates)。"
@@ -15,7 +15,7 @@ compatibility: "Supports .NET 6.0 up to .NET 10.0."
15
15
  4. Detect the project source code structure to confirm build tools (e.g., Maven, Gradle, Npm, NuGet) and testing frameworks.
16
16
  5. Read security and compliance requirements, including Static Application Security Testing (SAST), package vulnerability scanning, and container image scanning.
17
17
  6. Confirm environment variable requirements, secret information sources (e.g., Azure Key Vault), and Service Connection permissions.
18
- 7. **Proactively scan the `skills/azure-pipelines/templates/` directory to identify existing reusable template resources. Includes:**
18
+ 7. **Proactively scan the `skills/neo-azure-pipelines/templates/` directory to identify existing reusable template resources. Includes:**
19
19
  * **Build**: `build/build-dotnet.yml`
20
20
  * **Deploy**: `deploy/deploy-app-service.yml`, `deploy/deploy-iis.yml`
21
21
  * **Utils**: `util/clean-artifact.yml`, `util/extract-artifact.yml`, `util/iis/*.yml`, etc.
@@ -27,7 +27,7 @@ compatibility: "Supports .NET 6.0 up to .NET 10.0."
27
27
  4. Design trigger mechanisms based on branching strategies, distinguishing trigger paths for Continuous Integration (CI) and Continuous Deployment (CD).
28
28
  5. Determine the applicability of deployment strategies, such as Blue-Green, Canary, or Rolling Update.
29
29
  6. Validate conditional execution syntax (Conditions) in Pipeline logic to ensure subsequent steps only execute on specific branches or after successful prerequisites.
30
- 7. **Prioritize using templates from `skills/azure-pipelines/templates/` to assemble the Pipeline, rather than writing raw YAML from scratch.**
30
+ 7. **Prioritize using templates from `skills/neo-azure-pipelines/templates/` to assemble the Pipeline, rather than writing raw YAML from scratch.**
31
31
  * If the project is .NET and needs deployment to IIS, combine `build-dotnet.yml` and `deploy-iis.yml`.
32
32
  * If artifact manipulation is required, prioritize using `util/extract-artifact.yml`.
33
33
 
@@ -39,7 +39,7 @@ compatibility: "Supports .NET 6.0 up to .NET 10.0."
39
39
  5. Provide preventive comments and explanations for common execution errors (e.g., insufficient permissions, dependency conflicts).
40
40
  6. **Use `template` syntax to reference selected template files and correctly pass required parameters. For example:**
41
41
  ```yaml
42
- - template: skills/azure-pipelines/templates/build/build-dotnet.yml
42
+ - template: skills/neo-azure-pipelines/templates/build/build-dotnet.yml
43
43
  parameters:
44
44
  buildConfiguration: 'Release'
45
45
  ```
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: clarification
2
+ name: neo-clarification
3
3
  description: 系統化引導使用者釐清模糊需求,並將其轉換為結構化的規格文件。
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: code-review-architect
2
+ name: neo-code-review-architect
3
3
  description: 分析程式碼變更,從安全性、效能與風格等多個面向找出問題、潛在 Bug 與改善空間。
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: csharp
2
+ name: neo-csharp
3
3
  version: "1.4.0"
4
4
  category: "Core"
5
5
  description: "跨版本 C# 專家技能 (10, 11, 12, 13, 14+)。支援從 .NET 6 (LTS) 到 .NET 10 (LTS) 的現代開發模式,涵蓋 File-scoped namespaces 到 Extension Types 的全方位演進。"
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: csharp-interface-generator
2
+ name: neo-csharp-interface-generator
3
3
  version: "1.0.0"
4
4
  category: "Core"
5
5
  description: "專注於C#介面生成與檔案結構管理。"
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: dotnet
2
+ name: neo-dotnet
3
3
  version: "1.0.0"
4
4
  category: "Framework"
5
5
  description: 用於廣泛 .NET 工作的核心路由技能。此技能將偵測本機安裝的 .NET SDK 版本(要求 .NET 6+),並根據使用者的問題,將任務引導或準備載入其他合適的子技能(例如 Minimal APIs, MVC, Web API, EF Core)。
@@ -27,10 +27,10 @@ This skill serves as the unified entry point for the .NET development environmen
27
27
  3. **Requirement Analysis and Dynamic Skill Routing**
28
28
  - Determine the involved domain based on the user's specific problem or project architecture.
29
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):
30
- - **`dotnet-minimal-apis`**: When the requirement is for lightweight routing development, high-performance microservices, and Controllers are not used.
31
- - **`dotnet-webapi`**: When the requirement is for traditional RESTful API development following the controller pattern.
32
- - **`dotnet-mvc`**: When the requirement involves Server-Side Rendering (SSR), Razor views, and ViewModels.
33
- - **`dotnet-ef-core`**: When the requirement involves database migrations, Linq query optimization, or model mapping.
30
+ - **`neo-dotnet-minimal-apis`**: When the requirement is for lightweight routing development, high-performance microservices, and Controllers are not used.
31
+ - **`neo-dotnet-webapi`**: When the requirement is for traditional RESTful API development following the controller pattern.
32
+ - **`neo-dotnet-mvc`**: When the requirement involves Server-Side Rendering (SSR), Razor views, and ViewModels.
33
+ - **`neo-dotnet-ef-core`**: When the requirement involves database migrations, Linq query optimization, or model mapping.
34
34
 
35
35
  ## Usage Guidelines
36
36
  When this skill is triggered, please prioritize checking the SDK environment, then answer the user's .NET-related questions. If the problem is found to belong to one of the four professional domains mentioned above, proactively suggest and prepare to delegate it to the corresponding expert skill for processing.
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: dotnet-ef-core
2
+ name: neo-dotnet-ef-core
3
3
  version: "1.0.0"
4
4
  category: "Framework"
5
5
  description: "Entity Framework Core (EF Core) 專家指引。支援從 .NET 6 (LTS) 到 .NET 10 (LTS) 的現代開發模式,涵蓋 Code-First 移轉、查詢優化、陰影屬性與複雜資料建模。"
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: dotnet-minimal-apis
2
+ name: neo-dotnet-minimal-apis
3
3
  version: "1.0.0"
4
4
  category: "Framework"
5
5
  description: "開發高效能、輕量級 .NET Minimal API 的專家指引。支援從 .NET 6 (LTS) 到 .NET 10 (LTS) 的現代開發模式,涵蓋路由群組、端點過濾器與符合 OpenAPI 規範的強型別回應。"
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: dotnet-mvc
2
+ name: neo-dotnet-mvc
3
3
  version: "1.0.0"
4
4
  category: "Framework"
5
5
  description: "開發 ASP.NET Core MVC 應用程式的專家指引。支援從 .NET 6 (LTS) 到 .NET 10 (LTS) 的現代開發模式,涵蓋視圖模型、標籤協助程式、視圖元件與伺服器端渲染的最佳實踐。"
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: dotnet-webapi
2
+ name: neo-dotnet-webapi
3
3
  version: "1.0.0"
4
4
  category: "Framework"
5
5
  description: "開發 ASP.NET Core Web API (Controller-based) 的專家指引。支援從 .NET 6 (LTS) 到 .NET 10 (LTS) 的現代開發模式,涵蓋控制器設計、Problem Details、全域異常處理與 API 版本控制。"
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: explain
2
+ name: neo-explain
3
3
  description: 分析原始碼或專案結構,提供技術解析與架構洞察。
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: git-commit
2
+ name: neo-git-commit
3
3
  description: Analyzes staged changes, generates a high-quality Conventional Commits message in Traditional Chinese, and executes the commit only after user confirmation.
4
4
  disable-model-invocation: true
5
5
  ---
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: python
2
+ name: neo-python
3
3
  version: "1.0.0"
4
4
  category: "Core"
5
5
  description: "用於 Python 3.10+ 開發的核心專家技能。專注於現代 Python 特性(Structural Pattern Matching, Union Types, Async Task Groups)、程式碼品質與架構設計。"
@@ -58,4 +58,4 @@ compatibility: "Supports Python 3.10 to 3.14. Requires a Python project structur
58
58
  - [Modern Python syntax evolution (3.10-3.14) and PEP 8 naming conventions](reference/coding-style.md)
59
59
  - [Recommended modern Python 3.10 - 3.14 development patterns and best practices](reference/patterns.md)
60
60
  - [Outdated Python practices to avoid, common pitfalls, and security traps](reference/anti-patterns.md)
61
- - [Intelligent detection and management of Python project virtual environments and dependency tools](../python-manager/SKILL.md)
61
+ - [Intelligent detection and management of Python project virtual environments and dependency tools](../neo-python-manager/SKILL.md)
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: python-manager
2
+ name: neo-python-manager
3
3
  version: "1.1.0"
4
4
  category: "Environment"
5
5
  description: "智慧偵測與管理 Python 專案的虛擬環境與依賴套件工具(支援 uv, Poetry, venv/pip),包含工具安裝導引。"
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: start-plan
2
+ name: neo-start-plan
3
3
  description: 分析需求與專案現況,並生成詳細的開發執行計畫。
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: swift
2
+ name: neo-swift
3
3
  version: "1.0.0"
4
4
  category: "Language"
5
5
  description: "Swift 專家技能 (5.0+)。支援從基礎語法到 Swift 6 的現代開發模式,涵蓋 SwiftUI、Structured Concurrency、記憶體安全以及高效能 App 開發指引。"
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: swift-ui
2
+ name: neo-swift-ui
3
3
  version: "1.0.0"
4
4
  category: "UI Framework"
5
5
  description: "SwiftUI 專家技能 (iOS 16.0+)。支援從宣告式 UI 基礎到 iOS 18+ 的現代開發模式,涵蓋 NavigationStack、Observation 框架、資料流架構及高效能視圖設計。"