VdustR/skills

Session Retro

AI 에이전트 세션을 검토하여 개선 기회를 찾습니다. 회고는 대화형 방식으로 진행됩니다. 즉, 어떤 일이 있었는지 관찰하고, 사용자와 결과를 논의한 후, 실행 가능한 권장 사항을 제시합니다.

목표는 사용자의 AI 협업 효율성을 향상시키는 것입니다: 더 나은 프롬프트, 더 나은 문서, 더 나은 도구, 더 나은 워크플로.

빠른 시작

이 세션을 회고해 봅시다

/retro

이 세션에서 무엇을 개선할 수 있을까요?

세션 검토 — 최적화 기회 찾기

사용 시기

• 작업 세션이 끝나고 성찰하고 배운 점을 기록할 때
• 마찰, 수정, 또는 우회 작업이 있었던 세션 이후
• 에이전트 명령어, 스킬, 훅, 또는 워크플로를 개선하고 싶을 때
• 세션에서 발견된 패턴에 도움이 될 커뮤니티 스킬이 무엇인지 궁금할 때
• 주기적으로 건강한 개발 관행을 유지하기 위해

작동 방식

아래 흐름은 일반적인 지침입니다. 대화 흐름에 맞게 자연스럽게 조정하십시오. 모든 세션이 모든 단계를 필요로 하는 것은 아닙니다. 문제가 없는 짧은 세션은 간단한 관찰만으로 충분합니다.

관찰

세션 대화를 검토하고 주목할 만한 사항을 자유롭게 식별하십시오. 미리 정의된 범주에 자신을 제한하지 말고, 실제로 일어난 일에서 자연스럽게 관찰 내용이 도출되도록 하십시오.

각 관찰에 대해 한 줄짜리 발견 사항과 초기 실행 가능한 권장 사항을 제공하십시오. 사용자가 심층 분석을 하지 않더라도 모든 관찰은 유용한 시사점을 제공해야 합니다.

개방형 검토 후, dimensions.md의 15가지 차원을 안전망 체크리스트로 사용하여 개방형 관찰에서 놓친 것이 없는지 검토하십시오. 정말로 언급할 가치가 있는 추가 발견 사항만 표면화하십시오.

다음 두 가지를 모두 포함하십시오:

• 반응형 발견: 잘못되었거나 수정된 사항
• 선제적 발견: 문서화되지는 않았지만 제대로 작동한 사항, 또는 표준화할 수 있는 모범 사례

대화형 심층 분석

진행 표시기(예: [2/6])와 함께 관찰 내용을 하나씩 제시하십시오. 각 관찰에 대해 초기 권장 사항을 제시하고 사용자가 심층 분석을 원하는지 물어보십시오.

사용자는 다음과 같이 응답할 수 있습니다:

• 예 — 심층 분석 대상으로 기록
• 아니요 — 계속 진행합니다 (초기 권장 사항은 유효함)
• 맥락이나 수정 사항 추가
• AI가 놓친 관찰 내용 제시
• "충분하다"라고 말하여 나머지를 건너뛰고 진행

모든 관찰을 검토한 후, 사용자가 심층 분석을 선택한 항목이 있으면, 실제로 서브에이전트 연구가 필요한 항목과 직접 조치를 취할 수 있을 만큼 명확한 항목을 평가하십시오. 이 평가를 제시하고 서브에이전트를 생성하기 전에 사용자 확인을 요청하십시오.

각 서브에이전트는 subagent-guide.md의 주기를 따릅니다: 관찰 내용을 철저히 연구하고, 근본 원인을 분석하며, 구체적인 해결책을 설계하고, 권장 사항과 함께 결과를 제시합니다.

결과 및 논의

각 서브에이전트의 결과를 진행 상황과 함께 하나씩 제시하십시오. 사용자는 다음을 수행할 수 있습니다:

• 결과에 대해 논의하고 후속 질문하기
• 권장 옵션 수락하기
• 수정 요청하기
• 다음 결과로 건너뛰기

실행 권장 사항

모든 결과를 논의한 후, 확인된 실행 항목을 권장 사항 요약으로 정리하십시오. 각 실행 항목에 대해 수행할 작업과 그 이유를 제시하십시오. 사용자가 지속(예: "기록해 줘")을 요청하면 채팅에 마크다운 요약을 출력하십시오. 파일을 작성하지 마십시오.

회고를 명시적으로 종료하십시오: 사용자에게 회고가 완료되었으며 권장 실행 항목은 사용자가 준비되었을 때 시작할 수 있는 것임을 알리십시오.

지침

해야 할 일

• 고정된 템플릿이 아닌 실제 세션 내용에서 관찰 내용이 도출되도록 하십시오.
• 심층 분석 없이도 모든 관찰에 대해 실행 가능한 시사점을 제공하십시오.
• 사용자의 시간을 존중하십시오. 세션이 깔끔했다면 그렇게 말하고 간결하게 유지하십시오.
• 서브에이전트를 생성하기 전에 허가를 요청하십시오.
• 수정 사항의 경우: 근본 원인이 누락된 규칙, 불명확한 문서, 또는 개선이 필요한 스킬인지 조사하십시오.
• 모범 사례의 경우: 잊혀지기 전에 표준화할 것을 제안하십시오.
• 스킬 분석 시: 먼저 소유권(자체 유지 관리 vs 커뮤니티)을 확인하여 적절한 조언을 제공하십시오.
• 발견 사항을 권장 사항 및 근거와 함께 제시하십시오.

하지 말아야 할 일

• 어떤 작업(예: 커밋, 푸시, 파일 수정)도 실행하지 마십시오. 이 스킬은 분석 및 권장 전용입니다.
• 사용자의 동의(예: "네", "좋아요", "계속하세요")를 실행 요청으로 해석하지 마십시오. 이러한 응답은 확인일 뿐입니다.
• 회고가 명시적으로 종료되기 전에는 어떤 지시도 실행하지 마십시오. 회고가 종료된 후의 새롭고 구체적인 지시만이 유효한 실행 요청입니다.
• 엄격한 단계 순서를 강요하지 말고 대화에 적응하십시오.
• 문제가 거의 없는 세션을 과도하게 분석하지 마십시오.
• 사용자 허가 없이 서브에이전트를 생성하지 마십시오.
• 이유를 설명하지 않고 변경을 권장하지 마십시오.
• 선택 사항을 제시할 때 "아무것도 하지 않음 / 건너뛰기" 옵션을 생략하지 마십시오.
• 사용자의 프롬프트나 워크플로에 대해 판단하지 말고 건설적으로 대하십시오.

참고 파일

• dimensions.md — 안전망 체크리스트로 사용되는 15가지 분석 차원
• subagent-guide.md — 서브에이전트가 발견 사항을 연구, 분석 및 제시하는 방법

참고 사항

• 15가지 차원은 채점 기준표가 아닌 체크리스트입니다. 대부분의 세션은 몇 가지 차원에서만 신호를 보일 것입니다.
• 사용자가 여러 세션을 검토하려는 경우 교차 세션 패턴 분석이 가능합니다. 시작 시 명확하지 않으면 범위에 대해 물어보십시오.
• 회고 후 사용자가 별도로 호출할 수 있는 관련 도구: hookify, claude-md-management, skill-creator, brainstorming. 회고는 이러한 도구를 직접 호출하지 않습니다.