本文へ移動
cccskills
無料GitHub で公開

afx-cicd-scaffold

Bootstrap a complete .github/workflows/ set for a new project: CI (build/test/lint), CD (workflow_dispatch with env choice + OIDC + ECR), security-scan (gitleaks + dependency scan + CodeQL), and optional database-migration. Use this skill when the user wants to add GitHub Actions CI/CD to a project that does not already have it, or when they want to add missing workflows alongside existing ones.

インストール方法を見る

含まれるファイル(2)

  • SKILL.md5.1 KB
  • source.json937 B

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

Artifex CI/CD Scaffold Skill

For Claude Code AI Assistant

This skill generates a production-ready .github/workflows/ set for a project, replicating the patterns used in zoe and xenia/pms. It auto-detects the project stack and produces correctly-wired workflow files with all required secrets and variables documented inline.

What this skill generates

FilePurpose
.github/workflows/ci.ymlRuns on PR open/sync: build, test, lint. Stack-aware.
.github/workflows/cd.ymlManual deploy via workflow_dispatch with environment choice (staging / prod). OIDC auth, ECR image build/push, ECS deploy.
.github/workflows/security-scan.ymlGitLeaks secret scan + OWASP dependency check + CodeQL SAST. Scheduled daily + PR trigger.
.github/workflows/database-migration.ymlOptional. Flyway migrations via Gradle. Validates on PR, deploys on workflow_dispatch.
.gitleaks.tomlGitLeaks configuration (dropped at project root alongside .github/).

Stack detection

The script scans the project root for these marker files:

MarkerDetected stack
gradlew or pom.xmlJVM/Gradle (default)
package.jsonNode.js
Cargo.tomlRust
go.modGo

If none is found, JVM/Gradle is used (the user's primary stack).

Key design decisions

  • Manual deploy only. cd.yml uses workflow_dispatch with an environment input — no auto-deploy on push to main. This is intentional and must not be changed.
  • OIDC for AWS auth. No long-lived credentials. The required IAM role pattern is documented in the cd.yml header as arn:aws:iam::<account>:role/<project>-gha-deploy-<env>.
  • Concurrency group deploy-${{ inputs.environment }} with cancel-in-progress: false. Prevents two prod deploys racing. This is the xenia/pms pattern.
  • --force required to overwrite. Existing files are never silently clobbered. New files are always added side-by-side.

Conversational Routing

User phrasingAction
"add CI/CD to my project", "scaffold GitHub Actions", "set up workflows"Run init in the project directory
"add CI/CD without the database migration"Run init --no-db-migration
"preview what would be created"Run init --dry-run
"overwrite my existing workflows"Run init --force
"add security scanning"Run init — security-scan.yml is always included

If the user is working in a specific project directory, use that directory as the target. If no project directory is given, default to the current working directory.

How to run this skill

Standard scaffolding

  1. Confirm the target project directory.
  2. Preview with --dry-run:
    ~/.claude/skills/afx-cicd-scaffold/afx-cicd-scaffold.sh init /path/to/project --dry-run
    
  3. Show the user what would be generated.
  4. If they approve, run for real (with optional --no-db-migration if they do not use a database):
    ~/.claude/skills/afx-cicd-scaffold/afx-cicd-scaffold.sh init /path/to/project
    
  5. Walk the user through the next steps printed by the script:
    • Review and customise the generated files
    • Set the secrets and variables listed in the file header comments
    • Create the OIDC IAM roles for cd.yml
    • Commit the files

Adding workflows to an existing project

If .github/workflows/ already exists:

  • New files (ones not already present) are added automatically without --force.
  • Existing files are skipped with a warning.
  • If the user wants to regenerate all files from scratch, re-run with --force.

Database migration workflow

When the script runs interactively, it prompts whether to include database-migration.yml. The user can suppress the prompt with --no-db-migration. If the session is non-interactive (piped), the migration file is skipped by default.

Required secrets and variables reference

All are documented inline in the generated file headers. Key ones for cd.yml:

NameTypeDescription
AWS_ROLE_ARN_STAGINGSecretOIDC role ARN for staging: arn:aws:iam::<acct>:role/<project>-gha-deploy-staging
AWS_ROLE_ARN_PRODSecretOIDC role ARN for production: arn:aws:iam::<acct>:role/<project>-gha-deploy-prod
STAGING_URLSecretBase URL for staging smoke tests
PROD_URLSecretBase URL for production smoke tests
AWS_REGIONVariableAWS region (e.g. us-east-1)
ECR_REPOSITORYVariableECR repository name
ECS_SERVICEVariableECS service name
ECS_CLUSTER_STAGINGVariableECS cluster name for staging
ECS_CLUSTER_PRODVariableECS cluster name for production

Version

1.0.0 (ticket 12.2)

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

007

無料

Security audit, hardening, threat modeling (STRIDE/PASTA), Red/Blue Team, OWASP checks, code review, incident response, and infrastructure security for any project.

日本語の概要は準備中です。原文の説明を表示しています。

aibot88/sec_skill_store42026年5月27日 更新

Guides the creation of agile user stories and Gherkin feature files. Use when the user wants to create a user story, write acceptance criteria, define Gherkin scenarios, or author BDD feature files. This should trigger for requests such as Create a user story; Write a user story; I need to write a user story. Part of cursor-rules-java project

日本語の概要は準備中です。原文の説明を表示しています。

aibot88/sec_skill_store42026年5月27日 更新

Facilitates conversational discovery to create Architectural Decision Records (ADRs) for non-functional requirements using the ISO/IEC 25010:2023 quality model. Use when the user wants to document quality attributes, NFR decisions, security/performance/scalability architecture, or design systems with measurable quality criteria. This should trigger for requests such as Create ADR for Non-functional requirements; Document Non-functional requirements; Capture Non-functional requirements; Generate Non-functional requirements in an ADR. Part of cursor-rules-java project

日本語の概要は準備中です。原文の説明を表示しています。

aibot88/sec_skill_store42026年5月27日 更新

Run a health check on an existing project: dependency audit, security scan, test runner detection, CI/CD evaluation, and missing configuration analysis. Maps the three execution gates (pre/in/post) from /10x-bootstrapper to an assessment framework for existing codebases. Reads optional context/foundation/stack-assessment.md from /10x-stack-assess to focus checks on identified gaps. Writes context/foundation/health-check.md with findings, prioritized fixes, and an agent-readiness verdict. Use when the user has an existing project and wants to verify its health before working with an agent. Trigger phrases: "health check", "check my project", "audit my project", "is my project healthy", "sprawdź projekt", "audyt projektu", "health-check", "project health". Use AFTER /10x-stack-assess (brownfield chain), BEFORE agent onboarding (m1-l4).

日本語の概要は準備中です。原文の説明を表示しています。

aibot88/sec_skill_store42026年5月27日 更新

10x-team

無料

You MUST use this when building projects end-to-end. Orchestrates all 12 team roles — automatically switches between CTO, architect, PM, engineers, SRE, security, DBA, QA, and EM based on the current phase of work. Starts with brainstorming before any implementation.

日本語の概要は準備中です。原文の説明を表示しています。

aibot88/sec_skill_store42026年5月27日 更新

Use when you need to add or configure Maven plugins in your pom.xml — including quality tools (enforcer, surefire, failsafe, jacoco, pitest, spotbugs, pmd), security scanning (OWASP), code formatting (Spotless), version management, container image build (Jib), build information tracking, and benchmarking (JMH) — through a consultative, modular step-by-step approach that only adds what you actually need. This should trigger for requests such as Add Maven plugins in pom.xml; Improve Maven plugins in pom.xml. Part of cursor-rules-java project

日本語の概要は準備中です。原文の説明を表示しています。

aibot88/sec_skill_store42026年5月27日 更新

aibot88 のスキルをすべて見る

このスキルの問題を報告する