3.3 KiB
3.3 KiB
name, description
| name | description |
|---|---|
| verify-mcp-server-change | Review, implement, and verify changes to the AX HUB Java MCP server, including mandatory Korean class and method comments for added or modified production source. Use for JSON-RPC parsing or errors, MCP method handlers, Tool Registry metadata or fallback, tool execution planning and routing, streaming responses, trace or audit behavior, Spring profiles, and OpenShift deployment changes. Do not use for documentation-only edits unrelated to server behavior. |
Verify MCP Server Change
Workflow
- Read the root
AGENTS.md, the relevant production code, and its nearest tests. - Identify the affected contract and its downstream consumers before editing.
- Read the matching sections of references/change-checklist.md.
- Preserve the server boundaries: Agent Builder selects tools, this server validates and executes, and Tool Services own business rules.
- Implement the smallest coherent change and add or update focused tests.
- Add or refresh the required Korean source comments described below before verification.
- Run the narrowest useful tests while iterating, then run the project verification command before handoff.
- Update architecture or extension documentation only when the durable design or operational guidance changed.
- Report the behavior changed, files affected, verification run, comment coverage, and remaining risks.
필수 한글 소스 주석
소스 추가 또는 수정이 있으면 src/main/java의 해당 변경 범위에 아래 규칙을 반드시 적용한다.
- 새로 추가하거나 수정한 최상위
class,interface,record,enum선언 바로 위에 한글 Javadoc을 둔다. - 클래스 주석에는 다음을 명시한다.
- 해당 타입의 역할과 책임
- 처리하는 HTTP/MCP 요청 또는 처리 단계. 직접 요청을 처리하지 않으면 그 사실과 호출자를 명시한다.
- 주요 의존성 및 협력 객체, 또는 외부 시스템과의 경계
- 새로 추가하거나 수정한 명시적 메서드·생성자 바로 위에 한글 Javadoc을 둔다. 주석은 메서드가 하는 일, 입력/출력 또는 오류 처리, 호출 시점·영향 범위를 설명한다.
- compiler가 생성하는 record accessor, 단순 enum 상수, 빈 marker interface에는 메서드별 주석을 강제하지 않는다. 그러나 타입 자체의 주석은 필요하다.
- 주석은 구현 코드를 한 줄씩 번역하지 말고 협업자가 설계 의도와 호출 흐름을 이해하도록 작성한다. credential, bearer token, 개인정보 원문 및 민감 업무 payload를 주석에 쓰지 않는다.
- 기존 파일의 일부만 수정한 경우에도, 수정한 클래스 또는 메서드에 위 형식의 주석이 없거나 현재 동작과 맞지 않으면 함께 추가·갱신한다.
검증 전에는 변경된 production source의 클래스·메서드 선언과 Javadoc을 대조한다. 누락이 있으면 테스트가 통과해도 완료로 보고하지 않는다.
Verification commands
On Windows:
.\gradlew.bat test
On Unix-like systems:
./gradlew test
Use clean test for dependency, packaging, profile, deployment, or broad cross-cutting changes. Never claim verification succeeded unless the command completed successfully.