@moon791017/neo-skills 1.1.15 → 1.1.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.
- package/README.md +4 -34
- package/package.json +1 -1
- package/skills/neo-pr/SKILL.md +9 -15
- package/skills/neo-pr/evals/evals.json +4 -3
- package/skills/neo-pr/references/pr-template.md +12 -24
package/README.md
CHANGED
|
@@ -85,48 +85,18 @@ node bin/install-skills.js
|
|
|
85
85
|
|
|
86
86
|
### Agent Skills CLI 安裝
|
|
87
87
|
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
| Agent | `--agent` ID |
|
|
91
|
-
| :--- | :--- |
|
|
92
|
-
| Claude Code | `claude-code` |
|
|
93
|
-
| Copilot CLI | `github-copilot` |
|
|
94
|
-
| Codex | `codex` |
|
|
95
|
-
| Antigravity CLI | `antigravity-cli` |
|
|
96
|
-
|
|
97
|
-
安裝全部技能到目前專案(以 Codex 為例):
|
|
98
|
-
|
|
99
|
-
```bash
|
|
100
|
-
npx skills add Benknightdark/neo-skills --skill '*' --agent codex -y
|
|
101
|
-
```
|
|
102
|
-
|
|
103
|
-
安裝全部技能到全域(以 Codex 為例):
|
|
104
|
-
|
|
105
|
-
```bash
|
|
106
|
-
npx skills add Benknightdark/neo-skills --skill '*' --agent codex -g -y
|
|
107
|
-
```
|
|
108
|
-
|
|
109
|
-
同時安裝到多個 Agent 時,重複傳入 `--agent`:
|
|
88
|
+
安裝全部技能到目前專案:
|
|
110
89
|
|
|
111
90
|
```bash
|
|
112
|
-
npx skills add Benknightdark/neo-skills --skill
|
|
113
|
-
--agent codex \
|
|
114
|
-
--agent antigravity-cli \
|
|
115
|
-
-g -y
|
|
91
|
+
npx skills add Benknightdark/neo-skills --skill --all -y
|
|
116
92
|
```
|
|
117
93
|
|
|
118
|
-
|
|
94
|
+
安裝全部技能到全域:
|
|
119
95
|
|
|
120
96
|
```bash
|
|
121
|
-
npx skills add Benknightdark/neo-skills
|
|
122
|
-
--skill neo-typescript \
|
|
123
|
-
--skill neo-vue \
|
|
124
|
-
--agent codex \
|
|
125
|
-
-y
|
|
97
|
+
npx skills add Benknightdark/neo-skills --skill --all -g -y
|
|
126
98
|
```
|
|
127
99
|
|
|
128
|
-
> `--all` 等同同時選取全部技能與全部 Agent。不要使用 `--all -g` 表示「全域安裝全部技能」;Eve 與 PromptScript 僅支援專案範圍,會使該組合回報安裝失敗。
|
|
129
|
-
|
|
130
100
|
## 系統提示詞安裝
|
|
131
101
|
|
|
132
102
|
Agent Skills 規格同步的是技能目錄;`AGENTS.md`、`CLAUDE.md`、Copilot instructions 或 Antigravity `agents.md` 這類指導檔需要另外安裝。
|
package/package.json
CHANGED
package/skills/neo-pr/SKILL.md
CHANGED
|
@@ -79,29 +79,23 @@ Construct the PR Title and Description based on extracted commit and diff contex
|
|
|
79
79
|
|
|
80
80
|
#### 1. PR Title Standard (Conventional Commits)
|
|
81
81
|
* Format: `<type>(<scope>): <short summary>`
|
|
82
|
-
* Example: `feat(auth):
|
|
82
|
+
* Example: `feat(auth): 新增 JWT 驗證與 Token 自動刷新`
|
|
83
83
|
* Rules:
|
|
84
84
|
- Do not begin with filler phrases ("This PR implements...", "A commit to...").
|
|
85
85
|
- Keep under 50 characters, imperative mood, direct and actionable.
|
|
86
86
|
|
|
87
|
-
#### 2. PR
|
|
88
|
-
The PR
|
|
87
|
+
#### 2. PR Output Standard Structure
|
|
88
|
+
The PR output **must strictly be wrapped in a Markdown code block** (i.e. raw Markdown source code ` ```markdown ... ``` `) so that users can easily copy it directly into GitHub/GitLab PR description fields. The content inside the code block must consist exclusively of the following two sections:
|
|
89
89
|
|
|
90
|
+
````markdown
|
|
90
91
|
```markdown
|
|
91
|
-
|
|
92
|
-
|
|
92
|
+
標題:
|
|
93
|
+
<Conventional Commits 格式標題>
|
|
93
94
|
|
|
94
|
-
|
|
95
|
-
-
|
|
96
|
-
- Avoid line-by-line code repetition; focus on high-level architecture and logic evolution.
|
|
97
|
-
|
|
98
|
-
## ⚠️ Impact & Breaking Changes
|
|
99
|
-
- Note any breaking changes, API contract updates, or database schema migrations.
|
|
100
|
-
- Write `None` if there is no significant impact.
|
|
101
|
-
|
|
102
|
-
## 🧪 Verification & Test Steps
|
|
103
|
-
- List passed unit tests or manual verification steps (including exact execution commands).
|
|
95
|
+
內容:
|
|
96
|
+
- 列點並重點化的說明重要變更內容(包含主要模組/檔案調整、邏輯變更與重大影響)。
|
|
104
97
|
```
|
|
98
|
+
````
|
|
105
99
|
|
|
106
100
|
#### 3. Strict De-slop Rules
|
|
107
101
|
* ❌ Never use: "It is worth noting that", "Needless to say", "This PR aims to", "In summary", "Clearly".
|
|
@@ -4,10 +4,11 @@
|
|
|
4
4
|
{
|
|
5
5
|
"id": 1,
|
|
6
6
|
"prompt": "Generate a concise, non-AI-slop PR title and description for merging feature/user-auth into main.",
|
|
7
|
-
"expected_output": "A PR title adhering to Conventional Commits format, and a bulleted markdown PR description
|
|
7
|
+
"expected_output": "A PR title adhering to Conventional Commits format under '標題:', and a bulleted markdown PR description under '內容:' wrapped in a Markdown code block for easy copying, with no AI fluff phrases.",
|
|
8
8
|
"assertions": [
|
|
9
|
-
"PR
|
|
10
|
-
"PR
|
|
9
|
+
"PR output is enclosed inside a Markdown code block for easy copying",
|
|
10
|
+
"PR Title complies with Conventional Commits format under 標題:",
|
|
11
|
+
"PR Description includes bullet points summarizing key changes under 內容:",
|
|
11
12
|
"Content is structured strictly with bullet points",
|
|
12
13
|
"Does not contain AI tells like 'It is worth noting that' or 'This PR aims to'"
|
|
13
14
|
]
|
|
@@ -19,33 +19,22 @@ Titles must be clear, concise, and directly reflect the underlying changes using
|
|
|
19
19
|
* `chore`: Changes to the build process, auxiliary tools, or dependencies
|
|
20
20
|
* `perf`: A code change that improves performance
|
|
21
21
|
|
|
22
|
-
### Title Examples:
|
|
23
|
-
- ✅ `feat(auth): add Google OAuth login flow and token handler`
|
|
24
|
-
- ✅ `fix(cart): resolve overflow in checkout discount calculation`
|
|
25
|
-
- ✅ `refactor(db): extract user repository to domain service layer`
|
|
26
|
-
- ❌ `Updated some code` (Too vague)
|
|
27
|
-
- ❌ `feat(auth): this PR dramatically improves auth security and UX` (Contains AI fluff)
|
|
28
|
-
|
|
29
22
|
---
|
|
30
23
|
|
|
31
24
|
## 2. PR Description Template
|
|
32
25
|
|
|
33
|
-
```markdown
|
|
34
|
-
## 📌 Motivation
|
|
35
|
-
- [Briefly describe the issue solved, context, or feature request fulfilled]
|
|
36
|
-
|
|
37
|
-
## 🛠️ Key Changes
|
|
38
|
-
- [Key point 1: Modified module/file and rationale]
|
|
39
|
-
- [Key point 2: Added logic or architectural improvement]
|
|
40
|
-
- [Key point 3: Environment or dependency adjustments]
|
|
26
|
+
The PR output **must strictly be wrapped in a Markdown code block** (i.e. raw Markdown source code ` ```markdown ... ``` `) so that users can easily copy it directly into GitHub/GitLab PR description fields. The output format must strictly follow:
|
|
41
27
|
|
|
42
|
-
|
|
43
|
-
|
|
28
|
+
````markdown
|
|
29
|
+
```markdown
|
|
30
|
+
標題:
|
|
31
|
+
<type>(<scope>): <short summary>
|
|
44
32
|
|
|
45
|
-
|
|
46
|
-
- [
|
|
47
|
-
- [
|
|
33
|
+
內容:
|
|
34
|
+
- **[重要變更/關鍵模組 1]**:說明具體調整內容與目的。
|
|
35
|
+
- **[重要變更/關鍵模組 2]**:說明具體調整內容與目的。
|
|
48
36
|
```
|
|
37
|
+
````
|
|
49
38
|
|
|
50
39
|
---
|
|
51
40
|
|
|
@@ -55,7 +44,6 @@ When drafting PR descriptions, rigorously filter out filler words according to t
|
|
|
55
44
|
|
|
56
45
|
| ❌ Fluff Phrase | ⭕ Clean Alternative | Explanation |
|
|
57
46
|
| :--- | :--- | :--- |
|
|
58
|
-
| It is worth noting that this PR refactors auth logic. |
|
|
59
|
-
| This PR aims to resolve a potential crash during login. |
|
|
60
|
-
| In summary, this change seamlessly boosts system performance. |
|
|
61
|
-
| Imagine a scenario where unhandled requests hit the server... | Add defensive 401 error handling for unauthenticated requests. | Remove hypothetical setups; state defensive logic clearly. |
|
|
47
|
+
| It is worth noting that this PR refactors auth logic. | 重構驗證邏輯,改用統一中介軟體。 | Delete throat-clearing openers; use direct action verbs. |
|
|
48
|
+
| This PR aims to resolve a potential crash during login. | 修復登入時因 null 使用者引發的閃退問題。 | Omit "This PR aims to"; state goal and root cause directly. |
|
|
49
|
+
| In summary, this change seamlessly boosts system performance. | 減少 DB 查詢,降低 API 延遲 40ms。 | Replace "seamlessly" with concrete metrics. |
|