linear은(는) 무엇을 하나요?
개요
이 스킬은 Linear에서 이슈, 프로젝트 및 팀 워크플로우를 관리하기 위한 구조화된 워크플로우를 제공합니다. Linear MCP 서버와의 일관된 통합을 보장하며, 이슈, 프로젝트, 문서 및 팀 협업을 위한 자연어 기반 프로젝트 관리를 제공합니다.
사전 조건
- Linear MCP 서버가 연결되어 있고 OAuth를 통해 접근 가능해야 합니다.
- 관련 Linear 워크스페이스, 팀 및 프로젝트에 대한 액세스 권한을 확인하세요.
필수 워크플로우
다음 단계를 순서대로 따르세요. 단계를 건너뛰지 마십시오.
0단계: Linear MCP 설정 (아직 구성되지 않은 경우)
MCP 호출이 Linear MCP가 연결되지 않아 실패하면, 중단하고 설정하세요:
- Linear MCP 추가:
codex mcp add linear --url https://mcp.linear.app/mcp
- 원격 MCP 클라이언트 활성화:
config.toml에서[features] rmcp_client = true설정 또는codex --enable rmcp_client실행
- OAuth로 로그인:
codex mcp login linear
로그인 성공 후, 사용자는 codex를 다시 시작해야 합니다. 답변을 마치고 1단계를 계속하려면 다시 시도하라고 알려주세요.
Windows/WSL 참고: Windows에서 연결 오류가 발생하면 WSL을 통해 Linear MCP를 실행하도록 구성해 보세요:
{"mcpServers": {"linear": {"command": "wsl", "args": ["npx", "-y", "mcp-remote", "https://mcp.linear.app/sse", "--transport", "sse-only"]}}}
1단계
사용자의 목표와 범위를 명확히 하세요(예: 이슈 트라이징, 스프린트 계획, 문서 감사, 워크로드 균형). 필요에 따라 팀/프로젝트, 우선순위, 라벨, 사이클 및 마감일을 확인하세요.
2단계
적절한 워크플로우(아래 실용 워크플로우 참조)를 선택하고 필요한 Linear MCP 도구를 식별하세요. 도구를 호출하기 전에 필수 식별자(이슈 ID, 프로젝트 ID, 팀 키)를 확인하세요.
3단계
Linear MCP 도구 호출을 논리적 배치로 실행하세요:
- 먼저 읽기(목록/가져오기/검색)를 수행하여 컨텍스트를 구축하세요.
- 그런 다음 생성 또는 업데이트(이슈, 프로젝트, 라벨, 댓글)에 필요한 모든 필드를 포함하여 실행하세요.
- 대량 작업의 경우 변경 사항을 적용하기 전에 그룹화 논리를 설명하세요.
4단계
결과를 요약하고, 남은 격차나 차단 요인을 지적하고, 다음 작업(추가 이슈, 라벨 변경, 할당 또는 후속 댓글)을 제안하세요.
사용 가능한 도구
이슈 관리: list_issues, get_issue, create_issue, update_issue, list_my_issues, list_issue_statuses, list_issue_labels, create_issue_label
프로젝트 및 팀: list_projects, get_project, create_project, update_project, list_teams, get_team, list_users
문서 및 협업: list_documents, get_document, search_documentation, list_comments, create_comment, list_cycles
실용 워크플로우
- 스프린트 계획: 대상 팀의 열린 이슈를 검토하고, 우선순위별로 상위 항목을 선택하고, 할당과 함께 새 사이클(예: "Q1 Performance Sprint")을 생성합니다.
- 버그 트라이징: 중요/높은 우선순위 버그를 나열하고, 사용자 영향을 기준으로 순위를 매기고, 상위 항목을 "진행 중"으로 이동합니다.
- 문서 감사: 문서를 검색하고(예: API 인증), 누락되거나 오래된 섹션에 대해 "문서" 레이블이 지정된 이슈를 상세 수정 사항과 함께 엽니다.
- 팀 워크로드 균형: 활성 이슈를 담당자별로 그룹화하고, 부하가 높은 사람을 표시하고, 재분배를 제안하거나 적용합니다.
- 릴리스 계획: 마일스톤(기능 동결, 베타, 문서, 출시)이 있는 프로젝트(예: "v2.0 Release")를 생성하고, 예상 시간이 포함된 이슈를 생성합니다.
- 크로스 프로젝트 의존성: 모든 "차단됨" 이슈를 찾고, 차단자를 식별하고, 누락된 경우 연결된 이슈를 생성합니다.
- 자동 상태 업데이트: 업데이트가 오래된 이슈를 찾고, 현재 상태/차단 요인에 따라 상태 댓글을 추가합니다.
- 스마트 라벨링: 레이블이 없는 이슈를 분석하고, 레이블을 제안/적용하고, 누락된 레이블 범주를 생성합니다.
- 스프린트 회고: 마지막으로 완료된 사이클에 대한 보고서를 생성하고, 완료된 작업과 연기된 작업을 기록하고, 패턴에 대한 논의 이슈를 엽니다.
최대 생산성을 위한 팁
- 관련 변경 사항에 대해 작업을 일괄 처리하고, 반복되는 이슈 구조에 스마트 템플릿을 사용하는 것을 고려하세요.
- 가능하면 자연어 쿼리를 사용하세요("John이 이번 주에 작업 중인 내용을 보여줘").
- 컨텍스트 활용: 새 요청에서 이전 이슈를 참조하세요.
- 대규모 업데이트는 더 작은 배치로 나누어 속도 제한을 피하고, 자주 나열할 때 필터를 캐시하거나 재사용하세요.
문제 해결
- 인증: 브라우저 쿠키를 지우고, OAuth를 다시 실행하고, 워크스페이스 권한을 확인하고, API 액세스가 활성화되었는지 확인하세요.
- 도구 호출 오류: 모델이 여러 도구 호출을 지원하는지 확인하고, 모든 필수 필드를 제공하고, 복잡한 요청을 분할하세요.
- 데이터 누락: 토큰을 새로 고치고, 워크스페이스 액세스를 확인하고, 보관된 프로젝트가 있는지 확인하고, 올바른 팀이 선택되었는지 확인하세요.
- 성능: Linear API 속도 제한을 기억하세요. 대량 작업을 일괄 처리하고, 특정 필터를 사용하거나, 자주 묻는 쿼리를 캐시하세요.