Ottermind에서 Linear 사용하기: 이슈 목록을 명확한 다음 단계로

Linear 이슈를 대화에 가져와 다음에 무엇을 해야 할지 정리해 보세요. Ottermind에 Linear 스킬을 설정하면 에이전트가 접근 가능한 이슈와 댓글을 읽고, 검토 준비를 도우며, 팀이 이미 기록한 맥락을 활용해 후속 작업의 초안을 작성할 수 있습니다. 승인 후에는 지원되는 쓰기 작업으로 그 내용을 Linear에 반영할 수 있습니다.

이슈 관리 도구에 세부 정보는 있지만 서로 연결해서 살펴봐야 할 때 유용합니다. 어떤 이슈에 결정이 필요한가요? 두 고객 보고가 같은 오류를 설명하고 있나요? 엔지니어가 다음 티켓에 착수하려면 어떤 정보가 더 있어야 하나요?

아래 과정은 초대 링크 문제가 있는 가상의 릴리스를 예로 듭니다. 이슈 ID, 원본 기록의 사실, 출력 예시는 모두 설명을 위한 것이며, 연결된 워크스페이스에서 테스트한 결과를 나타내지 않습니다.

함께 작업할 팀 연결하기

byungkyu가 게시한 Linear API 스킬을 사용하세요. 이 서드 파티 스킬은 Maton을 통해 연결되며, Maton 인증과 활성 Linear OAuth 연결이 필요합니다. 에이전트가 접근할 수 있는 워크스페이스와 리소스는 이 연결에 따라 결정됩니다.

Ottermind 스킬 가이드에 따라 스킬을 활성화하고 작업을 담당할 에이전트에 연결하세요. Linear 연결이 여러 개라면 사용할 워크스페이스를 지정하세요. 먼저 알고 있는 이슈를 읽고 ID와 제목을 확인해 달라고 요청하세요.

스킬 문서에는 이슈 검색, 쿼리, 생성, 업데이트, 댓글 작업이 설명되어 있습니다. 쓰기 작업에는 명시적인 승인이 필요하며, 일부 작업에는 추가 권한 범위가 필요할 수 있습니다. 스킬 설정 안내에서 이러한 요구 사항을 확인할 수 있습니다.

팀이 내려야 할 결정을 중심으로 검토 준비하기

팀이 릴리스를 준비 중이며 세 개의 이슈에서 초대 링크를 언급한다고 가정해 보겠습니다. 하나는 이미 담당자가 지정되어 있고, 다른 하나에는 최근 추가 설명을 요청하는 댓글이 달렸으며, 나머지 하나에는 아직 재현하지 못한 고객 보고가 있습니다.

보드를 열면 이슈가 어디에 있는지 알 수 있습니다. 검토를 준비하려면 어떤 사실을 함께 논의해야 하는지 파악해야 합니다. 에이전트에게 설명과 관련 댓글을 읽고, 근거로 돌아갈 수 있는 링크를 포함한 짧은 안건 목록을 작성해 달라고 요청하세요.

[팀]의 Linear 워크스페이스에서 [프로젝트]의 릴리스 검토 안건을 작성해 주세요.
진행 중인 이슈와 현재 상태를 이해하는 데 필요한 댓글을 읽어 주세요.

각 논의 항목에 이슈 ID, 제목, 상태, 담당자,
기록된 문제나 질문, 근거가 되는 이슈 링크를 포함해 주세요.
안건을 필요한 결정, 누락된 정보, 확인된 진행 방해 요인으로 나눠 주세요.
기록된 사실을 사용하세요. 이슈가 오래되었다는 이유만으로 진행이 막혔다고 추론하지 마세요.
검토한 내용과 가져오지 못한 기록을 명시해 주세요. 이슈는 수정하지 마세요.

효과적인 안건 목록에는 동료가 각 항목을 논의해야 하는 이유를 알 수 있을 만큼 세부 정보가 담겨 있습니다. 가상의 예시에서는 다음처럼 정리할 수 있습니다.

이 요청에서 에이전트의 역할은 근거를 모으고 질문을 정리하는 것입니다. 재현 단계가 빠져 있다는 것은 구체적인 정보의 공백입니다. 릴리스 전체가 위험하다고 판단하려면 더 많은 정보가 필요합니다.

Linear는 이슈의 속성과 관계를 기준으로 필터링할 수 있습니다. 특정 프로젝트, 팀 또는 이슈 묶음으로 범위를 정하면 검토에 집중할 수 있고, 어디까지 검토했는지도 쉽게 평가할 수 있습니다.

이슈 묶음 읽기: Linear 필터링 참고 문서 · Linear GraphQL 가이드

안건이 준비되면 더 간결한 버전을 요청하세요. “검토를 시작할 때 사용할 5분 분량의 도입부를 작성해 주세요. 초대에 관한 결정을 먼저 다루고 정보 요청은 뒤에 배치해 주세요.” 누군가 세부 내용을 확인해야 할 때는 원래의 자세한 근거 표를 참고하면 됩니다.

비슷한 보고를 비교하되 차이점은 유지하기

“초대 링크가 작동하지 않는다”는 말은 여러 오류를 뜻할 수 있습니다. 어떤 사용자는 만료된 링크를 열었을 수 있습니다. 다른 사용자는 잘못된 계정으로 로그인했을 수 있습니다. 또 다른 사용자는 유효한 초대를 수락한 뒤 오류를 볼 수도 있습니다.

새 이슈를 만들기 전에 검색으로 관련 후보를 찾으세요. 그런 다음 설명, 발생 조건, 예상 동작을 비교해 달라고 요청하세요. 이렇게 하면 폭넓은 키워드 일치를 어떤 보고들을 함께 다뤄야 하는지 검토할 수 있는 가설로 발전시킬 수 있습니다.

[팀]의 이슈에서 초대 링크가 만료되거나 열리지 않는 문제를 검색해 주세요.
관련 이슈의 설명과 댓글을 읽어 주세요.

보고된 동작, 재현 조건, 영향을 받는 맥락,
예상 결과를 비교해 주세요. 모든 행에 이슈 ID와 원본 링크를 포함해 주세요.
중복 가능성을 검토할 만한 이슈 쌍을 제안하고 각각의 이유를 설명해 주세요.
불확실한 일치는 따로 유지하세요. 이슈를 닫거나 병합하거나 수정하지 마세요.

요청할 수 있는 비교의 간단한 예시입니다. 아래 ID와 보고는 가상의 내용입니다.

DEMO-41과 DEMO-63은 같은 논의에서 다뤄 볼 후보입니다. 그렇다고 근본 원인이 같다는 사실이 입증된 것은 아닙니다. DEMO-58도 초대를 언급하지만 재현 조건은 다른 질문을 가리킵니다.

유용한 후속 질문은 다음과 같습니다. “DEMO-41과 DEMO-63을 하나의 이슈에서 처리해야 하는지 알려면 어떤 근거가 필요할까요?” 답변에는 서로 대응하는 스크린샷, 정확한 오류 메시지 또는 재현 단계 비교가 필요하다는 내용이 담길 수 있습니다. 진단을 지어내지 말고 보고에서 근거를 찾아야 합니다.

이슈를 분류하고 처음 평가할 때 이 구분이 중요합니다. 중복 조사를 줄이면서도 엔지니어가 나중에 필요로 할 정보를 보존하는 것이 목표입니다.

합의한 동작을 구현 가능한 티켓으로 정리하기

이제 검토에서 다음과 같이 결정했다고 가정해 보겠습니다. 만료된 초대는 문제를 설명하고, 워크스페이스 관리자에게 새 초대를 요청하도록 사용자를 안내해야 합니다. 이 결정에는 초대 유효 기간 규칙 변경이 포함되지 않습니다.

이 메모만으로도 범위가 명확한 이슈 초안을 작성할 수 있습니다. 같은 대화에서 계속 작업하면 관련 보고와 결정의 이유를 계속 참고할 수 있습니다.

다음 승인된 제품 결정을 바탕으로 Linear 이슈 초안을 작성해 주세요: [메모].
[팀]과 [프로젝트]를 사용하세요. 방금 검토한 관련 보고를 링크로 연결해 주세요.

간결한 제목, 관찰된 동작, 예상 동작,
범위에 포함되는 작업, 메모에 명시된 제외 사항, 인수 기준을 포함해 주세요.
구현 방식을 임의로 만들지 마세요. 메모에 지정되어 있지 않다면
담당자와 우선순위는 설정하지 마세요. 생성 전에 전체 초안을 보여 주세요.
제가 생성을 승인하면 이슈 ID와 URL을 반환해 주세요.

이 가상의 결정에 대한 초안에는 다음 내용이 들어갈 수 있습니다.

• 제목: 초대가 만료되었을 때 다음 단계를 설명하기.
• 관찰된 동작: 보고된 만료 링크 흐름은 유용한 복구 작업 없이 종료됩니다.
• 예상 동작: 초대가 만료되었다고 설명하고 관리자에게 새 초대를 요청하도록 안내합니다.
• 범위에서 제외: 초대 유효 기간 규칙 변경.
• 인수 확인: 만료된 초대를 열면 합의한 설명과 복구 안내가 표시됩니다.

이는 작성 예시이며, Ottermind가 이슈를 생성하거나 테스트했다는 주장이 아닙니다. 요구 사항을 은근히 추가하지 않고도 결정을 실행 가능한 내용으로 바꾸는 방법을 보여 주는 것이 목적입니다.

예상 동작과 인수 기준을 함께 검토하세요. 메모에 복구 안내를 버튼으로 표시할지 일반 텍스트로 표시할지 나와 있지 않다면 미해결 사항으로 표시하세요. 지금 정확한 질문을 하는 편이 티켓에 임의의 디자인 세부 사항을 넣는 것보다 유용합니다.

선택한 스킬은 이슈 생성과 댓글 추가를 지원합니다. 정확한 쓰기 내용을 승인한 뒤 결과 이슈의 링크를 요청하세요. 결정이 기존 이슈에 해당한다면 같은 작업을 추적할 곳을 하나 더 만들기보다 그 이슈에 핵심을 담은 댓글을 준비하세요.

다음 단계를 원래 보고와 연결해 두기

좋은 세션은 서로 연결된 세 가지 결과물을 남길 수 있습니다. 검토 안건, 이슈 비교, 팀의 결정을 반영한 초안입니다. 각 결과물은 해당 작업이 필요한 이유를 설명하는 기록으로 연결되어야 합니다.

먼저 Linear 스킬 사용을 시작하고, 확인이 필요한 이슈 묶음 하나를 선택하세요. 스킬 소개는 에이전트가 이 기능을 사용할 수 있게 되는 방식을 설명합니다. 더 넓은 운영 방식을 살펴보려면 검토와 인계를 다루는 AI 프로젝트 관리 가이드를 참고하세요. 에이전트 워크스페이스 가이드는 맥락이 여러 단계에 걸친 작업을 어떻게 지원하는지 보여 줍니다.