luminae-helper 1.0.2 → 1.0.4
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/CHANGELOG.md +8 -0
- package/commands/git-push/SKILL.md +17 -72
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,83 +1,28 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: git-push
|
|
3
|
-
description:
|
|
3
|
+
description: 用户要求 Git 提交、推送或提交前审查时使用;普通代码审查和解释 Git 用法不自动触发。
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
#
|
|
6
|
+
# Git 提交与推送
|
|
7
7
|
|
|
8
|
-
|
|
8
|
+
按用户授权完成提交前审查、提交或推送。遵循当前项目规则,技能名称不代表额外授权。
|
|
9
9
|
|
|
10
|
-
|
|
10
|
+
## 操作边界
|
|
11
11
|
|
|
12
|
-
|
|
12
|
+
- 用户明确调用本技能并要求只审查:只读检查和报告,不暂存、不修复、不提交、不推送。
|
|
13
|
+
- 只提交:审查通过后提交指定改动,不自动推送。
|
|
14
|
+
- 提交并推送或明确调用本技能且未限制动作:执行完整流程。只要求推送已有提交时,不创建新提交。
|
|
15
|
+
- 审查发现实质问题:报告位置、影响和修复建议,停止提交/推送,不自动修复。后续用户授权修复后,验证修复再继续已授权流程。
|
|
13
16
|
|
|
14
|
-
|
|
15
|
-
2. **发现问题立即停止** — 只输出问题与解决方案,**不修复、不提交、不推送**
|
|
16
|
-
3. **通过后生成提交信息** — 分析 diff 内容,按 Conventional Commits 规范生成 commit message
|
|
17
|
-
4. **执行提交流程** — `git add` → `git commit` → `git push`
|
|
18
|
-
5. **中文 body** — 描述变更背景、原因和关键实现
|
|
19
|
-
6. **Conventional Commits** — `<type>(<scope>): <subject>`
|
|
17
|
+
## 执行
|
|
20
18
|
|
|
21
|
-
|
|
19
|
+
1. 确认仓库、当前分支、工作区及暂存区;读工作区与暂存区 diff,识别用户指定文件或改动块。已有无关改动和暂存内容保持原样。
|
|
20
|
+
2. 审查目标改动及必要的直接上下文,执行项目要求且与范围相称的检查。发现敏感信息、公共受控副本、依赖/构建契约限制时遵循项目边界。改动涉及样式、布局或交互,且渲染结果无法通过静态检查确认时,先本地启动页面截图自检并随审查结论附截图,再进入提交——agent 看不见渲染结果的 UI 交付,约 70% 问题本可在这一步拦截(用户估算,2026-09 复盘)。项目需要登录态、启动成本高或改动可通过静态检查确认时,跳过截图,在审查结论中注明「未经渲染验证」,由用户决定是否补验。
|
|
21
|
+
3. 提交前核实实际提交范围恰好是用户授权范围。不使用无差别暂存;文件中混有其他改动时按块隔离。无法安全隔离或无法确认归属时询问,不擅自清空他人暂存内容。
|
|
22
|
+
4. 按主要变更意图生成 Conventional Commit:`<type>(<scope>): <subject>`。scope 可省略,body 用中文解释背景和关键改动;不要仅凭文件扩展名判定类型。
|
|
23
|
+
5. 只执行已授权动作。推送前确认目标 remote、branch/upstream 和将被推送的提交集合;不能只看最新一个提交。目标不明或包含未授权提交时先确认。禁止擅自强推、切分支、改历史或处理远端冲突。
|
|
24
|
+
6. 回读提交文件清单、提交哈希和推送结果,确认未夹带无关改动。失败时报告停在哪一步,不把本地提交成功写成推送成功。
|
|
22
25
|
|
|
23
|
-
|
|
24
|
-
1. git status / git diff --stat / git diff
|
|
25
|
-
↓
|
|
26
|
-
2. Code Review(发现问题则停止)
|
|
27
|
-
↓
|
|
28
|
-
3. 生成 commit message(分析 diff,按 Conventional Commits 规范)
|
|
29
|
-
↓
|
|
30
|
-
4. git add <files>
|
|
31
|
-
5. git commit -m "<message>"
|
|
32
|
-
6. git push
|
|
33
|
-
```
|
|
26
|
+
## 交付
|
|
34
27
|
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
## 项目自适应身份
|
|
38
|
-
|
|
39
|
-
| 项目类型 | 身份 |
|
|
40
|
-
|---------|------|
|
|
41
|
-
| 前端/小程序 | 高级前端开发工程师 |
|
|
42
|
-
| 后端(Java/Go/Python等)| 高级后端开发工程师 |
|
|
43
|
-
| 其他 | 通用高级软件工程师 |
|
|
44
|
-
|
|
45
|
-
**必须优先遵循「当前项目规则文件」的约束。**
|
|
46
|
-
|
|
47
|
-
---
|
|
48
|
-
|
|
49
|
-
## Commit Message 生成规则
|
|
50
|
-
|
|
51
|
-
分析 `git diff` 输出,判断 commit 类型和 scope:
|
|
52
|
-
|
|
53
|
-
- 变更文件在 `docs/` → `docs`
|
|
54
|
-
- 变更包含 `*.test.ts` / `*.spec.ts` / `__tests__/` → `test`
|
|
55
|
-
- 变更包含 `package.json` / `pnpm-lock.yaml` / `go.mod` → `chore`
|
|
56
|
-
- 变更修复了某个问题 → `fix`
|
|
57
|
-
- 变更添加了新功能点 → `feat`
|
|
58
|
-
- scope 优先取变更最集中的模块目录名
|
|
59
|
-
|
|
60
|
-
格式:`feat(auth): 添加 JWT 登录功能`
|
|
61
|
-
|
|
62
|
-
## 输出格式
|
|
63
|
-
|
|
64
|
-
```
|
|
65
|
-
## 项目类型识别
|
|
66
|
-
- 类型:前端项目
|
|
67
|
-
- 身份:高级前端开发工程师
|
|
68
|
-
|
|
69
|
-
## Review 结论
|
|
70
|
-
✅ 通过 / ❌ 不通过(附问题清单)
|
|
71
|
-
|
|
72
|
-
## 提交信息
|
|
73
|
-
```
|
|
74
|
-
<type>(<scope>): <subject>
|
|
75
|
-
|
|
76
|
-
<body>
|
|
77
|
-
```
|
|
78
|
-
|
|
79
|
-
## 执行结果
|
|
80
|
-
- git add: ✅/❌
|
|
81
|
-
- git commit: ✅/❌ (hash: <sha>)
|
|
82
|
-
- git push: ✅/❌
|
|
83
|
-
```
|
|
28
|
+
简要给出审查结论、实际验证、提交哈希及远端分支(如执行),列出阻塞或未执行动作。无需重复输出项目身份和整套流程模板。
|