@captain_z/zsk-skills 1.0.0 → 1.0.1
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 +35 -32
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -4,26 +4,26 @@ ZNorth Standard Kit 的内容包：**46 颗原子 skill**，按领域分簇组
|
|
|
4
4
|
|
|
5
5
|
## 合规审查（ARCHITECTURE §4.4 硬指标）
|
|
6
6
|
|
|
7
|
-
| 检查项
|
|
8
|
-
|
|
|
9
|
-
| frontmatter 完整（`name` / `description` / `category` / `domain` / `tier` / `triggers`） | ✓ 46/46 | 结构化 lint 通过
|
|
10
|
-
| `name` 以 `zsk:` 前缀，扁平 slug
|
|
11
|
-
| `description` 以 `Use when…` 开头（trigger-optimized）
|
|
12
|
-
| `category` / `domain` / `tier` 枚举值合法
|
|
13
|
-
| `triggers` 数组非空
|
|
14
|
-
| 无硬编码项目名 / 技术栈（统一 `{{config.*}}` 占位符）
|
|
15
|
-
| `related:` 相对路径合法（build 已重写）
|
|
16
|
-
| 单文件 ≤ 300 行
|
|
7
|
+
| 检查项 | 结果 | 说明 |
|
|
8
|
+
| ---------------------------------------------------------------------------------------- | ------- | ----------------------------------------------------- |
|
|
9
|
+
| frontmatter 完整（`name` / `description` / `category` / `domain` / `tier` / `triggers`） | ✓ 46/46 | 结构化 lint 通过 |
|
|
10
|
+
| `name` 以 `zsk:` 前缀，扁平 slug | ✓ 46/46 | 命名空间统一 |
|
|
11
|
+
| `description` 以 `Use when…` 开头（trigger-optimized） | ✓ 46/46 | 触发匹配句式 |
|
|
12
|
+
| `category` / `domain` / `tier` 枚举值合法 | ✓ 46/46 | stage/workflow/standard/resource/meta · core/optional |
|
|
13
|
+
| `triggers` 数组非空 | ✓ 46/46 | 每颗至少 4 个关键词 |
|
|
14
|
+
| 无硬编码项目名 / 技术栈（统一 `{{config.*}}` 占位符） | ✓ | harness-neutral |
|
|
15
|
+
| `related:` 相对路径合法（build 已重写） | ✓ | 无孤儿引用 |
|
|
16
|
+
| 单文件 ≤ 300 行 | ⚠ 41/46 | 5 个 frontend skill 超标（见技术债） |
|
|
17
17
|
|
|
18
18
|
**技术债**（不阻塞 CI，`tools/lint-frontmatter.ts` 当前降级 warn）：
|
|
19
19
|
|
|
20
|
-
| 文件
|
|
21
|
-
|
|
|
22
|
-
| `frontend/a11y-web/SKILL.md`
|
|
23
|
-
| `frontend/testing-web/SKILL.md`
|
|
24
|
-
| `frontend/nfr-web/SKILL.md`
|
|
25
|
-
| `frontend/security-web/SKILL.md`
|
|
26
|
-
| `frontend/performance-web/SKILL.md` | 305
|
|
20
|
+
| 文件 | 行数 |
|
|
21
|
+
| ----------------------------------- | ---- |
|
|
22
|
+
| `frontend/a11y-web/SKILL.md` | 370 |
|
|
23
|
+
| `frontend/testing-web/SKILL.md` | 351 |
|
|
24
|
+
| `frontend/nfr-web/SKILL.md` | 352 |
|
|
25
|
+
| `frontend/security-web/SKILL.md` | 311 |
|
|
26
|
+
| `frontend/performance-web/SKILL.md` | 305 |
|
|
27
27
|
|
|
28
28
|
清理手法见 `memory/project_tech_debts_lint_frontmatter.md`；完成后把 `max-lines` 从 `warn` 升回 `error`。
|
|
29
29
|
|
|
@@ -37,30 +37,33 @@ zsk skill 是 LLM **按需自动触发**的资产：
|
|
|
37
37
|
4. **手动触发**（可选）：会话中显式说 "用 `zsk:spec`"、"走 `zsk:feature` 工作流"，LLM 直接载入指定 skill
|
|
38
38
|
|
|
39
39
|
**典型消费路径**（production，安装后）：
|
|
40
|
+
|
|
40
41
|
- `~/.claude/skills/<domain>/<slug>/SKILL.md` — Claude Code
|
|
41
42
|
- `~/.codex/skills/<domain>/<slug>/SKILL.md` — Codex
|
|
42
43
|
- `@captain_z/zsk-skills/<domain>/<slug>/SKILL.md` — 通过 npm 读
|
|
43
44
|
|
|
44
45
|
## 领域总览
|
|
45
46
|
|
|
46
|
-
| 领域
|
|
47
|
-
|
|
|
48
|
-
| `sdlc/`
|
|
49
|
-
| `frontend/`
|
|
50
|
-
| `quality/`
|
|
51
|
-
| `design-handoff/` | 2
|
|
52
|
-
| `system/`
|
|
53
|
-
| `meta/`
|
|
54
|
-
| **总计**
|
|
47
|
+
| 领域 | skill 数 | 职责 |
|
|
48
|
+
| ----------------- | -------- | ------------------------------------------ |
|
|
49
|
+
| `sdlc/` | 17 | 7 阶段 SDLC + 3 变更工作流 + task 执行框架 |
|
|
50
|
+
| `frontend/` | 16 | React + Web 层实现规范 |
|
|
51
|
+
| `quality/` | 5 | 跨栈质量原则 |
|
|
52
|
+
| `design-handoff/` | 2 | 设计交付方法论 |
|
|
53
|
+
| `system/` | 5 | 工程宪法级资源 |
|
|
54
|
+
| `meta/` | 1 | 元信息 |
|
|
55
|
+
| **总计** | **46** | |
|
|
55
56
|
|
|
56
57
|
## 安装套件（bundles.yaml）
|
|
57
58
|
|
|
58
|
-
| name
|
|
59
|
-
|
|
|
60
|
-
| `sdlc-only`
|
|
61
|
-
| `frontend-project`（推荐）
|
|
62
|
-
| `frontend-with-design-handoff` | 31
|
|
63
|
-
| `custom`
|
|
59
|
+
| name | skills | 场景 |
|
|
60
|
+
| ------------------------------ | ------ | --------------------------------------------- |
|
|
61
|
+
| `sdlc-only` | 10 | 纯流程骨架（7 阶段 + 3 工作流），不涉及技术栈 |
|
|
62
|
+
| `frontend-project`（推荐） | 29 | SDLC 10 + Frontend 16 + Quality 3 |
|
|
63
|
+
| `frontend-with-design-handoff` | 31 | frontend-project + Figma 交付 2 |
|
|
64
|
+
| `custom` | 交互 | 通过 `zsk add` 任意多选 |
|
|
65
|
+
|
|
66
|
+
<!-- Auto-generated by tools/catalog.ts — do not edit manually. Total: 46 skills -->
|
|
64
67
|
|
|
65
68
|
<!-- Auto-generated by tools/catalog.ts — do not edit manually. Total: 46 skills -->
|
|
66
69
|
|