LobeHub

상호작용 원칙과 체크리스트를 활용해 사용자 흐름을 설계하거나 검토합니다. 빈 화면, 로딩 및 오류 상태, 임시 저장 내용 보호, 다음 행동 안내와 고급 옵션 노출을 확인합니다.

• 사용자 화면을 설계할 때
• 입력 내용과 임시 저장 보호를 확인할 때
• 오류 후 복구 방법을 검토할 때

화면을 하나씩 인터페이스 패턴과 `ux` 체크리스트에 따라 감사합니다. 코드, 렌더링된 스크린샷, 실제 사용자 흐름을 확인하고 근거와 함께 장점과 문제를 기록하며, 일반화할 수 있는 결과를 체크리스트에 반영합니다.

• 화면별로 사용자 경험을 감사할 때
• 스크린샷으로 화면 표시를 확인할 때
• 실제 흐름과 성능을 살펴볼 때

Zustand 상태 유형, 선택자, 별도 액션 클래스의 구성을 안내합니다. `local-replica`로 서버 기반 목록과 상세 데이터를 동기화하고, 낙관적 업데이트 및 실패 시 롤백을 구현하는 방법과 기존 스토어 관례도 다룹니다.

• Zustand 스토어의 상태와 액션을 설계할 때
• 서버 기반 목록과 상세 데이터를 동기화할 때
• 낙관적 업데이트와 롤백을 구현할 때

공개 웹사이트의 셀프 호스팅, 배포, 마이그레이션, 설정 안내 문서를 작성하고 관리합니다. 현재 코드로 내용을 확인하고 영어와 중국어 간체 문서를 맞추며, 공개 경로가 바뀌면 링크와 테스트된 리디렉션을 업데이트합니다.

• 셀프 호스팅 안내 작성
• 배포 및 설정 절차 정리
• 페이지 이전 후 링크 수정

마이너 또는 패치 릴리스를 준비하고, 브랜치와 풀 리퀘스트 진행 방식 및 GitHub Release 노트 작성 절차를 확인하는 스킬입니다. 어떤 변경이 CI의 자동 태그와 릴리스 생성을 실행하는지, 버전 처리를 CI가 맡는 단계가 무엇인지 설명합니다.

• 기능 업데이트 마이너 릴리스 준비
• 주간 릴리스나 핫픽스 준비
• 풀 리퀘스트의 자동 릴리스 조건 확인

기존 애플리케이션에 키보드 단축키를 추가하고 등록하는 절차를 안내합니다. 키 조합, 적용 범위와 그룹, 번역, 훅, 선택적 툴팁, 브라우저나 운영체제 단축키와의 충돌 확인을 다룹니다.

• 기존 동작에 단축키 추가
• 단축키 적용 범위 결정
• 단축키 누락이나 충돌 점검

출시된 변경 사항을 바탕으로 사용자용 영어·중국어 제품 변경 로그 페이지를 작성합니다. 사용자 작업 흐름에 따라 업데이트를 정리하고 두 언어의 사실과 섹션 순서를 맞춥니다.

• 웹사이트 제품 변경 로그 작성
• 영어·중국어 업데이트 공지 맞추기
• 사용자 작업별로 변경 사항 정리

메시지, 파일 등 제품 데이터의 전문 검색 변경을 안내합니다. PostgreSQL과 Elasticsearch 검색 경로, 권한 유지, 문서 매핑, 증분 동기화와 재색인을 다루며 에이전트의 외부 웹 검색은 범위에 포함하지 않습니다.

• 제품 데이터를 검색 대상으로 추가
• 검색 제공자 변경
• 매핑 또는 검색 문서 수정

독립적인 검토자가 풀 리퀘스트, 코드 차이 또는 브랜치를 살펴봅니다. 변경 내용에 따라 로직, 보안, 성능, 호환성 등을 점검하고 근거를 담은 구조화된 보고서를 작성합니다.

• 풀 리퀘스트의 문제를 검토할 때
• 풀 리퀘스트 제출 전에 브랜치를 확인할 때
• 여러 에이전트에게 상세 검토를 요청할 때

LobeHub에 AI 모델 제공자를 추가하는 과정을 안내합니다. 런타임 연동, 모델 정보와 설정, 브랜드 표시, 문서화 및 인수 확인을 다루며, 기존 제공자에 모델만 추가하는 경우와 새 연동이 필요한 경우를 구분합니다.

• LobeHub에 새 AI 모델 제공자 추가하기
• 제공자의 설정 안내나 설명 갱신하기
• 모델 추가에 새 제공자 연동이 필요한지 판단하기

Upstash Workflow와 QStash로 비동기 작업을 구성하고, 실행 전 미리보기, 대량 작업의 페이지 분할과 분산 처리, 실행당 단일 항목 처리를 안내합니다. 병렬 제어, 재시도, 배포 설정도 다룹니다.

• 대량 데이터의 비동기 처리를 설계할 때
• 실행 전에 처리 건수를 미리 볼 때
• QStash 병렬 수와 처리 속도를 조정할 때

SWR을 활용한 클라이언트 데이터 요청 구조를 안내합니다. API 호출을 서비스와 스토어 훅에 배치하고 로딩 및 오류 상태, 쓰기 후 캐시 갱신을 다루며 컴포넌트의 `useEffect` 요청을 옮기는 방법을 설명합니다.

• 컴포넌트 요청을 스토어 훅으로 옮기기
• 업데이트 후 오래된 캐시 수정
• 로딩·빈 결과·오류 표시 정리

Electron 앱에 데스크톱 기능을 추가하는 과정을 안내합니다. 메인 프로세스 컨트롤러, IPC 타입, 렌더러 서비스, 프리로드 스크립트, 창과 메뉴 설정을 다루며 각 코드의 위치와 관련 구현 가이드를 제시합니다.

• Electron 앱에 기능 추가
• IPC 타입과 서비스 위치 확인
• 메뉴 설정 또는 창 관리

작업 ID로 에이전트 실행 기록을 살펴 실패한 도구 호출과 인수·결과, 사용 가능한 도구, 실행 문맥과 대규모 언어 모델 입력을 확인합니다. 문맥 지도와 다른 모델로 기록을 재생해 비교하는 기능도 제공합니다.

• 실패한 도구 호출 조사
• 대규모 언어 모델에 전달된 문맥 확인
• 작업별 도구와 결과 추적

에이전트 실행 단계, 도구 호출, 사람의 승인, 컨텍스트 압축, 하위 에이전트 호출에 훅을 등록하는 방법을 안내합니다. 이벤트를 관찰하고 로컬 도구 결과를 모의하거나 설정에 따라 웹훅으로 도구 호출을 허용 또는 거부할 수 있습니다.

• 에이전트 단계와 오류 기록
• 테스트 중 도구 결과 모의
• 웹훅으로 도구 호출 허용 또는 거부

애플리케이션의 LLM 생성 흐름을 정리합니다. 재사용 가능한 버전 관리 프롬프트, 구조화된 출력, 서비스별 모델 선택과 추적을 다루며 업무 흐름과 프롬프트의 식별 정보를 구분하도록 안내합니다.

• 재사용 프롬프트 버전 관리하기
• 서비스에 구조화된 LLM 출력 추가하기
• 생성 흐름의 모델과 실행 상태 추적하기

React와 TSX 화면을 구현할 때 기존 UI 라이브러리와 스타일 규칙에 맞는 구성 요소를 고르고, 상태와 레이아웃을 배치하며 메모이제이션이 필요한지 판단하도록 안내합니다.

• 기존 UI 구성 요소로 화면 구현
• 스타일 마이그레이션 방침 확인
• 상태를 둘 구성 요소 결정

Zustand 스토어의 목록·상세 타입, ID 키 맵, reducer, 공유 타입의 구성 지침을 찾도록 안내합니다. local-replica 기반 도메인 데이터 규칙과 스토어 작업의 자동 진입점인 zustand 스킬도 설명합니다.

• Zustand 목록·상세 데이터 설계
• ID 키 맵 규칙 확인
• reducer와 공유 타입 지침 찾기

서버 환경 변수로 사용자 설정의 기본값을 지정하도록 구현하는 절차를 안내합니다. 변수 검증, 서버 설정 구성, 사용자 저장소 반영부터 예시 환경 파일과 셀프 호스팅 문서 갱신까지 다룹니다.

• 환경 변수로 사용자 설정 기본값 지정
• 설정을 서버 구성과 사용자 저장소에 연결
• 환경 변수 예시와 문서 갱신

ESLint로 표현하기 어려운 판단을 다루는 모델 기반 코드 규칙을 `packages/alint`에서 관리합니다. 실제 코드로 오탐을 조정하고 결과를 분류하며, 실제 PR 데이터로 경고를 오류로 승격할 기준을 정하고 토큰 비용도 확인합니다.

• 모델 기반 코드 규칙 추가
• 실제 코드로 오탐 줄이기
• 경고를 오류로 승격할 기준 정하기

에이전트가 만들거나 수정한 리소스를 버전 기록이 있는 Work 기록과 카드로 등록하는 방법을 설명합니다. 중복 방지, 도구 결과 정규화, 셸 명령 스캔, 파일·작업 등록, 공유 대화의 접근 범위를 다룹니다.

• 에이전트 결과를 대화 카드로 기록할 때
• CLI가 만든 리소스를 감지할 때
• Work 중복 등록을 방지할 때

프로젝트의 `.agents/skills/`에 있는 스킬 파일을 정기적으로 점검해 중복, 역할 중첩, 오래된 참조, 설명과 본문 간 불일치를 찾습니다. 근거가 되는 파일 위치와 수정 제안을 함께 확인할 수 있습니다.

• 스킬 파일의 중복을 확인할 때
• 설명과 본문의 차이를 점검할 때
• 오래된 참조와 깨진 링크를 찾을 때

실제 데스크톱 채팅 앱에서 봇 채널의 인수 테스트를 진행합니다. Discord, Slack, Telegram, WeChat, Lark, QQ에서 메시지를 보내고 응답을 기다린 뒤 결과 화면을 캡처합니다. iMessage는 BlueBubbles 브리지를 사용합니다.

• 실제 Discord 채널에서 봇 응답 확인하기
• Slack이나 Telegram 대화 경로 테스트하기
• macOS 앱의 작업 결과 화면으로 기록하기

간헐적인 화면 오류, 오래된 상태, 순서 문제와 화면 이동 문제를 진단합니다. 렌더링, 클라이언트 상태, 서버 경계를 따라 데이터를 추적해 잘못된 결과가 처음 나타나는 지점을 찾습니다.

• 간헐적인 화면 오류 재현
• 이동 후 오래된 상태 추적
• 표시 순서가 처음 깨지는 경계 찾기