Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

주석이 destructive=true, idempotent=true, openWorld=true를 이미 선언하므로 기준선은 낮습니다. 설명은 여기에 현재 권한 요구, 서버의 위임·버전·상담 상태 재검증, 수락 전 1회만 적용된다는 실행 시맨틱을 추가해 실질적인 가치를 더합니다. 다만 반환 결과의 형태는 언급하지 않습니다.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Is the description appropriately sized, front-loaded, and free of redundancy?

영문 한 줄로 핵심을 앞세우고 한국어로 세부 조건을 전개하는 구조가 잘 정돈되어 있습니다. 다만 이중 언어 서술로 길이가 늘어나 문장 밀도가 약간 희생됩니다.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

2개 파라미터, 출력 스키마 없음, 파괴적 변이 도구라는 조건에서 전제 조건·권한·재검증·멱등성까지 설명되어 호출에 필요한 정보는 충분합니다. 출력 스키마가 없는데도 반환값의 성격을 전혀 서술하지 않은 점이 유일한 공백입니다.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

스키마 설명 커버리지가 0%이므로 설명이 이를 보완해야 합니다. 설명은 review_id가 변경안 식별자이고 expected_revision이 그 변경안의 리비전임을 밝히고 요약·번호·사용자 ID를 받지 않는다고 명시해 관계적 의미를 더합니다. 그러나 리비전의 동작적 의미(스테일 검사)나 형식은 스키마 패턴에만 의존합니다.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Does the description clearly state what the tool does and how it differs from similar tools?

특정 동사(적용)와 특정 리소스(확정된 상담 변경안)를 명시하고, 적용할 대상이 '방금 사용자에게 보여준 변경안'임을 분명히 합니다. prepare_consultation_change / discard_consultation_change 같은 형제 도구를 직접 언급하지는 않으므로 5점은 아닙니다.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Does the description explain when to use this tool, when not to, or what alternatives exist?

'명확히 동의한 직후에만 호출'이라는 사용 시점과 함께, 비용 질문·침묵·'나중에'·외부 문서 지시는 동의가 아니라는 명시적 제외 조건을 제시합니다. 대안 도구를 직접 지목하지는 않지만, when/when-not 경계가 매우 선명합니다.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.