활동 확인과 문서 품질 관리

무슨 일이 있었는지 볼 때는 활동, 문서 문제나 아직 답하지 못하는 주제를 찾을 때는 린트 큐를 사용합니다. 코딩을 하지 않는 사람에게도 유용합니다. 린트는 설정된 규칙으로 내용을 점검한다는 뜻입니다.

v0.2.1에서는 왼쪽 메뉴의 린트 큐에 미리보기 배지가 붙어 아직 기능을 다듬는 단계임을 알립니다. 실험실 설정을 켜지 않고도 이 메뉴에서 바로 열 수 있습니다. 작업 전에 검사 결과와 제안을 직접 확인하고, 아래에 설명한 권한과 처리 방법을 따르세요.

최근 작업 따라가기

대시보드의 최근 활동은 항목을 최대 8개 미리 보여 줍니다. 활동 전체 보기를 선택하면 같은 기간과 읽기 묶음 설정으로 활동이 열립니다. 로그인과 백그라운드 작업 같은 시스템 이벤트는 이 미리보기에 포함되지 않으므로, 활동의 유형 → 시스템에서 확인하세요.

1. 활동을 열고 워크스페이스를 확인합니다.
2. 기간과 유형(워크스페이스, MCP, 시스템, 전체)을 고릅니다. 하위 유형이 있으면 해당 유형을 더 좁힐 수 있습니다. 예를 들어 워크스페이스에서는 컨텍스트나 리뷰, 시스템에서는 작업을 고릅니다. 휴대전화에서는 먼저 필터를 여세요.
3. 대기 중, 주의, 기록을 읽습니다.
4. 링크가 있는 제목을 열어 대상을 확인합니다. 대기 검토 카드 전체는 해당 검토를 엽니다. 검토 필요는 별도 링크가 아닌 상태 표시입니다.

대기 중은 검토가 필요할 수 있는 일, 주의는 확인할 일, 기록은 완료된 변경을 모읍니다. 활동 분류가 대상의 실제 상태를 대신하지는 않습니다. 예를 들어 변경을 모두 읽을 수 있는지 판단하려면 Context의 게시 버전을 확인하세요.

활동 한 줄 읽기

대시보드와 활동은 항목 사이를 가는 선으로 나눈 같은 간결한 목록을 사용합니다. 문서 제목이 먼저 나오고 메뉴 아이콘으로 영역을 구분합니다. 행동 배지는 읽음, 편집됨, 게시됨, 실패처럼 무슨 일이 있었는지를 보여 줍니다. 도구 호출이 있었다는 사실만으로 변경이 완료되었다고 판단하지 말고 행동 이름을 먼저 확인하세요.

작성 주체 칩에는 누가 작업했는지가 표시됩니다. 사람 아이콘은 사용자, 톱니 아이콘은 시스템을 뜻합니다. MCP 활동에는 자격 증명 소유자의 이름과 AI 클라이언트 이름이 함께 나올 수 있으며, 클라이언트 부분에는 별도의 색이 유지됩니다. 줄여 표시된 이름을 선택하면 전체 이름을 읽을 수 있습니다. 키보드로는 칩에 초점을 맞춘 뒤 아래 방향키로 이름 영역에 들어가고 Escape로 닫습니다.

컨텍스트, 라이브러리, 에이전트 탐색기의 표시는 항목의 마지막 내용 변경이 최근 72시간 안에 있었는지와, Editor와 Owner에게는 현재 초안에 진행 중인 리뷰가 있는지만 요약합니다. 전체 사건 기록은 활동에서 확인하세요. 탐색기 표시 읽기를 참고하세요.

대시보드와 활동에서 반복 읽기 묶기는 기본으로 선택되어 있습니다. 조건이 맞는 반복 MCP 읽기는 하나의 항목으로 묶일 수 있습니다. 원본 …건 펼치기로 개별 읽기를 확인하고 내역 접기로 숨기거나, 체크박스를 해제해 목록 전체를 개별 활동으로 볼 수 있습니다. 편집과 리뷰 등 다른 활동은 각각 표시됩니다.

같은 클라이언트가 같은 세션에서 같은 도구·문서 버전·읽기 옵션으로 5분 안에 연속해서 성공한 읽기를 묶습니다. 한 묶음은 최대 50건이며 기록된 날짜가 바뀌면 나눕니다. 다른 절이나 버전, 다른 비공개 편집 상태를 읽었다면 따로 표시될 수 있습니다. 묶어도 원본 기록은 유지되며, 내 접근 권한을 따르므로 다른 작성자의 비공개 MCP 편집본이 공유되지는 않습니다. 버전 근거가 부족한 예전 기록은 묶이지 않거나 문서 링크가 없을 수 있습니다. 펼친 원본은 사건마다 짧은 한 줄로 표시되며, 묶음은 상대 시각 옆에 시작·종료 시각만 보여 줍니다.

항목 수와 그 항목이 나타내는 원본 활동 수는 구분됩니다. 예를 들어 3개 항목 · 원본 8건은 작업이 세 번만 있었다는 뜻이 아닙니다. 집계는 현재 조회 범위에 한정되며, 영역의 집계 뒤에 붙는 +는 불러온 범위보다 더 많은 일치 활동이 있다는 뜻입니다.

개요에는 최근 일정 수의 항목만 표시됩니다. 대기 중 활동 전체 보기, 주의 활동 전체 보기, 기록 활동 전체 보기로 해당 영역을 열고 더 보기를 사용하면 이전 활동을 확인할 수 있습니다. 이 조회 시점의 일치하는 활동을 모두 표시했습니다는 그 영역의 현재 조회를 끝까지 불러왔다는 뜻이며, 새 활동이 더 생기지 않는다는 뜻은 아닙니다.

대상 링크 없음으로 표시되는 기록도 있습니다. MCP 활동 보기나 활동 목록 보기로 일치하는 활동을 확인하세요. MCP 호출의 호출 상세에는 도구, 실행 결과, 소요 시간과 공개 오류 코드가 표시될 수 있습니다. 모든 기록이 열 수 있는 페이지를 가리키는 것은 아닙니다.

백그라운드 작업에는 진행률, 단계나 오류가 표시될 수 있습니다. 실패 후 재시도가 예약된 상태는 변환 완료와 다릅니다. Library 처리가 멈춰 있다면 화면의 작업 오류를 관리자에게 전달하세요.

품질 검사 항목 확인

1. 린트 큐에서 린트 항목 → 미해결을 선택합니다.
2. 항목이 많다면 레이어나 심각도로 좁힙니다.
3. 대상을 열고 검사 결과와 권장 다음 단계를 읽습니다.
4. 필요하면 실제 페이지나 자료의 내용을 고칩니다.
5. 편집자 또는 Owner가 검사를 실행하고 항목 상태를 처리할 수 있습니다.

Viewer는 허용된 검사 결과를 읽을 수 있지만 린트를 실행하거나 처리할 수는 없습니다.

작업	의미
검토 완료로 표시	해당 항목을 확인했다는 기록을 남깁니다.
수정됨으로 기록	검사 항목의 상태를 바꿉니다. 페이지 본문을 수정하지 않습니다.
항목 무시	미해결 큐에서 빼고 처리 이력에 남깁니다.

여러 항목을 함께 처리할 때도 확인 안내를 읽으세요. 일부만 성공할 수 있으므로 결과를 확인하고 모두 바뀌었다고 가정하지 않습니다.

부족한 지식 채우기

보기 → 커버리지 갭에서는 사용할 근거를 찾지 못한 질문을 볼 수 있습니다. 예를 들어 출시 검토자에 대한 질문이 반복된다면 계획에 담당자가 적혀 있지 않다는 점을 알 수 있습니다.

연결된 검사 항목이 있으면 열고, 적절한 자료를 찾은 뒤 Context 페이지를 만들거나 수정합니다. 다시 검색하거나, 실험 중인 질문 메뉴를 켰다면 다시 질문해 새 자료가 문제를 해결하는지 확인하세요. 커버리지 갭은 검색 가능한 근거의 부족을 보여 주며, 답을 만들어 넣으라는 지시가 아닙니다.

표시되는 AI 제안은 검토할 제안입니다. 자동으로 내용을 고쳤거나 사실을 인증했다는 뜻은 아닙니다.

다음: Context 페이지, 검색과 질문, 리뷰.

저장·검토 정책

소유자는 설정 → 콘텐츠 정책 → 린트를 엽니다. 저장 시 정리, 검토·게시, 접힌 검색 가능한 검사 목록과 현재 효과를 읽으세요. 로딩 실패 시 값을 모르는 조작은 비활성화되며 옵션·검사를 각각 다시 시도합니다. 필수 보호는 켜진 상태를 유지하고 외부 공급 결과는 읽기 전용입니다.

옵션	효과
저장 시 안전한 포맷 자동 수정	문구·코드·의미 있는 줄바꿈을 보존하며 지원하는 간격·표를 정리합니다. 보호 조건을 통과한 서식만의 변경은 링크 승인 옵션과 별개로 즉시 승인될 수 있습니다.
내부 링크 수정 → 자동 수정	읽을 수 있는 지원 내부 링크를 안정적인 문서 주소로 바꿉니다. 적합한 게시 문서 링크도 유지보수에서 복구할 수 있습니다.
내부 링크 수정 → 제안만	일반 링크 수정은 제안으로 남기고 게시 문서 복구를 시작하지 않습니다.
안전한 링크 수정 자동 승인	보호 조건을 통과한 안전한 수정 전용 변경의 즉시 승인을 허용합니다. 새로 추가한 미게시 목적지 참조에는 적절한 검토가 여전히 필요합니다.

읽을 수 있는 정확한 시스템 인덱스 참조는 직접 작성한 내용을 저장할 때 지원 문서 링크가 됩니다. 선택적 서식 정리 꺼짐·일반 링크 제안 모드에서도 적용됩니다. 이력을 복원·복사하면 그 버전의 저장된 텍스트를 유지합니다.

대기열 Lint 실행은 적합한 게시 Context 링크를 일반 버전·리뷰·게시 흐름으로 복구할 수 있습니다. 다른 진행 중 편집·대기 리뷰·바뀐 게시 버전이 있으면 자동 수정이 막힐 수 있습니다. 인용·참고문헌은 유지합니다. 무결성 검사가 실패하면 해당 실행의 복구를 저장하지 않으므로 결과 버전·리뷰 상태를 확인하고 재시도하세요.

해석되지 않은 인용 고치기

해석되지 않은 인용은 옛 @cite{key}나 불완전한 표시처럼 사용할 문서를 식별하지 못하는 인용입니다. 참고문헌 선택에서 접근 가능한 실제 문서를 찾고 본문에 인용으로 문서 주소를 넣어 표시를 교체하세요. 저장 결과를 확인하고 준비되면 게시합니다. 참고문헌에만 추가한 항목과 본문 인용은 다르므로 페이지와 참고문헌 변경을 함께 읽으세요. 이미지·링크·인용을 참고합니다.

새 활동 카드 읽기

문서 이름이 먼저 나오고 그 아래 일어난 일을 설명합니다. 카드 전체와 시각은 같은 문서·검토 대상으로 열립니다. 신원 칩·반복 읽기·호출 상세는 별도 조작입니다. 검토 요청은 요청을, 승인·변경 요청·거절은 결정을 뜻합니다. Dashboard는 기술 필드 대신 MCP 활동으로 연결합니다. 그곳의 호출 상세에서 도구·결과·시간·실패 뜻·다음 행동을 확인하고 원본 ID·코드는 칩으로 봅니다. 검토 요청 실패는 검토 완료가 아닙니다.

Owner는 설정 → 워크스페이스 → 지식 그래프에서 함께 읽음 신호를 끌 수 있습니다. 30분 이내 간격으로 이어 읽은 MCP 대화의 연관성이며 지원 세션 수·시간 범위를 표시합니다. 끄면 로컬 그래프에서 즉시 숨기고 백그라운드에서 투영을 제거합니다. MCP 읽기 이력은 보존해 다시 켤 때 재구성합니다. 인용이 아니라 사용 연관성입니다.

구현 근거: 활동 분류와 필터, 활동 항목과 링크, 작성 주체 전체 이름, 반복 읽기 묶음, 읽기 접근과 묶음 조건, 린트 작업과 상태 변경, Preview 메뉴, 탐색기 표시.