suyuan2022/suyuan-skill

해결하는 문제

AI 에이전트는 종종 읽고 싶지 않은 긴 텍스트, 기술적으로는 맞지만 쓸모없는 일반적인 답변을 주거나 클라우드 서비스에서 자신의 데이터를 꺼내는 것을 도와주지 못합니다. 이 프로젝트는 이러한 특정 불만을 해결하는 세 가지 실용적인 스킬을 모았습니다. 하나는 어려운 개념을 간단한 다이어그램으로 바꾸고, 하나는 AI가 답하기 전에 전문가처럼 생각하도록 강제하며, 하나는 Get Notes(biji.com) 데이터를 자신의 컴퓨터로 마이그레이션합니다.

작동 방식

각 스킬은 트리거될 때 에이전트가 읽는 지침 세트입니다. npx skills add suyuan2022/suyuan-skill -g 같은 명령으로 설치하면 사용자 디렉토리에 배치되어 모든 프로젝트에서 작동합니다. 세 개 모두 설치하거나 하나만 선택할 수 있습니다. 에이전트가 작업을 시작할 때마다 설치된 모든 스킬의 설명을 읽으므로 작성자는 에이전트의 주의를 낭비하지 않도록 실제로 사용하는 것만 설치할 것을 권장합니다.

• whatis – 개념을 이해하지 못하거나 에이전트의 텍스트가 너무 길 때 호출합니다(예: /whatis 美联储加息为什么会让房贷变贵). 텍스트가 거의 없고 다이어그램(플로우차트, 시퀀스 다이어그램, 아키텍처 다이어그램, 전후 비교)이 중심인 단일 HTML 페이지를 생성합니다. 컨텍스트가 부족하면 먼저 파일이나 웹을 검색하며, 다이어그램의 각 상자는 증거로 뒷받침되어야 합니다. 지어낸 사실은 없습니다. Anthropic의 ELI5 아이디어를 기반으로 더 안정적인 출력을 위해 타이포그래피와 구조 요구 사항을 추가했습니다.
• break-ai-slop – 에이전트가 개방형 작업을 시작하기 전에 네 가지 질문에 답하게 합니다. 현실 세계에서 누가 이것을 가장 잘하며 어떤 상황에서? 초보자나 AI의 실패한 결과는 어떤 모습인가? 일반적인 실수를 피했는데도 여전히 틀렸다면 근본 문제는 무엇인가? 성공을 진정으로 결정하는 제약은 무엇인가? 이것들을 생각한 후에만 시작합니다. "이건 일회용이 아니니 먼저 신중히 생각해"라고 말하거나 /break-ai-slop을 사용하여 트리거할 수 있습니다. 사실이나 오타가 아닌 글쓰기, 계획, 판단 작업을 위한 것이며 출력이 두 배로 길어집니다.
• get-biji – Get Notes(biji.com) 사용자용. 모든 녹음, 저장된 링크, 빠른 메모를 날짜별로 정리된 로컬 Markdown 파일로 동기화합니다. 새 항목은 증분으로 가져올 수 있습니다. 전사에는 화자와 타임스탬프가 포함되며 긴 것은 별도 파일이 됩니다. 파일이 당신의 것이므로 에이전트가 다른 메모와 함께 검색할 수 있고 Get이 변경되거나 오프라인이 되어도 유지됩니다. 또한 Get의 무료 전사 할당량을 사용합니다. Douyin, Xiaohongshu, Bilibili, Xiaoyuzhou 링크를 붙여넣으면 Get이 텍스트로 파싱합니다. 다른 사이트나 로컬 오디오의 경우 Get에 업로드하면 월간 할당량에서 차감됩니다(에이전트가 사전에 대략적인 비용을 알려줍니다). 전사는 임시 Get 노트에서 이루어지며 스킬이 이후 삭제하므로 다른 메모에는 영향을 미치지 않습니다. 설정에는 npm install && npx playwright install chromium 실행이 필요합니다(약 250MB 다운로드, 로그인에만 사용). 첫 사용 시 브라우저가 열려 biji.com에 로그인하므로 자신의 컴퓨터에서 실행해야 합니다. 이후 약 90일 동안 로그인 상태가 유지됩니다. 로컬 오디오/비디오 변환에는 ffmpeg도 필요합니다. 메모는 지정한 디렉토리에 저장되며 로그인 상태는 ~/.config/get-biji/에 있어 재설치나 업데이트 후에도 유지됩니다. 이 스킬은 skychentian/GET-biji를 작성자 허가를 받아 기반으로 합니다. 동기화 부분은 원본에서, 전사 스크립트는 추가되었습니다.

대상 사용자

AI 에이전트(Claude Code 등)를 실제 작업에 사용하고 이러한 일반적인 불만을 겪는 사람들: 개념을 이해하지 못하거나, 평범한 일반 출력을 얻거나, 메모 앱에 갇힌 데이터를 소유하고 재사용하고 싶은 경우. 스킬은 전역으로 설치되므로 에이전트가 처리하는 모든 프로젝트에서 작동합니다.

하이라이트

• 다이어그램 우선 설명 – whatis는 개념을 최소한의 텍스트로 시각적 HTML 페이지로 렌더링하고 주제에 가장 적합한 다이어그램 유형을 선택합니다.
• 증거 기반 다이어그램 – 각 상자는 정당화되어야 하며 필요 시 에이전트가 파일이나 웹을 확인합니다.
• 슬롭 방지 사고 루틴 – break-ai-slop의 네 가지 질문은 에이전트가 행동하기 전에 현실 세계 맥락, 실패 모드, 근본 원인, 진정한 제약을 고려하도록 강제합니다.
• Get Notes의 로컬 소유권 – 화자 태그가 있는 전사, 증분 업데이트, 오프라인 액세스를 갖춘 Markdown으로 전체 내보내기.
• 추가 도구 없는 전사 – Get 자체 할당량을 사용하여 링크나 업로드를 변환하고 비용을 사전에 경고합니다.
• 프로젝트 간 작동 – 전역 설치로 에이전트가 접촉하는 모든 프로젝트에서 이 스킬을 사용할 수 있습니다.
• MIT 라이선스 – 무료로 사용 및 수정 가능.