@moon791017/neo-skills 1.1.13 → 1.1.14

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 +35 -8
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -30,7 +30,7 @@
30
30
  | 漸進式揭露 | Agent 啟動時只讀 `name` 與 `description`;真正需要時才讀完整 `SKILL.md` 與 references。 |
31
31
  | 觸發導向描述 | 每個 skill 的 `description` 都說明「何時使用」,提升自動觸發準確度。 |
32
32
  | 外部知識庫 | 詳細規則放在 `references/` 或 `reference/`,避免主技能檔過長。 |
33
- | 可重用資源 | 透過 `assets/`、`templates/` 與 `scripts/` 提供可落地的產出基礎。 |
33
+ | 可重用資源 | 透過 `assets/`、`templates/` 與 `scripts/` 提供可實踐的產出基礎。 |
34
34
  | 可驗證結構 | 使用 `scripts/check-skills-syntax.py` 檢查技能名稱、frontmatter 與基本規格。 |
35
35
 
36
36
  ## 內建技能
@@ -60,14 +60,17 @@
60
60
  | Vue | `neo-vue` | 建置、除錯、重構或審查 Vue 3、SFC、Composition API、Pinia、Vue Router、Vite 與 Vue+TypeScript。 |
61
61
  | Agent 架構 | `neo-sub-agent` | 設計、建立、審查或轉換 sub-agent、custom agent、worker/reviewer/planner agent 或 multi-agent workflow。 |
62
62
  | Agent 架構 | `neo-agentic-design` | 設計、評估或實作 Agent 工作流、提示詞鏈、路由、規劃、反思、多 Agent 協作與記憶體管理等框架無關模式。 |
63
+ | 技能開發 | `generate-skill` | 建立、更新、審查或最佳化 Agent Skill,包含規格、觸發描述、延伸資源、評估資料與設計模式。 |
63
64
  | 可觀測性 | `neo-opentelemetry` | 解釋 OpenTelemetry 概念、規劃或審查 Collector 架構與設定、處理維運排障、安全、零程式 instrumentation 及相容性遷移。 |
64
65
  | 文字潤飾 | `neo-stop-slop` | 去除繁中或英文中的 AI 腔、贅詞、公式化句式,支援文件、註解、commit message 與 PR 說明。 |
65
66
 
67
+ `generate-skill` 位於 `.agents/skills/`,可由 Agent Skills CLI 探索與安裝;其餘技能位於 `skills/`。
68
+
66
69
  ## 安裝
67
70
 
68
71
  ### Antigravity CLI 全域安裝
69
72
 
70
- 同步所有技能到 `~/.gemini/antigravity-cli/skills`:
73
+ 同步 `skills/` 下的技能到 `~/.gemini/antigravity-cli/skills`:
71
74
 
72
75
  ```bash
73
76
  npx -y @moon791017/neo-skills@latest
@@ -81,24 +84,48 @@ node bin/install-skills.js
81
84
 
82
85
  ### Agent Skills CLI 安裝
83
86
 
84
- 安裝全部技能:
87
+ Agent Skills CLI 會從 GitHub repository 探索 `skills/` 與 `.agents/skills/`。請明確指定目標 Agent,避免使用 `--all` 時同時選取不支援全域安裝的 Agent。
88
+
89
+ | Agent | `--agent` ID |
90
+ | :--- | :--- |
91
+ | Claude Code | `claude-code` |
92
+ | Copilot CLI | `github-copilot` |
93
+ | Codex | `codex` |
94
+ | Antigravity CLI | `antigravity-cli` |
95
+
96
+ 安裝全部技能到目前專案(以 Codex 為例):
85
97
 
86
98
  ```bash
87
- npx skills add Benknightdark/neo-skills --all
99
+ npx skills add Benknightdark/neo-skills --skill '*' --agent codex -y
88
100
  ```
89
101
 
90
- 安裝到全域:
102
+ 安裝全部技能到全域(以 Codex 為例):
91
103
 
92
104
  ```bash
93
- npx skills add Benknightdark/neo-skills --all -g
105
+ npx skills add Benknightdark/neo-skills --skill '*' --agent codex -g -y
94
106
  ```
95
107
 
96
- 只安裝指定技能:
108
+ 同時安裝到多個 Agent 時,重複傳入 `--agent`:
97
109
 
98
110
  ```bash
99
- npx skills add Benknightdark/neo-skills --skill neo-typescript,neo-vue
111
+ npx skills add Benknightdark/neo-skills --skill '*' \
112
+ --agent codex \
113
+ --agent antigravity-cli \
114
+ -g -y
100
115
  ```
101
116
 
117
+ 只安裝指定技能時,重複傳入 `--skill`:
118
+
119
+ ```bash
120
+ npx skills add Benknightdark/neo-skills \
121
+ --skill neo-typescript \
122
+ --skill neo-vue \
123
+ --agent codex \
124
+ -y
125
+ ```
126
+
127
+ > `--all` 等同同時選取全部技能與全部 Agent。不要使用 `--all -g` 表示「全域安裝全部技能」;Eve 與 PromptScript 僅支援專案範圍,會使該組合回報安裝失敗。
128
+
102
129
  ## 系統提示詞安裝
103
130
 
104
131
  Agent Skills 規格同步的是技能目錄;`AGENTS.md`、`CLAUDE.md`、Copilot instructions 或 Antigravity `agents.md` 這類指導檔需要另外安裝。
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@moon791017/neo-skills",
3
- "version": "1.1.13",
3
+ "version": "1.1.14",
4
4
  "type": "module",
5
5
  "description": "Neo Skills: A Universal AI Agent Skills Extension",
6
6
  "homepage": "https://neo-blog-iota.vercel.app/",