Paths: File paths (shared/, references/, ../ln-*) are relative to skills repo root. If not found at CWD, locate this SKILL.md directory and go up one level for repo root.
ln-732-cicd-generator
Type: L3 Worker
Category: 7XX Project Bootstrap
Parent: ln-730-devops-setup
Generates GitHub Actions CI pipeline for automated testing and validation.
Purpose & Scope
Creates CI/CD workflow for GitHub:
- Does: Generate .github/workflows/ci.yml with lint, test, build, docker jobs
- Does NOT: Configure deployment, manage secrets, set up CD pipelines
Inputs
| Input |
Source |
Description |
| Stack Type |
ln-730 coordinator |
backend-dotnet, backend-python |
| Versions |
Auto-detected |
Node.js, .NET or Python versions |
| Frontend Path |
Auto-detected |
Path to frontend directory |
| Build Commands |
Auto-detected |
npm scripts, dotnet/pytest commands |
Outputs
| File |
Purpose |
Template |
.github/workflows/ci.yml |
Main CI pipeline |
github_ci_dotnet.template.yml or github_ci_python.template.yml |
Workflow
Phase 1: Stack Analysis
Determine which template to use:
| Detection |
Backend Template |
.sln or .csproj present |
github_ci_dotnet.template.yml |
requirements.txt or pyproject.toml present |
github_ci_python.template.yml |
Detect commands:
- Frontend: Read scripts from package.json (lint, build, test)
- .NET: Standard dotnet restore/build/test
- Python: pip install, ruff lint, pytest
Phase 2: Variable Substitution
Replace template variables:
| Variable |
Source |
Default |
{{NODE_VERSION}} |
package.json engines |
22 |
{{DOTNET_VERSION}} |
*.csproj TargetFramework |
9.0.x |
{{PYTHON_VERSION}} |
pyproject.toml |
3.12 |
{{FRONTEND_PATH}} |
Directory detection |
src/frontend |
Phase 3: Directory Creation
Create .github/workflows/ directory if not exists.
Phase 4: File Generation
Generate ci.yml from selected template:
- Check if workflow already exists (warn before overwrite)
- Apply variable substitution
- Write to
.github/workflows/ci.yml
- Validate YAML syntax
Generated Pipeline Structure
Jobs Overview
| Job |
Purpose |
Dependencies |
| frontend |
Lint, build, test React/Vite |
None |
| backend |
Build, test .NET or Python |
None |
| docker |
Build images, health checks |
frontend, backend |
Frontend Job Steps
- Checkout code
- Setup Node.js with caching
- Install dependencies (
npm ci)
- Run linter (
npm run lint)
- Build application (
npm run build)
- Run tests (
npm test)
Backend Job Steps (.NET)
- Checkout code
- Setup .NET SDK
- Restore dependencies (
dotnet restore)
- Build (
dotnet build)
- Run tests (
dotnet test)
Backend Job Steps (Python)
- Checkout code
- Setup Python with pip caching
- Install dependencies (
pip install -r requirements.txt)
- Run linter (
ruff check)
- Run tests (
pytest)
Docker Job Steps
- Checkout code
- Build images (
docker compose build)
- Start containers (
docker compose up -d)
- Wait for startup (30 seconds)
- Health check frontend (port 3000)
- Health check backend (port 5000/8000)
- Show logs on failure
- Stop containers (
docker compose down)
Triggers
| Event |
Branches |
| Push |
main, develop |
| Pull Request |
main |
Best Practices Applied
| Practice |
Implementation |
| Dependency caching |
npm cache, pip cache |
| Pinned versions |
actions/checkout@v4, setup-node@v4 |
| Parallel jobs |
frontend and backend run in parallel |
| Fail fast |
docker job waits for both to succeed |
| Clean up |
docker compose down runs always |
| Debug support |
logs shown on failure |
Quality Criteria
Generated workflow must:
Critical Notes
- GitHub Actions Only: This skill generates only GitHub Actions workflows. No Azure/GitLab support.
- Template-based: Use templates from references/. Do NOT hardcode workflow contents.
- Idempotent: Check if .github/workflows/ exists. Warn before overwriting ci.yml.
- Version Detection: Use detected versions, not hardcoded defaults.
Reference Files
| File |
Purpose |
| github_ci.template.yml |
Full template with comments |
| github_ci_dotnet.template.yml |
Compact .NET stack template |
| github_ci_python.template.yml |
Compact Python stack template |
Version: 1.1.0
Last Updated: 2026-01-10
1---2name: ln-732-cicd-generator-53description: Generates GitHub Actions CI workflow configuration4metadata:5 source: https://skillmd.com/skills/majiayu000/ln-732-cicd-generator-56---78> **Paths:** File paths (`shared/`, `references/`, `../ln-*`) are relative to skills repo root. If not found at CWD, locate this SKILL.md directory and go up one level for repo root.910# ln-732-cicd-generator1112**Type:** L3 Worker13**Category:** 7XX Project Bootstrap14**Parent:** ln-730-devops-setup1516Generates GitHub Actions CI pipeline for automated testing and validation.1718---1920## Purpose & Scope2122Creates CI/CD workflow for GitHub:23- **Does**: Generate .github/workflows/ci.yml with lint, test, build, docker jobs24- **Does NOT**: Configure deployment, manage secrets, set up CD pipelines2526---2728## Inputs2930| Input | Source | Description |31|-------|--------|-------------|32| **Stack Type** | ln-730 coordinator | backend-dotnet, backend-python |33| **Versions** | Auto-detected | Node.js, .NET or Python versions |34| **Frontend Path** | Auto-detected | Path to frontend directory |35| **Build Commands** | Auto-detected | npm scripts, dotnet/pytest commands |3637---3839## Outputs4041| File | Purpose | Template |42|------|---------|----------|43| `.github/workflows/ci.yml` | Main CI pipeline | [github_ci_dotnet.template.yml](references/github_ci_dotnet.template.yml) or [github_ci_python.template.yml](references/github_ci_python.template.yml) |4445---4647## Workflow4849### Phase 1: Stack Analysis5051Determine which template to use:5253| Detection | Backend Template |54|-----------|------------------|55| `.sln` or `.csproj` present | github_ci_dotnet.template.yml |56| `requirements.txt` or `pyproject.toml` present | github_ci_python.template.yml |5758Detect commands:59- Frontend: Read scripts from package.json (lint, build, test)60- .NET: Standard dotnet restore/build/test61- Python: pip install, ruff lint, pytest6263### Phase 2: Variable Substitution6465Replace template variables:6667| Variable | Source | Default |68|----------|--------|---------|69| `{{NODE_VERSION}}` | package.json engines | 22 |70| `{{DOTNET_VERSION}}` | *.csproj TargetFramework | 9.0.x |71| `{{PYTHON_VERSION}}` | pyproject.toml | 3.12 |72| `{{FRONTEND_PATH}}` | Directory detection | src/frontend |7374### Phase 3: Directory Creation7576Create `.github/workflows/` directory if not exists.7778### Phase 4: File Generation7980Generate ci.yml from selected template:811. Check if workflow already exists (warn before overwrite)822. Apply variable substitution833. Write to `.github/workflows/ci.yml`844. Validate YAML syntax8586---8788## Generated Pipeline Structure8990### Jobs Overview9192| Job | Purpose | Dependencies |93|-----|---------|--------------|94| **frontend** | Lint, build, test React/Vite | None |95| **backend** | Build, test .NET or Python | None |96| **docker** | Build images, health checks | frontend, backend |9798### Frontend Job Steps991001. Checkout code1012. Setup Node.js with caching1023. Install dependencies (`npm ci`)1034. Run linter (`npm run lint`)1045. Build application (`npm run build`)1056. Run tests (`npm test`)106107### Backend Job Steps (.NET)1081091. Checkout code1102. Setup .NET SDK1113. Restore dependencies (`dotnet restore`)1124. Build (`dotnet build`)1135. Run tests (`dotnet test`)114115### Backend Job Steps (Python)1161171. Checkout code1182. Setup Python with pip caching1193. Install dependencies (`pip install -r requirements.txt`)1204. Run linter (`ruff check`)1215. Run tests (`pytest`)122123### Docker Job Steps1241251. Checkout code1262. Build images (`docker compose build`)1273. Start containers (`docker compose up -d`)1284. Wait for startup (30 seconds)1295. Health check frontend (port 3000)1306. Health check backend (port 5000/8000)1317. Show logs on failure1328. Stop containers (`docker compose down`)133134---135136## Triggers137138| Event | Branches |139|-------|----------|140| **Push** | main, develop |141| **Pull Request** | main |142143---144145## Best Practices Applied146147| Practice | Implementation |148|----------|----------------|149| **Dependency caching** | npm cache, pip cache |150| **Pinned versions** | actions/checkout@v4, setup-node@v4 |151| **Parallel jobs** | frontend and backend run in parallel |152| **Fail fast** | docker job waits for both to succeed |153| **Clean up** | docker compose down runs always |154| **Debug support** | logs shown on failure |155156---157158## Quality Criteria159160Generated workflow must:161- [ ] Pass YAML syntax validation162- [ ] Use pinned action versions (not `@latest`)163- [ ] Include dependency caching164- [ ] Have health checks for docker job165- [ ] Clean up resources on completion166167---168169## Critical Notes1701711. **GitHub Actions Only**: This skill generates only GitHub Actions workflows. No Azure/GitLab support.1722. **Template-based**: Use templates from references/. Do NOT hardcode workflow contents.1733. **Idempotent**: Check if .github/workflows/ exists. Warn before overwriting ci.yml.1744. **Version Detection**: Use detected versions, not hardcoded defaults.175176---177178## Reference Files179180| File | Purpose |181|------|---------|182| [github_ci.template.yml](references/github_ci.template.yml) | Full template with comments |183| [github_ci_dotnet.template.yml](references/github_ci_dotnet.template.yml) | Compact .NET stack template |184| [github_ci_python.template.yml](references/github_ci_python.template.yml) | Compact Python stack template |185186---187188**Version:** 1.1.0189**Last Updated:** 2026-01-10