@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.
- package/.claude/skills/.temp-skill-index.md +245 -0
- package/.claude/skills/SKILL.md +264 -0
- package/.claude/skills/api-scaffolding/SKILL.md +431 -0
- package/.claude/skills/api-scaffolding/agents/backend-architect.md +282 -0
- package/.claude/skills/api-scaffolding/agents/django-pro.md +144 -0
- package/.claude/skills/api-scaffolding/agents/fastapi-pro.md +156 -0
- package/.claude/skills/api-scaffolding/agents/graphql-architect.md +146 -0
- package/.claude/skills/api-scaffolding/skills/fastapi-templates/SKILL.md +171 -0
- package/.claude/skills/api-testing-observability/SKILL.md +583 -0
- package/.claude/skills/api-testing-observability/agents/api-documenter.md +146 -0
- package/.claude/skills/api-testing-observability/commands/api-mock.md +1320 -0
- package/.claude/skills/brainstorming/SKILL.md +283 -0
- package/.claude/skills/bug-fixing/SKILL.md +382 -0
- package/.claude/skills/bug-fixing/references/backend-guide.md +132 -0
- package/.claude/skills/bug-fixing/references/bug-guide.md +354 -0
- package/.claude/skills/bug-fixing/references/bug-record-template.md +134 -0
- package/.claude/skills/bug-fixing/references/bug-records.md +88 -0
- package/.claude/skills/bug-fixing/references/code-review-gate.md +81 -0
- package/.claude/skills/bug-fixing/references/common-bugs.md +140 -0
- package/.claude/skills/bug-fixing/references/complete-workflow.md +361 -0
- package/.claude/skills/bug-fixing/references/config-driven-fixes.md +136 -0
- package/.claude/skills/bug-fixing/references/context-isolation-protocol.md +268 -0
- package/.claude/skills/bug-fixing/references/cross-surface-regression.md +120 -0
- package/.claude/skills/bug-fixing/references/database-investigation.md +129 -0
- package/.claude/skills/bug-fixing/references/dependency-and-integrity-protocol.md +369 -0
- package/.claude/skills/bug-fixing/references/fix-completeness-checklist.md +239 -0
- package/.claude/skills/bug-fixing/references/frontend-guide.md +219 -0
- package/.claude/skills/bug-fixing/references/fullstack-joint-guide.md +123 -0
- package/.claude/skills/bug-fixing/references/functional-breakage.md +117 -0
- package/.claude/skills/bug-fixing/references/ide-lint-errors-guide.md +176 -0
- package/.claude/skills/bug-fixing/references/impact-analysis.md +511 -0
- package/.claude/skills/bug-fixing/references/investigation-checklist.md +263 -0
- package/.claude/skills/bug-fixing/references/knowledge-extraction-guide.md +531 -0
- package/.claude/skills/bug-fixing/references/knowledge-workflow.md +212 -0
- package/.claude/skills/bug-fixing/references/post-edit-quality-gate.md +30 -0
- package/.claude/skills/bug-fixing/references/python-env-and-testing.md +126 -0
- package/.claude/skills/bug-fixing/references/rca-guide.md +428 -0
- package/.claude/skills/bug-fixing/references/similar-bug-patterns.md +113 -0
- package/.claude/skills/bug-fixing/references/skill-delegation-guide.md +350 -0
- package/.claude/skills/bug-fixing/references/skill-orchestration.md +155 -0
- package/.claude/skills/bug-fixing/references/testing-strategy.md +350 -0
- package/.claude/skills/bug-fixing/references/tooling-build-scripts.md +162 -0
- package/.claude/skills/bug-fixing/references/user-input-validation.md +77 -0
- package/.claude/skills/bug-fixing/references/ux-patterns.md +158 -0
- package/.claude/skills/bug-fixing/references/windows-terminal-hygiene.md +106 -0
- package/.claude/skills/bug-fixing/references/zero-regression-matrix.md +239 -0
- package/.claude/skills/bug-fixing/references/zero-risk-protocol.md +102 -0
- package/.claude/skills/bug-fixing/scripts/format_code.py +611 -0
- package/.claude/skills/bug-fixing/scripts/generate_report_template.py +74 -0
- package/.claude/skills/bug-fixing/scripts/lint_check.py +816 -0
- package/.claude/skills/bug-fixing/scripts/requirements.txt +36 -0
- package/.claude/skills/cicd-pipeline/SKILL.md +300 -0
- package/.claude/skills/code-review/SKILL.md +535 -0
- package/.claude/skills/code-review/references/anti-pattern-scan.md +102 -0
- package/.claude/skills/code-review/references/automated-analysis.md +456 -0
- package/.claude/skills/code-review/references/backend-common-issues.md +589 -0
- package/.claude/skills/code-review/references/backend-expert-guide.md +415 -0
- package/.claude/skills/code-review/references/backend-review.md +868 -0
- package/.claude/skills/code-review/references/batch-processing-strategy.md +198 -0
- package/.claude/skills/code-review/references/call-chain-analysis-protocol.md +166 -0
- package/.claude/skills/code-review/references/common-patterns.md +321 -0
- package/.claude/skills/code-review/references/configuration-review.md +425 -0
- package/.claude/skills/code-review/references/control-flow-completeness.md +114 -0
- package/.claude/skills/code-review/references/database-review.md +298 -0
- package/.claude/skills/code-review/references/dependency-and-integrity-protocol.md +313 -0
- package/.claude/skills/code-review/references/external-standards.md +51 -0
- package/.claude/skills/code-review/references/feature-review.md +329 -0
- package/.claude/skills/code-review/references/file-review-template.md +326 -0
- package/.claude/skills/code-review/references/frontend-advanced.md +654 -0
- package/.claude/skills/code-review/references/frontend-common-issues.md +482 -0
- package/.claude/skills/code-review/references/frontend-expert-guide.md +342 -0
- package/.claude/skills/code-review/references/frontend-review.md +783 -0
- package/.claude/skills/code-review/references/fullstack-consistency.md +418 -0
- package/.claude/skills/code-review/references/fullstack-review.md +477 -0
- package/.claude/skills/code-review/references/functional-completeness.md +386 -0
- package/.claude/skills/code-review/references/hidden-bugs-detection.md +473 -0
- package/.claude/skills/code-review/references/ide-lint-errors-guide.md +173 -0
- package/.claude/skills/code-review/references/infrastructure-review.md +453 -0
- package/.claude/skills/code-review/references/iteration-review.md +264 -0
- package/.claude/skills/code-review/references/job-review.md +335 -0
- package/.claude/skills/code-review/references/layered-checklist-protocol.md +157 -0
- package/.claude/skills/code-review/references/logic-completeness.md +535 -0
- package/.claude/skills/code-review/references/mandatory-checklist.md +288 -0
- package/.claude/skills/code-review/references/multi-language-guide.md +800 -0
- package/.claude/skills/code-review/references/new-project-review.md +226 -0
- package/.claude/skills/code-review/references/non-code-files-review.md +451 -0
- package/.claude/skills/code-review/references/overlooked-issues.md +657 -0
- package/.claude/skills/code-review/references/platform-specific-review.md +195 -0
- package/.claude/skills/code-review/references/precision-analysis-protocol.md +260 -0
- package/.claude/skills/code-review/references/python-patterns.md +494 -0
- package/.claude/skills/code-review/references/rca-techniques.md +362 -0
- package/.claude/skills/code-review/references/report-template.md +430 -0
- package/.claude/skills/code-review/references/resource-limits-and-degradation.md +137 -0
- package/.claude/skills/code-review/references/review-dimensions.md +311 -0
- package/.claude/skills/code-review/references/review-guide.md +202 -0
- package/.claude/skills/code-review/references/review-knowledge-workflow.md +257 -0
- package/.claude/skills/code-review/references/review-progress-tracker-protocol.md +172 -0
- package/.claude/skills/code-review/references/review-record-template.md +195 -0
- package/.claude/skills/code-review/references/skill-orchestration.md +143 -0
- package/.claude/skills/code-review/references/ui-ux-review.md +470 -0
- package/.claude/skills/containerization/SKILL.md +313 -0
- package/.claude/skills/database-migrations/agents/database-admin.md +142 -0
- package/.claude/skills/database-migrations/agents/database-optimizer.md +144 -0
- package/.claude/skills/database-migrations/commands/migration-observability.md +408 -0
- package/.claude/skills/database-migrations/commands/sql-migrations.md +492 -0
- package/.claude/skills/finishing-a-development-branch/SKILL.md +319 -0
- package/.claude/skills/frontend-design/LICENSE.txt +177 -0
- package/.claude/skills/frontend-design/SKILL.md +587 -0
- package/.claude/skills/frontend-design/references/color-consistency.md +487 -0
- package/.claude/skills/frontend-design/references/color-palettes-full.md +657 -0
- package/.claude/skills/frontend-design/references/design-system-generator.md +285 -0
- package/.claude/skills/frontend-design/references/font-pairings-full.md +705 -0
- package/.claude/skills/frontend-design/references/industry-anti-patterns.md +281 -0
- package/.claude/skills/frontend-design/references/layout-anti-patterns.md +582 -0
- package/.claude/skills/frontend-design/references/motion-patterns.md +659 -0
- package/.claude/skills/frontend-design/references/pre-delivery-checklist.md +153 -0
- package/.claude/skills/frontend-design/references/responsive-design.md +555 -0
- package/.claude/skills/frontend-design/references/style-modification-rules.md +335 -0
- package/.claude/skills/frontend-design/references/ui-styles-full.md +383 -0
- package/.claude/skills/frontend-design/references/ui-styles-rating.md +191 -0
- package/.claude/skills/frontend-design/references/ux-guidelines.md +640 -0
- package/.claude/skills/fullstack-developer/SKILL.md +512 -0
- package/.claude/skills/fullstack-developer/references/api-contract-guide.md +312 -0
- package/.claude/skills/fullstack-developer/references/api-response-patterns.md +223 -0
- package/.claude/skills/fullstack-developer/references/async-patterns.md +220 -0
- package/.claude/skills/fullstack-developer/references/bug-prevention.md +914 -0
- package/.claude/skills/fullstack-developer/references/code-quality-checklist.md +271 -0
- package/.claude/skills/fullstack-developer/references/complete-development-workflow.md +278 -0
- package/.claude/skills/fullstack-developer/references/context-isolation-protocol.md +256 -0
- package/.claude/skills/fullstack-developer/references/database-migration.md +331 -0
- package/.claude/skills/fullstack-developer/references/dependency-and-integrity-protocol.md +390 -0
- package/.claude/skills/fullstack-developer/references/development-phases.md +333 -0
- package/.claude/skills/fullstack-developer/references/expert-guide.md +214 -0
- package/.claude/skills/fullstack-developer/references/file-import-patterns.md +114 -0
- package/.claude/skills/fullstack-developer/references/graceful-degradation-patterns.md +78 -0
- package/.claude/skills/fullstack-developer/references/ide-lint-errors-guide.md +183 -0
- package/.claude/skills/fullstack-developer/references/integration-testing.md +301 -0
- package/.claude/skills/fullstack-developer/references/mock-api-patterns.md +307 -0
- package/.claude/skills/fullstack-developer/references/phase-gate-template.md +249 -0
- package/.claude/skills/fullstack-developer/references/post-edit-quality-gate.md +30 -0
- package/.claude/skills/fullstack-developer/references/python-engineering.md +79 -0
- package/.claude/skills/fullstack-developer/references/skill-orchestration.md +214 -0
- package/.claude/skills/fullstack-developer/references/skill-router-table.md +304 -0
- package/.claude/skills/fullstack-developer/references/state-sync.md +217 -0
- package/.claude/skills/fullstack-developer/references/ui-testing-checklist.md +292 -0
- package/.claude/skills/fullstack-developer/scripts/format_code.py +611 -0
- package/.claude/skills/fullstack-developer/scripts/lint_check.py +816 -0
- package/.claude/skills/fullstack-developer/scripts/requirements.txt +36 -0
- package/.claude/skills/performance-optimization/SKILL.md +250 -0
- package/.claude/skills/product-requirements/SKILL.md +357 -0
- package/.claude/skills/product-requirements/references/acceptance-criteria.md +335 -0
- package/.claude/skills/product-requirements/references/answer-first-questioning-protocol.md +299 -0
- package/.claude/skills/product-requirements/references/competitive-analysis-guide.md +183 -0
- package/.claude/skills/product-requirements/references/document-accuracy-protocol.md +253 -0
- package/.claude/skills/product-requirements/references/document-management-protocol.md +278 -0
- package/.claude/skills/product-requirements/references/external-standards.md +62 -0
- package/.claude/skills/product-requirements/references/feature-spec-template.md +359 -0
- package/.claude/skills/product-requirements/references/knowledge-acquisition-protocol.md +251 -0
- package/.claude/skills/product-requirements/references/plan-execution-protocol.md +334 -0
- package/.claude/skills/product-requirements/references/plan-generation-protocol.md +264 -0
- package/.claude/skills/product-requirements/references/prioritization-frameworks.md +80 -0
- package/.claude/skills/product-requirements/references/requirement-decomposition-protocol.md +291 -0
- package/.claude/skills/product-requirements/references/user-story-examples.md +297 -0
- package/.claude/skills/product-requirements/references/workflow-templates.md +266 -0
- package/.claude/skills/react-best-practices/SKILL.md +198 -0
- package/.claude/skills/react-best-practices/references/advanced-patterns.md +94 -0
- package/.claude/skills/react-best-practices/references/bundle-optimization.md +182 -0
- package/.claude/skills/react-best-practices/references/client-data-fetching.md +112 -0
- package/.claude/skills/react-best-practices/references/complete-guide.md +2249 -0
- package/.claude/skills/react-best-practices/references/eliminating-waterfalls.md +169 -0
- package/.claude/skills/react-best-practices/references/javascript-performance.md +256 -0
- package/.claude/skills/react-best-practices/references/rendering-performance.md +230 -0
- package/.claude/skills/react-best-practices/references/rerender-optimization.md +214 -0
- package/.claude/skills/react-best-practices/references/server-performance.md +182 -0
- package/.claude/skills/security-audit/SKILL.md +226 -0
- package/.claude/skills/shared-references/advanced-debugging-techniques.md +186 -0
- package/.claude/skills/shared-references/code-quality-checklist.md +218 -0
- package/.claude/skills/shared-references/code-review-efficiency-guide.md +125 -0
- package/.claude/skills/shared-references/mcp-dependency-compatibility-protocol.md +276 -0
- package/.claude/skills/shared-references/skill-call-graph.md +230 -0
- package/.claude/skills/shared-references/skill-orchestration-protocol.md +281 -0
- package/.claude/skills/shared-references/subagent-dispatch-templates.md +199 -0
- package/.claude/skills/skill-expert-skills/LICENSE.txt +204 -0
- package/.claude/skills/skill-expert-skills/QUICK_NAVIGATION.md +374 -0
- package/.claude/skills/skill-expert-skills/SKILL.md +247 -0
- package/.claude/skills/skill-expert-skills/docs/_index.md +91 -0
- package/.claude/skills/skill-expert-skills/references/deep-research-methodology.md +389 -0
- package/.claude/skills/skill-expert-skills/references/docs-generation-workflow.md +398 -0
- package/.claude/skills/skill-expert-skills/references/domain-expertise-protocol.md +343 -0
- package/.claude/skills/skill-expert-skills/references/domain-knowledge/_index.md +54 -0
- package/.claude/skills/skill-expert-skills/references/domain-knowledge/backend-expertise.md +517 -0
- package/.claude/skills/skill-expert-skills/references/domain-knowledge/bug-fixing-expertise.md +363 -0
- package/.claude/skills/skill-expert-skills/references/domain-knowledge/code-review-expertise.md +392 -0
- package/.claude/skills/skill-expert-skills/references/domain-knowledge/frontend-expertise.md +410 -0
- package/.claude/skills/skill-expert-skills/references/domain-knowledge-template.md +503 -0
- package/.claude/skills/skill-expert-skills/references/examples.md +782 -0
- package/.claude/skills/skill-expert-skills/references/integration-examples.md +655 -0
- package/.claude/skills/skill-expert-skills/references/knowledge-validation-checklist.md +246 -0
- package/.claude/skills/skill-expert-skills/references/latest-knowledge-acquisition.md +461 -0
- package/.claude/skills/skill-expert-skills/references/mcp-tools-guide.md +439 -0
- package/.claude/skills/skill-expert-skills/references/official-best-practices.md +616 -0
- package/.claude/skills/skill-expert-skills/references/patterns.md +218 -0
- package/.claude/skills/skill-expert-skills/references/plugin-skills-guide.md +432 -0
- package/.claude/skills/skill-expert-skills/references/requirement-elicitation-protocol.md +290 -0
- package/.claude/skills/skill-expert-skills/references/skill-creator-SKILL.md +353 -0
- package/.claude/skills/skill-expert-skills/references/skill-templates.md +583 -0
- package/.claude/skills/skill-expert-skills/references/skills-knowledge-base.md +561 -0
- package/.claude/skills/skill-expert-skills/references/tools-guide.md +379 -0
- package/.claude/skills/skill-expert-skills/references/troubleshooting.md +378 -0
- package/.claude/skills/skill-expert-skills/references/universality-guide.md +205 -0
- package/.claude/skills/skill-expert-skills/references/writing-style-guide.md +466 -0
- package/.claude/skills/skill-expert-skills/scripts/__pycache__/quick_validate.cpython-313.pyc +0 -0
- package/.claude/skills/skill-expert-skills/scripts/__pycache__/universal_validate.cpython-313.pyc +0 -0
- package/.claude/skills/skill-expert-skills/scripts/analyze_trigger.py +425 -0
- package/.claude/skills/skill-expert-skills/scripts/diff_with_official.py +188 -0
- package/.claude/skills/skill-expert-skills/scripts/init_skill.py +349 -0
- package/.claude/skills/skill-expert-skills/scripts/package_skill.py +156 -0
- package/.claude/skills/skill-expert-skills/scripts/quick_validate.py +493 -0
- package/.claude/skills/skill-expert-skills/scripts/requirements.txt +2 -0
- package/.claude/skills/skill-expert-skills/scripts/universal_validate.py +182 -0
- package/.claude/skills/skill-expert-skills/scripts/upgrade_skill.py +431 -0
- package/.claude/skills/subagent-driven-development/SKILL.md +268 -0
- package/.claude/skills/test-driven-development/SKILL.md +246 -0
- package/.claude/skills/test-driven-development/references/testing-anti-patterns.md +192 -0
- package/.claude/skills/using-git-worktrees/SKILL.md +266 -0
- package/.claude/skills/using-skillstack/SKILL.md +127 -0
- package/.claude/skills/vercel-deploy/SKILL.md +166 -0
- package/.claude/skills/vercel-deploy/scripts/deploy.sh +249 -0
- package/.claude/skills/verification-before-completion/SKILL.md +305 -0
- package/.claude/skills/writing-plans/SKILL.md +259 -0
- package/README.md +69 -0
- package/bin/cli.js +468 -0
- package/lib/init.js +333 -0
- 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` |
|