triflux 6.0.21 → 6.1.0

package/skills/tfx-autoresearch/SKILL.md

@@ -0,0 +1,129 @@
+---
+name: tfx-autoresearch
+description: >
+  자율 웹 리서치 → 실행 가능 계획 도출.
+  주제를 받아 웹 검색 → 정보 수집 → 분석 → 구조화된 리서치 보고서 생성.
+triggers:
+  - autoresearch
+  - 리서치
+  - 자동 리서치
+  - 웹 리서치
+  - 조사해
+  - 알아봐
+  - research this
+argument-hint: "<topic>"
+source: GAP 분석 P2 #8
+---
+
+# tfx-autoresearch — 자율 웹 리서치
+
+> 주제를 받아 자동으로 웹을 검색하고, 결과를 분석하여 구조화된 리서치 보고서를 생성합니다.
+> "조사는 AI가, 판단은 사람이."
+
+## 사용법
+
+```
+/autoresearch Next.js 15 App Router 변경점
+/리서치 Rust vs Go 백엔드 성능 비교
+/웹 리서치 2026 프론트엔드 프레임워크 트렌드
+/research this MCP protocol specification
+```
+
+## 리서치 프로세스
+
+리서치는 아래 6단계를 순서대로 실행합니다.
+
+### Step 1: 주제 수집
+
+사용자로부터 리서치 주제를 수집합니다. 인자로 주어지지 않았으면 대화로 요청합니다.
+
+- 주제가 모호하면 범위를 좁히는 후속 질문을 합니다.
+- 리서치 목적(비교, 기술 선택, 트렌드 파악 등)을 확인합니다.
+
+### Step 2: 검색 쿼리 자동 생성
+
+주제에서 3-5개의 검색 쿼리를 자동 생성합니다.
+
+**규칙:**
+1. 한국어 주제 → 한국어 쿼리 2-3개 + 영어 쿼리 1-2개 생성
+2. 영어 주제 → 영어 쿼리 3-5개 생성
+3. 일반 쿼리 + 비교 쿼리 + 최신 동향 쿼리를 조합
+4. 각 쿼리는 검색 엔진 최적화를 위해 핵심 키워드 중심으로 구성
+
+**예시 (주제: "Next.js 15 변경점"):**
+```
+- "Next.js 15 주요 변경점 정리"
+- "Next.js 15 App Router 변경사항 2025"
+- "Next.js 15 breaking changes migration"
+- "Next.js 15 vs 14 comparison"
+```
+
+### Step 3: 웹 검색 실행
+
+brave-search MCP 또는 WebSearch 도구로 각 쿼리를 실행합니다.
+
+**규칙:**
+1. 사용 가능한 검색 도구를 자동 감지합니다 (brave-search MCP 우선, 없으면 WebSearch).
+2. 각 쿼리당 상위 5-10개 결과를 수집합니다.
+3. 중복 URL은 자동 제거합니다.
+4. 검색 실패 시 쿼리를 변형하여 재시도합니다.
+
+### Step 4: 핵심 정보 추출
+
+수집된 결과에서 핵심 정보를 추출합니다.
+
+**규칙:**
+1. 각 결과의 제목, URL, 스니펫을 정규화합니다.
+2. 주제와 관련성이 높은 정보를 우선 선별합니다.
+3. 사실(fact)과 의견(opinion)을 구분합니다.
+4. 날짜가 포함된 정보는 최신성을 기준으로 정렬합니다.
+
+### Step 5: 구조화된 리서치 보고서 생성
+
+수집-분석된 정보를 구조화된 마크다운 보고서로 작성합니다.
+
+### Step 6: 보고서 저장
+
+`.tfx/reports/research-{timestamp}.md`에 저장하고 경로를 사용자에게 알립니다.
+
+## 보고서 형식
+
+```markdown
+# Research: {topic}
+Date: {date}
+
+## Executive Summary
+{1-3문장 핵심 요약}
+
+## Key Findings
+1. {발견 1}
+2. {발견 2}
+3. {발견 3}
+...
+
+## Comparative Analysis
+| 항목 | A | B |
+|------|---|---|
+| ... | ... | ... |
+
+(비교 대상이 있을 때만 포함)
+
+## Actionable Recommendations
+1. {추천 1: 구체적이고 실행 가능한 다음 단계}
+2. {추천 2}
+3. {추천 3}
+
+## Sources
+- [{제목}]({URL}) — {한줄 요약}
+- ...
+```
+
+## 동작 규칙
+
+1. 검색 도구가 없으면 사용자에게 알리고 수동 리서치 모드로 전환합니다.
+2. 검색 결과가 부족하면 쿼리를 변형하여 추가 검색합니다.
+3. 모든 정보에 출처 URL을 반드시 표기합니다.
+4. 추천 사항은 "실행 가능"해야 합니다 (모호한 조언 금지).
+5. 보고서는 항상 `.tfx/reports/research-{timestamp}.md`에 저장합니다.
+6. 리서치 완료 후 보고서 경로와 핵심 요약을 사용자에게 보고합니다.
+7. 한국어 주제는 한국어 보고서, 영어 주제는 영어 보고서로 작성합니다.

package/skills/tfx-deep-interview/SKILL.md

@@ -0,0 +1,133 @@
+---
+name: tfx-deep-interview
+description: >
+  구현 전 소크라테스식 질의로 요구사항 깊이 탐색.
+  5단계 인터뷰를 통해 요구사항을 명확히 하고 최적 구현 경로를 도출합니다.
+triggers:
+  - deep-interview
+  - 딥인터뷰
+  - 소크라테스
+  - 깊이 탐색
+  - 요구사항 분석
+argument-hint: "<topic>"
+---
+
+# tfx-deep-interview — 소크라테스식 깊이 탐색
+
+> 구현 전에 질문을 통해 요구사항의 깊이를 탐색합니다.
+> "좋은 답은 좋은 질문에서 나온다."
+
+## 사용법
+
+```
+/deep-interview 인증 시스템 리팩터링
+/deep-interview JWT 기반 세션 관리
+/딥인터뷰 데이터 파이프라인 설계
+```
+
+## 5단계 인터뷰 프로세스
+
+인터뷰는 반드시 아래 5단계를 순서대로 진행합니다. 각 단계에서 사용자 응답을 수집한 후 다음 단계로 이동합니다.
+
+### Stage 1: Clarify (명확화)
+
+> "정확히 무엇을 달성하려는가?"
+
+목표를 한 문장으로 정의하고, 성공 기준과 현재 상태의 차이를 파악합니다.
+
+**질문 템플릿:**
+
+1. "이 작업의 핵심 목표를 한 문장으로 설명해주세요."
+2. "완료 후 어떤 상태가 되어야 성공인가요?"
+3. "현재 상태에서 가장 큰 문제점은 무엇인가요?"
+
+### Stage 2: Decompose (분해)
+
+> "이것을 어떤 하위 문제로 나눌 수 있는가?"
+
+대상을 3-5개의 독립적 하위 문제로 분해하고, 의존성과 우선순위를 결정합니다.
+
+**질문 템플릿:**
+
+1. "이 작업을 3-5개의 독립된 단계로 나눈다면?"
+2. "각 단계 사이에 의존성이 있나요?"
+3. "가장 먼저 해결해야 할 핵심 문제는?"
+
+### Stage 3: Challenge (반론)
+
+> "이 접근의 약점은?"
+
+선택한 접근 방식의 단점을 식별하고, 실패 시나리오와 기술 부채 가능성을 탐색합니다.
+
+**질문 템플릿:**
+
+1. "이 방식이 실패할 수 있는 시나리오는?"
+2. "6개월 후 이 코드를 유지보수할 때 문제가 될 부분은?"
+3. "이 접근이 다른 시스템에 미치는 영향은?"
+
+### Stage 4: Alternatives (대안)
+
+> "다른 방법은?"
+
+최소 2개의 대안을 검토하고, 각 대안의 trade-off를 비교합니다.
+
+**질문 템플릿:**
+
+1. "같은 목표를 달성할 수 있는 완전히 다른 접근은?"
+2. "시간이 절반밖에 없다면 어떤 방식을 택하겠습니까?"
+3. "이 기술 대신 다른 것을 사용하면 어떤 trade-off가 있나요?"
+
+### Stage 5: Synthesize (종합)
+
+> "최적 경로는?"
+
+인터뷰 결과를 종합하여 실행 계획을 도출하고, 구조화된 요구사항 문서를 생성합니다.
+
+**질문 템플릿:**
+
+1. "지금까지의 논의를 종합하면, 최적의 접근 방식은?"
+2. "첫 번째 단계로 무엇을 실행하시겠습니까?"
+3. "이 결정에 대해 확신하는 정도는? (1-10)"
+
+## 산출물
+
+인터뷰 완료 후 `.tfx/plans/interview-{timestamp}.md` 경로에 구조화된 요구사항 문서를 생성합니다.
+
+### 산출물 형식
+
+```markdown
+# Interview: {topic}
+Date: {date}
+
+## Goal
+{1문장 목표}
+
+## Decomposition
+{하위 문제 목록}
+
+## Risks & Challenges
+{식별된 위험}
+
+## Alternatives Considered
+| 대안 | 장점 | 단점 |
+|------|------|------|
+| ... | ... | ... |
+
+## Decision
+{최종 결정 + 근거}
+
+## Action Plan
+1. {단계 1}
+2. {단계 2}
+3. ...
+```
+
+## 동작 규칙
+
+1. 각 단계에서 반드시 사용자 응답을 수집한 후 다음 단계로 이동합니다.
+2. 사용자가 명확한 답을 못 할 경우, 후속 질문으로 유도합니다.
+3. 단계를 건너뛰지 않습니다 (5단계 모두 필수).
+4. 이전 단계의 답변을 다음 단계 질문에 반영합니다 (대화형 연결).
+5. 최종 산출물은 항상 `.tfx/plans/interview-{timestamp}.md`에 마크다운 파일로 저장합니다.
+6. 인터뷰 시작 시 현재 주제와 관련된 코드베이스를 탐색하여 컨텍스트를 확보합니다.
+7. 각 단계 전환 시 이전 단계 요약을 한 줄로 보여줍니다.