ark-controller-development
16
总安装量
2
周安装量
#21483
全站排名
安装命令
npx skills add https://github.com/mckinsey/agents-at-scale-ark --skill ark-controller-development
Agent 安装分布
claude-code
2
windsurf
1
opencode
1
antigravity
1
gemini-cli
1
Skill 文档
Ark Controller Development
Guidance for developing the Ark Kubernetes operator in ark/.
When to use this skill
- Modifying Go type definitions (
api/v1alpha1/*_types.go) - Fixing CRD/Helm chart sync errors
- Adding new CRD fields or resources
CRD Generation Flow
api/v1alpha1/*_types.go # Go types with markers
â
make manifests # Generates CRDs and syncs to Helm chart
â
config/crd/bases/*.yaml # Source CRDs (auto-generated)
dist/chart/templates/crd/ # Helm chart CRDs (auto-synced)
make manifests automatically syncs source CRDs to the Helm chart while preserving templated headers.
Fixing “CRDs out of sync” Errors
When make build fails with CRD validation errors:
cd ark
make manifests
make build
Key Directories
| Directory | Purpose |
|---|---|
api/v1alpha1/ |
Go type definitions |
config/crd/bases/ |
Auto-generated source CRDs |
dist/chart/templates/crd/ |
Helm chart CRDs (auto-synced) |
internal/controller/ |
Reconciliation logic |
internal/webhook/ |
Admission webhooks |
internal/genai/ |
AI/ML execution logic |
Common Tasks
After Modifying Types or Comments
Go type comments become CRD field descriptions:
cd ark
make manifests
make build
After Any Go Code Change
make lint-fix # Format and fix linting
make build # Build and validate