tangchunwu source-command-kotlin-build
Use this skill when the user asks to run the migrated source command kotlin-build.
Command Template
Kotlin Build and Fix
This command invokes the kotlin-build-resolver agent to incrementally fix Kotlin build errors with minimal changes.
What This Command Does
- Run Diagnostics: Execute
./gradlew build,detekt,ktlintCheck - Parse Errors: Group by file and sort by severity
- Fix Incrementally: One error at a time
- Verify Each Fix: Re-run build after each change
- Report Summary: Show what was fixed and what remains
When to Use
Use /kotlin-build when:
./gradlew buildfails with errors- Kotlin compiler reports errors
./gradlew detektreports violations- Gradle dependency resolution fails
- After pulling changes that break the build
Diagnostic Commands Run
# Primary build check
./gradlew build 2>&1
# Static analysis
./gradlew detekt 2>&1 || echo "detekt not configured"
./gradlew ktlintCheck 2>&1 || echo "ktlint not configured"
# Dependency issues
./gradlew dependencies --configuration runtimeClasspath 2>&1 | head -100
# Optional deep refresh when caches or dependency metadata are suspect
./gradlew build --refresh-dependencies
Example Session
User: /kotlin-build
Agent:
# Kotlin Build Resolution
## Initial Diagnostics
```bash
$ ./gradlew build
e: src/main/kotlin/com/example/service/UserService.kt:25:15 Unresolved reference: UserRepository
e: src/main/kotlin/com/example/routes/UserRoutes.kt:42:9 Type mismatch: inferred type is String but Int was expected
e: src/main/kotlin/com/example/routes/UserRoutes.kt:58:5 'when' expression must be exhaustive
```
Errors found: 3
## Fix 1: Unresolved Reference
File: src/main/kotlin/com/example/service/UserService.kt:25
Error: Unresolved reference: UserRepository
Cause: Missing import
```kotlin
// Added import
import com.example.repository.UserRepository
```
```bash
$ ./gradlew build
# 2 errors remaining
```
## Fix 2: Type Mismatch
File: src/main/kotlin/com/example/routes/UserRoutes.kt:42
Error: Type mismatch: inferred type is String but Int was expected
```kotlin
// Changed
val count = call.parameters["count"]
// To
val count = call.parameters["count"]?.toIntOrNull()
?: return@get call.respond(HttpStatusCode.BadRequest, "Invalid count")
```
```bash
$ ./gradlew build
# 1 error remaining
```
## Fix 3: Non-Exhaustive When
File: src/main/kotlin/com/example/routes/UserRoutes.kt:58
Error: 'when' expression must be exhaustive
```kotlin
// Added missing branch
when (user.role) {
Role.ADMIN -> handleAdmin(user)
Role.USER -> handleUser(user)
Role.MODERATOR -> handleModerator(user) // Added
}
```
```bash
$ ./gradlew build
# Build successful!
```
## Final Verification
```bash
$ ./gradlew detekt
# No issues
$ ./gradlew test
# All tests passed
```
## Summary
| Metric | Count |
|--------|-------|
| Build errors fixed | 3 |
| Detekt issues fixed | 0 |
| Files modified | 2 |
| Remaining issues | 0 |
Build Status: PASS: SUCCESS
Common Errors Fixed
| Error | Typical Fix |
|---|---|
Unresolved reference: X |
Add import or dependency |
Type mismatch |
Fix type conversion or assignment |
'when' must be exhaustive |
Add missing sealed class branches |
Suspend function can only be called from coroutine |
Add suspend modifier |
Smart cast impossible |
Use local val or let |
None of the following candidates is applicable |
Fix argument types |
Could not resolve dependency |
Fix version or add repository |
Fix Strategy
- Build errors first - Code must compile
- Detekt violations second - Fix code quality issues
- ktlint warnings third - Fix formatting
- One fix at a time - Verify each change
- Minimal changes - Don't refactor, just fix
Stop Conditions
The agent will stop and report if:
- Same error persists after 3 attempts
- Fix introduces more errors
- Requires architectural changes
- Missing external dependencies
Related Commands
/kotlin-test- Run tests after build succeeds/kotlin-review- Review code quality/verify- Full verification loop
Related
- Agent:
agents/kotlin-build-resolver.md - Skill:
skills/kotlin-patterns/