code-abyss 1.6.15 → 1.7.0

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 (82) hide show
  1. package/bin/install.js +25 -4
  2. package/package.json +2 -2
  3. package/skills/SKILL.md +24 -16
  4. package/skills/domains/ai/SKILL.md +2 -2
  5. package/skills/domains/ai/prompt-and-eval.md +279 -0
  6. package/skills/domains/architecture/SKILL.md +2 -3
  7. package/skills/domains/architecture/security-arch.md +87 -0
  8. package/skills/domains/data-engineering/SKILL.md +188 -26
  9. package/skills/domains/development/SKILL.md +1 -4
  10. package/skills/domains/devops/SKILL.md +3 -5
  11. package/skills/domains/devops/performance.md +63 -0
  12. package/skills/domains/devops/testing.md +97 -0
  13. package/skills/domains/frontend-design/SKILL.md +12 -3
  14. package/skills/domains/frontend-design/claymorphism/SKILL.md +117 -0
  15. package/skills/domains/frontend-design/claymorphism/references/tokens.css +52 -0
  16. package/skills/domains/frontend-design/engineering.md +287 -0
  17. package/skills/domains/frontend-design/glassmorphism/SKILL.md +138 -0
  18. package/skills/domains/frontend-design/glassmorphism/references/tokens.css +32 -0
  19. package/skills/domains/frontend-design/liquid-glass/SKILL.md +135 -0
  20. package/skills/domains/frontend-design/liquid-glass/references/tokens.css +81 -0
  21. package/skills/domains/frontend-design/neubrutalism/SKILL.md +141 -0
  22. package/skills/domains/frontend-design/neubrutalism/references/tokens.css +44 -0
  23. package/skills/domains/infrastructure/SKILL.md +174 -34
  24. package/skills/domains/mobile/SKILL.md +211 -21
  25. package/skills/domains/orchestration/SKILL.md +1 -0
  26. package/skills/domains/security/SKILL.md +4 -6
  27. package/skills/domains/security/blue-team.md +57 -0
  28. package/skills/domains/security/red-team.md +54 -0
  29. package/skills/domains/security/threat-intel.md +50 -0
  30. package/skills/orchestration/multi-agent/SKILL.md +195 -46
  31. package/skills/run_skill.js +134 -0
  32. package/skills/tools/gen-docs/SKILL.md +6 -4
  33. package/skills/tools/gen-docs/scripts/doc_generator.js +349 -0
  34. package/skills/tools/verify-change/SKILL.md +8 -6
  35. package/skills/tools/verify-change/scripts/change_analyzer.js +270 -0
  36. package/skills/tools/verify-module/SKILL.md +6 -4
  37. package/skills/tools/verify-module/scripts/module_scanner.js +145 -0
  38. package/skills/tools/verify-quality/SKILL.md +5 -3
  39. package/skills/tools/verify-quality/scripts/quality_checker.js +276 -0
  40. package/skills/tools/verify-security/SKILL.md +7 -5
  41. package/skills/tools/verify-security/scripts/security_scanner.js +133 -0
  42. package/skills/domains/COVERAGE_PLAN.md +0 -232
  43. package/skills/domains/ai/model-evaluation.md +0 -790
  44. package/skills/domains/ai/prompt-engineering.md +0 -703
  45. package/skills/domains/architecture/compliance.md +0 -299
  46. package/skills/domains/architecture/data-security.md +0 -184
  47. package/skills/domains/data-engineering/data-pipeline.md +0 -762
  48. package/skills/domains/data-engineering/data-quality.md +0 -894
  49. package/skills/domains/data-engineering/stream-processing.md +0 -791
  50. package/skills/domains/development/dart.md +0 -963
  51. package/skills/domains/development/kotlin.md +0 -834
  52. package/skills/domains/development/php.md +0 -659
  53. package/skills/domains/development/swift.md +0 -755
  54. package/skills/domains/devops/e2e-testing.md +0 -914
  55. package/skills/domains/devops/performance-testing.md +0 -734
  56. package/skills/domains/devops/testing-strategy.md +0 -667
  57. package/skills/domains/frontend-design/build-tools.md +0 -743
  58. package/skills/domains/frontend-design/performance.md +0 -734
  59. package/skills/domains/frontend-design/testing.md +0 -699
  60. package/skills/domains/infrastructure/gitops.md +0 -735
  61. package/skills/domains/infrastructure/iac.md +0 -855
  62. package/skills/domains/infrastructure/kubernetes.md +0 -1018
  63. package/skills/domains/mobile/android-dev.md +0 -979
  64. package/skills/domains/mobile/cross-platform.md +0 -795
  65. package/skills/domains/mobile/ios-dev.md +0 -931
  66. package/skills/domains/security/secrets-management.md +0 -834
  67. package/skills/domains/security/supply-chain.md +0 -931
  68. package/skills/domains/security/threat-modeling.md +0 -828
  69. package/skills/run_skill.py +0 -88
  70. package/skills/tests/README.md +0 -225
  71. package/skills/tests/SUMMARY.md +0 -362
  72. package/skills/tests/__init__.py +0 -3
  73. package/skills/tests/test_change_analyzer.py +0 -558
  74. package/skills/tests/test_doc_generator.py +0 -538
  75. package/skills/tests/test_module_scanner.py +0 -376
  76. package/skills/tests/test_quality_checker.py +0 -516
  77. package/skills/tests/test_security_scanner.py +0 -426
  78. package/skills/tools/gen-docs/scripts/doc_generator.py +0 -491
  79. package/skills/tools/verify-change/scripts/change_analyzer.py +0 -529
  80. package/skills/tools/verify-module/scripts/module_scanner.py +0 -321
  81. package/skills/tools/verify-quality/scripts/quality_checker.py +0 -481
  82. package/skills/tools/verify-security/scripts/security_scanner.py +0 -368
@@ -0,0 +1,141 @@
1
+ ---
2
+ name: neubrutalism
3
+ description: Neubrutalism design system skill. Use when building bold UI with thick borders, offset solid shadows, high saturation colors, and minimal border radius.
4
+ license: MIT
5
+ ---
6
+
7
+ # Neubrutalism Design Spec
8
+
9
+ ## Core Principles
10
+
11
+ 1. **Thick Borders** — Bold `3–5px solid` black outlines on all elements
12
+ 2. **Offset Solid Shadows** — Hard-edge `box-shadow` with zero blur (e.g. `5px 5px 0 #000`)
13
+ 3. **High Saturation Colors** — Vivid, punchy fills: pinks, yellows, blues, greens
14
+ 4. **Minimal Radius** — `0–8px` border-radius; sharp or barely rounded corners
15
+ 5. **Flat Aesthetic** — No gradients, no blur, no transparency
16
+
17
+ ## CSS Tokens
18
+
19
+ Reference: [references/tokens.css](references/tokens.css)
20
+
21
+ ```css
22
+ @import 'references/tokens.css';
23
+
24
+ .nb-card {
25
+ background: var(--nb-yellow);
26
+ border: var(--nb-border-thick);
27
+ border-radius: var(--nb-radius);
28
+ box-shadow: var(--nb-shadow);
29
+ }
30
+ ```
31
+
32
+ ## Component Examples
33
+
34
+ ### Card
35
+ ```css
36
+ .nb-card {
37
+ background: var(--nb-white);
38
+ border: var(--nb-border-thick);
39
+ border-radius: var(--nb-radius);
40
+ box-shadow: var(--nb-shadow);
41
+ padding: 1.5rem;
42
+ }
43
+ ```
44
+
45
+ ### Button
46
+ ```css
47
+ .nb-btn {
48
+ background: var(--nb-yellow);
49
+ border: var(--nb-border);
50
+ border-radius: var(--nb-radius);
51
+ box-shadow: var(--nb-shadow-sm);
52
+ padding: 0.6rem 1.4rem;
53
+ font-family: var(--nb-font);
54
+ font-weight: var(--nb-font-weight);
55
+ cursor: pointer;
56
+ transition: transform 0.1s, box-shadow 0.1s;
57
+ }
58
+ .nb-btn:hover {
59
+ transform: translate(-2px, -2px);
60
+ box-shadow: var(--nb-shadow);
61
+ }
62
+ .nb-btn:active {
63
+ transform: translate(3px, 3px);
64
+ box-shadow: none;
65
+ }
66
+ ```
67
+
68
+ ### Navbar
69
+ ```css
70
+ .nb-nav {
71
+ background: var(--nb-bg);
72
+ border-bottom: var(--nb-border-thick);
73
+ padding: 1rem 2rem;
74
+ position: sticky;
75
+ top: 0;
76
+ z-index: 100;
77
+ }
78
+ ```
79
+
80
+ ### Input
81
+ ```css
82
+ .nb-input {
83
+ background: var(--nb-white);
84
+ border: var(--nb-border);
85
+ border-radius: var(--nb-radius);
86
+ box-shadow: var(--nb-shadow-sm);
87
+ padding: 0.6rem 1rem;
88
+ font-family: var(--nb-font);
89
+ font-weight: var(--nb-font-weight-body);
90
+ }
91
+ .nb-input:focus {
92
+ outline: none;
93
+ box-shadow: var(--nb-shadow);
94
+ }
95
+ ```
96
+
97
+ ### Badge
98
+ ```css
99
+ .nb-badge {
100
+ background: var(--nb-pink);
101
+ border: var(--nb-border);
102
+ border-radius: var(--nb-radius);
103
+ padding: 0.2rem 0.8rem;
104
+ font-family: var(--nb-font);
105
+ font-weight: var(--nb-font-weight);
106
+ font-size: 0.85rem;
107
+ }
108
+ ```
109
+
110
+ ## Typography
111
+
112
+ - Use bold, geometric sans-serif fonts (Space Grotesk, Inter, etc.)
113
+ - Headings: `font-weight: 700`, `letter-spacing: -0.02em`
114
+ - Body: `font-weight: 500`
115
+ - Uppercase sparingly for labels/badges
116
+
117
+ ```css
118
+ h1, h2, h3 {
119
+ font-family: var(--nb-font-heading);
120
+ font-weight: var(--nb-font-weight);
121
+ letter-spacing: var(--nb-letter-spacing);
122
+ }
123
+ body {
124
+ font-family: var(--nb-font);
125
+ font-weight: var(--nb-font-weight-body);
126
+ }
127
+ ```
128
+
129
+ ## Accessibility Notes
130
+
131
+ - Thick borders provide strong visual boundaries — good for low-vision users
132
+ - Ensure color contrast ≥ 4.5:1 for text on colored backgrounds
133
+ - Active/hover states use `transform` shifts — provide `prefers-reduced-motion` fallback
134
+
135
+ ```css
136
+ @media (prefers-reduced-motion: reduce) {
137
+ .nb-btn:hover, .nb-btn:active {
138
+ transform: none;
139
+ }
140
+ }
141
+ ```
@@ -0,0 +1,44 @@
1
+ :root {
2
+ /* Borders */
3
+ --nb-border: 3px solid #000;
4
+ --nb-border-thick: 5px solid #000;
5
+
6
+ /* Shadows (offset solid, no blur) */
7
+ --nb-shadow-sm: 3px 3px 0 #000;
8
+ --nb-shadow: 5px 5px 0 #000;
9
+ --nb-shadow-lg: 8px 8px 0 #000;
10
+
11
+ /* Radius */
12
+ --nb-radius: 4px;
13
+ --nb-radius-lg: 8px;
14
+
15
+ /* Colors — high saturation */
16
+ --nb-pink: #ff6b9d;
17
+ --nb-yellow: #ffd43b;
18
+ --nb-blue: #4dabf7;
19
+ --nb-green: #51cf66;
20
+ --nb-orange: #ff922b;
21
+ --nb-purple: #cc5de8;
22
+ --nb-red: #ff6b6b;
23
+ --nb-white: #fff;
24
+ --nb-black: #000;
25
+ --nb-bg: #f5f0e8;
26
+
27
+ /* Typography */
28
+ --nb-font: 'Space Grotesk', 'Inter', system-ui, sans-serif;
29
+ --nb-font-heading: 'Space Grotesk', 'Inter', system-ui, sans-serif;
30
+ --nb-font-weight: 700;
31
+ --nb-font-weight-body: 500;
32
+ --nb-letter-spacing: -0.02em;
33
+ }
34
+
35
+ [data-theme="dark"] {
36
+ --nb-border: 3px solid #fff;
37
+ --nb-border-thick: 5px solid #fff;
38
+ --nb-shadow-sm: 3px 3px 0 #fff;
39
+ --nb-shadow: 5px 5px 0 #fff;
40
+ --nb-shadow-lg: 8px 8px 0 #fff;
41
+ --nb-bg: #1a1a2e;
42
+ --nb-black: #fff;
43
+ --nb-white: #1a1a2e;
44
+ }
@@ -1,58 +1,198 @@
1
1
  ---
2
2
  name: infrastructure
3
- description: 云原生基础设施。Kubernetes、Helm、Kustomize、Operator、CRD、GitOps、ArgoCD、Flux、IaC、Terraform、Pulumi、CDK、基础设施即代码。当用户提到 K8s、Helm、GitOps、IaC、基础设施即代码时路由到此。
3
+ description: 云原生基础设施。Kubernetes、Helm、Kustomize、Operator、CRD、GitOps、ArgoCD、Flux、IaC、Terraform、Pulumi、CDK。当用户提到 K8s、Helm、GitOps、IaC 时路由到此。
4
+ license: MIT
4
5
  ---
5
6
 
6
7
  # 云原生基础设施 · Infrastructure
7
8
 
8
- ## 秘典矩阵
9
-
10
- | 秘典 | 核心神通 | 触发词 |
11
- |------|----------|--------|
12
- | [kubernetes](kubernetes.md) | Helm/Kustomize/Operator/CRD | Kubernetes、K8s、Helm、Kustomize、Operator、CRD、部署策略 |
13
- | [gitops](gitops.md) | ArgoCD/Flux/声明式部署 | GitOps、ArgoCD、Flux、声明式部署、自动同步 |
14
- | [iac](iac.md) | Terraform/Pulumi/CDK/状态管理 | IaC、Terraform、Pulumi、CDK、基础设施即代码、状态管理 |
15
-
16
- ## 云原生架构视角
9
+ ## 域概览
17
10
 
18
11
  ```
19
12
  GitOps 控制平面
20
-
21
- ┌─────────────────┼─────────────────┐
22
-
13
+ |
14
+ +-----------------+-----------------+
15
+ | | |
23
16
  ArgoCD/Flux Kubernetes IaC 层
24
-
25
- Git Repo ──────> Helm/Kustomize ──> Terraform/Pulumi
26
-
17
+ | | |
18
+ Git Repo ------> Helm/Kustomize --> Terraform/Pulumi
19
+ | | |
27
20
  声明式配置 容器编排 云资源管理
28
21
  ```
29
22
 
30
- ## 快速选择
23
+ ---
24
+
25
+ ## Kubernetes 容器编排
26
+
27
+ ### Helm Chart 开发
28
+
29
+ 标准结构:`Chart.yaml` + `values.yaml` + `templates/` + `charts/`
30
+
31
+ 核心要点:
32
+ - Chart.yaml:`apiVersion: v2`, dependencies 声明子 Chart(condition 控制启用)
33
+ - values.yaml 设计:image / replicaCount / resources / autoscaling / service / ingress / probes / env / persistence
34
+ - Deployment 模板:使用 `_helpers.tpl` 定义 `fullname` / `labels` / `selectorLabels`
35
+ - 配置校验:`checksum/config: {{ include ... | sha256sum }}` 触发滚动更新
36
+ - 安全上下文:`runAsNonRoot: true, runAsUser: 1000`
37
+
38
+ 关键命令:
39
+ - `helm lint` / `helm template --debug` 验证
40
+ - `helm install -f values-prod.yaml` 部署
41
+ - `helm upgrade --reuse-values` 升级
42
+ - `helm rollback <release> <revision>` 回滚
43
+ - `helm push <chart>.tgz oci://registry` 推送 OCI
44
+
45
+ ### Kustomize 配置管理
46
+
47
+ 目录结构:`base/` + `overlays/{dev,staging,production}/`
48
+
49
+ 核心能力:
50
+ - base/kustomization.yaml:resources / commonLabels / images / configMapGenerator / secretGenerator
51
+ - overlay:namespace / patchesStrategicMerge / patchesJson6902 / replicas / images / configMapGenerator(behavior: merge)
52
+ - 命令:`kubectl apply -k overlays/production` / `kubectl diff -k`
53
+
54
+ ### Operator 模式
55
+
56
+ - CRD 定义:openAPIV3Schema 声明 spec/status,subresources(status/scale)
57
+ - Controller 核心循环:Get CR → 构建期望状态 → Create/Update 子资源 → 更新 Status
58
+ - OwnerReferences:子资源关联 CR,级联删除
59
+ - 初始化:`operator-sdk init` → `create api` → `make manifests` → `make install`
31
60
 
32
- ### 容器编排
33
- - **Helm Chart 开发** → `kubernetes.md`
34
- - **Kustomize 配置** → `kubernetes.md`
35
- - **Operator 模式** → `kubernetes.md`
36
- - **部署策略** → `kubernetes.md`
61
+ ### 部署策略
37
62
 
38
- ### 持续部署
39
- - **GitOps 流程** → `gitops.md`
40
- - **ArgoCD 配置** `gitops.md`
41
- - **Flux 自动化** `gitops.md`
42
- - **多环境管理** `gitops.md`
63
+ | 策略 | 实现方式 | 适用场景 |
64
+ |------|----------|----------|
65
+ | 滚动更新 | `strategy.rollingUpdate` maxSurge/maxUnavailable | 默认策略 |
66
+ | 蓝绿部署 | 两个 Deployment + Service selector 切换 | 零停机切换 |
67
+ | 金丝雀 | stable(9) + canary(1) 共享 Service | 渐进式验证 |
68
+ | Flagger | `Canary` CRD + 自动分析指标 | 自动化金丝雀 |
43
69
 
44
- ### 基础设施即代码
45
- - **Terraform 模块** → `iac.md`
46
- - **Pulumi 开发** `iac.md`
47
- - **AWS CDK** `iac.md`
48
- - **状态管理** `iac.md`
70
+ ### K8s Checklist
71
+
72
+ - [ ] 健康检查:livenessProbe + readinessProbe 必配
73
+ - [ ] 资源限制:requests + limits 防止资源耗尽
74
+ - [ ] HPA:CPU/Memory/自定义指标自动扩缩容
75
+ - [ ] PDB:`minAvailable` 防止滚动更新中断
76
+ - [ ] ResourceQuota + LimitRange:命名空间资源配额
77
+ - [ ] 镜像使用 Digest 确保一致性
78
+ - [ ] Pod 反亲和性分散到不同节点
79
+ - [ ] 密钥外部化:External Secrets Operator
80
+
81
+ ---
82
+
83
+ ## GitOps 持续部署
84
+
85
+ ### ArgoCD vs Flux
86
+
87
+ | 特性 | ArgoCD | Flux |
88
+ |------|--------|------|
89
+ | Web UI | 功能强大 | 无(可用 Weave GitOps) |
90
+ | 多租户 | Projects + RBAC | 需额外配置 |
91
+ | 多集群 | 原生支持 | 原生支持 |
92
+ | 镜像自动更新 | 需 Image Updater | 原生支持 |
93
+ | 渐进式交付 | Argo Rollouts | Flagger |
94
+ | CNCF | Graduated | Graduated |
95
+
96
+ ### ArgoCD 核心模式
97
+
98
+ - Application:source(repoURL/path/targetRevision) + destination(server/namespace)
99
+ - syncPolicy:`automated(prune: true, selfHeal: true)` + retry
100
+ - ignoreDifferences:忽略 HPA 修改的 `/spec/replicas`
101
+ - ApplicationSet:Git 目录生成器,一套模板管理多环境
102
+ - 多集群:`argocd cluster add` 注册集群
103
+ - Notifications:ConfigMap 配置 Slack/Email 通知模板
104
+ - Rollouts:`Canary` CRD + steps(setWeight/pause) + AnalysisTemplate(Prometheus 查询)
105
+
106
+ ### Flux 核心模式
107
+
108
+ - GitRepository:`interval: 1m`, ref branch, secretRef
109
+ - Kustomization:path + prune + healthChecks + postBuild substitute
110
+ - HelmRepository + HelmRelease:chart + values + install/upgrade remediation
111
+ - ImageRepository + ImagePolicy + ImageUpdateAutomation:自动检测新镜像并提交 Git
112
+
113
+ ### 多环境管理
114
+
115
+ ```
116
+ fleet-infra/
117
+ ├── clusters/{dev,staging,production}/ # 每集群入口
118
+ ├── infrastructure/base + overlays/ # 基础组件
119
+ └── apps/base + overlays/ # 应用配置
120
+ ```
121
+
122
+ ### 密钥管理
123
+
124
+ - Sealed Secrets:`kubeseal` 加密 → 提交 Git → Controller 解密
125
+ - External Secrets Operator:SecretStore(AWS SM) + ExternalSecret → 自动同步
126
+
127
+ ### GitOps Checklist
128
+
129
+ - [ ] Git 为唯一真相源,所有变更通过 PR
130
+ - [ ] 自动同步 + 自愈(selfHeal)
131
+ - [ ] 密钥加密存储(Sealed Secrets / External Secrets)
132
+ - [ ] 渐进式交付(Rollouts / Flagger)
133
+ - [ ] 多环境目录隔离
134
+ - [ ] 回滚策略:保留历史版本
135
+
136
+ ---
137
+
138
+ ## 基础设施即代码 (IaC)
139
+
140
+ ### 工具对比
141
+
142
+ | 工具 | 语言 | 状态管理 | 云支持 | 学习曲线 |
143
+ |------|------|----------|--------|----------|
144
+ | Terraform | HCL | 显式(S3/TF Cloud) | 全平台 | 中等 |
145
+ | Pulumi | Python/TS/Go | 自动(Pulumi Cloud) | 全平台 | 较低 |
146
+ | AWS CDK | Python/TS | CloudFormation | AWS | 中等 |
147
+
148
+ ### Terraform 核心模式
149
+
150
+ 项目结构:`modules/{vpc,eks,rds}/` + `environments/{dev,staging,prod}/`
151
+
152
+ - Provider:版本锁定 `required_providers` + `default_tags`
153
+ - Backend:S3 + DynamoDB 锁 + KMS 加密
154
+ - 模块化:`variable` → `resource` → `output`,环境通过 `module` 引用
155
+ - 远程状态:`data "terraform_remote_state"` 跨模块引用
156
+ - 命令流:`init` → `validate` → `fmt` → `plan -out=tfplan` → `apply tfplan`
157
+ - 状态管理:`state list/show/mv/rm` / `import` 导入现有资源
158
+ - Workspace:`workspace new/select` 多环境隔离
159
+
160
+ ### Pulumi 核心模式
161
+
162
+ - ComponentResource:自定义资源组(VPC/EKS 封装为类)
163
+ - Config:`pulumi.Config()` 读取 stack 配置
164
+ - Outputs:`pulumi.export()` 导出值
165
+ - 命令:`preview` → `up` → `stack output` / `destroy`
166
+
167
+ ### AWS CDK 核心模式
168
+
169
+ - Stack:继承 `Stack`,使用 L2 Constructs(`ec2.Vpc` / `eks.Cluster`)
170
+ - 跨 Stack 引用:通过构造函数参数传递
171
+ - 命令:`synth` → `diff` → `deploy --all` / `bootstrap`
172
+
173
+ ### IaC Checklist
174
+
175
+ - [ ] 模块化:可复用组件抽象为模块
176
+ - [ ] 环境隔离:不同环境不同 State
177
+ - [ ] 远程状态 + 状态锁定
178
+ - [ ] Provider 版本锁定
179
+ - [ ] 密钥管理:Secrets Manager / SSM
180
+ - [ ] 统一资源标签
181
+ - [ ] Plan 后人工审查再 Apply
182
+ - [ ] CI/CD 集成自动化
183
+
184
+ ---
49
185
 
50
186
  ## 最佳实践
51
187
 
52
188
  | 层级 | 工具选择 | 原则 |
53
189
  |------|----------|------|
54
190
  | 应用部署 | Helm + Kustomize | 模板化 + 环境差异 |
55
- | 持续交付 | ArgoCD/Flux | Git 为唯一真相源 |
56
- | 基础设施 | Terraform/Pulumi | 声明式 + 状态管理 |
191
+ | 持续交付 | ArgoCD / Flux | Git 为唯一真相源 |
192
+ | 基础设施 | Terraform / Pulumi | 声明式 + 状态管理 |
57
193
  | 配置管理 | External Secrets | 密钥外部化 |
58
194
  | 可观测性 | Prometheus + Grafana | 指标 + 可视化 |
195
+
196
+ ## 触发词
197
+
198
+ Kubernetes、K8s、Helm、Kustomize、Operator、CRD、GitOps、ArgoCD、Flux、IaC、Terraform、Pulumi、CDK、基础设施即代码
@@ -1,32 +1,222 @@
1
1
  ---
2
2
  name: mobile
3
3
  description: 移动开发。iOS、Android、SwiftUI、Jetpack Compose、React Native、Flutter、跨平台。当用户提到移动开发、iOS、Android、跨平台时路由到此。
4
+ license: MIT
4
5
  ---
5
6
 
6
- # 📱 移动开发域 (Mobile Development)
7
+ # 移动开发域 · Mobile Development
7
8
 
8
- ## 子域清单
9
-
10
- | 文档 | 覆盖范围 | 触发词 |
11
- |------|----------|--------|
12
- | ios-dev.md | SwiftUI、UIKit、Combine、iOS架构 | iOS开发、SwiftUI、UIKit、Combine |
13
- | android-dev.md | Jetpack Compose、Kotlin、Android架构 | Android开发、Jetpack Compose、Kotlin |
14
- | cross-platform.md | React Native、Flutter、跨平台对比 | 跨平台、React Native、Flutter |
15
-
16
- ## 路由规则
9
+ ## 域概览
17
10
 
18
11
  ```
19
- 用户输入
20
-
21
- ├─ iOS/SwiftUI/UIKit ios-dev.md
22
- ├─ Android/Compose/Kotlin android-dev.md
23
- └─ 跨平台/RN/Flutter → cross-platform.md
12
+ 原生开发 跨平台开发
13
+ ├── iOS (SwiftUI/UIKit) ├── React Native (JS/TS)
14
+ ├── Android (Compose/Kotlin) └── Flutter (Dart)
15
+ └── 共通:MVVM / 网络层 / 持久化 / 测试
24
16
  ```
25
17
 
26
- ## 核心能力
18
+ ---
19
+
20
+ ## iOS 开发
21
+
22
+ ### SwiftUI 核心模式
23
+
24
+ - View 组件:`struct MyView: View { var body: some View { ... } }`
25
+ - State 管理:
26
+ - `@State` — 本地状态
27
+ - `@Binding` — 父子双向绑定
28
+ - `@StateObject` — 拥有 ObservableObject
29
+ - `@ObservedObject` — 引用 ObservableObject
30
+ - `@EnvironmentObject` / `@Environment` — 全局注入
31
+ - ObservableObject:`@Published` 属性自动触发 UI 更新
32
+ - Custom ViewModifier:`struct CardModifier: ViewModifier` + `extension View { func cardStyle() }`
33
+ - 生命周期:`.task { await ... }` / `.onAppear` / `.onDisappear`
34
+
35
+ ### UIKit 集成
36
+
37
+ - UIViewControllerRepresentable:包装 UIViewController 到 SwiftUI
38
+ - UIViewRepresentable:包装 UIView 到 SwiftUI
39
+ - Coordinator 模式:处理 delegate 回调
40
+ - Auto Layout:`NSLayoutConstraint.activate([...])` + `translatesAutoresizingMaskIntoConstraints = false`
41
+
42
+ ### Combine 响应式
43
+
44
+ - Publisher:`URLSession.shared.dataTaskPublisher` → `map` → `decode` → `eraseToAnyPublisher`
45
+ - 订阅:`.sink(receiveCompletion:receiveValue:)` + `.store(in: &cancellables)`
46
+ - 常用 Operators:`debounce` / `removeDuplicates` / `combineLatest` / `flatMap`
47
+ - Subject:`PassthroughSubject`(无初始值)/ `CurrentValueSubject`(有初始值)
48
+
49
+ ### iOS 架构
50
+
51
+ MVVM(推荐):
52
+ - Model:`Codable` 数据结构
53
+ - Repository:`protocol` + `async throws` 方法
54
+ - ViewModel:`@MainActor class VM: ObservableObject` + `@Published` 属性
55
+ - View:`@StateObject private var viewModel = VM()`
56
+
57
+ VIPER(复杂场景):
58
+ - View ←→ Presenter ←→ Interactor → Entity
59
+ - Router 处理导航
60
+
61
+ ### 网络层
62
+
63
+ - APIClient:泛型 `func get<T: Decodable>(_ path:) async throws -> T`
64
+ - Token 管理:`request.setValue("Bearer \(token)", forHTTPHeaderField: "Authorization")`
65
+ - 错误处理:`enum APIError: Error { case invalidURL, invalidResponse, httpError(Int) }`
66
+
67
+ ### 数据持久化
68
+
69
+ - UserDefaults:`@propertyWrapper struct UserDefault<T>` 简化访问
70
+ - Keychain:`SecItemAdd` / `SecItemCopyMatching` 存储敏感数据
71
+ - Core Data:`NSPersistentContainer` + `NSManagedObjectContext`
72
+ - SwiftData(iOS 17+):`@Model` 宏简化持久化
73
+
74
+ ### iOS Checklist
75
+
76
+ - [ ] SwiftUI 优先,UIKit 按需集成
77
+ - [ ] `@MainActor` 确保 UI 线程安全
78
+ - [ ] async/await 替代回调
79
+ - [ ] 依赖注入提升可测试性
80
+ - [ ] LazyVStack/LazyHStack 优化大列表
81
+ - [ ] 图片缓存(NSCache)减少内存压力
82
+ - [ ] Keychain 存储敏感数据(非 UserDefaults)
83
+ - [ ] 单元测试覆盖 ViewModel + Mock Repository
84
+
85
+ ---
86
+
87
+ ## Android 开发
88
+
89
+ ### Jetpack Compose 核心模式
90
+
91
+ - Composable:`@Composable fun MyScreen() { ... }`
92
+ - State 管理:
93
+ - `remember { mutableStateOf(value) }` — 本地状态
94
+ - `rememberSaveable` — 跨配置变更保存
95
+ - `derivedStateOf` — 派生状态避免重组
96
+ - LazyColumn:`items(list, key = { it.id })` 提供稳定 key
97
+ - Side Effects:
98
+ - `LaunchedEffect(key)` — 启动协程
99
+ - `DisposableEffect(key)` — 清理资源(onDispose)
100
+ - `SideEffect` — 同步状态到外部
101
+ - `snapshotFlow { state }` — 监听状态变化转 Flow
102
+ - Navigation:`NavHost` + `composable(route)` + `navController.navigate()`
103
+ - Custom Modifier:`fun Modifier.myModifier(): Modifier = composed { ... }`
104
+
105
+ ### ViewModel + StateFlow
106
+
107
+ - StateFlow(推荐替代 LiveData):
108
+ - `MutableStateFlow(UiState())` + `.asStateFlow()`
109
+ - `_uiState.update { it.copy(isLoading = true) }`
110
+ - Compose 中:`val uiState by viewModel.uiState.collectAsState()`
111
+ - UiState data class:封装 loading / error / data
112
+
113
+ ### Kotlin Coroutines & Flow
114
+
115
+ - 协程:`viewModelScope.launch { withContext(Dispatchers.IO) { ... } }`
116
+ - 并发:`coroutineScope { val a = async { ... }; val b = async { ... } }`
117
+ - Flow:`flow { emit(value) }` + `.flowOn(Dispatchers.IO)`
118
+ - StateFlow:`.stateIn(scope, SharingStarted.WhileSubscribed(5000), initial)`
119
+ - 搜索防抖:`searchQuery.debounce(300).filter { it.isNotEmpty() }.flatMapLatest { ... }`
120
+ - Channel:`Channel<Event>(BUFFERED)` + `.receiveAsFlow()` 一次性事件
121
+
122
+ ### 依赖注入 (Hilt)
123
+
124
+ - `@HiltAndroidApp` Application + `@AndroidEntryPoint` Activity
125
+ - `@Module @InstallIn(SingletonComponent::class)` 提供依赖
126
+ - `@Provides @Singleton` 提供实例 / `@Binds` 绑定接口
127
+ - ViewModel:`@HiltViewModel class VM @Inject constructor(repo)` + `hiltViewModel()`
128
+
129
+ ### Room 数据库
130
+
131
+ - Entity:`@Entity(tableName)` + `@PrimaryKey` + `@ColumnInfo`
132
+ - DAO:`@Query` / `@Insert(onConflict = REPLACE)` / `@Delete` + 返回 `Flow<List<T>>`
133
+ - Database:`@Database(entities, version)` + `Room.databaseBuilder`
134
+
135
+ ### 网络层 (Retrofit)
136
+
137
+ - ApiService:`@GET` / `@POST` / `@Path` / `@Query` / `@Body` / `@Multipart`
138
+ - Interceptor:AuthInterceptor 注入 Bearer Token
139
+ - OkHttpClient:`addInterceptor` + `connectTimeout`
140
+
141
+ ### Android Checklist
142
+
143
+ - [ ] Compose 优先,View 系统按需使用
144
+ - [ ] StateFlow 替代 LiveData
145
+ - [ ] Hilt 依赖注入
146
+ - [ ] Room 本地持久化
147
+ - [ ] `key` 参数优化 LazyColumn
148
+ - [ ] `remember` / `derivedStateOf` 避免过度重组
149
+ - [ ] Coil 图片加载 + 缓存策略
150
+ - [ ] 单元测试覆盖 ViewModel(runTest + advanceUntilIdle)
151
+
152
+ ---
153
+
154
+ ## 跨平台开发
155
+
156
+ ### React Native vs Flutter
157
+
158
+ | 维度 | React Native | Flutter |
159
+ |------|--------------|---------|
160
+ | 语言 | TypeScript | Dart |
161
+ | 渲染 | 原生组件(桥接) | 自绘引擎(Skia) |
162
+ | 性能 | 接近原生 | 接近原生 |
163
+ | 热重载 | Fast Refresh | Hot Reload |
164
+ | 生态 | npm(成熟) | pub.dev(快速增长) |
165
+ | UI 一致性 | 跟随系统 | 完全一致 |
166
+ | 包体积 | ~7MB | ~15MB |
167
+
168
+ ### React Native 核心模式
169
+
170
+ - 组件:函数组件 + Hooks(useState / useEffect / useCallback / useMemo)
171
+ - 列表:`FlatList` + `keyExtractor` + `initialNumToRender` + `windowSize`
172
+ - Navigation:`@react-navigation/native` + `createNativeStackNavigator`
173
+ - 状态管理:Redux Toolkit(`createSlice` + `createAsyncThunk`)/ Zustand
174
+ - 原生桥接:`NativeModules` 调用 iOS(Swift) / Android(Kotlin) 原生代码
175
+ - 性能:`React.memo` / Hermes 引擎 / 新架构 JSI(无桥接序列化)
176
+
177
+ ### Flutter 核心模式
178
+
179
+ - Widget:StatelessWidget / StatefulWidget + `setState`
180
+ - 状态管理:
181
+ - Provider:`ChangeNotifier` + `Consumer` / `context.watch`
182
+ - Riverpod(推荐):`FutureProvider` / `StateNotifierProvider` + `ref.watch`
183
+ - Navigation:go_router(`GoRoute` + `context.go/push/pop`)
184
+ - 原生桥接:`MethodChannel` + Platform Channels(iOS Swift / Android Kotlin)
185
+ - 性能:`const` 构造函数 / `ListView.builder` / `RepaintBoundary` / `ValueKey`
186
+
187
+ ### 选型建议
188
+
189
+ | 场景 | 推荐 | 理由 |
190
+ |------|------|------|
191
+ | 团队有 Web 背景 | React Native | 学习成本低 |
192
+ | 追求极致性能/动画 | Flutter | 自绘引擎 60fps |
193
+ | UI 高度定制 | Flutter | 完全控制渲染 |
194
+ | 大量原生交互 | React Native | 桥接生态成熟 |
195
+ | 需要原生极致体验 | 原生开发 | 无桥接开销 |
196
+
197
+ ### 跨平台 Checklist
198
+
199
+ - [ ] 选型匹配团队技术栈和业务需求
200
+ - [ ] 列表优化:FlatList(RN) / ListView.builder(Flutter) + key
201
+ - [ ] 状态管理:Redux Toolkit(RN) / Riverpod(Flutter)
202
+ - [ ] 原生模块桥接方案验证
203
+ - [ ] 包体积优化:ProGuard(Android) / tree-shake-icons(Flutter)
204
+ - [ ] 性能基线:冷启动 < 1.5s / 渲染 > 55fps
205
+
206
+ ---
207
+
208
+ ## 通用最佳实践
209
+
210
+ | 实践 | 说明 |
211
+ |------|------|
212
+ | MVVM 架构 | 分离 UI / 业务逻辑 / 数据层 |
213
+ | 依赖注入 | Hilt(Android) / Protocol(iOS) / Context(RN) |
214
+ | 响应式状态 | StateFlow / Combine / Hooks / Riverpod |
215
+ | 网络层封装 | 统一错误处理 + Token 管理 + 重试 |
216
+ | 本地持久化 | Room / Core Data / AsyncStorage / Hive |
217
+ | 列表优化 | 懒加载 + 稳定 key + 缓存 |
218
+ | 测试覆盖 | ViewModel 单元测试 + UI 测试关键流程 |
219
+
220
+ ## 触发词
27
221
 
28
- - 原生 iOS/Android 开发
29
- - 跨平台框架选型与实现
30
- - 移动架构设计(MVVM/VIPER/Clean)
31
- - 性能优化与调试
32
- - 原生模块桥接
222
+ iOS、SwiftUI、UIKit、Combine、Android、Jetpack Compose、Kotlin、React Native、Flutter、跨平台、移动开发、MVVM
@@ -1,6 +1,7 @@
1
1
  ---
2
2
  name: orchestration
3
3
  description: 协同编排知识域。多Agent协同、任务分解、并行执行、冲突解决。当魔尊需要多Agent协作、任务编排、并行处理时使用。
4
+ license: MIT
4
5
  user-invocable: true
5
6
  ---
6
7
 
@@ -1,6 +1,7 @@
1
1
  ---
2
2
  name: security
3
3
  description: 攻防秘典索引。渗透测试、代码审计、红队攻击、蓝队防御、威胁情报、漏洞研究。当魔尊提到安全、渗透、攻防、红队、蓝队、漏洞时路由到此。
4
+ license: MIT
4
5
  ---
5
6
 
6
7
  # 攻防秘典 · 三脉道统
@@ -11,13 +12,10 @@ description: 攻防秘典索引。渗透测试、代码审计、红队攻击、
11
12
  |------|------|------|----------|
12
13
  | [pentest](pentest.md) | 🔥 赤焰 | 赤焰化身 | Web/API/内网渗透、OWASP Top 10 |
13
14
  | [code-audit](code-audit.md) | 🔥 赤焰 | 赤焰化身 | 危险函数、污点分析、漏洞挖掘 |
14
- | [red-team](red-team.md) | 🔥 赤焰 | 赤焰化身 | PoC开发、C2框架、横向移动、免杀 |
15
- | [blue-team](blue-team.md) | ❄ 玄冰 | 玄冰化身 | 检测工程、SOC运营、应急响应、取证 |
16
- | [threat-intel](threat-intel.md) | 👁 天眼 | 天眼化身 | OSINT、威胁狩猎、情报分析 |
15
+ | [red-team](red-team.md) | 🔥 赤焰 | 赤焰化身 | PoC开发、C2框架、横向移动、免杀、供应链安全 |
16
+ | [blue-team](blue-team.md) | ❄ 玄冰 | 玄冰化身 | 检测工程、SOC运营、应急响应、取证、密钥管理 |
17
+ | [threat-intel](threat-intel.md) | 👁 天眼 | 天眼化身 | OSINT、威胁狩猎、情报分析、威胁建模 |
17
18
  | [vuln-research](vuln-research.md) | 🔥 赤焰 | 赤焰化身 | 二进制分析、逆向工程、Exploit开发 |
18
- | [threat-modeling](threat-modeling.md) | 🛡️ 防御 | 设计化身 | STRIDE、PASTA、攻击树、威胁矩阵 |
19
- | [supply-chain](supply-chain.md) | 🔗 供应链 | 守护化身 | SBOM、依赖扫描、SLSA、Sigstore |
20
- | [secrets-management](secrets-management.md) | 🔐 密钥 | 守密化身 | Vault、KMS、密钥轮转、加密 |
21
19
 
22
20
  ## 攻击链视角(赤焰脉·破妄道)
23
21