circleci-config
GitHub优化CircleCI配置以提升速度、稳定性和可维护性。用于改善构建性能，减少流水线浪费，调整缓存与工作区策略，解决配置导致的测试不稳定问题，并提供基线分析与验证方案。
Trigger Scenarios
Install
npx skills add fanfan-de/anybox --skill circleci-config -g -y
SKILL.md
Frontmatter
{
"name": "circleci-config",
"description": "Optimize CircleCI configuration for speed, reliability, and maintainability. Use when users ask to improve `.circleci\/config.yml`, reduce CI runtime, tune caching\/workspaces\/parallelism, remove pipeline waste, or fix flaky pipeline behavior caused by configuration choices."
}
CircleCI Config
Overview
Use this skill to improve CircleCI performance and stability without changing product behavior. Focus on measured bottlenecks first, then implement the smallest safe config changes with clear validation criteria.
Read references/cache-optimization.md when the request involves save_cache, restore_cache, persist_to_workspace, attach_workspace, cache key design, dependency caching, lockfiles, or complaints about low cache hit rates, oversized caches, or wasted persistence steps.
Read references/persisting-data.md when the request involves choosing between caches, workspaces, and artifacts, or when data is being moved between jobs inefficiently.
Read references/test-results-and-splitting.md when the request involves slow test jobs, parallelism, flaky test visibility, missing JUnit XML, or circleci tests run.
Read references/patterns.md when the request involves approvals, branch/tag filters, schedules, deploy flow structure, or environment promotion patterns.
Inputs To Gather
.yamland.ymlfiles in.circleci/and any reusable config fragments- Current pain points: duration, flakiness, cost, or maintainability
- Baseline metrics: slowest jobs, most frequent retries/failures, queue and run times
- Risk tolerance for structural changes
Workflow
- Build a baseline.
- Identify top 1-3 longest jobs and top flaky jobs.
- Capture before metrics (duration, pass rate, retries).
- Remove pipeline waste.
- Eliminate duplicate jobs/workflows.
- Tighten branch/tag filters and workflow triggers.
- Improve dependency and artifact flow.
- Fix cache keys to include deterministic lockfile checks.
- Use workspaces/artifacts to avoid rebuilding identical outputs.
- Prefer cache scopes that are narrow, reproducible, and cheap to restore.
- Apply safe parallelism.
- Parallelize only proven bottlenecks.
- Keep fan-out/fan-in readable and deterministic.
- Validate impact.
- Define expected metric changes and acceptance criteria before finalizing.
Guardrails
- Prefer configuration fixes before proposing application code changes.
- Do not add blanket retries to hide deterministic failures.
- Preserve deployment safety gates while optimizing build/test stages.
- Keep changes incremental and easy to revert.
- Prefer language-specific cache directories over broad project snapshots.
- Avoid cache keys that rotate every run unless the user explicitly wants effectively write-only caches.
Output Contract
Provide:
- Baseline bottleneck summary.
- Proposed or applied config changes with rationale.
- Expected runtime/reliability impact.
- Validation plan and rollback note.
Version History
- 08dc189 Current 2026-07-05 18:56
