HughYau/qiushi-skill

Qiushi‑Skill란 무엇인가요?

Qiushi‑Skill은 AI 에이전트를 위한 "스킬"(플러그인 모듈) 라이브러리입니다. 마르크스-레닌주의 철학에서 유래한 9가지 전통적인 방법론 도구(모순 분석, 실천-인지, 조사 우선, 대중노선, 비판과 자기비판, 장기전략, 집중력, 별불꽃이 초원을 태우듯, 종합적 계획)를 패키지화하여, Claude Code, Cursor, Codex 등과 같은 대화형 에이전트 런타임에 즉시 사용 가능한 자가 포함형 스킬 정의로 제공합니다.

각 스킬은 다음과 같은 요소를 포함합니다:

• 짧은 트리거 규칙 (어떤 상황에서 스킬을 사용해야 하는지)
• 작업 가이드 (에이전트가 수행해야 할 단계별 행동)
• 출력 템플릿 (에이전트가 반환하는 구조화된 결과)
• 하드 제약 조건 (지켜야 하는 규율 규칙)
• 핸드오프 사양 (다음에 무엇을 해야 하는지)

이 라이브러리는 참조 텍스트(원작에서 인용한 문장), 서브에이전트(예: 사실/추측/모름 보고서를 생성하는 "조사자"), 여러 스킬을 연결할 수 있는 워크플로우 정의도 함께 제공합니다.

---

왜 존재하는가?

저자는 현재 많은 AI 에이전트는 "생각"할 수 있지만, "생각하는 방식"에 대해 생각하지 않는다고 주장합니다. 즉, 답에 즉각적으로 뛰어들고, 증거를 무시하며, 문제의 난이도가 높아지면 포기하는 경향이 있습니다. Qiushi‑Skill은 에이전트에게 체계적이고 증거 중심의 방법론을 제공함으로써 다음과 같은 목표를 달성하고자 합니다:

1. 사실 중심 – 결론은 검증된 증거에 따라야 한다.
2. 자기비판적 – 정기적인 점검과 비판 루프를 수행한다.
3. 전략적 – 작업에 적합한 "무기"(스킬)를 선택하고 자원을 집중한다.

---

설치 방법

1️⃣ 1줄 설치 (권장)

npx qiushi-skill

CLI는 호스트 에이전트(Claude Code, Cursor 등)를 감지하고, 적절한 스킬 파일을 호스트의 플러그인 디렉터리에 작성하며, 엔트리포인트 스킬(arming‑thought)을 등록합니다.

특정 호스트나 범위를 지정할 수도 있습니다. 예시:

npx qiushi-skill install --target claude-code --scope user
npx qiushi-skill install --target cursor,codex,opencode,openclaw,hermes,nanobot --scope user

2️⃣ Claude Code 마켓플레이스

내장된 마켓플레이스 명령어를 통해 플러그인을 추가합니다:

/plugin marketplace add HughYau/qiushi-skill
/plugin install qiushi-skill@qiushi-skill

Node.js가 없을 경우, 단순히 skills/ 폴더를 호스트의 스킬 디렉터리에 복사하면 됩니다.

---

스킬 사용법

설치 후, "무장 사고"(Arming Thought) 카ーネル이 모든 세션 시작 시 자동으로 로드됩니다(약 50줄의 지속 코드). 이 카ーネル은 최상위 원칙인 실사구시(사실에 근거하여 진실을 찾는다)를 강제하고, 현재 맥락에 따라 9개의 방법론 스킬 중 하나를 호출할지 여부를 결정합니다.

마크다운 슬래시 명령어를 지원하는 경우 (수동 명령어)

명령어	스킬
/contradiction-analysis	모순 분석법
/practice-cognition	실천 인식론
/investigation-first	조사 우선
/mass-line	대중노선
/criticism-self-criticism	비판과 자기비판
/protracted-strategy	장기전략
/concentrate-forces	집중력
/spark-prairie-fire	별불꽃이 초원을 태우듯
/overall-planning	종합적 계획
/workflows	워크플로우 조합

각 명령어는 해당 SKILL.md를 열거나 서브에이전트를 실행하고, 메인 에이전트가 소비할 수 있는 구조화된 결과를 반환합니다.

---

프로젝트 구조 (개요)

qiushi-skill/
├─ .claude-plugin/   # Claude Code 마켓플레이스 메타데이터
├─ .cursor-plugin/   # Cursor 플러그인 메타데이터
├─ bin/qiushi-skill.mjs   # CLI 진입점
├─ commands/          # 마크다운 슬래시 명령어 파일
├─ hooks/             # 세션 시작 시 인젝션 스크립트 (POSIX, PowerShell, CMD)
├─ agents/            # 서브에이전트 (조사자, 자기비판자)
├─ skills/            # 방법론 스킬 하나당 하나의 폴더 + 엔트리 카ーネル
│   ├─ arming-thought/   # 엔트리 카ーネル (실사구시 + 라우팅)
│   ├─ contradiction-analysis/
│   ├─ practice-cognition/
│   └─ … (다른 7개 스킬) …
│   └─ workflows/        # 스킬 간 워크플로우 정의
├─ tests/             # 모든 플랫폼용 검증 스크립트
├─ docs/              # 정적 사이트 및 플랫폼별 설치 가이드
└─ package.json

---

누구에게 적합한가요?

• 커스텀 AI 어시스턴트를 개발하는 개발자 (Claude Code, Cursor, Codex 등)로서 철학적 기반을 가진 의사결정 계층을 내장하고 싶은 사람.
• 에이전트 프롬프팅 실험을 하는 연구자로서 재현 가능하고 구조화된 추론 패턴이 필요한 사람.
• LLM 기반 자동화에서 증거 중심, 자기비판적 워크플로우를 강제하고 싶은 팀.

---

라이선스 및 커뮤니티

• MIT 라이선스 – 자유롭게 사용, 수정, 재배포 가능.
• 토론, 예제, 제3자 통합은 README에 기재됨 (예: "제로베이스 AI" 책, "Ralph Qiushi" 워크플로우, 사용자 제출 사례 연구).
• 저자는 또한 여러 플랫폼에 걸쳐 에이전트 스킬을 설치하는 메타도구 AcademicForge 를 유지 관리하고 있습니다.

---

TL;DR

Qiushi‑Skill은 작고 Node 기반의 CLI 또는 마켓플레이스 엔트리를 통해 제공되는 AI 에이전트용 9가지 체계적 추론 "스킬"의 즉시 사용 가능한 컬렉션입니다. 사실 중심, 자기비판적인 워크플로우를 에이전트에 제공하여, 복잡하고 다단계 문제를 더 잘 해결할 수 있도록 합니다.