@tinkcarlos/skillora 0.2.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 (234) hide show
  1. package/.claude/skills/.temp-skill-index.md +245 -0
  2. package/.claude/skills/SKILL.md +264 -0
  3. package/.claude/skills/api-scaffolding/SKILL.md +431 -0
  4. package/.claude/skills/api-scaffolding/agents/backend-architect.md +282 -0
  5. package/.claude/skills/api-scaffolding/agents/django-pro.md +144 -0
  6. package/.claude/skills/api-scaffolding/agents/fastapi-pro.md +156 -0
  7. package/.claude/skills/api-scaffolding/agents/graphql-architect.md +146 -0
  8. package/.claude/skills/api-scaffolding/skills/fastapi-templates/SKILL.md +171 -0
  9. package/.claude/skills/api-testing-observability/SKILL.md +583 -0
  10. package/.claude/skills/api-testing-observability/agents/api-documenter.md +146 -0
  11. package/.claude/skills/api-testing-observability/commands/api-mock.md +1320 -0
  12. package/.claude/skills/brainstorming/SKILL.md +283 -0
  13. package/.claude/skills/bug-fixing/SKILL.md +382 -0
  14. package/.claude/skills/bug-fixing/references/backend-guide.md +132 -0
  15. package/.claude/skills/bug-fixing/references/bug-guide.md +354 -0
  16. package/.claude/skills/bug-fixing/references/bug-record-template.md +134 -0
  17. package/.claude/skills/bug-fixing/references/bug-records.md +88 -0
  18. package/.claude/skills/bug-fixing/references/code-review-gate.md +81 -0
  19. package/.claude/skills/bug-fixing/references/common-bugs.md +140 -0
  20. package/.claude/skills/bug-fixing/references/complete-workflow.md +361 -0
  21. package/.claude/skills/bug-fixing/references/config-driven-fixes.md +136 -0
  22. package/.claude/skills/bug-fixing/references/context-isolation-protocol.md +268 -0
  23. package/.claude/skills/bug-fixing/references/cross-surface-regression.md +120 -0
  24. package/.claude/skills/bug-fixing/references/database-investigation.md +129 -0
  25. package/.claude/skills/bug-fixing/references/dependency-and-integrity-protocol.md +369 -0
  26. package/.claude/skills/bug-fixing/references/fix-completeness-checklist.md +239 -0
  27. package/.claude/skills/bug-fixing/references/frontend-guide.md +219 -0
  28. package/.claude/skills/bug-fixing/references/fullstack-joint-guide.md +123 -0
  29. package/.claude/skills/bug-fixing/references/functional-breakage.md +117 -0
  30. package/.claude/skills/bug-fixing/references/ide-lint-errors-guide.md +176 -0
  31. package/.claude/skills/bug-fixing/references/impact-analysis.md +511 -0
  32. package/.claude/skills/bug-fixing/references/investigation-checklist.md +263 -0
  33. package/.claude/skills/bug-fixing/references/knowledge-extraction-guide.md +531 -0
  34. package/.claude/skills/bug-fixing/references/knowledge-workflow.md +212 -0
  35. package/.claude/skills/bug-fixing/references/post-edit-quality-gate.md +30 -0
  36. package/.claude/skills/bug-fixing/references/python-env-and-testing.md +126 -0
  37. package/.claude/skills/bug-fixing/references/rca-guide.md +428 -0
  38. package/.claude/skills/bug-fixing/references/similar-bug-patterns.md +113 -0
  39. package/.claude/skills/bug-fixing/references/skill-delegation-guide.md +350 -0
  40. package/.claude/skills/bug-fixing/references/skill-orchestration.md +155 -0
  41. package/.claude/skills/bug-fixing/references/testing-strategy.md +350 -0
  42. package/.claude/skills/bug-fixing/references/tooling-build-scripts.md +162 -0
  43. package/.claude/skills/bug-fixing/references/user-input-validation.md +77 -0
  44. package/.claude/skills/bug-fixing/references/ux-patterns.md +158 -0
  45. package/.claude/skills/bug-fixing/references/windows-terminal-hygiene.md +106 -0
  46. package/.claude/skills/bug-fixing/references/zero-regression-matrix.md +239 -0
  47. package/.claude/skills/bug-fixing/references/zero-risk-protocol.md +102 -0
  48. package/.claude/skills/bug-fixing/scripts/format_code.py +611 -0
  49. package/.claude/skills/bug-fixing/scripts/generate_report_template.py +74 -0
  50. package/.claude/skills/bug-fixing/scripts/lint_check.py +816 -0
  51. package/.claude/skills/bug-fixing/scripts/requirements.txt +36 -0
  52. package/.claude/skills/cicd-pipeline/SKILL.md +300 -0
  53. package/.claude/skills/code-review/SKILL.md +535 -0
  54. package/.claude/skills/code-review/references/anti-pattern-scan.md +102 -0
  55. package/.claude/skills/code-review/references/automated-analysis.md +456 -0
  56. package/.claude/skills/code-review/references/backend-common-issues.md +589 -0
  57. package/.claude/skills/code-review/references/backend-expert-guide.md +415 -0
  58. package/.claude/skills/code-review/references/backend-review.md +868 -0
  59. package/.claude/skills/code-review/references/batch-processing-strategy.md +198 -0
  60. package/.claude/skills/code-review/references/call-chain-analysis-protocol.md +166 -0
  61. package/.claude/skills/code-review/references/common-patterns.md +321 -0
  62. package/.claude/skills/code-review/references/configuration-review.md +425 -0
  63. package/.claude/skills/code-review/references/control-flow-completeness.md +114 -0
  64. package/.claude/skills/code-review/references/database-review.md +298 -0
  65. package/.claude/skills/code-review/references/dependency-and-integrity-protocol.md +313 -0
  66. package/.claude/skills/code-review/references/external-standards.md +51 -0
  67. package/.claude/skills/code-review/references/feature-review.md +329 -0
  68. package/.claude/skills/code-review/references/file-review-template.md +326 -0
  69. package/.claude/skills/code-review/references/frontend-advanced.md +654 -0
  70. package/.claude/skills/code-review/references/frontend-common-issues.md +482 -0
  71. package/.claude/skills/code-review/references/frontend-expert-guide.md +342 -0
  72. package/.claude/skills/code-review/references/frontend-review.md +783 -0
  73. package/.claude/skills/code-review/references/fullstack-consistency.md +418 -0
  74. package/.claude/skills/code-review/references/fullstack-review.md +477 -0
  75. package/.claude/skills/code-review/references/functional-completeness.md +386 -0
  76. package/.claude/skills/code-review/references/hidden-bugs-detection.md +473 -0
  77. package/.claude/skills/code-review/references/ide-lint-errors-guide.md +173 -0
  78. package/.claude/skills/code-review/references/infrastructure-review.md +453 -0
  79. package/.claude/skills/code-review/references/iteration-review.md +264 -0
  80. package/.claude/skills/code-review/references/job-review.md +335 -0
  81. package/.claude/skills/code-review/references/layered-checklist-protocol.md +157 -0
  82. package/.claude/skills/code-review/references/logic-completeness.md +535 -0
  83. package/.claude/skills/code-review/references/mandatory-checklist.md +288 -0
  84. package/.claude/skills/code-review/references/multi-language-guide.md +800 -0
  85. package/.claude/skills/code-review/references/new-project-review.md +226 -0
  86. package/.claude/skills/code-review/references/non-code-files-review.md +451 -0
  87. package/.claude/skills/code-review/references/overlooked-issues.md +657 -0
  88. package/.claude/skills/code-review/references/platform-specific-review.md +195 -0
  89. package/.claude/skills/code-review/references/precision-analysis-protocol.md +260 -0
  90. package/.claude/skills/code-review/references/python-patterns.md +494 -0
  91. package/.claude/skills/code-review/references/rca-techniques.md +362 -0
  92. package/.claude/skills/code-review/references/report-template.md +430 -0
  93. package/.claude/skills/code-review/references/resource-limits-and-degradation.md +137 -0
  94. package/.claude/skills/code-review/references/review-dimensions.md +311 -0
  95. package/.claude/skills/code-review/references/review-guide.md +202 -0
  96. package/.claude/skills/code-review/references/review-knowledge-workflow.md +257 -0
  97. package/.claude/skills/code-review/references/review-progress-tracker-protocol.md +172 -0
  98. package/.claude/skills/code-review/references/review-record-template.md +195 -0
  99. package/.claude/skills/code-review/references/skill-orchestration.md +143 -0
  100. package/.claude/skills/code-review/references/ui-ux-review.md +470 -0
  101. package/.claude/skills/containerization/SKILL.md +313 -0
  102. package/.claude/skills/database-migrations/agents/database-admin.md +142 -0
  103. package/.claude/skills/database-migrations/agents/database-optimizer.md +144 -0
  104. package/.claude/skills/database-migrations/commands/migration-observability.md +408 -0
  105. package/.claude/skills/database-migrations/commands/sql-migrations.md +492 -0
  106. package/.claude/skills/finishing-a-development-branch/SKILL.md +319 -0
  107. package/.claude/skills/frontend-design/LICENSE.txt +177 -0
  108. package/.claude/skills/frontend-design/SKILL.md +587 -0
  109. package/.claude/skills/frontend-design/references/color-consistency.md +487 -0
  110. package/.claude/skills/frontend-design/references/color-palettes-full.md +657 -0
  111. package/.claude/skills/frontend-design/references/design-system-generator.md +285 -0
  112. package/.claude/skills/frontend-design/references/font-pairings-full.md +705 -0
  113. package/.claude/skills/frontend-design/references/industry-anti-patterns.md +281 -0
  114. package/.claude/skills/frontend-design/references/layout-anti-patterns.md +582 -0
  115. package/.claude/skills/frontend-design/references/motion-patterns.md +659 -0
  116. package/.claude/skills/frontend-design/references/pre-delivery-checklist.md +153 -0
  117. package/.claude/skills/frontend-design/references/responsive-design.md +555 -0
  118. package/.claude/skills/frontend-design/references/style-modification-rules.md +335 -0
  119. package/.claude/skills/frontend-design/references/ui-styles-full.md +383 -0
  120. package/.claude/skills/frontend-design/references/ui-styles-rating.md +191 -0
  121. package/.claude/skills/frontend-design/references/ux-guidelines.md +640 -0
  122. package/.claude/skills/fullstack-developer/SKILL.md +512 -0
  123. package/.claude/skills/fullstack-developer/references/api-contract-guide.md +312 -0
  124. package/.claude/skills/fullstack-developer/references/api-response-patterns.md +223 -0
  125. package/.claude/skills/fullstack-developer/references/async-patterns.md +220 -0
  126. package/.claude/skills/fullstack-developer/references/bug-prevention.md +914 -0
  127. package/.claude/skills/fullstack-developer/references/code-quality-checklist.md +271 -0
  128. package/.claude/skills/fullstack-developer/references/complete-development-workflow.md +278 -0
  129. package/.claude/skills/fullstack-developer/references/context-isolation-protocol.md +256 -0
  130. package/.claude/skills/fullstack-developer/references/database-migration.md +331 -0
  131. package/.claude/skills/fullstack-developer/references/dependency-and-integrity-protocol.md +390 -0
  132. package/.claude/skills/fullstack-developer/references/development-phases.md +333 -0
  133. package/.claude/skills/fullstack-developer/references/expert-guide.md +214 -0
  134. package/.claude/skills/fullstack-developer/references/file-import-patterns.md +114 -0
  135. package/.claude/skills/fullstack-developer/references/graceful-degradation-patterns.md +78 -0
  136. package/.claude/skills/fullstack-developer/references/ide-lint-errors-guide.md +183 -0
  137. package/.claude/skills/fullstack-developer/references/integration-testing.md +301 -0
  138. package/.claude/skills/fullstack-developer/references/mock-api-patterns.md +307 -0
  139. package/.claude/skills/fullstack-developer/references/phase-gate-template.md +249 -0
  140. package/.claude/skills/fullstack-developer/references/post-edit-quality-gate.md +30 -0
  141. package/.claude/skills/fullstack-developer/references/python-engineering.md +79 -0
  142. package/.claude/skills/fullstack-developer/references/skill-orchestration.md +214 -0
  143. package/.claude/skills/fullstack-developer/references/skill-router-table.md +304 -0
  144. package/.claude/skills/fullstack-developer/references/state-sync.md +217 -0
  145. package/.claude/skills/fullstack-developer/references/ui-testing-checklist.md +292 -0
  146. package/.claude/skills/fullstack-developer/scripts/format_code.py +611 -0
  147. package/.claude/skills/fullstack-developer/scripts/lint_check.py +816 -0
  148. package/.claude/skills/fullstack-developer/scripts/requirements.txt +36 -0
  149. package/.claude/skills/performance-optimization/SKILL.md +250 -0
  150. package/.claude/skills/product-requirements/SKILL.md +357 -0
  151. package/.claude/skills/product-requirements/references/acceptance-criteria.md +335 -0
  152. package/.claude/skills/product-requirements/references/answer-first-questioning-protocol.md +299 -0
  153. package/.claude/skills/product-requirements/references/competitive-analysis-guide.md +183 -0
  154. package/.claude/skills/product-requirements/references/document-accuracy-protocol.md +253 -0
  155. package/.claude/skills/product-requirements/references/document-management-protocol.md +278 -0
  156. package/.claude/skills/product-requirements/references/external-standards.md +62 -0
  157. package/.claude/skills/product-requirements/references/feature-spec-template.md +359 -0
  158. package/.claude/skills/product-requirements/references/knowledge-acquisition-protocol.md +251 -0
  159. package/.claude/skills/product-requirements/references/plan-execution-protocol.md +334 -0
  160. package/.claude/skills/product-requirements/references/plan-generation-protocol.md +264 -0
  161. package/.claude/skills/product-requirements/references/prioritization-frameworks.md +80 -0
  162. package/.claude/skills/product-requirements/references/requirement-decomposition-protocol.md +291 -0
  163. package/.claude/skills/product-requirements/references/user-story-examples.md +297 -0
  164. package/.claude/skills/product-requirements/references/workflow-templates.md +266 -0
  165. package/.claude/skills/react-best-practices/SKILL.md +198 -0
  166. package/.claude/skills/react-best-practices/references/advanced-patterns.md +94 -0
  167. package/.claude/skills/react-best-practices/references/bundle-optimization.md +182 -0
  168. package/.claude/skills/react-best-practices/references/client-data-fetching.md +112 -0
  169. package/.claude/skills/react-best-practices/references/complete-guide.md +2249 -0
  170. package/.claude/skills/react-best-practices/references/eliminating-waterfalls.md +169 -0
  171. package/.claude/skills/react-best-practices/references/javascript-performance.md +256 -0
  172. package/.claude/skills/react-best-practices/references/rendering-performance.md +230 -0
  173. package/.claude/skills/react-best-practices/references/rerender-optimization.md +214 -0
  174. package/.claude/skills/react-best-practices/references/server-performance.md +182 -0
  175. package/.claude/skills/security-audit/SKILL.md +226 -0
  176. package/.claude/skills/shared-references/advanced-debugging-techniques.md +186 -0
  177. package/.claude/skills/shared-references/code-quality-checklist.md +218 -0
  178. package/.claude/skills/shared-references/code-review-efficiency-guide.md +125 -0
  179. package/.claude/skills/shared-references/mcp-dependency-compatibility-protocol.md +276 -0
  180. package/.claude/skills/shared-references/skill-call-graph.md +230 -0
  181. package/.claude/skills/shared-references/skill-orchestration-protocol.md +281 -0
  182. package/.claude/skills/shared-references/subagent-dispatch-templates.md +199 -0
  183. package/.claude/skills/skill-expert-skills/LICENSE.txt +204 -0
  184. package/.claude/skills/skill-expert-skills/QUICK_NAVIGATION.md +374 -0
  185. package/.claude/skills/skill-expert-skills/SKILL.md +247 -0
  186. package/.claude/skills/skill-expert-skills/docs/_index.md +91 -0
  187. package/.claude/skills/skill-expert-skills/references/deep-research-methodology.md +389 -0
  188. package/.claude/skills/skill-expert-skills/references/docs-generation-workflow.md +398 -0
  189. package/.claude/skills/skill-expert-skills/references/domain-expertise-protocol.md +343 -0
  190. package/.claude/skills/skill-expert-skills/references/domain-knowledge/_index.md +54 -0
  191. package/.claude/skills/skill-expert-skills/references/domain-knowledge/backend-expertise.md +517 -0
  192. package/.claude/skills/skill-expert-skills/references/domain-knowledge/bug-fixing-expertise.md +363 -0
  193. package/.claude/skills/skill-expert-skills/references/domain-knowledge/code-review-expertise.md +392 -0
  194. package/.claude/skills/skill-expert-skills/references/domain-knowledge/frontend-expertise.md +410 -0
  195. package/.claude/skills/skill-expert-skills/references/domain-knowledge-template.md +503 -0
  196. package/.claude/skills/skill-expert-skills/references/examples.md +782 -0
  197. package/.claude/skills/skill-expert-skills/references/integration-examples.md +655 -0
  198. package/.claude/skills/skill-expert-skills/references/knowledge-validation-checklist.md +246 -0
  199. package/.claude/skills/skill-expert-skills/references/latest-knowledge-acquisition.md +461 -0
  200. package/.claude/skills/skill-expert-skills/references/mcp-tools-guide.md +439 -0
  201. package/.claude/skills/skill-expert-skills/references/official-best-practices.md +616 -0
  202. package/.claude/skills/skill-expert-skills/references/patterns.md +218 -0
  203. package/.claude/skills/skill-expert-skills/references/plugin-skills-guide.md +432 -0
  204. package/.claude/skills/skill-expert-skills/references/requirement-elicitation-protocol.md +290 -0
  205. package/.claude/skills/skill-expert-skills/references/skill-creator-SKILL.md +353 -0
  206. package/.claude/skills/skill-expert-skills/references/skill-templates.md +583 -0
  207. package/.claude/skills/skill-expert-skills/references/skills-knowledge-base.md +561 -0
  208. package/.claude/skills/skill-expert-skills/references/tools-guide.md +379 -0
  209. package/.claude/skills/skill-expert-skills/references/troubleshooting.md +378 -0
  210. package/.claude/skills/skill-expert-skills/references/universality-guide.md +205 -0
  211. package/.claude/skills/skill-expert-skills/references/writing-style-guide.md +466 -0
  212. package/.claude/skills/skill-expert-skills/scripts/__pycache__/quick_validate.cpython-313.pyc +0 -0
  213. package/.claude/skills/skill-expert-skills/scripts/__pycache__/universal_validate.cpython-313.pyc +0 -0
  214. package/.claude/skills/skill-expert-skills/scripts/analyze_trigger.py +425 -0
  215. package/.claude/skills/skill-expert-skills/scripts/diff_with_official.py +188 -0
  216. package/.claude/skills/skill-expert-skills/scripts/init_skill.py +349 -0
  217. package/.claude/skills/skill-expert-skills/scripts/package_skill.py +156 -0
  218. package/.claude/skills/skill-expert-skills/scripts/quick_validate.py +493 -0
  219. package/.claude/skills/skill-expert-skills/scripts/requirements.txt +2 -0
  220. package/.claude/skills/skill-expert-skills/scripts/universal_validate.py +182 -0
  221. package/.claude/skills/skill-expert-skills/scripts/upgrade_skill.py +431 -0
  222. package/.claude/skills/subagent-driven-development/SKILL.md +268 -0
  223. package/.claude/skills/test-driven-development/SKILL.md +246 -0
  224. package/.claude/skills/test-driven-development/references/testing-anti-patterns.md +192 -0
  225. package/.claude/skills/using-git-worktrees/SKILL.md +266 -0
  226. package/.claude/skills/using-skillstack/SKILL.md +127 -0
  227. package/.claude/skills/vercel-deploy/SKILL.md +166 -0
  228. package/.claude/skills/vercel-deploy/scripts/deploy.sh +249 -0
  229. package/.claude/skills/verification-before-completion/SKILL.md +305 -0
  230. package/.claude/skills/writing-plans/SKILL.md +259 -0
  231. package/README.md +69 -0
  232. package/bin/cli.js +468 -0
  233. package/lib/init.js +333 -0
  234. package/package.json +29 -0
@@ -0,0 +1,36 @@
1
+ # Bug-fixing scripts dependencies
2
+ # Install: pip install -r requirements.txt
3
+
4
+ # === Required (for scripts to run) ===
5
+ # None - scripts use standard library only
6
+
7
+ # === Recommended formatters ===
8
+ ruff>=0.1.0 # Fast Python linter + formatter (replaces black, isort, flake8)
9
+ black>=23.0.0 # Python formatter (fallback if ruff unavailable)
10
+
11
+ # === Recommended linters ===
12
+ mypy>=1.0.0 # Python static type checker
13
+ pylint>=3.0.0 # Python linter (optional, ruff preferred)
14
+
15
+ # === For JavaScript/TypeScript projects ===
16
+ # Install via npm:
17
+ # npm install -g prettier # JS/TS/CSS/HTML formatter
18
+ # npm install -g eslint # JS/TS linter
19
+ # npm install -g typescript # TypeScript compiler (for type checking)
20
+
21
+ # === For Go projects ===
22
+ # gofmt is included with Go installation
23
+
24
+ # === For Rust projects ===
25
+ # rustfmt: rustup component add rustfmt
26
+
27
+ # === Quick install commands ===
28
+ # Python formatters/linters:
29
+ # pip install ruff mypy
30
+ #
31
+ # Node.js formatters/linters:
32
+ # npm install -g prettier eslint typescript
33
+ #
34
+ # Check dependencies:
35
+ # python format_code.py --check-deps
36
+ # python lint_check.py --check-deps
@@ -0,0 +1,300 @@
1
+ ---
2
+ name: cicd-pipeline
3
+ description: |
4
+ CI/CD pipeline configuration with GitHub Actions, GitLab CI, and DevSecOps.
5
+
6
+ Use when:
7
+ - Setting up CI/CD pipelines
8
+ - Configuring GitHub Actions workflows
9
+ - Implementing automated testing/deployment
10
+ - Adding security scanning to pipelines
11
+
12
+ Key Features:
13
+ - GitHub Actions / GitLab CI templates
14
+ - Multi-stage pipelines
15
+ - Security scanning integration
16
+ - Deployment strategies
17
+ allowed-tools: [read, write, execute, grep, glob]
18
+ ---
19
+
20
+ # CI/CD Pipeline
21
+
22
+ Automate everything, trust nothing.
23
+
24
+ ## The Iron Law
25
+
26
+ ```
27
+ NO MERGE WITHOUT CI. NO DEPLOY WITHOUT CD. NO PIPELINE WITHOUT SECURITY.
28
+ ```
29
+
30
+ ---
31
+
32
+ ## Quick Start
33
+
34
+ ```
35
+ CI/CD 需求
36
+
37
+
38
+ ┌─────────────────────────────────────────────────────────────┐
39
+ │ Step 1: 选择平台 │
40
+ │ ─────────────────────────────────────────────────────────── │
41
+ │ GitHub → GitHub Actions │
42
+ │ GitLab → GitLab CI │
43
+ │ 自托管 → Jenkins / Drone │
44
+ └─────────────────────────────────────────────────────────────┘
45
+
46
+
47
+ ┌─────────────────────────────────────────────────────────────┐
48
+ │ Step 2: 配置流水线 │
49
+ │ ─────────────────────────────────────────────────────────── │
50
+ │ 1. 代码检查 (Lint + Type Check) │
51
+ │ 2. 测试 (Unit + Integration) │
52
+ │ 3. 安全扫描 (SAST + Dependency) │
53
+ │ 4. 构建 (Build + Docker) │
54
+ │ 5. 部署 (Staging → Production) │
55
+ └─────────────────────────────────────────────────────────────┘
56
+ ```
57
+
58
+ ---
59
+
60
+ ## 🔴 GitHub Actions 模板
61
+
62
+ ### 基础 CI
63
+
64
+ ```yaml
65
+ # .github/workflows/ci.yml
66
+ name: CI
67
+
68
+ on:
69
+ push:
70
+ branches: [main, develop]
71
+ pull_request:
72
+ branches: [main]
73
+
74
+ jobs:
75
+ lint:
76
+ runs-on: ubuntu-latest
77
+ steps:
78
+ - uses: actions/checkout@v4
79
+ - uses: actions/setup-node@v4
80
+ with:
81
+ node-version: '20'
82
+ cache: 'npm'
83
+ - run: npm ci
84
+ - run: npm run lint
85
+ - run: npm run type-check
86
+
87
+ test:
88
+ runs-on: ubuntu-latest
89
+ needs: lint
90
+ steps:
91
+ - uses: actions/checkout@v4
92
+ - uses: actions/setup-node@v4
93
+ with:
94
+ node-version: '20'
95
+ cache: 'npm'
96
+ - run: npm ci
97
+ - run: npm test -- --coverage
98
+ - uses: codecov/codecov-action@v4
99
+
100
+ security:
101
+ runs-on: ubuntu-latest
102
+ steps:
103
+ - uses: actions/checkout@v4
104
+ - run: npm audit --audit-level=high
105
+ - uses: snyk/actions/node@master
106
+ env:
107
+ SNYK_TOKEN: ${{ secrets.SNYK_TOKEN }}
108
+ ```
109
+
110
+ ### CD 部署
111
+
112
+ ```yaml
113
+ # .github/workflows/deploy.yml
114
+ name: Deploy
115
+
116
+ on:
117
+ push:
118
+ branches: [main]
119
+
120
+ jobs:
121
+ deploy:
122
+ runs-on: ubuntu-latest
123
+ environment: production
124
+ steps:
125
+ - uses: actions/checkout@v4
126
+ - run: npm ci && npm run build
127
+ - uses: amondnet/vercel-action@v25
128
+ with:
129
+ vercel-token: ${{ secrets.VERCEL_TOKEN }}
130
+ vercel-org-id: ${{ secrets.VERCEL_ORG_ID }}
131
+ vercel-project-id: ${{ secrets.VERCEL_PROJECT_ID }}
132
+ vercel-args: '--prod'
133
+ ```
134
+
135
+ ---
136
+
137
+ ## 🔴 GitLab CI 模板
138
+
139
+ ```yaml
140
+ # .gitlab-ci.yml
141
+ stages:
142
+ - lint
143
+ - test
144
+ - security
145
+ - build
146
+ - deploy
147
+
148
+ variables:
149
+ NODE_VERSION: "20"
150
+
151
+ lint:
152
+ stage: lint
153
+ image: node:${NODE_VERSION}
154
+ script:
155
+ - npm ci
156
+ - npm run lint
157
+ - npm run type-check
158
+ cache:
159
+ paths:
160
+ - node_modules/
161
+
162
+ test:
163
+ stage: test
164
+ image: node:${NODE_VERSION}
165
+ script:
166
+ - npm ci
167
+ - npm test -- --coverage
168
+ coverage: '/Lines\s*:\s*(\d+\.?\d*)%/'
169
+ artifacts:
170
+ reports:
171
+ coverage_report:
172
+ coverage_format: cobertura
173
+ path: coverage/cobertura-coverage.xml
174
+
175
+ security:
176
+ stage: security
177
+ image: node:${NODE_VERSION}
178
+ script:
179
+ - npm audit --audit-level=high
180
+ allow_failure: true
181
+
182
+ build:
183
+ stage: build
184
+ image: docker:latest
185
+ services:
186
+ - docker:dind
187
+ script:
188
+ - docker build -t $CI_REGISTRY_IMAGE:$CI_COMMIT_SHA .
189
+ - docker push $CI_REGISTRY_IMAGE:$CI_COMMIT_SHA
190
+
191
+ deploy:
192
+ stage: deploy
193
+ environment: production
194
+ only:
195
+ - main
196
+ script:
197
+ - echo "Deploying to production..."
198
+ ```
199
+
200
+ ---
201
+
202
+ ## 🔴 流水线阶段
203
+
204
+ | 阶段 | 内容 | 失败处理 |
205
+ |------|------|----------|
206
+ | **Lint** | ESLint, Prettier, Type Check | 阻塞 |
207
+ | **Test** | Unit, Integration | 阻塞 |
208
+ | **Security** | SAST, Dependency Scan | 阻塞 (P0/P1) |
209
+ | **Build** | Docker, Artifacts | 阻塞 |
210
+ | **Deploy Staging** | 预发布环境 | 阻塞 |
211
+ | **Deploy Prod** | 生产环境 | 需审批 |
212
+
213
+ ---
214
+
215
+ ## 🔴 安全集成
216
+
217
+ ### 依赖扫描
218
+
219
+ ```yaml
220
+ # GitHub Actions
221
+ - uses: snyk/actions/node@master
222
+ - run: npm audit --audit-level=high
223
+
224
+ # GitLab CI
225
+ include:
226
+ - template: Security/Dependency-Scanning.gitlab-ci.yml
227
+ ```
228
+
229
+ ### SAST 扫描
230
+
231
+ ```yaml
232
+ # GitHub Actions
233
+ - uses: github/codeql-action/analyze@v3
234
+
235
+ # GitLab CI
236
+ include:
237
+ - template: Security/SAST.gitlab-ci.yml
238
+ ```
239
+
240
+ ### Secret 扫描
241
+
242
+ ```yaml
243
+ # GitHub Actions
244
+ - uses: trufflesecurity/trufflehog@main
245
+ with:
246
+ path: ./
247
+ base: ${{ github.event.repository.default_branch }}
248
+ ```
249
+
250
+ ---
251
+
252
+ ## 🔴 部署策略
253
+
254
+ | 策略 | 适用场景 | 风险 |
255
+ |------|----------|------|
256
+ | **Rolling** | 无状态服务 | 低 |
257
+ | **Blue-Green** | 需要快速回滚 | 中 |
258
+ | **Canary** | 大流量服务 | 低 |
259
+ | **Feature Flag** | 渐进式发布 | 低 |
260
+
261
+ ---
262
+
263
+ ## 输出契约
264
+
265
+ ```markdown
266
+ ## CI/CD Pipeline Report
267
+
268
+ ### 配置文件
269
+ - `.github/workflows/ci.yml`
270
+ - `.github/workflows/deploy.yml`
271
+
272
+ ### 流水线阶段
273
+ | 阶段 | 状态 | 耗时 |
274
+ |------|------|------|
275
+ | Lint | ✅ | 45s |
276
+ | Test | ✅ | 2m30s |
277
+ | Security | ✅ | 1m15s |
278
+ | Build | ✅ | 3m |
279
+ | Deploy | ✅ | 1m |
280
+
281
+ ### 安全扫描结果
282
+ - 依赖漏洞: 0 High, 2 Medium
283
+ - SAST: 0 Issues
284
+
285
+ ### 部署信息
286
+ - 环境: Production
287
+ - URL: https://app.example.com
288
+ - 版本: v1.2.3
289
+ ```
290
+
291
+ ---
292
+
293
+ ## Reference Navigation
294
+
295
+ | Situation | Read This |
296
+ |-----------|-----------|
297
+ | GitHub Actions | `references/github-actions-templates.md` |
298
+ | GitLab CI | `references/gitlab-ci-templates.md` |
299
+ | 安全扫描 | `references/security-scanning.md` |
300
+ | 部署策略 | `references/deployment-strategies.md` |