AgentSkillsCN

java-oop-assignment

根据 PDF 规范完成 Java OOP 大学作业，以最少的代码实现目标。当用户提交 PDF 作业文件，或提及完成 Java/FOP/OOP 课后习题时，此技能将助您事半功倍。重点在于以最精简的代码满足所有需求。

SKILL.md
--- frontmatter
name: java-oop-assignment
description: "Completes Java OOP university assignments from PDF specifications with minimal implementation. Use when user provides a PDF assignment file or mentions completing a Java/FOP/OOP homework exercise. Focuses on writing the least code necessary to satisfy requirements."

Java OOP Assignment Solver

Philosophy

KISS + YAGNI: Write the minimum code to pass. Less code = less to review = fewer bugs.

Workflow

Phase 1: Understand

  1. •Read the PDF - Extract all requirements, class diagrams, method signatures
  2. •Explore codebase - Find existing templates, enums, helper classes marked @DoNotTouch
  3. •Identify tasks - List each numbered requirement (H6.1, H6.2, etc.)

Phase 2: Plan

Create a todo list with:

  • •Files to CREATE (interfaces, enums, classes)
  • •Files to MODIFY (implement methods, add implements)
  • •Implementation order (dependencies first)

Phase 3: Implement

For each task:

  1. •Interfaces/Enums first - No dependencies
  2. •Abstract classes - Base functionality
  3. •Concrete classes - Extend/implement
  4. •Modify existing - Add interface implementations, fill in TODO methods
  5. •Remove crash() calls - Replace crash("H6.X") with actual implementation

Phase 4: Verify

  1. •Build with Gradle: ./gradlew compileJava
  2. •Run main if playground exists: ./gradlew run
  3. •Check output matches PDF examples

Implementation Rules

Minimal Code

  • •No extra comments unless logic is unclear
  • •No extra validation unless specified
  • •No helper methods unless reused 3+ times
  • •Match exact signatures from PDF (visibility, types, names)

PDF Reading Tips

  • •Class diagrams: Solid arrow = extends, dashed arrow = implements
  • •"protected": Accessible to subclasses
  • •"private final": Immutable, set in constructor
  • •Mandatory requirements in boxes: Must follow exactly

Modern Java Idioms

Use the following for code conciseness, elegance and brevity.

  • •Switch expressions (->) - returns value, no break needed, fewer lines
  • •Pattern matching instanceof - cast + variable binding in one check
  • •var - type inference for locals, less redundancy
  • •Ternary operator - one-liner conditionals over if-else blocks
  • •Math.min/max - bounds checking without branching
  • •Records - immutable data classes in one line (if allowed)
  • •Text blocks (""") - multi-line strings without concatenation

Gradle Notes

  • •If build fails with version error, try: JAVA_HOME=/path/to/jdk21 ./gradlew build
  • •@StudentImplementationRequired("H6.X") marks methods to implement
  • •Remove crash("H6.X") calls when implementing

Checklist

  • • All TODO comments addressed
  • • All crash() calls removed
  • • All interfaces/classes from diagram created
  • • Build succeeds
  • • Run output matches PDF examples (if playground provided)