From 8700faff66bbf491d2da982bf05b7d34458289ed Mon Sep 17 00:00:00 2001 From: Jamkris Date: Wed, 8 Apr 2026 12:56:11 +0900 Subject: [PATCH 01/24] refactor: silence hook logging and update tests to verify quiet execution --- scripts/hooks/evaluate-session.js | 11 ++++----- scripts/hooks/pre-compact.js | 5 ++-- scripts/hooks/session-end.js | 9 +++---- scripts/hooks/session-start.js | 40 +++++++------------------------ scripts/hooks/suggest-compact.js | 14 ++++------- tests/hooks/hooks.test.js | 32 +++++++++++-------------- 6 files changed, 36 insertions(+), 75 deletions(-) diff --git a/scripts/hooks/evaluate-session.js b/scripts/hooks/evaluate-session.js index e74d082..fba6d6a 100644 --- a/scripts/hooks/evaluate-session.js +++ b/scripts/hooks/evaluate-session.js @@ -17,8 +17,7 @@ const { getLearnedSkillsDir, ensureDir, readFile, - countInFile, - log + countInFile } = require('../lib/utils'); const { runHook } = require('../lib/hook-utils'); @@ -63,12 +62,10 @@ runHook('ContinuousLearning', async () => { // Skip short sessions if (messageCount < minSessionLength) { - log(`[ContinuousLearning] Session too short (${messageCount} messages), skipping`); - process.exit(0); + // Session too short, skip silently + return; } - // Signal to Gemini that session should be evaluated for extractable patterns - log(`[ContinuousLearning] Session has ${messageCount} messages - evaluate for extractable patterns`); - log(`[ContinuousLearning] Save learned skills to: ${learnedSkillsPath}`); + // Session evaluation completed silently }); diff --git a/scripts/hooks/pre-compact.js b/scripts/hooks/pre-compact.js index 173f13f..d6e15db 100644 --- a/scripts/hooks/pre-compact.js +++ b/scripts/hooks/pre-compact.js @@ -15,8 +15,7 @@ const { getTimeString, findFiles, ensureDir, - appendFile, - log + appendFile } = require('../lib/utils'); const { runHook } = require('../lib/hook-utils'); @@ -40,5 +39,5 @@ runHook('PreCompact', async () => { appendFile(activeSession, `\n---\n**[Compaction occurred at ${timeStr}]** - Context was summarized\n`); } - log('[PreCompact] State saved before compaction'); + // Completed silently }); diff --git a/scripts/hooks/session-end.js b/scripts/hooks/session-end.js index 18ba5a3..82b879a 100644 --- a/scripts/hooks/session-end.js +++ b/scripts/hooks/session-end.js @@ -17,8 +17,7 @@ const { getSessionIdShort, ensureDir, writeFile, - replaceInFile, - log + replaceInFile } = require('../lib/utils'); const { runHook } = require('../lib/hook-utils'); @@ -42,9 +41,7 @@ runHook('SessionEnd', async () => { `**Last Updated:** ${currentTime}` ); - if (success) { - log(`[SessionEnd] Updated session file: ${sessionFile}`); - } + // Updated silently } else { // Create new session file with template const template = `# Session: ${today} @@ -74,7 +71,7 @@ runHook('SessionEnd', async () => { `; writeFile(sessionFile, template); - log(`[SessionEnd] Created session file: ${sessionFile}`); + // Created silently } }); diff --git a/scripts/hooks/session-start.js b/scripts/hooks/session-start.js index 8eca0ae..d4d32da 100644 --- a/scripts/hooks/session-start.js +++ b/scripts/hooks/session-start.js @@ -33,37 +33,13 @@ runHook('SessionStart', async () => { // Match both old format (YYYY-MM-DD-session.tmp) and new format (YYYY-MM-DD-shortid-session.tmp) const recentSessions = findFiles(sessionsDir, '*-session.tmp', { maxAge: 7 }); - if (recentSessions.length > 0) { - const latest = recentSessions[0]; - log(`[SessionStart] Found ${recentSessions.length} recent session(s)`); - log(`[SessionStart] Latest: ${latest.path}`); - } - - // Check for learned skills - const learnedSkills = findFiles(learnedDir, '*.md'); - - if (learnedSkills.length > 0) { - log(`[SessionStart] ${learnedSkills.length} learned skill(s) available in ${learnedDir}`); - } - - // Check for available session aliases - const aliases = listAliases({ limit: 5 }); + // Check for recent sessions, learned skills, and aliases (silent) + findFiles(sessionsDir, '*-session.tmp', { maxAge: 7 }); + findFiles(learnedDir, '*.md'); + listAliases({ limit: 5 }); - if (aliases.length > 0) { - const aliasNames = aliases.map(a => a.name).join(', '); - log(`[SessionStart] ${aliases.length} session alias(es) available: ${aliasNames}`); - log(`[SessionStart] Use /sessions load to continue a previous session`); - } - - // Detect and report package manager - const pm = getPackageManager(); - log(`[SessionStart] Package manager: ${pm.name} (${pm.source})`); - - // If package manager was detected via fallback, show selection prompt - if (pm.source === 'fallback' || pm.source === 'default') { - log('[SessionStart] No package manager preference found.'); - log(getSelectionPrompt()); - } + // Detect package manager (silent) + getPackageManager(); // Command shims: only needed for manual installs (no extension). // When the extension is installed, Gemini CLI loads commands directly @@ -87,7 +63,7 @@ runHook('SessionStart', async () => { for (const file of fs.readdirSync(globalCmdDir).filter(f => f.endsWith('.toml'))) { if (extCmds.has(file)) { fs.unlinkSync(path.join(globalCmdDir, file)); - log(`[SessionStart] Removed stale shim: ${file}`); + // Silently remove stale shim } } } @@ -122,7 +98,7 @@ runHook('SessionStart', async () => { ); } fs.writeFileSync(globalFile, newContent); - log(`[SessionStart] Created shim: ${file}`); + // Silently create shim } } } diff --git a/scripts/hooks/suggest-compact.js b/scripts/hooks/suggest-compact.js index cb533e4..9a665c4 100644 --- a/scripts/hooks/suggest-compact.js +++ b/scripts/hooks/suggest-compact.js @@ -17,8 +17,7 @@ const path = require('path'); const { getTempDir, readFile, - writeFile, - log + writeFile } = require('../lib/utils'); const { runHook } = require('../lib/hook-utils'); @@ -42,14 +41,11 @@ runHook('StrategicCompact', async () => { // Save updated count writeFile(counterFile, String(count)); - // Suggest compact after threshold tool calls + // Suggest compact only at key milestones (threshold and intervals) if (count === threshold) { - log(`[StrategicCompact] ${threshold} tool calls reached - consider /compact if transitioning phases`); - } - - // Suggest at regular intervals after threshold - if (count > threshold && count % 25 === 0) { - log(`[StrategicCompact] ${count} tool calls - good checkpoint for /compact if context is stale`); + console.error(`[Hint] ${threshold} tool calls reached - consider /compact if transitioning phases`); + } else if (count > threshold && count % 25 === 0) { + console.error(`[Hint] ${count} tool calls - good checkpoint for /compact if context is stale`); } }); diff --git a/tests/hooks/hooks.test.js b/tests/hooks/hooks.test.js index de12d38..169d191 100644 --- a/tests/hooks/hooks.test.js +++ b/tests/hooks/hooks.test.js @@ -92,12 +92,14 @@ async function runTests() { assert.strictEqual(result.code, 0, `Exit code should be 0, got ${result.code}`); })) passed++; else failed++; - if (await asyncTest('outputs session info to stderr', async () => { + if (await asyncTest('runs silently on success', async () => { const result = await runScript(path.join(scriptsDir, 'session-start.js')); + // Normal operation should produce minimal or no stderr output + // Only warnings/errors should appear assert.ok( - result.stderr.includes('[SessionStart]') || - result.stderr.includes('Package manager'), - 'Should output session info' + !result.stderr.includes('[SessionStart] Found') && + !result.stderr.includes('[SessionStart] Package manager'), + 'Should not output verbose info on success' ); })) passed++; else failed++; @@ -155,9 +157,9 @@ async function runTests() { assert.strictEqual(result.code, 0, `Exit code should be 0, got ${result.code}`); })) passed++; else failed++; - if (await asyncTest('outputs PreCompact message', async () => { + if (await asyncTest('runs silently on success', async () => { const result = await runScript(path.join(scriptsDir, 'pre-compact.js')); - assert.ok(result.stderr.includes('[PreCompact]'), 'Should output PreCompact message'); + assert.ok(!result.stderr.includes('[PreCompact]'), 'Should not output verbose info on success'); })) passed++; else failed++; if (await asyncTest('creates compaction log', async () => { @@ -224,11 +226,10 @@ async function runTests() { assert.strictEqual(result.code, 0, `Exit code should be 0, got ${result.code}`); })) passed++; else failed++; - if (await asyncTest('skips short sessions', async () => { + if (await asyncTest('skips short sessions silently', async () => { const testDir = createTestDir(); const transcriptPath = path.join(testDir, 'transcript.jsonl'); - // Create a short transcript (less than 10 user messages) const transcript = Array(5).fill('{"type":"user","content":"test"}\n').join(''); fs.writeFileSync(transcriptPath, transcript); @@ -236,19 +237,16 @@ async function runTests() { GEMINI_TRANSCRIPT_PATH: transcriptPath }); - assert.ok( - result.stderr.includes('Session too short'), - 'Should indicate session is too short' - ); + assert.strictEqual(result.code, 0, 'Should exit cleanly'); + assert.ok(!result.stderr.includes('Session too short'), 'Should skip silently'); cleanupTestDir(testDir); })) passed++; else failed++; - if (await asyncTest('processes sessions with enough messages', async () => { + if (await asyncTest('processes long sessions silently', async () => { const testDir = createTestDir(); const transcriptPath = path.join(testDir, 'transcript.jsonl'); - // Create a longer transcript (more than 10 user messages) const transcript = Array(15).fill('{"type":"user","content":"test"}\n').join(''); fs.writeFileSync(transcriptPath, transcript); @@ -256,10 +254,8 @@ async function runTests() { GEMINI_TRANSCRIPT_PATH: transcriptPath }); - assert.ok( - result.stderr.includes('15 messages'), - 'Should report message count' - ); + assert.strictEqual(result.code, 0, 'Should exit cleanly'); + assert.ok(!result.stderr.includes('15 messages'), 'Should process silently'); cleanupTestDir(testDir); })) passed++; else failed++; From 8ff778336c843045f4e0d67175df22b010c4c5ec Mon Sep 17 00:00:00 2001 From: Jamkris Date: Wed, 8 Apr 2026 12:56:49 +0900 Subject: [PATCH 02/24] refactor: simplify session hook logic by removing unused variables and redundant file lookups --- scripts/hooks/session-end.js | 4 +--- scripts/hooks/session-start.js | 5 ++--- 2 files changed, 3 insertions(+), 6 deletions(-) diff --git a/scripts/hooks/session-end.js b/scripts/hooks/session-end.js index 82b879a..9269085 100644 --- a/scripts/hooks/session-end.js +++ b/scripts/hooks/session-end.js @@ -35,13 +35,11 @@ runHook('SessionEnd', async () => { // If session file exists for today, update the end time if (fs.existsSync(sessionFile)) { - const success = replaceInFile( + replaceInFile( sessionFile, /\*\*Last Updated:\*\*.*/, `**Last Updated:** ${currentTime}` ); - - // Updated silently } else { // Create new session file with template const template = `# Session: ${today} diff --git a/scripts/hooks/session-start.js b/scripts/hooks/session-start.js index d4d32da..fe1f0bc 100644 --- a/scripts/hooks/session-start.js +++ b/scripts/hooks/session-start.js @@ -16,7 +16,7 @@ const { ensureDir, log } = require('../lib/utils'); -const { getPackageManager, getSelectionPrompt } = require('../lib/package-manager'); +const { getPackageManager } = require('../lib/package-manager'); const { listAliases } = require('../lib/session-aliases'); const { runHook } = require('../lib/hook-utils'); @@ -33,8 +33,7 @@ runHook('SessionStart', async () => { // Match both old format (YYYY-MM-DD-session.tmp) and new format (YYYY-MM-DD-shortid-session.tmp) const recentSessions = findFiles(sessionsDir, '*-session.tmp', { maxAge: 7 }); - // Check for recent sessions, learned skills, and aliases (silent) - findFiles(sessionsDir, '*-session.tmp', { maxAge: 7 }); + // Initialize recent sessions, learned skills, and aliases (silent) findFiles(learnedDir, '*.md'); listAliases({ limit: 5 }); From 2540d572a8b72b005739e3b8c139a81a19b72077 Mon Sep 17 00:00:00 2001 From: Jamkris Date: Wed, 8 Apr 2026 12:57:21 +0900 Subject: [PATCH 03/24] refactor: remove unused recentSessions variable in session-start hook --- scripts/hooks/session-start.js | 5 +---- 1 file changed, 1 insertion(+), 4 deletions(-) diff --git a/scripts/hooks/session-start.js b/scripts/hooks/session-start.js index fe1f0bc..c59a039 100644 --- a/scripts/hooks/session-start.js +++ b/scripts/hooks/session-start.js @@ -29,11 +29,8 @@ runHook('SessionStart', async () => { ensureDir(sessionsDir); ensureDir(learnedDir); - // Check for recent session files (last 7 days) - // Match both old format (YYYY-MM-DD-session.tmp) and new format (YYYY-MM-DD-shortid-session.tmp) - const recentSessions = findFiles(sessionsDir, '*-session.tmp', { maxAge: 7 }); - // Initialize recent sessions, learned skills, and aliases (silent) + findFiles(sessionsDir, '*-session.tmp', { maxAge: 7 }); findFiles(learnedDir, '*.md'); listAliases({ limit: 5 }); From 828013500108e6caaa8732c76f8ee6cf1c777b1b Mon Sep 17 00:00:00 2001 From: Jamkris Date: Wed, 8 Apr 2026 13:03:48 +0900 Subject: [PATCH 04/24] docs: update language navigation links and remove redundant Korean README file --- COMMANDS.md | 2 + README.ko.md | 192 -------------------- README.md | 2 +- COMMANDS.ko.md => docs/ko-KR/COMMANDS.md | 2 + docs/ko-KR/README.md | 2 +- COMMANDS.zh-CN.md => docs/zh-CN/COMMANDS.md | 2 + README.zh-CN.md => docs/zh-CN/README.md | 4 +- 7 files changed, 10 insertions(+), 196 deletions(-) delete mode 100644 README.ko.md rename COMMANDS.ko.md => docs/ko-KR/COMMANDS.md (98%) rename COMMANDS.zh-CN.md => docs/zh-CN/COMMANDS.md (98%) rename README.zh-CN.md => docs/zh-CN/README.md (96%) diff --git a/COMMANDS.md b/COMMANDS.md index 3e0fa43..ce578ce 100644 --- a/COMMANDS.md +++ b/COMMANDS.md @@ -1,3 +1,5 @@ +**Language:** **English** | [한국어](docs/ko-KR/COMMANDS.md) | [简体中文](docs/zh-CN/COMMANDS.md) + # Gemini CLI Extension Commands List of available commands provided by `everything-gemini-code`. diff --git a/README.ko.md b/README.ko.md deleted file mode 100644 index 22c19f9..0000000 --- a/README.ko.md +++ /dev/null @@ -1,192 +0,0 @@ -**Language:** [English](README.md) | **한국어** | [简体中文](README.zh-CN.md) - -# Everything Gemini Code - -[![Stars](https://img.shields.io/github/stars/Jamkris/everything-gemini-code?style=flat)](https://github.com/Jamkris/everything-gemini-code/stargazers) -[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE) - -**Gemini CLI / Antigravity를 위한 종합 설정 스위트입니다.** - -이 확장은 Gemini 개발 워크플로우를 강력하게 만들어줄 프로덕션 레벨의 에이전트, 스킬, 훅, 명령어, 규칙, 그리고 MCP 설정을 제공합니다. - ---- - -## 🚀 빠른 시작 - -```bash -npm install -g @google/gemini-cli@latest - -# 또는 - -npm update -g @google/gemini-cli -``` - -### 인증 설정 (필수) - -Gemini CLI를 사용하려면 API 키가 필요합니다. - -1. [Google AI Studio](https://aistudio.google.com/)에서 API 키를 발급받으세요. -2. 환경 변수로 설정합니다: - -```bash -export GEMINI_API_KEY="여기에_API_키를_입력하세요" -``` - -### 옵션 1: Gemini CLI를 통한 설치 (권장) - -가장 간편한 설치 방법입니다. Gemini CLI용 확장이 자동으로 설정됩니다. - -```bash -gemini extensions install https://github.com/Jamkris/everything-gemini-code -``` - -### 옵션 2: 스크립트를 통한 설치 (Antigravity 및 고급 사용자용) - -**Antigravity** (VS Code / Cursor)를 사용하거나 설치를 커스터마이징해야 하는 경우 권장됩니다. 기존 설정은 자동으로 업데이트됩니다. - -```bash -# Antigravity 전용 설치 (권장) -/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Jamkris/everything-gemini-code/main/install.sh)" -- --antigravity - -# 전체 설치 (CLI + Antigravity) -/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Jamkris/everything-gemini-code/main/install.sh)" -- --all -``` - -### 옵션 1: 삭제 방법 (Uninstallation) - -```bash -gemini extensions uninstall https://github.com/Jamkris/everything-gemini-code -``` - -### 옵션 2: 삭제 방법 (Uninstallation) - -```bash -# 선택적 삭제 (권장): 해당 확장에서 설치한 파일만 삭제하고, 사용자가 추가한 파일은 유지합니다. -/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Jamkris/everything-gemini-code/main/uninstall.sh)" -- --antigravity - -# 전체 삭제 (주의): 해당 디렉토리의 모든 파일을 삭제합니다. -/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Jamkris/everything-gemini-code/main/uninstall.sh)" -- --antigravity --purge -``` - -### 옵션 2: 수동 설치 (고급) - -직접 제어하거나 특정 컴포넌트만 커스터마이징하고 싶다면: - -```bash -# 저장소 복제 -git clone https://github.com/Jamkris/everything-gemini-code.git - -# 에이전트 복사 -cp everything-gemini-code/agents/*.md ~/.gemini/agents/ - -# 명령어 복사 (Gemini CLI 용) -cp everything-gemini-code/commands/*.toml ~/.gemini/commands/ - -# 워크플로우 복사 (Antigravity 용) -# 참고: Antigravity는 ~/.gemini/antigravity/global_workflows/ 경로를 사용합니다. -cp everything-gemini-code/workflows/*.md ~/.gemini/antigravity/global_workflows/ - -# 스킬 복사 -cp -r everything-gemini-code/skills/* ~/.gemini/skills/ - -``` - -> **Antigravity 사용자 참고:** -> Antigravity를 위해 수동 설치하는 경우, 호환성을 위해 `~/.gemini/antigravity/` 하위 디렉토리(`global_agents`, `global_skills`)에 복사하는 것이 좋습니다. `install.sh` 스크립트는 이를 자동으로 처리합니다. -> -> **참고:** 규칙은 `install.sh`를 통해 `~/.gemini/GEMINI.md`에 통합됩니다. 수동 설치 시: `cp everything-gemini-code/templates/GEMINI_GLOBAL.md ~/.gemini/GEMINI.md` - -### 옵션 3: Gemini CLI 확장 프로그램으로 설치 (개발자 모드) - -이 저장소를 Gemini CLI 확장 프로그램으로 직접 링크할 수 있습니다. 이를 통해 변경 사항을 실시간으로 개발하고 테스트할 수 있습니다. - -```bash -# 저장소 복제 -git clone https://github.com/Jamkris/everything-gemini-code.git -cd everything-gemini-code - -# 확장 프로그램 링크 -gemini extensions link . -``` - -> ⚠️ **참고:** 규칙(Rules)은 확장 프로그램으로 자동 배포되지 않으므로 `~/.gemini/rules/` 또는 `~/.gemini/antigravity/global_rules/` 경로에 수동으로 설치해야 합니다. - ---- - -## 💻 사용법 - -설치가 완료되면 Gemini CLI에서 새로운 기능들을 바로 사용할 수 있습니다. - -### 슬래시 명령어 (Slash Commands) - -커스텀 명령어로 워크플로우를 자동화하세요 (전체 명령어 목록은 [COMMANDS.ko.md](COMMANDS.ko.md) 참조): - -```bash -# 기능 구현 계획 수립 -/plan "JWT 사용자 인증 기능 추가" - -# TDD 워크플로우 시작 -/tdd "사용자 서비스 생성" - -# 코드 리뷰 실행 -/code-review -``` - -### 에이전트 (Agents) - -복잡한 작업을 전문 에이전트에게 위임하세요: - -```bash -# 시스템 설계를 위한 아키텍트 에이전트 사용 -@architect "마이크로서비스 아키텍처 설계해줘..." - -# 보안 취약점 점검을 위한 보안 리뷰어 사용 -@security-reviewer "이 파일의 인젝션 취약점 점검해줘" -``` - -### 스킬 (Skills) - -Gemini는 "TDD 워크플로우"나 "백엔드 패턴"과 같이 요청과 관련된 스킬을 자동으로 활용합니다. - -### MCP 서버 (MCP Servers) - -Gemini의 기능을 확장하기 위해 Model Context Protocol (MCP) 서버를 구성하고 관리하세요. ([MCP 설정 가이드](mcp-configs/README.md) 참조) - ---- - -## 📦 구성 요소 - -이 확장은 완전한 개발 환경 설정을 포함합니다: - -``` -everything-gemini-code/ -├── gemini-extension.json # 확장 프로그램 매니페스트 -├── agents/ # 전문 서브 에이전트 (@planner, @architect 등) -├── skills/ # 워크플로우 정의 (TDD, 패턴 등) -├── commands/ # Gemini CLI 명령어 (.toml) -├── workflows/ # Antigravity 워크플로우 (.md) -├── templates/ # GEMINI.md 규칙 템플릿 (Global, TS, Python, Go) -├── hooks/ # 자동화 트리거 (hooks.json) -└── mcp-configs/ # MCP 서버 설정 -``` - ---- - -만약 "Skill conflict detected" 경고가 뜬다면, 이전에 수동으로 설치한 스킬들과 충돌하는 것입니다. 확장에서 제공하는 최신 스킬을 사용하려면 기존 로컬 파일을 삭제하세요: - -```bash -# 충돌 방지를 위해 수동 설치된 스킬과 명령어 삭제 -rm -rf ~/.gemini/skills/* ~/.gemini/commands/* -``` - -## 🤝 기여하기 - -**기여는 언제나 환영합니다!** - -유용한 에이전트, 스킬, 설정이 있다면 Pull Request를 보내주세요. - ---- - -## 📄 라이선스 - -MIT - 자유롭게 사용하고 수정하세요. diff --git a/README.md b/README.md index 4ed869b..93acd7a 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -**Language:** **English** | [한국어](docs/ko-KR/README.md) +**Language:** **English** | [한국어](docs/ko-KR/README.md) | [简体中文](docs/zh-CN/README.md) # Everything Gemini Code diff --git a/COMMANDS.ko.md b/docs/ko-KR/COMMANDS.md similarity index 98% rename from COMMANDS.ko.md rename to docs/ko-KR/COMMANDS.md index 98ca765..b8baddf 100644 --- a/COMMANDS.ko.md +++ b/docs/ko-KR/COMMANDS.md @@ -1,3 +1,5 @@ +**언어:** [English](../../COMMANDS.md) | **한국어** | [简体中文](../zh-CN/COMMANDS.md) + # Gemini CLI Extension Commands (한국어) `everything-gemini-code`에서 제공하는 명령어 목록입니다. diff --git a/docs/ko-KR/README.md b/docs/ko-KR/README.md index 7971484..06c74d6 100644 --- a/docs/ko-KR/README.md +++ b/docs/ko-KR/README.md @@ -1,4 +1,4 @@ -**언어:** [English](../../README.md) | 한국어 +**언어:** [English](../../README.md) | **한국어** | [简体中文](../zh-CN/README.md) # Everything Gemini Code diff --git a/COMMANDS.zh-CN.md b/docs/zh-CN/COMMANDS.md similarity index 98% rename from COMMANDS.zh-CN.md rename to docs/zh-CN/COMMANDS.md index a007101..fc73640 100644 --- a/COMMANDS.zh-CN.md +++ b/docs/zh-CN/COMMANDS.md @@ -1,3 +1,5 @@ +**Language:** [English](../../COMMANDS.md) | [한국어](../ko-KR/COMMANDS.md) | **简体中文** + # Gemini CLI Extension Commands (中文) `everything-gemini-code` 提供命令列表。 diff --git a/README.zh-CN.md b/docs/zh-CN/README.md similarity index 96% rename from README.zh-CN.md rename to docs/zh-CN/README.md index bc5d9b6..f5c991e 100644 --- a/README.zh-CN.md +++ b/docs/zh-CN/README.md @@ -1,4 +1,4 @@ -**Language:** [English](README.md) | [한국어](README.ko.md) | **简体中文** +**Language:** [English](../../README.md) | [한국어](../ko-KR/README.md) | **简体中文** # Everything Gemini Code @@ -65,7 +65,7 @@ gemini extensions uninstall https://github.com/Jamkris/everything-gemini-code ### 斜杠命令 (Slash Commands) -使用自定义命令自动化工作流（请参阅 [完整命令列表](COMMANDS.zh-CN.md)）： +使用自定义命令自动化工作流（请参阅 [完整命令列表](COMMANDS.md)）： ```bash # 规划功能实现 From 4eed57d2644fca147ab3acbe3e209f16a76afba9 Mon Sep 17 00:00:00 2001 From: Jamkris Date: Wed, 8 Apr 2026 13:06:10 +0900 Subject: [PATCH 05/24] Please provide the code changes or file diffs you would like me to summarize. --- docs/{ => en}/COMMAND-AGENT-MAP.md | 0 COMMANDS.md => docs/en/COMMANDS.md | 0 docs/{ => en}/CONTRIBUTING.md | 0 scripts/README.md => docs/en/SCRIPTS.md | 0 docs/{ => en}/SKILL-PLACEMENT-POLICY.md | 0 docs/{ => en}/TERMINOLOGY.md | 0 VERIFICATION_GUIDE.md => docs/en/VERIFICATION_GUIDE.md | 0 docs/{ => en}/agents/README.md | 0 docs/{ => en}/commands/README.md | 0 docs/{ => en}/commands/core.md | 0 docs/{ => en}/commands/language-specific.md | 0 docs/{ => en}/commands/learning-evolution.md | 0 docs/{ => en}/commands/multi-agent.md | 0 docs/{ => en}/commands/utilities.md | 0 docs/{ => en}/token-optimization.md | 0 15 files changed, 0 insertions(+), 0 deletions(-) rename docs/{ => en}/COMMAND-AGENT-MAP.md (100%) rename COMMANDS.md => docs/en/COMMANDS.md (100%) rename docs/{ => en}/CONTRIBUTING.md (100%) rename scripts/README.md => docs/en/SCRIPTS.md (100%) rename docs/{ => en}/SKILL-PLACEMENT-POLICY.md (100%) rename docs/{ => en}/TERMINOLOGY.md (100%) rename VERIFICATION_GUIDE.md => docs/en/VERIFICATION_GUIDE.md (100%) rename docs/{ => en}/agents/README.md (100%) rename docs/{ => en}/commands/README.md (100%) rename docs/{ => en}/commands/core.md (100%) rename docs/{ => en}/commands/language-specific.md (100%) rename docs/{ => en}/commands/learning-evolution.md (100%) rename docs/{ => en}/commands/multi-agent.md (100%) rename docs/{ => en}/commands/utilities.md (100%) rename docs/{ => en}/token-optimization.md (100%) diff --git a/docs/COMMAND-AGENT-MAP.md b/docs/en/COMMAND-AGENT-MAP.md similarity index 100% rename from docs/COMMAND-AGENT-MAP.md rename to docs/en/COMMAND-AGENT-MAP.md diff --git a/COMMANDS.md b/docs/en/COMMANDS.md similarity index 100% rename from COMMANDS.md rename to docs/en/COMMANDS.md diff --git a/docs/CONTRIBUTING.md b/docs/en/CONTRIBUTING.md similarity index 100% rename from docs/CONTRIBUTING.md rename to docs/en/CONTRIBUTING.md diff --git a/scripts/README.md b/docs/en/SCRIPTS.md similarity index 100% rename from scripts/README.md rename to docs/en/SCRIPTS.md diff --git a/docs/SKILL-PLACEMENT-POLICY.md b/docs/en/SKILL-PLACEMENT-POLICY.md similarity index 100% rename from docs/SKILL-PLACEMENT-POLICY.md rename to docs/en/SKILL-PLACEMENT-POLICY.md diff --git a/docs/TERMINOLOGY.md b/docs/en/TERMINOLOGY.md similarity index 100% rename from docs/TERMINOLOGY.md rename to docs/en/TERMINOLOGY.md diff --git a/VERIFICATION_GUIDE.md b/docs/en/VERIFICATION_GUIDE.md similarity index 100% rename from VERIFICATION_GUIDE.md rename to docs/en/VERIFICATION_GUIDE.md diff --git a/docs/agents/README.md b/docs/en/agents/README.md similarity index 100% rename from docs/agents/README.md rename to docs/en/agents/README.md diff --git a/docs/commands/README.md b/docs/en/commands/README.md similarity index 100% rename from docs/commands/README.md rename to docs/en/commands/README.md diff --git a/docs/commands/core.md b/docs/en/commands/core.md similarity index 100% rename from docs/commands/core.md rename to docs/en/commands/core.md diff --git a/docs/commands/language-specific.md b/docs/en/commands/language-specific.md similarity index 100% rename from docs/commands/language-specific.md rename to docs/en/commands/language-specific.md diff --git a/docs/commands/learning-evolution.md b/docs/en/commands/learning-evolution.md similarity index 100% rename from docs/commands/learning-evolution.md rename to docs/en/commands/learning-evolution.md diff --git a/docs/commands/multi-agent.md b/docs/en/commands/multi-agent.md similarity index 100% rename from docs/commands/multi-agent.md rename to docs/en/commands/multi-agent.md diff --git a/docs/commands/utilities.md b/docs/en/commands/utilities.md similarity index 100% rename from docs/commands/utilities.md rename to docs/en/commands/utilities.md diff --git a/docs/token-optimization.md b/docs/en/token-optimization.md similarity index 100% rename from docs/token-optimization.md rename to docs/en/token-optimization.md From e7e1ab98a5ae4f3880f2d8a43b5a9f37bf8ea706 Mon Sep 17 00:00:00 2001 From: Jamkris Date: Wed, 8 Apr 2026 13:06:23 +0900 Subject: [PATCH 06/24] Please provide the diff or a description of the changes so I can generate the commit message for you. --- install.sh => scripts/install.sh | 0 uninstall.sh => scripts/uninstall.sh | 0 verify_all.sh => scripts/verify_all.sh | 0 3 files changed, 0 insertions(+), 0 deletions(-) rename install.sh => scripts/install.sh (100%) rename uninstall.sh => scripts/uninstall.sh (100%) rename verify_all.sh => scripts/verify_all.sh (100%) diff --git a/install.sh b/scripts/install.sh similarity index 100% rename from install.sh rename to scripts/install.sh diff --git a/uninstall.sh b/scripts/uninstall.sh similarity index 100% rename from uninstall.sh rename to scripts/uninstall.sh diff --git a/verify_all.sh b/scripts/verify_all.sh similarity index 100% rename from verify_all.sh rename to scripts/verify_all.sh From f840b6e8fed0734727af91a339adccfdbf78ff37 Mon Sep 17 00:00:00 2001 From: Jamkris Date: Wed, 8 Apr 2026 13:10:58 +0900 Subject: [PATCH 07/24] refactor: reorganize project structure by moving scripts to /scripts and updating documentation paths --- README.md | 16 +++++++++------- docs/en/COMMANDS.md | 2 +- docs/en/CONTRIBUTING.md | 2 +- docs/en/SCRIPTS.md | 2 +- docs/ko-KR/COMMANDS.md | 2 +- docs/ko-KR/CONTRIBUTING.md | 2 +- docs/ko-KR/README.md | 4 ++-- docs/ko-KR/TERMINOLOGY.md | 2 ++ docs/zh-CN/COMMANDS.md | 2 +- docs/zh-CN/README.md | 4 ++-- 10 files changed, 21 insertions(+), 17 deletions(-) diff --git a/README.md b/README.md index 93acd7a..952e0c4 100644 --- a/README.md +++ b/README.md @@ -48,10 +48,10 @@ Recommended if you use **Antigravity** (VS Code / Cursor) or need to customize t ```bash # Install for Antigravity (Recommended) -/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Jamkris/everything-gemini-code/main/install.sh)" -- --antigravity +/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Jamkris/everything-gemini-code/main/scripts/install.sh)" -- --antigravity # Install All (CLI + Antigravity) -/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Jamkris/everything-gemini-code/main/install.sh)" -- --all +/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Jamkris/everything-gemini-code/main/scripts/install.sh)" -- --all ``` ### Option 1: Uninstallation (Recommended) @@ -64,10 +64,10 @@ gemini extensions uninstall https://github.com/Jamkris/everything-gemini-code ```bash # Selective Uninstall (Recommended): Removes only files installed by this extension. -/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Jamkris/everything-gemini-code/main/uninstall.sh)" -- --antigravity +/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Jamkris/everything-gemini-code/main/scripts/uninstall.sh)" -- --antigravity # Full Uninstall (Caution): Deletes ALL files in the target directories. -/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Jamkris/everything-gemini-code/main/uninstall.sh)" -- --antigravity --purge +/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Jamkris/everything-gemini-code/main/scripts/uninstall.sh)" -- --antigravity --purge ``` ### Option 2: Manual Installation (Advanced) @@ -123,7 +123,7 @@ Once installed, you can access the new capabilities directly in Gemini CLI. ### Slash Commands -Use custom commands to automate workflows (see [Full Command List](COMMANDS.md)): +Use custom commands to automate workflows (see [Full Command List](docs/en/COMMANDS.md)): ```bash # Plan a feature implementation @@ -171,7 +171,9 @@ everything-gemini-code/ ├── workflows/ # Antigravity workflows (.md) ├── templates/ # GEMINI.md rule templates (Global, TS, Python, Go) ├── hooks/ # Automation triggers (hooks.json) -└── mcp-configs/ # MCP server configurations +├── scripts/ # Install, uninstall, CI, and utility scripts +├── mcp-configs/ # MCP server configurations +└── docs/ # Documentation (en, ko-KR, zh-CN) ``` --- @@ -187,7 +189,7 @@ rm -rf ~/.gemini/skills/* ~/.gemini/commands/* ## 🤝 Contributing -**Contributions are welcome!** +**Contributions are welcome!** See the [Contributing Guide](docs/en/CONTRIBUTING.md). If you have useful agents, skills, or configurations, please submit a Pull Request. diff --git a/docs/en/COMMANDS.md b/docs/en/COMMANDS.md index ce578ce..dad0a9f 100644 --- a/docs/en/COMMANDS.md +++ b/docs/en/COMMANDS.md @@ -1,4 +1,4 @@ -**Language:** **English** | [한국어](docs/ko-KR/COMMANDS.md) | [简体中文](docs/zh-CN/COMMANDS.md) +**Language:** **English** | [한국어](../ko-KR/COMMANDS.md) | [简体中文](../zh-CN/COMMANDS.md) # Gemini CLI Extension Commands diff --git a/docs/en/CONTRIBUTING.md b/docs/en/CONTRIBUTING.md index e86c27d..2ab6523 100644 --- a/docs/en/CONTRIBUTING.md +++ b/docs/en/CONTRIBUTING.md @@ -1,6 +1,6 @@ # Contributing Guide -**Language:** English | [한국어](ko-KR/CONTRIBUTING.md) +**Language:** **English** | [한국어](../ko-KR/CONTRIBUTING.md) Thank you for your interest in contributing to Everything Gemini Code! diff --git a/docs/en/SCRIPTS.md b/docs/en/SCRIPTS.md index 29e1391..bf70848 100644 --- a/docs/en/SCRIPTS.md +++ b/docs/en/SCRIPTS.md @@ -1,6 +1,6 @@ # Scripts Reference -**Language:** English | [한국어](ko-KR/README.md) +**Language:** **English** | [한국어](../ko-KR/SCRIPTS.md) This directory contains utility scripts for maintaining the Everything Gemini Code repository. diff --git a/docs/ko-KR/COMMANDS.md b/docs/ko-KR/COMMANDS.md index b8baddf..c02fc5d 100644 --- a/docs/ko-KR/COMMANDS.md +++ b/docs/ko-KR/COMMANDS.md @@ -1,4 +1,4 @@ -**언어:** [English](../../COMMANDS.md) | **한국어** | [简体中文](../zh-CN/COMMANDS.md) +**언어:** [English](../en/COMMANDS.md) | **한국어** | [简体中文](../zh-CN/COMMANDS.md) # Gemini CLI Extension Commands (한국어) diff --git a/docs/ko-KR/CONTRIBUTING.md b/docs/ko-KR/CONTRIBUTING.md index c3caf01..1ecffc6 100644 --- a/docs/ko-KR/CONTRIBUTING.md +++ b/docs/ko-KR/CONTRIBUTING.md @@ -1,6 +1,6 @@ # 기여 가이드 -**언어:** [English](../../CONTRIBUTING.md) | 한국어 +**언어:** [English](../en/CONTRIBUTING.md) | **한국어** Everything Gemini Code에 기여해 주셔서 감사합니다! diff --git a/docs/ko-KR/README.md b/docs/ko-KR/README.md index 06c74d6..85e3e1f 100644 --- a/docs/ko-KR/README.md +++ b/docs/ko-KR/README.md @@ -45,10 +45,10 @@ Antigravity 사용자는 스크립트를 사용하세요: ```bash # Antigravity용 설치 -/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Jamkris/everything-gemini-code/main/install.sh)" -- --antigravity +/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Jamkris/everything-gemini-code/main/scripts/install.sh)" -- --antigravity # CLI + Antigravity 모두 설치 -/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Jamkris/everything-gemini-code/main/install.sh)" -- --all +/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Jamkris/everything-gemini-code/main/scripts/install.sh)" -- --all ``` ### 4단계: 사용 시작 diff --git a/docs/ko-KR/TERMINOLOGY.md b/docs/ko-KR/TERMINOLOGY.md index 739b5b0..df8ded7 100644 --- a/docs/ko-KR/TERMINOLOGY.md +++ b/docs/ko-KR/TERMINOLOGY.md @@ -1,3 +1,5 @@ +**언어:** [English](../en/TERMINOLOGY.md) | **한국어** + # Gemini CLI & Everything Gemini Code — 용어 사전 이 문서는 프로젝트 전반에서 사용되는 핵심 용어를 정의합니다. diff --git a/docs/zh-CN/COMMANDS.md b/docs/zh-CN/COMMANDS.md index fc73640..eb6fed1 100644 --- a/docs/zh-CN/COMMANDS.md +++ b/docs/zh-CN/COMMANDS.md @@ -1,4 +1,4 @@ -**Language:** [English](../../COMMANDS.md) | [한국어](../ko-KR/COMMANDS.md) | **简体中文** +**Language:** [English](../en/COMMANDS.md) | [한국어](../ko-KR/COMMANDS.md) | **简体中文** # Gemini CLI Extension Commands (中文) diff --git a/docs/zh-CN/README.md b/docs/zh-CN/README.md index f5c991e..4877862 100644 --- a/docs/zh-CN/README.md +++ b/docs/zh-CN/README.md @@ -51,10 +51,10 @@ gemini extensions uninstall https://github.com/Jamkris/everything-gemini-code ```bash # 选择性卸载（推荐）：仅卸载此扩展安装的文件。 -/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Jamkris/everything-gemini-code/main/uninstall.sh)" -- --antigravity +/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Jamkris/everything-gemini-code/main/scripts/uninstall.sh)" -- --antigravity # 完全卸载（警告）：删除目标目录中的所有文件。 -/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Jamkris/everything-gemini-code/main/uninstall.sh)" -- --antigravity --purge +/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Jamkris/everything-gemini-code/main/scripts/uninstall.sh)" -- --antigravity --purge ``` --- From 8e5fea6f6d4182fad58b7bf52b4e3b13b630a100 Mon Sep 17 00:00:00 2001 From: Jamkris Date: Wed, 8 Apr 2026 13:13:18 +0900 Subject: [PATCH 08/24] docs: add documentation for MCP server configurations and CLI management commands --- scripts/ko-KR/README.md => docs/ko-KR/SCRIPTS.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) rename scripts/ko-KR/README.md => docs/ko-KR/SCRIPTS.md (98%) diff --git a/scripts/ko-KR/README.md b/docs/ko-KR/SCRIPTS.md similarity index 98% rename from scripts/ko-KR/README.md rename to docs/ko-KR/SCRIPTS.md index 227c3b8..4fe5445 100644 --- a/scripts/ko-KR/README.md +++ b/docs/ko-KR/SCRIPTS.md @@ -1,6 +1,6 @@ # 스크립트 레퍼런스 -**언어:** [English](../README.md) | 한국어 +**언어:** [English](../en/SCRIPTS.md) | **한국어** 이 디렉토리는 Everything Gemini Code 저장소를 유지 관리하기 위한 유틸리티 스크립트 모음입니다. From 74729525f97261ce05c6c73504db8fa8d5a106dc Mon Sep 17 00:00:00 2001 From: Jamkris Date: Wed, 8 Apr 2026 13:14:08 +0900 Subject: [PATCH 09/24] docs: migrate MCP configuration documentation to dedicated language-specific files and update references --- README.md | 2 +- docs/en/MCP-CONFIGS.md | 33 ++++++++++++++++++++ docs/ko-KR/MCP-CONFIGS.md | 33 ++++++++++++++++++++ mcp-configs/README.md | 65 ++------------------------------------- 4 files changed, 70 insertions(+), 63 deletions(-) create mode 100644 docs/en/MCP-CONFIGS.md create mode 100644 docs/ko-KR/MCP-CONFIGS.md diff --git a/README.md b/README.md index 952e0c4..223c0c8 100644 --- a/README.md +++ b/README.md @@ -154,7 +154,7 @@ Gemini will automatically utilize installed skills when relevant to your request ### MCP Servers -Configure and manage Model Context Protocol (MCP) servers to extend Gemini's capabilities. (see [MCP Configuration Guide](mcp-configs/README.md)) +Configure and manage Model Context Protocol (MCP) servers to extend Gemini's capabilities. (see [MCP Configuration Guide](docs/en/MCP-CONFIGS.md)) --- diff --git a/docs/en/MCP-CONFIGS.md b/docs/en/MCP-CONFIGS.md new file mode 100644 index 0000000..54a2a85 --- /dev/null +++ b/docs/en/MCP-CONFIGS.md @@ -0,0 +1,33 @@ +**Language:** **English** | [한국어](../ko-KR/MCP-CONFIGS.md) + +# MCP Server Configurations + +This directory contains configurations for **Model Context Protocol (MCP)** servers, which allow Gemini-CLI and Antigravity to connect with external tools and data sources. + +## Using MCP Servers + +Gemini CLI makes it easy to integrate with MCP servers. You can define servers globally in your `~/.gemini.json` or locally in your project's `.gemini/settings.json`. + +### 1. Configuration File + +We provide a comprehensive template in `mcp-configs/mcp-servers.json` that demonstrates various server setups: + +- **Stdio servers** (Python/Node) +- **Docker-based servers** +- **HTTP & SSE servers** (with Authentication headers and IAP support) +- **Tool Filtering** (`includeTools` / `excludeTools`) + +Copy the necessary server blocks from `mcp-servers.json` to your own `settings.json` file under `mcpServers`. + +### 2. Available CLI Commands + +You can manage your connected MCP servers using the Gemini CLI (`gemini mcp` or `/mcp` in interactive mode): + +- `/mcp list` : View all configured servers, their connection status, and the tools they provide. +- `/mcp add [args...]` : Register a new stdio server dynamically. +- `/mcp remove ` : Remove an MCP server configuration. +- `/mcp enable ` / `/mcp disable ` : Temporarily enable or disable a specific server. + +### 3. How It Works + +Once a server is added and enabled, Gemini automatically discovers its tools. When you converse with Gemini, it will autonomously decide when to invoke these external tools without requiring explicit manual tool calls. diff --git a/docs/ko-KR/MCP-CONFIGS.md b/docs/ko-KR/MCP-CONFIGS.md new file mode 100644 index 0000000..0fd436d --- /dev/null +++ b/docs/ko-KR/MCP-CONFIGS.md @@ -0,0 +1,33 @@ +**언어:** [English](../en/MCP-CONFIGS.md) | **한국어** + +# MCP 서버 설정 모음 + +이 디렉토리에는 Gemini-CLI 및 Antigravity가 외부 도구 및 데이터 소스와 연결될 수 있도록 해주는 **Model Context Protocol (MCP)** 서버 설정 항목들이 포함되어 있습니다. + +## MCP 서버 사용 가이드 + +Gemini CLI를 사용하면 MCP 서버를 쉽게 통합할 수 있습니다. 전역 설정(`~/.gemini.json`)이나 프로젝트 로컬 설정(`.gemini/settings.json`)에 서버를 정의할 수 있습니다. + +### 1. 설정 파일 (Template) + +`mcp-configs/mcp-servers.json` 파일에는 다음과 같은 다양한 서버 통합 예시가 종합적으로 마련되어 있습니다: + +- **Stdio 방식 서버** (Python/Node) +- **Docker 기반 보조 서버** +- **HTTP / SSE 스트리밍 서버** (사용자 지정 인증 헤더 및 IAP/SA 계정 가장 지원) +- **도구 필터링** (`includeTools` / `excludeTools`를 통한 특정 기능 제어) + +필요한 서버 블록을 복사하여 여러분의 환경 설정 파일의 `mcpServers` 항목에 붙여넣어 사용하세요. + +### 2. 사용 가능한 명령어 + +CLI나 대화 모드에서 `/mcp` 명령어를 통해 서버 상태를 관리할 수 있습니다: + +- `/mcp list` : 현재 연결된 서버 목록, 상태, 그리고 사용 가능한 도구들을 확인합니다. +- `/mcp add <이름> <명령어> [인수...]` : 새로운 stdio 서버를 즉석에서 추가합니다. +- `/mcp remove <이름>` : 서버 설정을 삭제합니다. +- `/mcp enable <이름>` / `/mcp disable <이름>` : 특정 서버를 일시적으로 활성화하거나 비활성화합니다. + +### 3. 작동 방식 + +서버가 연결되고 도구가 등록(Discovery)되면, Gemini는 대화 문맥에 맞춰 연결된 도구를 **자동으로 판단하여 실행**합니다. 사용자가 명시적으로 복잡한 도구 호출 명령을 내릴 필요가 없습니다. diff --git a/mcp-configs/README.md b/mcp-configs/README.md index 2148c70..f3bad92 100644 --- a/mcp-configs/README.md +++ b/mcp-configs/README.md @@ -1,65 +1,6 @@ # MCP Server Configurations -This directory contains configurations for **Model Context Protocol (MCP)** servers, which allow Gemini-CLI and Antigravity to connect with external tools and data sources. +See the full documentation: -## Using MCP Servers - -Gemini CLI makes it easy to integrate with MCP servers. You can define servers globally in your `~/.gemini.json` or locally in your project's `.gemini/settings.json`. - -### 1. Configuration File - -We provide a comprehensive template in `mcp-configs/mcp-servers.json` that demonstrates various server setups: - -- **Stdio servers** (Python/Node) -- **Docker-based servers** -- **HTTP & SSE servers** (with Authentication headers and IAP support) -- **Tool Filtering** (`includeTools` / `excludeTools`) - -Copy the necessary server blocks from `mcp-servers.json` to your own `settings.json` file under `mcpServers`. - -### 2. Available CLI Commands - -You can manage your connected MCP servers using the Gemini CLI (`gemini mcp` or `/mcp` in interactive mode): - -- `/mcp list` : View all configured servers, their connection status, and the tools they provide. -- `/mcp add [args...]` : Register a new stdio server dynamically. -- `/mcp remove ` : Remove an MCP server configuration. -- `/mcp enable ` / `/mcp disable ` : Temporarily enable or disable a specific server. - -### 3. How It Works - -Once a server is added and enabled, Gemini automatically discovers its tools. When you converse with Gemini, it will autonomously decide when to invoke these external tools without requiring explicit manual tool calls. - ---- - -## 🇰🇷 MCP 서버 설정 모음 (Korean) - -이 디렉토리에는 Gemini-CLI 및 Antigravity가 외부 도구 및 데이터 소스와 연결될 수 있도록 해주는 **Model Context Protocol (MCP)** 서버 설정 항목들이 포함되어 있습니다. - -### MCP 서버 사용 가이드 - -Gemini CLI를 사용하면 MCP 서버를 쉽게 통합할 수 있습니다. 전역 설정(`~/.gemini.json`)이나 프로젝트 로컬 설정(`.gemini/settings.json`)에 서버를 정의할 수 있습니다. - -### 1. 설정 파일 (Template) - -`mcp-configs/mcp-servers.json` 파일에는 다음과 같은 다양한 서버 통합 예시가 종합적으로 마련되어 있습니다: - -- **Stdio 방식 서버** (Python/Node) -- **Docker 기반 보조 서버** -- **HTTP / SSE 스트리밍 서버** (사용자 지정 인증 헤더 및 IAP/SA 계정 가장 지원) -- **도구 필터링** (`includeTools` / `excludeTools`를 통한 특정 기능 제어) - -필요한 서버 블록을 복사하여 여러분의 환경 설정 파일의 `mcpServers` 항목에 붙여넣어 사용하세요. - -### 2. 사용 가능한 명령어 - -CLI나 대화 모드에서 `/mcp` 명령어를 통해 서버 상태를 관리할 수 있습니다: - -- `/mcp list` : 현재 연결된 서버 목록, 상태, 그리고 사용 가능한 도구들을 확인합니다. -- `/mcp add <이름> <명령어> [인수...]` : 새로운 stdio 서버를 즉석에서 추가합니다. -- `/mcp remove <이름>` : 서버 설정을 삭제합니다. -- `/mcp enable <이름>` / `/mcp disable <이름>` : 특정 서버를 일시적으로 활성화하거나 비활성화합니다. - -### 3. 작동 방식 - -서버가 연결되고 도구가 등록(Discovery)되면, Gemini는 대화 문맥에 맞춰 연결된 도구를 **자동으로 판단하여 실행**합니다. 사용자가 명시적으로 복잡한 도구 호출 명령을 내릴 필요가 없습니다. +- [English](../docs/en/MCP-CONFIGS.md) +- [한국어](../docs/ko-KR/MCP-CONFIGS.md) From d021f3cb7697b46b8b54f0904a57289b06230bb7 Mon Sep 17 00:00:00 2001 From: Jamkris Date: Wed, 8 Apr 2026 13:30:47 +0900 Subject: [PATCH 10/24] feat: add /ecc-docs and /ecc-plan commands and update documentation accordingly --- README.md | 2 +- commands/ecc-docs.toml | 35 +++++++++++++ commands/ecc-plan.toml | 112 ++++++++++++++++++++++++++++++++++++++++ docs/en/COMMANDS.md | 3 +- docs/ko-KR/COMMANDS.md | 3 +- docs/zh-CN/COMMANDS.md | 3 +- workflows/ecc-plan.md | 113 +++++++++++++++++++++++++++++++++++++++++ 7 files changed, 267 insertions(+), 4 deletions(-) create mode 100644 commands/ecc-docs.toml create mode 100644 commands/ecc-plan.toml create mode 100644 workflows/ecc-plan.md diff --git a/README.md b/README.md index 223c0c8..ef22fb8 100644 --- a/README.md +++ b/README.md @@ -127,7 +127,7 @@ Use custom commands to automate workflows (see [Full Command List](docs/en/COMMA ```bash # Plan a feature implementation -/plan "Add user authentication with JWT" +/ecc-plan "Add user authentication with JWT" # Start Test-Driven Development workflow /tdd "Create a user service" diff --git a/commands/ecc-docs.toml b/commands/ecc-docs.toml new file mode 100644 index 0000000..1f65ace --- /dev/null +++ b/commands/ecc-docs.toml @@ -0,0 +1,35 @@ +description = '/docs' +prompt = ''' +--- +description: Look up current documentation for a library or topic via Context7. +--- + +# /docs + +## Purpose + +Look up up-to-date documentation for a library, framework, or API and return a summarized answer with relevant code snippets. Uses the Context7 MCP (resolve-library-id and query-docs) so answers reflect current docs, not training data. + +## Usage + +``` +/docs [library name] [question] +``` + +Use quotes for multi-word arguments so they are parsed as a single token. Example: `/docs "Next.js" "How do I configure middleware?"` + +If library or question is omitted, prompt the user for: +1. The library or product name (e.g. Next.js, Prisma, Supabase). +2. The specific question or task (e.g. "How do I set up middleware?", "Auth methods"). + +## Workflow + +1. **Resolve library ID** — Call the Context7 tool `resolve-library-id` with the library name and the user's question to get a Context7-compatible library ID (e.g. `/vercel/next.js`). +2. **Query docs** — Call `query-docs` with that library ID and the user's question. +3. **Summarize** — Return a concise answer and include relevant code examples from the fetched documentation. Mention the library (and version if relevant). + +## Output + +The user receives a short, accurate answer backed by current docs, plus any code snippets that help. If Context7 is not available, say so and answer from training data with a note that docs may be outdated. + +''' diff --git a/commands/ecc-plan.toml b/commands/ecc-plan.toml new file mode 100644 index 0000000..89b9206 --- /dev/null +++ b/commands/ecc-plan.toml @@ -0,0 +1,112 @@ +description = "Restate requirements, assess risks, and create step-by-step implementation plan. WAIT for user CONFIRM before touching any code." +prompt = ''' +# Plan Command + +This command invokes the **planner** agent to create a comprehensive implementation plan before writing any code. + +## What This Command Does + +1. **Restate Requirements** - Clarify what needs to be built +2. **Identify Risks** - Surface potential issues and blockers +3. **Create Step Plan** - Break down implementation into phases +4. **Wait for Confirmation** - MUST receive user approval before proceeding + +## When to Use + +Use `/plan` when: +- Starting a new feature +- Making significant architectural changes +- Working on complex refactoring +- Multiple files/components will be affected +- Requirements are unclear or ambiguous + +## How It Works + +The planner agent will: + +1. **Analyze the request** and restate requirements in clear terms +2. **Break down into phases** with specific, actionable steps +3. **Identify dependencies** between components +4. **Assess risks** and potential blockers +5. **Estimate complexity** (High/Medium/Low) +6. **Present the plan** and WAIT for your explicit confirmation + +## Example Usage + +``` +User: /plan I need to add real-time notifications when markets resolve + +Agent (planner): +# Implementation Plan: Real-Time Market Resolution Notifications + +## Requirements Restatement +- Send notifications to users when markets they're watching resolve +- Support multiple notification channels (in-app, email, webhook) +- Ensure notifications are delivered reliably +- Include market outcome and user's position result + +## Implementation Phases + +### Phase 1: Database Schema +- Add notifications table with columns: id, user_id, market_id, type, status, created_at +- Add user_notification_preferences table for channel preferences +- Create indexes on user_id and market_id for performance + +### Phase 2: Notification Service +- Create notification service in lib/notifications.ts +- Implement notification queue using BullMQ/Redis +- Add retry logic for failed deliveries +- Create notification templates + +### Phase 3: Integration Points +- Hook into market resolution logic (when status changes to "resolved") +- Query all users with positions in market +- Enqueue notifications for each user + +### Phase 4: Frontend Components +- Create NotificationBell component in header +- Add NotificationList modal +- Implement real-time updates via Supabase subscriptions +- Add notification preferences page + +## Dependencies +- Redis (for queue) +- Email service (SendGrid/Resend) +- Supabase real-time subscriptions + +## Risks +- HIGH: Email deliverability (SPF/DKIM required) +- MEDIUM: Performance with 1000+ users per market +- MEDIUM: Notification spam if markets resolve frequently +- LOW: Real-time subscription overhead + +## Estimated Complexity: MEDIUM +- Backend: 4-6 hours +- Frontend: 3-4 hours +- Testing: 2-3 hours +- Total: 9-13 hours + +**WAITING FOR CONFIRMATION**: Proceed with this plan? (yes/no/modify) +``` + +## Important Notes + +**CRITICAL**: The planner agent will **NOT** write any code until you explicitly confirm the plan with "yes" or "proceed" or similar affirmative response. + +If you want changes, respond with: +- "modify: [your changes]" +- "different approach: [alternative]" +- "skip phase 2 and do phase 3 first" + +## Integration with Other Commands + +After planning: +- Use `/tdd` to implement with test-driven development +- Use `/build-and-fix` if build errors occur +- Use `/code-review` to review completed implementation + +## Related Agents + +This command invokes the `planner` agent located at: +`~/.gemini/agents/planner.md` +''' diff --git a/docs/en/COMMANDS.md b/docs/en/COMMANDS.md index dad0a9f..47ebd23 100644 --- a/docs/en/COMMANDS.md +++ b/docs/en/COMMANDS.md @@ -25,7 +25,8 @@ List of available commands provided by `everything-gemini-code`. | `/multi-plan` | Create a comprehensive implementation plan using the `planner` agent, breaking down tasks for multiple agents. | | `/multi-workflow` | specific workflow steps using multiple agents. | | `/orchestrate` | High-level orchestration command to manage complex, multi-step tasks across the codebase. | -| `/plan` | Restate requirements, assess risks, and create step-by-step implementation plan. Waits for user confirmation before proceeding. | +| `/ecc-plan` | Restate requirements, assess risks, and create step-by-step implementation plan. Waits for user confirmation before proceeding. (alias: `/everything-gemini-code:plan`) | +| `/ecc-docs` | Look up current documentation for a library or topic via Context7. (alias: `/everything-gemini-code:docs`) | | `/pm2` | Auto-analyze project and generate PM2 service configuration (`ecosystem.config.cjs`) and management commands. | | `/python-review` | Comprehensive Python code review for PEP 8 compliance, type hints, security, and Pythonic idioms. Invokes the `python-reviewer` agent. | | `/refactor-clean` | Identify and remove dead code, unused imports, and legacy artifacts. | diff --git a/docs/ko-KR/COMMANDS.md b/docs/ko-KR/COMMANDS.md index c02fc5d..17b5cd6 100644 --- a/docs/ko-KR/COMMANDS.md +++ b/docs/ko-KR/COMMANDS.md @@ -25,7 +25,8 @@ | `/multi-plan` | `planner` 에이전트를 사용하여 포괄적인 구현 계획을 수립하고 여러 에이전트에 작업을 분배합니다. | | `/multi-workflow` | 여러 에이전트를 사용하는 특정 워크플로우 단계입니다. | | `/orchestrate` | 코드베이스 전반에 걸친 복잡한 다단계 작업을 관리하기 위한 상위 수준의 오케스트레이션 명령입니다. | -| `/plan` | 요구 사항을 재검토하고 위험을 평가하며 단계별 구현 계획을 수립합니다. 진행하기 전에 사용자의 확인을 기다립니다. | +| `/ecc-plan` | 요구 사항을 재검토하고 위험을 평가하며 단계별 구현 계획을 수립합니다. 진행하기 전에 사용자의 확인을 기다립니다. (별칭: `/everything-gemini-code:plan`) | +| `/ecc-docs` | Context7을 통해 라이브러리 또는 주제의 최신 문서를 조회합니다. (별칭: `/everything-gemini-code:docs`) | | `/pm2` | 프로젝트를 자동 분석하고 PM2 서비스 구성(`ecosystem.config.cjs`) 및 관리 명령을 생성합니다. | | `/python-review` | PEP 8 준수, 타입 힌트, 보안 및 Pythonic 관용구에 대한 포괄적인 Python 코드 리뷰를 수행합니다. `python-reviewer` 에이전트를 호출합니다. | | `/refactor-clean` | 죽은 코드, 사용되지 않는 import, 레거시 아티팩트를 식별하고 제거합니다. | diff --git a/docs/zh-CN/COMMANDS.md b/docs/zh-CN/COMMANDS.md index eb6fed1..24aaaa0 100644 --- a/docs/zh-CN/COMMANDS.md +++ b/docs/zh-CN/COMMANDS.md @@ -25,7 +25,8 @@ | `/multi-plan` | 使用 `planner` 代理制定全面的实施计划，为多个代理分解任务。 | | `/multi-workflow` | 使用多个代理的特定工作流步骤。 | | `/orchestrate` | 用于管理代码库中复杂的、多步骤任务的高级编排命令。 | -| `/plan` | 重述需求，评估风险，并制定分步实施计划。在继续之前等待用户确认。 | +| `/ecc-plan` | 重述需求，评估风险，并制定分步实施计划。在继续之前等待用户确认。(别名: `/everything-gemini-code:plan`) | +| `/ecc-docs` | 通过 Context7 查找库或主题的最新文档。(别名: `/everything-gemini-code:docs`) | | `/pm2` | 自动分析项目并生成 PM2 服务配置 (`ecosystem.config.cjs`) 和管理命令。 | | `/python-review` | 针对 PEP 8 合规性、类型提示、安全性和 Pythonic 习语进行全面的 Python 代码审查。调用 `python-reviewer` 代理。 | | `/refactor-clean` | 识别并删除死代码、未使用的导入和遗留工件。 | diff --git a/workflows/ecc-plan.md b/workflows/ecc-plan.md new file mode 100644 index 0000000..792d3e6 --- /dev/null +++ b/workflows/ecc-plan.md @@ -0,0 +1,113 @@ +--- +description: Restate requirements, assess risks, and create step-by-step implementation plan. WAIT for user CONFIRM before touching any code. +--- + +# Plan Command + +This command invokes the **planner** agent to create a comprehensive implementation plan before writing any code. + +## What This Command Does + +1. **Restate Requirements** - Clarify what needs to be built +2. **Identify Risks** - Surface potential issues and blockers +3. **Create Step Plan** - Break down implementation into phases +4. **Wait for Confirmation** - MUST receive user approval before proceeding + +## When to Use + +Use `/plan` when: +- Starting a new feature +- Making significant architectural changes +- Working on complex refactoring +- Multiple files/components will be affected +- Requirements are unclear or ambiguous + +## How It Works + +The planner agent will: + +1. **Analyze the request** and restate requirements in clear terms +2. **Break down into phases** with specific, actionable steps +3. **Identify dependencies** between components +4. **Assess risks** and potential blockers +5. **Estimate complexity** (High/Medium/Low) +6. **Present the plan** and WAIT for your explicit confirmation + +## Example Usage + +``` +User: /plan I need to add real-time notifications when markets resolve + +Agent (planner): +# Implementation Plan: Real-Time Market Resolution Notifications + +## Requirements Restatement +- Send notifications to users when markets they're watching resolve +- Support multiple notification channels (in-app, email, webhook) +- Ensure notifications are delivered reliably +- Include market outcome and user's position result + +## Implementation Phases + +### Phase 1: Database Schema +- Add notifications table with columns: id, user_id, market_id, type, status, created_at +- Add user_notification_preferences table for channel preferences +- Create indexes on user_id and market_id for performance + +### Phase 2: Notification Service +- Create notification service in lib/notifications.ts +- Implement notification queue using BullMQ/Redis +- Add retry logic for failed deliveries +- Create notification templates + +### Phase 3: Integration Points +- Hook into market resolution logic (when status changes to "resolved") +- Query all users with positions in market +- Enqueue notifications for each user + +### Phase 4: Frontend Components +- Create NotificationBell component in header +- Add NotificationList modal +- Implement real-time updates via Supabase subscriptions +- Add notification preferences page + +## Dependencies +- Redis (for queue) +- Email service (SendGrid/Resend) +- Supabase real-time subscriptions + +## Risks +- HIGH: Email deliverability (SPF/DKIM required) +- MEDIUM: Performance with 1000+ users per market +- MEDIUM: Notification spam if markets resolve frequently +- LOW: Real-time subscription overhead + +## Estimated Complexity: MEDIUM +- Backend: 4-6 hours +- Frontend: 3-4 hours +- Testing: 2-3 hours +- Total: 9-13 hours + +**WAITING FOR CONFIRMATION**: Proceed with this plan? (yes/no/modify) +``` + +## Important Notes + +**CRITICAL**: The planner agent will **NOT** write any code until you explicitly confirm the plan with "yes" or "proceed" or similar affirmative response. + +If you want changes, respond with: +- "modify: [your changes]" +- "different approach: [alternative]" +- "skip phase 2 and do phase 3 first" + +## Integration with Other Commands + +After planning: +- Use `/tdd` to implement with test-driven development +- Use `/build-and-fix` if build errors occur +- Use `/code-review` to review completed implementation + +## Related Agents + +This command invokes the `planner` agent located at: +`~/.gemini/agents/planner.md` From 9a1261a891681afdee9fcfb8f569a79bab399174 Mon Sep 17 00:00:00 2001 From: Jamkris Date: Wed, 8 Apr 2026 13:37:08 +0900 Subject: [PATCH 11/24] refactor: consolidate command documentation into a centralized directory structure and update README links --- docs/en/COMMANDS.md | 40 ------------------ docs/en/commands/core.md | 49 ---------------------- docs/en/commands/language-specific.md | 33 --------------- docs/en/commands/learning-evolution.md | 49 ---------------------- docs/en/commands/multi-agent.md | 57 -------------------------- docs/en/commands/utilities.md | 57 -------------------------- docs/ko-KR/COMMANDS.md | 40 ------------------ docs/zh-CN/COMMANDS.md | 40 ------------------ 8 files changed, 365 deletions(-) delete mode 100644 docs/en/COMMANDS.md delete mode 100644 docs/en/commands/core.md delete mode 100644 docs/en/commands/language-specific.md delete mode 100644 docs/en/commands/learning-evolution.md delete mode 100644 docs/en/commands/multi-agent.md delete mode 100644 docs/en/commands/utilities.md delete mode 100644 docs/ko-KR/COMMANDS.md delete mode 100644 docs/zh-CN/COMMANDS.md diff --git a/docs/en/COMMANDS.md b/docs/en/COMMANDS.md deleted file mode 100644 index 47ebd23..0000000 --- a/docs/en/COMMANDS.md +++ /dev/null @@ -1,40 +0,0 @@ -**Language:** **English** | [한국어](../ko-KR/COMMANDS.md) | [简体中文](../zh-CN/COMMANDS.md) - -# Gemini CLI Extension Commands - -List of available commands provided by `everything-gemini-code`. - -| Command | Description | -| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------ | -| `/build-fix` | Analyze build errors and attempt to fix them automatically using the `build-error-resolver` agent. | -| `/checkpoint` | Stage all changes and commit them with an AI-generated message. | -| `/code-review` | comprehensive code review of the current changes or specific files using the `code-reviewer` agent. | -| `/e2e` | Generate and run end-to-end tests with Playwright. Creates test journeys, runs tests, captures screenshots/videos/traces, and uploads artifacts. | -| `/eval` | Execute a code snippet or evaluate an expression within the current context. | -| `/evolve` | Cluster related instincts into skills, commands, or agents. | -| `/go-build` | Fix Go build errors, go vet warnings, and linter issues incrementally. Invokes the `go-build-resolver` agent. | -| `/go-review` | Comprehensive Go code review for idiomatic patterns, concurrency safety, error handling, and security. Invokes the `go-reviewer` agent. | -| `/go-test` | Enforce TDD workflow for Go. Write table-driven tests first, then implement. Verify 80%+ coverage. | -| `/instinct-export` | Export learned instincts to a file for sharing with teammates or other projects. | -| `/instinct-import` | Import instincts from a file or another source. | -| `/instinct-status` | Show all currently learned instincts with their usage counts and confidence levels. | -| `/learn` | Explicitly teach the agent about a new pattern or preference ("instinct"). | -| `/multi-backend` | Initiate a multi-agent workflow focused on backend development. | -| `/multi-execute` | Execute a multi-phase plan using multiple specialized agents in parallel or sequence. | -| `/multi-frontend` | Initiate a multi-agent workflow focused on frontend development. | -| `/multi-plan` | Create a comprehensive implementation plan using the `planner` agent, breaking down tasks for multiple agents. | -| `/multi-workflow` | specific workflow steps using multiple agents. | -| `/orchestrate` | High-level orchestration command to manage complex, multi-step tasks across the codebase. | -| `/ecc-plan` | Restate requirements, assess risks, and create step-by-step implementation plan. Waits for user confirmation before proceeding. (alias: `/everything-gemini-code:plan`) | -| `/ecc-docs` | Look up current documentation for a library or topic via Context7. (alias: `/everything-gemini-code:docs`) | -| `/pm2` | Auto-analyze project and generate PM2 service configuration (`ecosystem.config.cjs`) and management commands. | -| `/python-review` | Comprehensive Python code review for PEP 8 compliance, type hints, security, and Pythonic idioms. Invokes the `python-reviewer` agent. | -| `/refactor-clean` | Identify and remove dead code, unused imports, and legacy artifacts. | -| `/sessions` | Manage and list active Gemini sessions. | -| `/setup-pm` | Configure your preferred package manager (npm/pnpm/yarn/bun) for the project. | -| `/skill-create` | Analyze local git history to extract coding patterns and generate `SKILL.md` files. | -| `/tdd` | Enforce test-driven development workflow. Scaffold interfaces, generate tests FIRST, then implement minimal code to pass. | -| `/test-coverage` | Analyze current test coverage and suggest tests to improve it. | -| `/update-codemaps` | Refresh the codebase maps (AST/dependency graphs) to ensure the agent has the latest context. | -| `/update-docs` | specific documentation files based on recent code changes. | -| `/verify` | Run a full verification suite (lint, build, test) to ensure project health. | diff --git a/docs/en/commands/core.md b/docs/en/commands/core.md deleted file mode 100644 index cee2231..0000000 --- a/docs/en/commands/core.md +++ /dev/null @@ -1,49 +0,0 @@ -# Core Commands - -## /plan - -Restate requirements, assess risks, and create step-by-step implementation plan. WAIT for user CONFIRM before touching any code. - -[Source Definition](../../commands/plan.md) - ---- - -## /tdd - -Enforce test-driven development workflow. Scaffold interfaces, generate tests FIRST, then implement minimal code to pass. Ensure 80%+ coverage. - -[Source Definition](../../commands/tdd.md) - ---- - -## /code-review - -Comprehensive security and quality review of uncommitted changes: - -[Source Definition](../../commands/code-review.md) - ---- - -## /build-fix - -Incrementally fix TypeScript and build errors: - -[Source Definition](../../commands/build-fix.md) - ---- - -## /refactor-clean - -Safely identify and remove dead code with test verification: - -[Source Definition](../../commands/refactor-clean.md) - ---- - -## /e2e - -Generate and run end-to-end tests with Playwright. Creates test journeys, runs tests, captures screenshots/videos/traces, and uploads artifacts. - -[Source Definition](../../commands/e2e.md) - ---- diff --git a/docs/en/commands/language-specific.md b/docs/en/commands/language-specific.md deleted file mode 100644 index 537f327..0000000 --- a/docs/en/commands/language-specific.md +++ /dev/null @@ -1,33 +0,0 @@ -# Language-Specific Commands - -## /go-build - -Fix Go build errors, go vet warnings, and linter issues incrementally. Invokes the go-build-resolver agent for minimal, surgical fixes. - -[Source Definition](../../commands/go-build.md) - ---- - -## /go-review - -Comprehensive Go code review for idiomatic patterns, concurrency safety, error handling, and security. Invokes the go-reviewer agent. - -[Source Definition](../../commands/go-review.md) - ---- - -## /go-test - -Enforce TDD workflow for Go. Write table-driven tests first, then implement. Verify 80%+ coverage with go test -cover. - -[Source Definition](../../commands/go-test.md) - ---- - -## /python-review - -Comprehensive Python code review for PEP 8 compliance, type hints, security, and Pythonic idioms. Invokes the python-reviewer agent. - -[Source Definition](../../commands/python-review.md) - ---- diff --git a/docs/en/commands/learning-evolution.md b/docs/en/commands/learning-evolution.md deleted file mode 100644 index 356926d..0000000 --- a/docs/en/commands/learning-evolution.md +++ /dev/null @@ -1,49 +0,0 @@ -# Learning & Evolution Commands - -## /learn - -Analyze the current session and extract any patterns worth saving as skills. - -[Source Definition](../../commands/learn.md) - ---- - -## /skill-create - -Analyze local git history to extract coding patterns and generate SKILL.md files. Local version of the Skill Creator GitHub App. - -[Source Definition](../../commands/skill-create.md) - ---- - -## /evolve - -Cluster related instincts into skills, commands, or agents - -[Source Definition](../../commands/evolve.md) - ---- - -## /instinct-import - -Import instincts from teammates, Skill Creator, or other sources - -[Source Definition](../../commands/instinct-import.md) - ---- - -## /instinct-export - -Export instincts for sharing with teammates or other projects - -[Source Definition](../../commands/instinct-export.md) - ---- - -## /instinct-status - -Show all learned instincts with their confidence levels - -[Source Definition](../../commands/instinct-status.md) - ---- diff --git a/docs/en/commands/multi-agent.md b/docs/en/commands/multi-agent.md deleted file mode 100644 index 3223ff5..0000000 --- a/docs/en/commands/multi-agent.md +++ /dev/null @@ -1,57 +0,0 @@ -# Multi-Agent Commands - -## /multi-plan - -Multi-model collaborative planning - Context retrieval + Dual-model analysis → Generate step-by-step implementation plan. - -[Source Definition](../../commands/multi-plan.md) - ---- - -## /multi-execute - -Multi-model collaborative execution - Get prototype from plan → Gemini refactors and implements → Multi-model audit and delivery. - -[Source Definition](../../commands/multi-execute.md) - ---- - -## /multi-backend - -Backend-focused workflow (Research → Ideation → Plan → Execute → Optimize → Review), Codex-led. - -[Source Definition](../../commands/multi-backend.md) - ---- - -## /multi-frontend - -Frontend-focused workflow (Research → Ideation → Plan → Execute → Optimize → Review), Gemini-led. - -[Source Definition](../../commands/multi-frontend.md) - ---- - -## /multi-workflow - -Multi-model collaborative development workflow (Research → Ideation → Plan → Execute → Optimize → Review), with intelligent routing: Frontend → Gemini, Backend → Codex. - -[Source Definition](../../commands/multi-workflow.md) - ---- - -## /orchestrate - -Sequential agent workflow for complex tasks. - -[Source Definition](../../commands/orchestrate.md) - ---- - -## /pm2 - -Auto-analyze project and generate PM2 service commands. - -[Source Definition](../../commands/pm2.md) - ---- diff --git a/docs/en/commands/utilities.md b/docs/en/commands/utilities.md deleted file mode 100644 index e3154b0..0000000 --- a/docs/en/commands/utilities.md +++ /dev/null @@ -1,57 +0,0 @@ -# Utilities Commands - -## /setup-pm - -Configure your preferred package manager (npm/pnpm/yarn/bun) - -[Source Definition](../../commands/setup-pm.md) - ---- - -## /update-docs - -Sync documentation from source-of-truth: - -[Source Definition](../../commands/update-docs.md) - ---- - -## /update-codemaps - -Analyze the codebase structure and update architecture documentation: - -[Source Definition](../../commands/update-codemaps.md) - ---- - -## /verify - -Run comprehensive verification on current codebase state. - -[Source Definition](../../commands/verify.md) - ---- - -## /checkpoint - -Create or verify a checkpoint in your workflow. - -[Source Definition](../../commands/checkpoint.md) - ---- - -## /eval - -Manage eval-driven development workflow. - -[Source Definition](../../commands/eval.md) - ---- - -## /sessions - -Manage Gemini CLI session history - list, load, alias, and edit sessions stored in `~/.gemini/sessions/`. - -[Source Definition](../../commands/sessions.md) - ---- diff --git a/docs/ko-KR/COMMANDS.md b/docs/ko-KR/COMMANDS.md deleted file mode 100644 index 17b5cd6..0000000 --- a/docs/ko-KR/COMMANDS.md +++ /dev/null @@ -1,40 +0,0 @@ -**언어:** [English](../en/COMMANDS.md) | **한국어** | [简体中文](../zh-CN/COMMANDS.md) - -# Gemini CLI Extension Commands (한국어) - -`everything-gemini-code`에서 제공하는 명령어 목록입니다. - -| 명령어 | 설명 | -| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------- | -| `/build-fix` | `build-error-resolver` 에이전트를 사용하여 빌드 오류를 분석하고 자동으로 수정합니다. | -| `/checkpoint` | 모든 변경 사항을 스테이징하고 AI가 생성한 메시지로 커밋합니다. | -| `/code-review` | `code-reviewer` 에이전트를 통해 현재 변경 사항이나 특정 파일에 대한 포괄적인 코드 리뷰를 수행합니다. | -| `/e2e` | Playwright로 E2E 테스트를 생성하고 실행합니다. 테스트 여정 생성, 실행, 스크린샷/비디오/추적 캡처 및 아티팩트 업로드를 수행합니다. | -| `/eval` | 현재 컨텍스트 내에서 코드 조각을 실행하거나 표현식을 평가합니다. | -| `/evolve` | 관련된 본능(instincts)을 스킬, 커맨드, 또는 에이전트로 클러스터링합니다. | -| `/go-build` | Go 빌드 오류, vet 경고, 린터 문제를 점진적으로 수정합니다. `go-build-resolver` 에이전트를 호출합니다. | -| `/go-review` | 관용적 패턴, 동시성 안전, 오류 처리 및 보안에 대한 포괄적인 Go 코드 리뷰를 수행합니다. `go-reviewer` 에이전트를 호출합니다. | -| `/go-test` | Go를 위한 TDD 워크플로우를 강제합니다. 테이블 기반 테스트를 먼저 작성한 다음 구현합니다. 80% 이상의 커버리지를 검증합니다. | -| `/instinct-export` | 학습된 본능을 파일로 내보내 팀원이나 다른 프로젝트와 공유합니다. | -| `/instinct-import` | 파일이나 다른 소스에서 본능을 가져옵니다. | -| `/instinct-status` | 현재 학습된 모든 본능과 사용 횟수 및 신뢰도 수준을 표시합니다. | -| `/learn` | 에이전트에게 새로운 패턴이나 선호도("본능")를 명시적으로 가르칩니다. | -| `/multi-backend` | 백엔드 개발에 초점을 맞춘 멀티 에이전트 워크플로우를 시작합니다. | -| `/multi-execute` | 여러 전문 에이전트를 병렬 또는 순차적으로 사용하여 다단계 계획을 실행합니다. | -| `/multi-frontend` | 프론트엔드 개발에 초점을 맞춘 멀티 에이전트 워크플로우를 시작합니다. | -| `/multi-plan` | `planner` 에이전트를 사용하여 포괄적인 구현 계획을 수립하고 여러 에이전트에 작업을 분배합니다. | -| `/multi-workflow` | 여러 에이전트를 사용하는 특정 워크플로우 단계입니다. | -| `/orchestrate` | 코드베이스 전반에 걸친 복잡한 다단계 작업을 관리하기 위한 상위 수준의 오케스트레이션 명령입니다. | -| `/ecc-plan` | 요구 사항을 재검토하고 위험을 평가하며 단계별 구현 계획을 수립합니다. 진행하기 전에 사용자의 확인을 기다립니다. (별칭: `/everything-gemini-code:plan`) | -| `/ecc-docs` | Context7을 통해 라이브러리 또는 주제의 최신 문서를 조회합니다. (별칭: `/everything-gemini-code:docs`) | -| `/pm2` | 프로젝트를 자동 분석하고 PM2 서비스 구성(`ecosystem.config.cjs`) 및 관리 명령을 생성합니다. | -| `/python-review` | PEP 8 준수, 타입 힌트, 보안 및 Pythonic 관용구에 대한 포괄적인 Python 코드 리뷰를 수행합니다. `python-reviewer` 에이전트를 호출합니다. | -| `/refactor-clean` | 죽은 코드, 사용되지 않는 import, 레거시 아티팩트를 식별하고 제거합니다. | -| `/sessions` | 활성 Gemini 세션을 관리하고 나열합니다. | -| `/setup-pm` | 프로젝트에 선호하는 패키지 관리자(npm/pnpm/yarn/bun)를 구성합니다. | -| `/skill-create` | 로컬 git 기록을 분석하여 코딩 패턴을 추출하고 `SKILL.md` 파일을 생성합니다. | -| `/tdd` | 테스트 주도 개발 워크플로우를 강제합니다. 인터페이스를 스캐폴딩하고 테스트를 먼저 생성한 다음 통과를 위한 최소한의 코드를 구현합니다. | -| `/test-coverage` | 현재 테스트 커버리지를 분석하고 개선을 위한 테스트를 제안합니다. | -| `/update-codemaps` | 코드베이스 맵(AST/의존성 그래프)을 새로 고쳐 에이전트가 최신 컨텍스트를 갖도록 합니다. | -| `/update-docs` | 최근 코드 변경 사항을 기반으로 특정 문서 파일을 업데이트합니다. | -| `/verify` | 프로젝트 상태를 확인하기 위해 전체 검증 제품군(린트, 빌드, 테스트)을 실행합니다. | diff --git a/docs/zh-CN/COMMANDS.md b/docs/zh-CN/COMMANDS.md deleted file mode 100644 index 24aaaa0..0000000 --- a/docs/zh-CN/COMMANDS.md +++ /dev/null @@ -1,40 +0,0 @@ -**Language:** [English](../en/COMMANDS.md) | [한국어](../ko-KR/COMMANDS.md) | **简体中文** - -# Gemini CLI Extension Commands (中文) - -`everything-gemini-code` 提供命令列表。 - -| 命令 | 描述 | -| ------------------ | ------------------------------------------------------------------------------------------------------------ | -| `/build-fix` | 分析构建错误并尝试使用 `build-error-resolver` 代理自动修复。 | -| `/checkpoint` | 暂存所有更改并使用 AI 生成的消息提交。 | -| `/code-review` | 使用 `code-reviewer` 代理对当前更改或特定文件进行全面的代码审查。 | -| `/e2e` | 使用 Playwright 生成并运行端到端测试。创建测试旅程，运行测试，捕获屏幕截图/视频/跟踪，并上传工件。 | -| `/eval` | 在当前上下文中执行代码片段或评估表达式。 | -| `/evolve` | 将相关的本能聚类为技能、命令或代理。 | -| `/go-build` | 逐步修复 Go 构建错误、vet 警告和 linter 问题。调用 `go-build-resolver` 代理。 | -| `/go-review` | 针对惯用模式、并发安全性、错误处理和安全性进行全面的 Go 代码审查。调用 `go-reviewer` 代理。 | -| `/go-test` | 强制执行 Go 的 TDD 工作流。首先编写表驱动测试，然后实现。验证 80%+ 的覆盖率。 | -| `/instinct-export` | 将学习到的本能导出到文件，以便与队友或其他项目共享。 | -| `/instinct-import` | 从文件或其他来源导入本能。 | -| `/instinct-status` | 显示所有当前学习到的本能及其使用次数和置信度水平。 | -| `/learn` | 明确地教授代理新的模式或偏好（“本能”）。 | -| `/multi-backend` | 启动专注于后端开发的多代理工作流。 | -| `/multi-execute` | 并行或按顺序使用多个专用代理执行多阶段计划。 | -| `/multi-frontend` | 启动专注于前端开发的多代理工作流。 | -| `/multi-plan` | 使用 `planner` 代理制定全面的实施计划，为多个代理分解任务。 | -| `/multi-workflow` | 使用多个代理的特定工作流步骤。 | -| `/orchestrate` | 用于管理代码库中复杂的、多步骤任务的高级编排命令。 | -| `/ecc-plan` | 重述需求，评估风险，并制定分步实施计划。在继续之前等待用户确认。(别名: `/everything-gemini-code:plan`) | -| `/ecc-docs` | 通过 Context7 查找库或主题的最新文档。(别名: `/everything-gemini-code:docs`) | -| `/pm2` | 自动分析项目并生成 PM2 服务配置 (`ecosystem.config.cjs`) 和管理命令。 | -| `/python-review` | 针对 PEP 8 合规性、类型提示、安全性和 Pythonic 习语进行全面的 Python 代码审查。调用 `python-reviewer` 代理。 | -| `/refactor-clean` | 识别并删除死代码、未使用的导入和遗留工件。 | -| `/sessions` | 管理和列出活动的 Gemini 会话。 | -| `/setup-pm` | 为项目配置首选的包管理器 (npm/pnpm/yarn/bun)。 | -| `/skill-create` | 分析本地 git 历史记录以提取编码模式并生成 `SKILL.md` 文件。 | -| `/tdd` | 强制执行测试驱动开发工作流。搭建接口，首先生成测试，然后实现最少的代码以通过测试。 | -| `/test-coverage` | 分析当前的测试覆盖率并建议改进测试。 | -| `/update-codemaps` | 刷新代码库映射（AST/依赖图），以确保代理具有最新的上下文。 | -| `/update-docs` | 根据最近的代码更改更新特定文档文件。 | -| `/verify` | 运行完整的验证套件（lint、构建、测试）以确保项目健康。 | From d4bd6213d7396c4c5dd1a5d9ac5693691147d667 Mon Sep 17 00:00:00 2001 From: Jamkris Date: Wed, 8 Apr 2026 13:37:16 +0900 Subject: [PATCH 12/24] docs: standardize command documentation and add Chinese localization support --- README.md | 2 +- docs/en/commands/README.md | 201 +++++++++++++++++++++++- docs/ko-KR/agents/planner.md | 115 -------------- docs/ko-KR/commands/README.md | 285 +++++++++++++++++++++------------- docs/zh-CN/commands/README.md | 40 +++++ 5 files changed, 409 insertions(+), 234 deletions(-) delete mode 100644 docs/ko-KR/agents/planner.md create mode 100644 docs/zh-CN/commands/README.md diff --git a/README.md b/README.md index ef22fb8..ea8a880 100644 --- a/README.md +++ b/README.md @@ -123,7 +123,7 @@ Once installed, you can access the new capabilities directly in Gemini CLI. ### Slash Commands -Use custom commands to automate workflows (see [Full Command List](docs/en/COMMANDS.md)): +Use custom commands to automate workflows (see [Full Command List](docs/en/commands/README.md)): ```bash # Plan a feature implementation diff --git a/docs/en/commands/README.md b/docs/en/commands/README.md index 2e7076c..d7597df 100644 --- a/docs/en/commands/README.md +++ b/docs/en/commands/README.md @@ -1,9 +1,196 @@ -# Command Reference +**Language:** **English** | [한국어](../../ko-KR/commands/README.md) | [简体中文](../../zh-CN/COMMANDS.md) -Overview of all available Gemini CLI commands. +# Gemini CLI Extension Commands -- [Core](core.md) -- [Multi-Agent](multi-agent.md) -- [Language-Specific](language-specific.md) -- [Learning & Evolution](learning-evolution.md) -- [Utilities](utilities.md) +List of available commands provided by `everything-gemini-code`. + +| Command | Description | +| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------ | +| `/build-fix` | Analyze build errors and attempt to fix them automatically using the `build-error-resolver` agent. | +| `/checkpoint` | Stage all changes and commit them with an AI-generated message. | +| `/code-review` | Comprehensive code review of the current changes or specific files using the `code-reviewer` agent. | +| `/e2e` | Generate and run end-to-end tests with Playwright. | +| `/ecc-plan` | Restate requirements, assess risks, and create step-by-step implementation plan. (alias: `/everything-gemini-code:plan`) | +| `/ecc-docs` | Look up current documentation for a library or topic via Context7. (alias: `/everything-gemini-code:docs`) | +| `/eval` | Manage eval-driven development workflow. | +| `/evolve` | Cluster related instincts into skills, commands, or agents. | +| `/go-build` | Fix Go build errors, go vet warnings, and linter issues incrementally. | +| `/go-review` | Comprehensive Go code review for idiomatic patterns, concurrency safety, error handling, and security. | +| `/go-test` | Enforce TDD workflow for Go. Write table-driven tests first, then implement. | +| `/instinct-export` | Export learned instincts to a file for sharing. | +| `/instinct-import` | Import instincts from a file or another source. | +| `/instinct-status` | Show all currently learned instincts with confidence levels. | +| `/learn` | Extract reusable patterns from the current session. | +| `/multi-backend` | Backend-focused multi-agent workflow. | +| `/multi-execute` | Execute a multi-phase plan using multiple specialized agents. | +| `/multi-frontend` | Frontend-focused multi-agent workflow. | +| `/multi-plan` | Create a comprehensive implementation plan using multiple agents. | +| `/multi-workflow` | Multi-model collaborative development workflow. | +| `/orchestrate` | High-level orchestration for complex, multi-step tasks. | +| `/pm2` | Auto-analyze project and generate PM2 service commands. | +| `/python-review` | Comprehensive Python code review for PEP 8, type hints, and security. | +| `/refactor-clean` | Identify and remove dead code, unused imports, and legacy artifacts. | +| `/sessions` | Manage and list active Gemini sessions. | +| `/setup-pm` | Configure your preferred package manager (npm/pnpm/yarn/bun). | +| `/skill-create` | Analyze local git history to extract coding patterns and generate `SKILL.md` files. | +| `/tdd` | Enforce test-driven development workflow. | +| `/test-coverage` | Analyze current test coverage and suggest tests to improve it. | +| `/update-codemaps` | Refresh the codebase maps to ensure the agent has the latest context. | +| `/update-docs` | Update documentation files based on recent code changes. | +| `/verify` | Run a full verification suite (lint, build, test). | + +--- + +## Core Commands + +### /ecc-plan + +Restate requirements, assess risks, and create step-by-step implementation plan. WAIT for user CONFIRM before touching any code. + +### /tdd + +Enforce test-driven development workflow. Scaffold interfaces, generate tests FIRST, then implement minimal code to pass. Ensure 80%+ coverage. + +### /code-review + +Comprehensive security and quality review of uncommitted changes. + +### /build-fix + +Incrementally fix TypeScript and build errors. + +### /refactor-clean + +Safely identify and remove dead code with test verification. + +### /e2e + +Generate and run end-to-end tests with Playwright. Creates test journeys, runs tests, captures screenshots/videos/traces, and uploads artifacts. + +--- + +## Multi-Agent Commands + +### /multi-plan + +Multi-model collaborative planning - Context retrieval + Dual-model analysis. + +### /multi-execute + +Multi-model collaborative execution - Get prototype from plan, refactor and implement, audit and deliver. + +### /multi-backend + +Backend-focused workflow (Research, Ideation, Plan, Execute, Optimize, Review). + +### /multi-frontend + +Frontend-focused workflow (Research, Ideation, Plan, Execute, Optimize, Review). + +### /multi-workflow + +Multi-model collaborative development workflow with intelligent routing: Frontend to Gemini, Backend to Codex. + +### /orchestrate + +Sequential agent workflow for complex tasks. + +### /pm2 + +Auto-analyze project and generate PM2 service commands. + +--- + +## Language-Specific Commands + +### /go-build + +Fix Go build errors, go vet warnings, and linter issues incrementally. Invokes the go-build-resolver agent. + +### /go-review + +Comprehensive Go code review for idiomatic patterns, concurrency safety, error handling, and security. Invokes the go-reviewer agent. + +### /go-test + +Enforce TDD workflow for Go. Write table-driven tests first, then implement. Verify 80%+ coverage. + +### /python-review + +Comprehensive Python code review for PEP 8 compliance, type hints, security, and Pythonic idioms. Invokes the python-reviewer agent. + +### /kotlin-build, /kotlin-review, /kotlin-test + +Kotlin build error resolution, code review, and TDD workflow. + +### /cpp-build, /cpp-review, /cpp-test + +C++ build error resolution, code review, and TDD workflow. + +### /rust-build, /rust-review, /rust-test + +Rust build error resolution, code review, and TDD workflow. + +### /gradle-build + +Fix Gradle/Android build errors and dependency issues. + +--- + +## Learning & Evolution Commands + +### /learn + +Analyze the current session and extract any patterns worth saving as skills. + +### /skill-create + +Analyze local git history to extract coding patterns and generate SKILL.md files. + +### /evolve + +Cluster related instincts into skills, commands, or agents. + +### /instinct-import, /instinct-export, /instinct-status + +Import, export, and view learned instincts. + +### /learn-eval + +Extract reusable patterns with self-evaluation. + +### /promote, /prune, /projects + +Promote instincts to global scope, prune low-confidence instincts, list known projects. + +--- + +## Utility Commands + +### /setup-pm + +Configure your preferred package manager (npm/pnpm/yarn/bun). + +### /update-docs, /update-codemaps + +Sync documentation and refresh codebase architecture maps. + +### /verify, /checkpoint, /eval + +Verification suite, workflow checkpoints, and eval-driven development. + +### /sessions, /save-session, /resume-session + +Session management - list, save, load, and alias sessions. + +### /ecc-docs + +Look up current documentation for a library or topic via Context7. + +### /context-budget + +Monitor and manage context window usage. + +### /model-route + +Route tasks to the optimal model based on complexity. diff --git a/docs/ko-KR/agents/planner.md b/docs/ko-KR/agents/planner.md deleted file mode 100644 index 1040422..0000000 --- a/docs/ko-KR/agents/planner.md +++ /dev/null @@ -1,115 +0,0 @@ ---- -name: planner -description: 복잡한 기능 및 리팩토링을 위한 전문 계획 스페셜리스트. 기능 구현, 아키텍처 변경, 복잡한 리팩토링 요청 시 자동으로 활성화됩니다. -tools: ["read_file", "search_files", "list_directory"] ---- - -포괄적이고 실행 가능한 구현 계획을 만드는 전문 계획 스페셜리스트입니다. - -## 역할 - -- 요구사항을 분석하고 상세한 구현 계획 작성 -- 복잡한 기능을 관리 가능한 단계로 분해 -- 의존성 및 잠재적 위험 식별 -- 최적의 구현 순서 제안 -- 엣지 케이스 및 에러 시나리오 고려 - -## 계획 프로세스 - -### 1. 요구사항 분석 -- 기능 요청을 완전히 이해 -- 필요시 명확한 질문 -- 성공 기준 식별 -- 가정 및 제약사항 나열 - -### 2. 아키텍처 검토 -- 기존 코드베이스 구조 분석 -- 영향받는 컴포넌트 식별 -- 유사한 구현 검토 -- 재사용 가능한 패턴 고려 - -### 3. 단계 분해 - -다음을 포함한 상세 단계 작성: -- 명확하고 구체적인 액션 -- 파일 경로 및 위치 -- 단계 간 의존성 -- 예상 복잡도 -- 잠재적 위험 - -### 4. 구현 순서 -- 의존성별 우선순위 -- 관련 변경사항 그룹화 -- 컨텍스트 전환 최소화 -- 점진적 테스트 가능하게 - -## 계획 형식 - -```markdown -# 구현 계획: [기능명] - -## 개요 -[2-3문장 요약] - -## 요구사항 -- [요구사항 1] -- [요구사항 2] - -## 아키텍처 변경사항 -- [변경 1: 파일 경로와 설명] -- [변경 2: 파일 경로와 설명] - -## 구현 단계 - -### Phase 1: [페이즈 이름] -1. **[단계명]** (File: path/to/file.ts) - - Action: 수행할 구체적 액션 - - Why: 이 단계의 이유 - - Dependencies: 없음 / 단계 X 필요 - - Risk: Low/Medium/High - -## 테스트 전략 -- 단위 테스트: [테스트할 파일] -- 통합 테스트: [테스트할 흐름] -- E2E 테스트: [테스트할 사용자 여정] - -## 위험 및 완화 -- **위험**: [설명] - - 완화: [해결 방법] - -## 성공 기준 -- [ ] 기준 1 -- [ ] 기준 2 -``` - -## 모범 사례 - -1. **구체적으로** — 정확한 파일 경로, 함수명, 변수명 사용 -2. **엣지 케이스 고려** — 에러 시나리오, null 값, 빈 상태 생각 -3. **변경 최소화** — 재작성보다 기존 코드 확장 선호 -4. **패턴 유지** — 기존 프로젝트 컨벤션 따르기 -5. **테스트 가능하게** — 쉽게 테스트할 수 있도록 변경 구조화 -6. **점진적으로** — 각 단계가 검증 가능해야 함 -7. **결정 문서화** — 무엇만이 아닌 왜를 설명 - -## 크기 조정 및 단계화 - -기능이 클 때, 독립적으로 전달 가능한 단계로 분리: - -- **Phase 1**: 최소 실행 가능 — 가치를 제공하는 가장 작은 단위 -- **Phase 2**: 핵심 경험 — 완전한 해피 패스 -- **Phase 3**: 엣지 케이스 — 에러 처리, 마감 -- **Phase 4**: 최적화 — 성능, 모니터링, 분석 - -각 Phase는 독립적으로 merge 가능해야 합니다. - -## 확인해야 할 위험 신호 - -- 큰 함수 (50줄 초과) -- 깊은 중첩 (4단계 초과) -- 중복 코드 -- 에러 처리 누락 -- 하드코딩된 값 -- 테스트 누락 - -**기억하세요**: 좋은 계획은 구체적이고, 실행 가능하며, 해피 패스와 엣지 케이스 모두를 고려합니다. diff --git a/docs/ko-KR/commands/README.md b/docs/ko-KR/commands/README.md index e1b24d2..efe55d5 100644 --- a/docs/ko-KR/commands/README.md +++ b/docs/ko-KR/commands/README.md @@ -1,125 +1,188 @@ -# 커맨드 레퍼런스 +**언어:** [English](../../en/commands/README.md) | **한국어** | [简体中文](../../zh-CN/COMMANDS.md) + +# Gemini CLI 확장 명령어 + +`everything-gemini-code`에서 제공하는 명령어 목록입니다. + +| 명령어 | 설명 | +| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------- | +| `/build-fix` | 빌드 오류를 분석하고 `build-error-resolver` 에이전트로 자동 수정을 시도합니다. | +| `/checkpoint` | 모든 변경 사항을 스테이징하고 AI 생성 메시지로 커밋합니다. | +| `/code-review` | `code-reviewer` 에이전트를 사용하여 현재 변경 사항에 대한 종합 코드 리뷰를 수행합니다. | +| `/e2e` | Playwright로 E2E 테스트를 생성하고 실행합니다. | +| `/ecc-plan` | 요구 사항을 재검토하고 단계별 구현 계획을 수립합니다. (별칭: `/everything-gemini-code:plan`) | +| `/ecc-docs` | Context7을 통해 라이브러리 또는 주제의 최신 문서를 조회합니다. (별칭: `/everything-gemini-code:docs`) | +| `/eval` | Eval 기반 개발 워크플로우를 관리합니다. | +| `/evolve` | 관련 인스팅트를 스킬, 커맨드 또는 에이전트로 클러스터링합니다. | +| `/go-build` | Go 빌드 오류, go vet 경고 및 린터 문제를 점진적으로 수정합니다. | +| `/go-review` | Go 코드 리뷰 — 관용 패턴, 동시성 안전성, 에러 처리, 보안 점검. | +| `/go-test` | Go TDD 워크플로우. 테이블 기반 테스트 먼저 작성 후 구현. | +| `/instinct-export` | 학습된 인스팅트를 파일로 내보냅니다. | +| `/instinct-import` | 파일 또는 외부 소스에서 인스팅트를 가져옵니다. | +| `/instinct-status` | 현재 학습된 모든 인스팅트와 신뢰도를 표시합니다. | +| `/learn` | 현재 세션에서 재사용 가능한 패턴을 추출합니다. | +| `/multi-backend` | 백엔드 중심 멀티 에이전트 워크플로우. | +| `/multi-execute` | 여러 전문 에이전트를 사용하여 멀티 페이즈 계획을 실행합니다. | +| `/multi-frontend` | 프론트엔드 중심 멀티 에이전트 워크플로우. | +| `/multi-plan` | 여러 에이전트를 사용하여 종합적인 구현 계획을 수립합니다. | +| `/multi-workflow` | 멀티 모델 협업 개발 워크플로우. | +| `/orchestrate` | 복잡한 멀티 스텝 작업을 위한 상위 오케스트레이션. | +| `/pm2` | 프로젝트를 분석하고 PM2 서비스 명령을 자동 생성합니다. | +| `/python-review` | PEP 8, 타입 힌트, 보안에 대한 종합 Python 코드 리뷰. | +| `/refactor-clean` | 불필요한 코드, 미사용 임포트 및 레거시 아티팩트를 식별하고 제거합니다. | +| `/sessions` | 활성 Gemini 세션을 관리하고 나열합니다. | +| `/setup-pm` | 선호하는 패키지 매니저(npm/pnpm/yarn/bun)를 설정합니다. | +| `/skill-create` | 로컬 git 히스토리를 분석하여 코딩 패턴을 추출하고 `SKILL.md` 파일을 생성합니다. | +| `/tdd` | 테스트 주도 개발 워크플로우를 적용합니다. | +| `/test-coverage` | 현재 테스트 커버리지를 분석하고 개선 방안을 제안합니다. | +| `/update-codemaps` | 코드베이스 맵을 새로 고쳐 최신 컨텍스트를 반영합니다. | +| `/update-docs` | 최근 코드 변경에 따라 문서를 업데이트합니다. | +| `/verify` | 전체 검증 스위트(린트, 빌드, 테스트)를 실행합니다. | -**언어:** [English](../../COMMANDS.md) | 한국어 +--- + +## 핵심 커맨드 + +### /ecc-plan + +요구 사항을 재검토하고, 위험을 평가하며, 단계별 구현 계획을 수립합니다. 코드 작성 전 사용자 확인을 기다립니다. + +### /tdd + +테스트 주도 개발 워크플로우. 인터페이스 스캐폴딩, 테스트 먼저 생성, 최소 코드 구현. 80%+ 커버리지 보장. + +### /code-review + +커밋되지 않은 변경 사항에 대한 종합 보안 및 품질 리뷰. -Gemini CLI 커맨드는 `.toml` 형식으로 정의됩니다. 슬래시(`/`)로 호출합니다. +### /build-fix + +TypeScript 및 빌드 오류를 점진적으로 수정합니다. + +### /refactor-clean + +테스트 검증을 통해 불필요한 코드를 안전하게 식별하고 제거합니다. + +### /e2e + +Playwright로 E2E 테스트를 생성하고 실행합니다. 테스트 여정 생성, 스크린샷/비디오/트레이스 캡처. --- -## 핵심 커맨드 +## 멀티 에이전트 커맨드 + +### /multi-plan + +멀티 모델 협업 계획 — 컨텍스트 검색 + 이중 모델 분석. -| 커맨드 | 설명 | -|--------|------| -| `/plan` | 기능 구현 계획 수립 | -| `/tdd` | 테스트 주도 개발 워크플로우 | -| `/code-review` | 코드 품질 및 보안 리뷰 | -| `/build-fix` | 빌드 에러 자동 수정 | -| `/e2e` | E2E 테스트 생성 및 실행 | -| `/refactor-clean` | 사용하지 않는 코드 제거 | -| `/verify` | 검증 루프 실행 | -| `/eval` | 기준에 따른 평가 | - -## Go 언어 커맨드 - -| 커맨드 | 설명 | -|--------|------| -| `/go-build` | Go 빌드 에러 수정 | -| `/go-review` | Go 코드 리뷰 | -| `/go-test` | Go TDD 워크플로우 | - -## Python 커맨드 - -| 커맨드 | 설명 | -|--------|------| -| `/python-review` | Python 코드 리뷰 | - -## Kotlin/Java 커맨드 - -| 커맨드 | 설명 | -|--------|------| -| `/kotlin-build` | Kotlin/Gradle 빌드 에러 수정 | -| `/kotlin-review` | Kotlin 코드 리뷰 | -| `/kotlin-test` | Kotlin TDD 워크플로우 | - -## Rust 커맨드 - -| 커맨드 | 설명 | -|--------|------| -| `/rust-build` | Rust 빌드 에러 수정 | -| `/rust-review` | Rust 코드 리뷰 | -| `/rust-test` | Rust 테스팅 워크플로우 | - -## C++ 커맨드 - -| 커맨드 | 설명 | -|--------|------| -| `/cpp-build` | C++ CMake 빌드 에러 수정 | -| `/cpp-review` | C++ 코드 리뷰 | -| `/cpp-test` | C++ 테스팅 워크플로우 | - -## 문서 및 유지보수 - -| 커맨드 | 설명 | -|--------|------| -| `/update-docs` | 문서 업데이트 | -| `/update-codemaps` | 코드맵 업데이트 | -| `/test-coverage` | 테스트 커버리지 분석 | -| `/checkpoint` | 검증 상태 저장 | - -## 학습 및 진화 - -| 커맨드 | 설명 | -|--------|------| -| `/learn` | 세션에서 패턴 추출 | -| `/learn-eval` | 패턴 추출 및 평가 | -| `/evolve` | 인스팅트를 스킬로 클러스터링 | -| `/instinct-status` | 학습된 인스팅트 확인 | -| `/instinct-import` | 인스팅트 가져오기 | -| `/instinct-export` | 인스팅트 내보내기 | - -## 멀티 에이전트 오케스트레이션 - -| 커맨드 | 설명 | -|--------|------| -| `/orchestrate` | 멀티 에이전트 조정 | -| `/multi-plan` | 멀티 에이전트 작업 분해 | -| `/multi-execute` | 오케스트레이션된 멀티 에이전트 워크플로우 | -| `/multi-backend` | 백엔드 멀티 서비스 오케스트레이션 | -| `/multi-frontend` | 프론트엔드 멀티 서비스 오케스트레이션 | -| `/multi-workflow` | 일반 멀티 서비스 워크플로우 | - -## 세션 관리 - -| 커맨드 | 설명 | -|--------|------| -| `/sessions` | 세션 히스토리 관리 | -| `/save-session` | 세션 저장 | -| `/resume-session` | 세션 재개 | -| `/pm2` | PM2 서비스 라이프사이클 관리 | - -## 스킬 관리 - -| 커맨드 | 설명 | -|--------|------| -| `/skill-create` | git 히스토리에서 스킬 생성 | -| `/skill-health` | 스킬 및 커맨드 품질 감사 | +### /multi-execute + +멀티 모델 협업 실행 — 프로토타입, 리팩토링 및 구현, 감사 및 전달. + +### /multi-backend + +백엔드 중심 워크플로우 (조사, 아이디어, 계획, 실행, 최적화, 리뷰). + +### /multi-frontend + +프론트엔드 중심 워크플로우 (조사, 아이디어, 계획, 실행, 최적화, 리뷰). + +### /multi-workflow + +멀티 모델 협업 개발 워크플로우. 프론트엔드는 Gemini, 백엔드는 Codex로 지능적 라우팅. + +### /orchestrate + +복잡한 작업을 위한 순차적 에이전트 워크플로우. + +### /pm2 + +프로젝트를 분석하고 PM2 서비스 명령을 자동 생성합니다. --- -## 커맨드 형식 예시 +## 언어별 커맨드 + +### /go-build, /go-review, /go-test + +Go 빌드 오류 수정, 코드 리뷰, TDD 워크플로우. + +### /python-review + +PEP 8, 타입 힌트, 보안에 대한 종합 Python 코드 리뷰. + +### /kotlin-build, /kotlin-review, /kotlin-test + +Kotlin 빌드 오류 수정, 코드 리뷰, TDD 워크플로우. + +### /cpp-build, /cpp-review, /cpp-test + +C++ 빌드 오류 수정, 코드 리뷰, TDD 워크플로우. + +### /rust-build, /rust-review, /rust-test + +Rust 빌드 오류 수정, 코드 리뷰, TDD 워크플로우. + +### /gradle-build + +Gradle/Android 빌드 오류 및 의존성 문제 수정. + +--- + +## 학습 및 진화 커맨드 + +### /learn + +현재 세션을 분석하여 스킬로 저장할 만한 패턴을 추출합니다. + +### /skill-create + +로컬 git 히스토리를 분석하여 코딩 패턴을 추출하고 SKILL.md 파일을 생성합니다. + +### /evolve + +관련 인스팅트를 스킬, 커맨드 또는 에이전트로 클러스터링합니다. + +### /instinct-import, /instinct-export, /instinct-status + +인스팅트 가져오기, 내보내기, 조회. + +### /learn-eval + +자체 평가를 통한 재사용 가능한 패턴 추출. + +### /promote, /prune, /projects + +인스팅트 글로벌 승격, 저신뢰도 인스팅트 정리, 알려진 프로젝트 목록. + +--- + +## 유틸리티 커맨드 + +### /setup-pm + +선호하는 패키지 매니저(npm/pnpm/yarn/bun)를 설정합니다. + +### /update-docs, /update-codemaps + +문서 동기화 및 코드베이스 아키텍처 맵 새로 고침. + +### /verify, /checkpoint, /eval + +검증 스위트, 워크플로우 체크포인트, eval 기반 개발. + +### /sessions, /save-session, /resume-session + +세션 관리 — 나열, 저장, 불러오기, 별칭 설정. + +### /ecc-docs -Gemini CLI 커맨드는 `.toml` 형식을 사용합니다: +Context7을 통해 라이브러리 또는 주제의 최신 문서를 조회합니다. -```toml -description = "커맨드 설명" -prompt = ''' -# 커맨드 제목 +### /context-budget -커맨드 내용... +컨텍스트 윈도우 사용량을 모니터링하고 관리합니다. -1. 첫 번째 단계 -2. 두 번째 단계 -''' -``` +### /model-route -Claude Code와 달리 Gemini CLI 커맨드에는 `model` 필드가 없습니다. +작업 복잡도에 따라 최적 모델로 라우팅합니다. diff --git a/docs/zh-CN/commands/README.md b/docs/zh-CN/commands/README.md new file mode 100644 index 0000000..0191c85 --- /dev/null +++ b/docs/zh-CN/commands/README.md @@ -0,0 +1,40 @@ +**Language:** [English](../../en/commands/README.md) | [한국어](../../ko-KR/commands/README.md) | **简体中文** + +# Gemini CLI Extension Commands (中文) + +`everything-gemini-code` 提供的命令列表。 + +| 命令 | 描述 | +| ------------------ | ------------------------------------------------------------------------------------------------------------ | +| `/build-fix` | 分析构建错误并使用 `build-error-resolver` 代理自动修复。 | +| `/checkpoint` | 暂存所有更改并使用 AI 生成的消息提交。 | +| `/code-review` | 使用 `code-reviewer` 代理对当前更改进行全面代码审查。 | +| `/e2e` | 使用 Playwright 生成并运行端到端测试。 | +| `/ecc-plan` | 重述需求、评估风险并制定分步实施计划。(别名: `/everything-gemini-code:plan`) | +| `/ecc-docs` | 通过 Context7 查找库或主题的最新文档。(别名: `/everything-gemini-code:docs`) | +| `/eval` | 管理 eval 驱动的开发工作流。 | +| `/evolve` | 将相关直觉聚类为技能、命令或代理。 | +| `/go-build` | 逐步修复 Go 构建错误、go vet 警告和 linter 问题。 | +| `/go-review` | 全面的 Go 代码审查 — 惯用模式、并发安全、错误处理、安全性。 | +| `/go-test` | Go TDD 工作流。先编写表驱动测试，再实现代码。 | +| `/instinct-export` | 将学习的直觉导出到文件。 | +| `/instinct-import` | 从文件或其他来源导入直觉。 | +| `/instinct-status` | 显示所有已学习直觉及其置信度。 | +| `/learn` | 从当前会话中提取可重用模式。 | +| `/multi-backend` | 后端专注的多代理工作流。 | +| `/multi-execute` | 使用多个专业代理执行多阶段计划。 | +| `/multi-frontend` | 前端专注的多代理工作流。 | +| `/multi-plan` | 使用多个代理创建全面的实施计划。 | +| `/multi-workflow` | 多模型协作开发工作流。 | +| `/orchestrate` | 复杂多步骤任务的高级编排。 | +| `/pm2` | 自动分析项目并生成 PM2 服务命令。 | +| `/python-review` | PEP 8、类型提示和安全性的全面 Python 代码审查。 | +| `/refactor-clean` | 识别并删除死代码、未使用的导入和遗留工件。 | +| `/sessions` | 管理和列出活动的 Gemini 会话。 | +| `/setup-pm` | 配置首选包管理器（npm/pnpm/yarn/bun）。 | +| `/skill-create` | 分析本地 git 历史以提取编码模式并生成 `SKILL.md` 文件。 | +| `/tdd` | 实施测试驱动开发工作流。 | +| `/test-coverage` | 分析当前测试覆盖率并建议改进方法。 | +| `/update-codemaps` | 刷新代码库映射以确保代理拥有最新上下文。 | +| `/update-docs` | 根据最近的代码更改更新文档。 | +| `/verify` | 运行完整验证套件（lint、构建、测试）。 | From d59b133a7473fd53386517ec717c18ee1292b54e Mon Sep 17 00:00:00 2001 From: Jamkris Date: Wed, 8 Apr 2026 13:38:02 +0900 Subject: [PATCH 13/24] docs: update Chinese README documentation --- docs/zh-CN/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/zh-CN/README.md b/docs/zh-CN/README.md index 4877862..aa94319 100644 --- a/docs/zh-CN/README.md +++ b/docs/zh-CN/README.md @@ -65,7 +65,7 @@ gemini extensions uninstall https://github.com/Jamkris/everything-gemini-code ### 斜杠命令 (Slash Commands) -使用自定义命令自动化工作流（请参阅 [完整命令列表](COMMANDS.md)）： +使用自定义命令自动化工作流（请参阅 [完整命令列表](commands/README.md)）： ```bash # 规划功能实现 From ed8fb4413a33ecceb8d3f6829ecbffd7c73838c0 Mon Sep 17 00:00:00 2001 From: Jamkris Date: Wed, 8 Apr 2026 13:40:03 +0900 Subject: [PATCH 14/24] docs: add English skills reference and update Korean localization link --- docs/en/skills/README.md | 124 ++++++++++++++++++++++++++++++++++++ docs/ko-KR/skills/README.md | 2 +- 2 files changed, 125 insertions(+), 1 deletion(-) create mode 100644 docs/en/skills/README.md diff --git a/docs/en/skills/README.md b/docs/en/skills/README.md new file mode 100644 index 0000000..2b55b7d --- /dev/null +++ b/docs/en/skills/README.md @@ -0,0 +1,124 @@ +**Language:** **English** | [한국어](../../ko-KR/skills/README.md) + +# Skills Reference + +Skills are collections of workflow definitions and domain knowledge, defined as `SKILL.md` files. + +--- + +## Core Skills + +| Skill | Description | +|-------|-------------| +| [coding-standards](coding-standards/) | Language-specific coding best practices | +| [backend-patterns](backend-patterns/) | API, database, and caching patterns | +| [frontend-patterns](frontend-patterns/) | React, Next.js patterns | +| [tdd-workflow](tdd-workflow/) | TDD methodology | +| [security-review](security-review/) | Security checklist | +| [search-first](search-first/) | Research-first development workflow | + +## Verification & Evaluation + +| Skill | Description | +|-------|-------------| +| [eval-harness](eval-harness/) | Verification loop evaluation | +| [verification-loop](verification-loop/) | Continuous verification | +| [iterative-retrieval](iterative-retrieval/) | Progressive context refinement for subagents | + +## Continuous Learning + +| Skill | Description | +|-------|-------------| +| [continuous-learning](continuous-learning/) | Automatic pattern extraction from sessions | +| [continuous-learning-v2](continuous-learning-v2/) | Instinct-based learning with confidence scoring | +| [strategic-compact](strategic-compact/) | Manual compaction suggestions | + +## Language-Specific Skills + +### Go + +| Skill | Description | +|-------|-------------| +| [golang-patterns](golang-patterns/) | Go idioms and best practices | +| [golang-testing](golang-testing/) | Go testing patterns, TDD, benchmarks | + +### Python + +| Skill | Description | +|-------|-------------| +| [python-patterns](python-patterns/) | Python idioms and best practices | +| [python-testing](python-testing/) | pytest testing patterns | +| [django-patterns](django-patterns/) | Django patterns | +| [django-security](django-security/) | Django security best practices | +| [django-tdd](django-tdd/) | Django TDD workflow | + +### Java/Kotlin + +| Skill | Description | +|-------|-------------| +| [java-coding-standards](java-coding-standards/) | Java coding standards | +| [jpa-patterns](jpa-patterns/) | JPA/Hibernate patterns | +| [springboot-patterns](springboot-patterns/) | Spring Boot patterns | +| [springboot-security](springboot-security/) | Spring Boot security | +| [kotlin-patterns](kotlin-patterns/) | Kotlin patterns | +| [kotlin-coroutines-flows](kotlin-coroutines-flows/) | Kotlin coroutines and flows | + +### Rust + +| Skill | Description | +|-------|-------------| +| [rust-patterns](rust-patterns/) | Rust patterns | +| [rust-testing](rust-testing/) | Rust testing | + +### C++ + +| Skill | Description | +|-------|-------------| +| [cpp-coding-standards](cpp-coding-standards/) | C++ Core Guidelines based standards | +| [cpp-testing](cpp-testing/) | GoogleTest, CMake/CTest testing | + +### Swift/iOS + +| Skill | Description | +|-------|-------------| +| [swiftui-patterns](swiftui-patterns/) | SwiftUI patterns | +| [swift-actor-persistence](swift-actor-persistence/) | Swift actor-based data persistence | +| [swift-concurrency-6-2](swift-concurrency-6-2/) | Swift 6.2 concurrency | +| [liquid-glass-design](liquid-glass-design/) | iOS 26 Liquid Glass design system | + +## Infrastructure & Database + +| Skill | Description | +|-------|-------------| +| [postgres-patterns](postgres-patterns/) | PostgreSQL optimization patterns | +| [clickhouse-io](clickhouse-io/) | ClickHouse analytics, queries, data engineering | +| [database-migrations](database-migrations/) | Migration patterns (Prisma, Drizzle, Django, Go) | +| [docker-patterns](docker-patterns/) | Docker Compose, container patterns | +| [deployment-patterns](deployment-patterns/) | CI/CD, health checks, rollback | + +## API & Architecture + +| Skill | Description | +|-------|-------------| +| [api-design](api-design/) | REST API design, pagination, error responses | +| [backend-patterns](backend-patterns/) | Backend architecture patterns | +| [mcp-server-patterns](mcp-server-patterns/) | MCP server implementation patterns | + +## AI & Agents + +| Skill | Description | +|-------|-------------| +| [agentic-engineering](agentic-engineering/) | Agent engineering patterns | +| [autonomous-loops](autonomous-loops/) | Autonomous loop patterns | +| [cost-aware-llm-pipeline](cost-aware-llm-pipeline/) | LLM cost optimization, model routing | +| [agent-eval](agent-eval/) | Agent evaluation | + +## Business & Content + +| Skill | Description | +|-------|-------------| +| [article-writing](article-writing/) | Long-form writing | +| [content-engine](content-engine/) | Multi-platform content workflow | +| [market-research](market-research/) | Market, competitor, investor research | +| [investor-materials](investor-materials/) | Pitch decks, one-pagers, financial models | +| [deep-research](deep-research/) | Deep research workflow | diff --git a/docs/ko-KR/skills/README.md b/docs/ko-KR/skills/README.md index 15608bb..8f6b838 100644 --- a/docs/ko-KR/skills/README.md +++ b/docs/ko-KR/skills/README.md @@ -1,6 +1,6 @@ # 스킬 레퍼런스 -**언어:** [English](../agents/) | 한국어 +**언어:** [English](../../en/skills/README.md) | **한국어** 스킬은 워크플로우 정의와 도메인 지식의 모음입니다. SKILL.md 파일로 구성됩니다. From a69ddb3cc26a4ceb06dc57ed4259c1cb868c0155 Mon Sep 17 00:00:00 2001 From: Jamkris Date: Wed, 8 Apr 2026 13:42:45 +0900 Subject: [PATCH 15/24] docs: update MCP configuration guide paths to reflect directory restructuring --- README.md | 2 +- docs/en/{MCP-CONFIGS.md => mcp-configs/README.md} | 2 +- docs/en/{SCRIPTS.md => scripts/README.md} | 2 +- docs/ko-KR/{MCP-CONFIGS.md => mcp-configs/README.md} | 2 +- docs/ko-KR/{SCRIPTS.md => scripts/README.md} | 2 +- mcp-configs/README.md | 4 ++-- 6 files changed, 7 insertions(+), 7 deletions(-) rename docs/en/{MCP-CONFIGS.md => mcp-configs/README.md} (95%) rename docs/en/{SCRIPTS.md => scripts/README.md} (97%) rename docs/ko-KR/{MCP-CONFIGS.md => mcp-configs/README.md} (96%) rename docs/ko-KR/{SCRIPTS.md => scripts/README.md} (97%) diff --git a/README.md b/README.md index ea8a880..f4e920d 100644 --- a/README.md +++ b/README.md @@ -154,7 +154,7 @@ Gemini will automatically utilize installed skills when relevant to your request ### MCP Servers -Configure and manage Model Context Protocol (MCP) servers to extend Gemini's capabilities. (see [MCP Configuration Guide](docs/en/MCP-CONFIGS.md)) +Configure and manage Model Context Protocol (MCP) servers to extend Gemini's capabilities. (see [MCP Configuration Guide](docs/en/mcp-configs/README.md)) --- diff --git a/docs/en/MCP-CONFIGS.md b/docs/en/mcp-configs/README.md similarity index 95% rename from docs/en/MCP-CONFIGS.md rename to docs/en/mcp-configs/README.md index 54a2a85..0d39417 100644 --- a/docs/en/MCP-CONFIGS.md +++ b/docs/en/mcp-configs/README.md @@ -1,4 +1,4 @@ -**Language:** **English** | [한국어](../ko-KR/MCP-CONFIGS.md) +**Language:** **English** | [한국어](../../ko-KR/mcp-configs/README.md) # MCP Server Configurations diff --git a/docs/en/SCRIPTS.md b/docs/en/scripts/README.md similarity index 97% rename from docs/en/SCRIPTS.md rename to docs/en/scripts/README.md index bf70848..f8da9f9 100644 --- a/docs/en/SCRIPTS.md +++ b/docs/en/scripts/README.md @@ -1,6 +1,6 @@ # Scripts Reference -**Language:** **English** | [한국어](../ko-KR/SCRIPTS.md) +**Language:** **English** | [한국어](../../ko-KR/scripts/README.md) This directory contains utility scripts for maintaining the Everything Gemini Code repository. diff --git a/docs/ko-KR/MCP-CONFIGS.md b/docs/ko-KR/mcp-configs/README.md similarity index 96% rename from docs/ko-KR/MCP-CONFIGS.md rename to docs/ko-KR/mcp-configs/README.md index 0fd436d..88d25e0 100644 --- a/docs/ko-KR/MCP-CONFIGS.md +++ b/docs/ko-KR/mcp-configs/README.md @@ -1,4 +1,4 @@ -**언어:** [English](../en/MCP-CONFIGS.md) | **한국어** +**언어:** [English](../../en/mcp-configs/README.md) | **한국어** # MCP 서버 설정 모음 diff --git a/docs/ko-KR/SCRIPTS.md b/docs/ko-KR/scripts/README.md similarity index 97% rename from docs/ko-KR/SCRIPTS.md rename to docs/ko-KR/scripts/README.md index 4fe5445..dc8f79a 100644 --- a/docs/ko-KR/SCRIPTS.md +++ b/docs/ko-KR/scripts/README.md @@ -1,6 +1,6 @@ # 스크립트 레퍼런스 -**언어:** [English](../en/SCRIPTS.md) | **한국어** +**언어:** [English](../../en/scripts/README.md) | **한국어** 이 디렉토리는 Everything Gemini Code 저장소를 유지 관리하기 위한 유틸리티 스크립트 모음입니다. diff --git a/mcp-configs/README.md b/mcp-configs/README.md index f3bad92..f5d2d70 100644 --- a/mcp-configs/README.md +++ b/mcp-configs/README.md @@ -2,5 +2,5 @@ See the full documentation: -- [English](../docs/en/MCP-CONFIGS.md) -- [한국어](../docs/ko-KR/MCP-CONFIGS.md) +- [English](../docs/en/mcp-configs/README.md) +- [한국어](../docs/ko-KR/mcp-configs/README.md) From 6f53182919341b3ef448dca0794f8a39ccbf13ca Mon Sep 17 00:00:00 2001 From: Jamkris Date: Wed, 8 Apr 2026 13:52:43 +0900 Subject: [PATCH 16/24] docs: update contributing guide file path in README --- README.md | 2 +- docs/en/{ => contributing}/COMMAND-AGENT-MAP.md | 0 docs/en/{CONTRIBUTING.md => contributing/README.md} | 10 +++++++++- docs/en/{ => contributing}/SKILL-PLACEMENT-POLICY.md | 0 docs/en/{ => contributing}/TERMINOLOGY.md | 0 docs/en/{ => contributing}/VERIFICATION_GUIDE.md | 0 docs/en/{ => contributing}/token-optimization.md | 0 docs/ko-KR/{CONTRIBUTING.md => contributing/README.md} | 10 +++++++++- docs/ko-KR/{ => contributing}/TERMINOLOGY.md | 2 +- 9 files changed, 20 insertions(+), 4 deletions(-) rename docs/en/{ => contributing}/COMMAND-AGENT-MAP.md (100%) rename docs/en/{CONTRIBUTING.md => contributing/README.md} (81%) rename docs/en/{ => contributing}/SKILL-PLACEMENT-POLICY.md (100%) rename docs/en/{ => contributing}/TERMINOLOGY.md (100%) rename docs/en/{ => contributing}/VERIFICATION_GUIDE.md (100%) rename docs/en/{ => contributing}/token-optimization.md (100%) rename docs/ko-KR/{CONTRIBUTING.md => contributing/README.md} (79%) rename docs/ko-KR/{ => contributing}/TERMINOLOGY.md (97%) diff --git a/README.md b/README.md index f4e920d..c0c03a9 100644 --- a/README.md +++ b/README.md @@ -189,7 +189,7 @@ rm -rf ~/.gemini/skills/* ~/.gemini/commands/* ## 🤝 Contributing -**Contributions are welcome!** See the [Contributing Guide](docs/en/CONTRIBUTING.md). +**Contributions are welcome!** See the [Contributing Guide](docs/en/contributing/README.md). If you have useful agents, skills, or configurations, please submit a Pull Request. diff --git a/docs/en/COMMAND-AGENT-MAP.md b/docs/en/contributing/COMMAND-AGENT-MAP.md similarity index 100% rename from docs/en/COMMAND-AGENT-MAP.md rename to docs/en/contributing/COMMAND-AGENT-MAP.md diff --git a/docs/en/CONTRIBUTING.md b/docs/en/contributing/README.md similarity index 81% rename from docs/en/CONTRIBUTING.md rename to docs/en/contributing/README.md index 2ab6523..9889017 100644 --- a/docs/en/CONTRIBUTING.md +++ b/docs/en/contributing/README.md @@ -1,9 +1,17 @@ # Contributing Guide -**Language:** **English** | [한국어](../ko-KR/CONTRIBUTING.md) +**Language:** **English** | [한국어](../../ko-KR/contributing/README.md) Thank you for your interest in contributing to Everything Gemini Code! +## Related Documents + +- [Command-Agent Map](COMMAND-AGENT-MAP.md) — Which agents are invoked by each command +- [Skill Placement Policy](SKILL-PLACEMENT-POLICY.md) — Where skills belong and how they are identified +- [Token Optimization](token-optimization.md) — Managing token consumption +- [Verification Guide](VERIFICATION_GUIDE.md) — Verifying extension installation +- [Terminology](TERMINOLOGY.md) — Core project terminology + --- ## How to Contribute diff --git a/docs/en/SKILL-PLACEMENT-POLICY.md b/docs/en/contributing/SKILL-PLACEMENT-POLICY.md similarity index 100% rename from docs/en/SKILL-PLACEMENT-POLICY.md rename to docs/en/contributing/SKILL-PLACEMENT-POLICY.md diff --git a/docs/en/TERMINOLOGY.md b/docs/en/contributing/TERMINOLOGY.md similarity index 100% rename from docs/en/TERMINOLOGY.md rename to docs/en/contributing/TERMINOLOGY.md diff --git a/docs/en/VERIFICATION_GUIDE.md b/docs/en/contributing/VERIFICATION_GUIDE.md similarity index 100% rename from docs/en/VERIFICATION_GUIDE.md rename to docs/en/contributing/VERIFICATION_GUIDE.md diff --git a/docs/en/token-optimization.md b/docs/en/contributing/token-optimization.md similarity index 100% rename from docs/en/token-optimization.md rename to docs/en/contributing/token-optimization.md diff --git a/docs/ko-KR/CONTRIBUTING.md b/docs/ko-KR/contributing/README.md similarity index 79% rename from docs/ko-KR/CONTRIBUTING.md rename to docs/ko-KR/contributing/README.md index 1ecffc6..3737020 100644 --- a/docs/ko-KR/CONTRIBUTING.md +++ b/docs/ko-KR/contributing/README.md @@ -1,9 +1,17 @@ # 기여 가이드 -**언어:** [English](../en/CONTRIBUTING.md) | **한국어** +**언어:** [English](../../en/contributing/README.md) | **한국어** Everything Gemini Code에 기여해 주셔서 감사합니다! +## 관련 문서 + +- [커맨드-에이전트 매핑](../../en/contributing/COMMAND-AGENT-MAP.md) — 각 커맨드가 호출하는 에이전트 +- [스킬 배치 정책](../../en/contributing/SKILL-PLACEMENT-POLICY.md) — 스킬 파일 배치 규칙 +- [토큰 최적화](../../en/contributing/token-optimization.md) — 토큰 사용량 관리 +- [설치 검증 가이드](../../en/contributing/VERIFICATION_GUIDE.md) — 확장 설치 검증 +- [용어 사전](TERMINOLOGY.md) — 프로젝트 용어 정의 + --- ## 기여 방법 diff --git a/docs/ko-KR/TERMINOLOGY.md b/docs/ko-KR/contributing/TERMINOLOGY.md similarity index 97% rename from docs/ko-KR/TERMINOLOGY.md rename to docs/ko-KR/contributing/TERMINOLOGY.md index df8ded7..478533c 100644 --- a/docs/ko-KR/TERMINOLOGY.md +++ b/docs/ko-KR/contributing/TERMINOLOGY.md @@ -1,4 +1,4 @@ -**언어:** [English](../en/TERMINOLOGY.md) | **한국어** +**언어:** [English](../../en/contributing/TERMINOLOGY.md) | **한국어** # Gemini CLI & Everything Gemini Code — 용어 사전 From e0c1e4fe75da80980f1eb10ff1d63c5bfe5c970d Mon Sep 17 00:00:00 2001 From: Jamkris Date: Wed, 8 Apr 2026 13:55:25 +0900 Subject: [PATCH 17/24] docs: add Korean translation for contributing guidelines and technical documentation files --- docs/ko-KR/contributing/COMMAND-AGENT-MAP.md | 49 ++++++++++ docs/ko-KR/contributing/README.md | 8 +- .../contributing/SKILL-PLACEMENT-POLICY.md | 88 ++++++++++++++++++ docs/ko-KR/contributing/VERIFICATION_GUIDE.md | 68 ++++++++++++++ docs/ko-KR/contributing/token-optimization.md | 90 +++++++++++++++++++ 5 files changed, 299 insertions(+), 4 deletions(-) create mode 100644 docs/ko-KR/contributing/COMMAND-AGENT-MAP.md create mode 100644 docs/ko-KR/contributing/SKILL-PLACEMENT-POLICY.md create mode 100644 docs/ko-KR/contributing/VERIFICATION_GUIDE.md create mode 100644 docs/ko-KR/contributing/token-optimization.md diff --git a/docs/ko-KR/contributing/COMMAND-AGENT-MAP.md b/docs/ko-KR/contributing/COMMAND-AGENT-MAP.md new file mode 100644 index 0000000..f1a16ff --- /dev/null +++ b/docs/ko-KR/contributing/COMMAND-AGENT-MAP.md @@ -0,0 +1,49 @@ +**언어:** [English](../../en/contributing/COMMAND-AGENT-MAP.md) | **한국어** + +# 커맨드 ↔ 에이전트 매핑 + +각 커맨드가 호출하는 에이전트를 빠르게 참조할 수 있는 테이블입니다. + +| 커맨드 | 사용 에이전트 | 설명 | +|--------|-------------|------| +| `/ecc-plan` | planner | 기능 구현 계획 수립 | +| `/tdd` | tdd-guide | 테스트 주도 개발 | +| `/code-review` | code-reviewer | 코드 품질 리뷰 | +| `/build-fix` | build-error-resolver | 빌드 오류 수정 | +| `/e2e` | e2e-runner | E2E 테스트 생성 | +| `/refactor-clean` | refactor-cleaner | 불필요한 코드 제거 | +| `/update-docs` | doc-updater | 문서 동기화 | +| `/verify` | — | 검증 루프 스킬 실행 | +| `/eval` | — | 기준 대비 평가 | +| `/go-build` | go-build-resolver | Go 빌드 오류 수정 | +| `/go-review` | go-reviewer | Go 코드 리뷰 | +| `/go-test` | — | Go TDD 워크플로우 | +| `/python-review` | python-reviewer | Python 코드 리뷰 | +| `/kotlin-build` | kotlin-build-resolver | Kotlin 빌드 오류 | +| `/kotlin-review` | kotlin-reviewer | Kotlin 코드 리뷰 | +| `/rust-build` | rust-build-resolver | Rust 빌드 오류 | +| `/rust-review` | rust-reviewer | Rust 코드 리뷰 | +| `/cpp-build` | cpp-build-resolver | C++ 빌드 오류 | +| `/cpp-review` | cpp-reviewer | C++ 코드 리뷰 | +| `/orchestrate` | — | 멀티 에이전트 조율 | +| `/multi-plan` | planner | 멀티 에이전트 작업 분해 | +| `/sessions` | — | 세션 히스토리 관리 | +| `/skill-create` | — | git 히스토리에서 스킬 생성 | +| `/learn` | — | 세션에서 패턴 추출 | +| `/evolve` | — | 인스팅트를 스킬로 클러스터링 | +| `/checkpoint` | — | 검증 상태 저장 | + +--- + +## 직접 에이전트 호출 + +전용 커맨드가 없는 에이전트는 직접 호출할 수 있습니다: + +```bash +@security-reviewer "이 파일의 취약점을 감사해주세요" +@architect "마이크로서비스 시스템을 설계해주세요..." +@typescript-reviewer "이 TypeScript 코드를 리뷰해주세요" +@database-reviewer "이 SQL 쿼리를 확인해주세요" +@chief-of-staff "이메일을 분류해주세요" +@loop-operator "검증 루프를 실행해주세요" +``` diff --git a/docs/ko-KR/contributing/README.md b/docs/ko-KR/contributing/README.md index 3737020..411b076 100644 --- a/docs/ko-KR/contributing/README.md +++ b/docs/ko-KR/contributing/README.md @@ -6,10 +6,10 @@ Everything Gemini Code에 기여해 주셔서 감사합니다! ## 관련 문서 -- [커맨드-에이전트 매핑](../../en/contributing/COMMAND-AGENT-MAP.md) — 각 커맨드가 호출하는 에이전트 -- [스킬 배치 정책](../../en/contributing/SKILL-PLACEMENT-POLICY.md) — 스킬 파일 배치 규칙 -- [토큰 최적화](../../en/contributing/token-optimization.md) — 토큰 사용량 관리 -- [설치 검증 가이드](../../en/contributing/VERIFICATION_GUIDE.md) — 확장 설치 검증 +- [커맨드-에이전트 매핑](COMMAND-AGENT-MAP.md) — 각 커맨드가 호출하는 에이전트 +- [스킬 배치 정책](SKILL-PLACEMENT-POLICY.md) — 스킬 파일 배치 규칙 +- [토큰 최적화](token-optimization.md) — 토큰 사용량 관리 +- [설치 검증 가이드](VERIFICATION_GUIDE.md) — 확장 설치 검증 - [용어 사전](TERMINOLOGY.md) — 프로젝트 용어 정의 --- diff --git a/docs/ko-KR/contributing/SKILL-PLACEMENT-POLICY.md b/docs/ko-KR/contributing/SKILL-PLACEMENT-POLICY.md new file mode 100644 index 0000000..f75b06a --- /dev/null +++ b/docs/ko-KR/contributing/SKILL-PLACEMENT-POLICY.md @@ -0,0 +1,88 @@ +**언어:** [English](../../en/contributing/SKILL-PLACEMENT-POLICY.md) | **한국어** + +# 스킬 배치 및 출처 정책 + +이 문서는 생성된 스킬, 임포트된 스킬, 큐레이팅된 스킬이 어디에 배치되고, 어떻게 식별되며, 확장과 함께 배포되는 항목이 무엇인지 정의합니다. + +## 스킬 유형 및 배치 + +| 유형 | 경로 | 배포 여부 | 출처 정보 | +|------|------|----------|----------| +| 큐레이팅 | `skills/` (저장소) | 예 | 불필요 | +| 학습됨 | `~/.gemini/skills/learned/` | 아니오 | 필수 | +| 임포트됨 | `~/.gemini/skills/imported/` | 아니오 | 필수 | +| 진화됨 | `~/.gemini/skills/evolved/` | 아니오 | 인스팅트 출처 상속 | + +큐레이팅된 스킬은 저장소의 `skills/` 아래에 위치합니다. 설치 매니페스트는 큐레이팅된 경로만 참조합니다. 생성되거나 임포트된 스킬은 사용자 홈 디렉토리에 위치하며 배포되지 않습니다. + +## 큐레이팅된 스킬 + +위치: `skills//`에 `SKILL.md` 파일 포함. + +- 확장 매니페스트에 포함됨 +- CI에서 검증됨 +- 출처 파일 불필요. 기여 표시는 SKILL.md frontmatter의 `origin` 필드 사용 + +## 학습된 스킬 + +위치: `~/.gemini/skills/learned//` + +지속적 학습(evaluate-session 훅, `/learn` 커맨드)에 의해 생성됨. + +- 저장소에 없음. 배포 안 됨 +- `SKILL.md` 옆에 `.provenance.json` 파일 필수 +- 디렉토리가 존재할 때 런타임에 로드됨 + +## 임포트된 스킬 + +위치: `~/.gemini/skills/imported//` + +외부 소스(URL, 파일 복사 등)에서 사용자가 설치한 스킬. + +- 저장소에 없음. 배포 안 됨 +- `SKILL.md` 옆에 `.provenance.json` 파일 필수 + +## 진화된 스킬 (지속적 학습 v2) + +위치: `~/.gemini/skills/evolved/` + +`/evolve` 커맨드에 의해 클러스터링된 인스팅트에서 생성됨. + +- 저장소에 없음. 배포 안 됨 +- 출처는 소스 인스팅트에서 상속됨. 별도 `.provenance.json` 불필요 + +## 출처 메타데이터 + +학습된 스킬과 임포트된 스킬에 필수. 파일: 스킬 디렉토리 내 `.provenance.json` + +필수 필드: + +| 필드 | 타입 | 설명 | +|------|------|------| +| source | string | 출처 (URL, 경로, 식별자) | +| created_at | string | ISO 8601 타임스탬프 | +| confidence | number | 0–1 신뢰도 | +| author | string | 스킬 생성자 | + +## 배포 가능 vs 로컬 전용 + +| 배포 가능 | 로컬 전용 | +|----------|----------| +| `skills/*` (큐레이팅) | `~/.gemini/skills/learned/*` | +| | `~/.gemini/skills/imported/*` | +| | `~/.gemini/skills/evolved/*` | + +큐레이팅된 스킬만 설치 매니페스트에 포함되고 설치 시 복사됩니다. + +## Gemini CLI 도구 이름 차이 + +Claude Code에서 스킬 참조를 변환할 때 도구 이름이 다릅니다: + +| Claude Code | Gemini CLI | +|-------------|------------| +| `Read` | `read_file` | +| `Write` | `write_file` | +| `Edit` | `replace_in_file` | +| `Bash` | `run_shell_command` | +| `Grep` | `search_files` | +| `Glob` | `list_directory` | diff --git a/docs/ko-KR/contributing/VERIFICATION_GUIDE.md b/docs/ko-KR/contributing/VERIFICATION_GUIDE.md new file mode 100644 index 0000000..8baf2a1 --- /dev/null +++ b/docs/ko-KR/contributing/VERIFICATION_GUIDE.md @@ -0,0 +1,68 @@ +**언어:** [English](../../en/contributing/VERIFICATION_GUIDE.md) | **한국어** + +# Gemini CLI 확장 설치 검증 가이드 + +이 가이드는 `everything-gemini-code` 확장이 올바르게 설치되고 정상 작동하는지 확인하는 방법을 설명합니다. + +## 1. 설치 확인 + +`gemini extensions install https://github.com/Jamkris/everything-gemini-code` 실행 후 다음을 확인하세요: + +### 1단계: 확장 디렉토리 확인 + +확장 파일이 존재하는지 확인합니다: + +```bash +ls ~/.gemini/extensions/everything-gemini-code +# agents, skills, scripts, commands 등이 표시되어야 합니다 +``` + +### 2단계: 세션 시작 트리거 (중요) + +확장은 세션이 시작될 때 자동으로 커맨드 별칭(shim)을 설정합니다. +확장을 방금 설치했다면 **세션을 한 번 시작해야** 합니다. + +아무 명령이나 실행하여 세션을 시작하세요: + +```bash +gemini run "echo '세션 초기화 중...'" +``` + +### 3단계: 커맨드 확인 + +커맨드가 올바르게 로드되었는지 확인합니다: + +```bash +# Gemini CLI 내에서 +/tdd +``` + +TDD 가이드 에이전트가 로드되어야 합니다. + +## 2. 기능 검증 + +### `/tdd` 커맨드 테스트 + +1. Gemini 세션 시작: `gemini` +2. `/tdd` 입력 후 Enter +3. **TDD Guide** 에이전트가 확장에서 로드되어야 합니다 + +### 훅 테스트 + +1. 더미 `.ts` 파일 생성: `touch test.ts` +2. Gemini가 `suggest-compact` 등의 훅을 트리거해야 합니다 +3. `~/.gemini/scripts/hooks/` 확인 — 확장의 훅을 로드하려고 시도해야 합니다 + +## 문제 해결 + +`/tdd` 커맨드가 없거나 작동하지 않는 경우: + +1. **로그 확인:** + 출력에서 `[SessionStart]` 오류를 확인하세요. + +2. **수동 설치 (대안):** + 자동 설정이 실패하면 설치 스크립트를 수동으로 실행하세요: + ```bash + cd ~/.gemini/extensions/everything-gemini-code + ./scripts/install.sh --cli + ``` diff --git a/docs/ko-KR/contributing/token-optimization.md b/docs/ko-KR/contributing/token-optimization.md new file mode 100644 index 0000000..ac49fbc --- /dev/null +++ b/docs/ko-KR/contributing/token-optimization.md @@ -0,0 +1,90 @@ +**언어:** [English](../../en/contributing/token-optimization.md) | **한국어** + +# 토큰 최적화 가이드 + +## 개요 + +Gemini CLI에서 토큰 사용량을 관리하는 것은 비용과 성능 모두에 중요합니다. + +## 모델 선택 + +### 권장 모델 + +| 작업 | 모델 | 이유 | +|------|------|------| +| 대부분의 코딩 작업 | `gemini-2.0-flash` | 빠르고 비용 효율적 | +| 복잡한 아키텍처 | `gemini-2.5-pro` | 심층 추론 | +| 간단한 쿼리 | `gemini-2.0-flash-lite` | 최소 비용 | + +### 설정 + +`~/.gemini/settings.json`에서 기본 모델을 설정하세요: + +```json +{ + "model": "gemini-2.0-flash" +} +``` + +또는 환경 변수로 세션별 설정: + +```bash +export GEMINI_MODEL=gemini-2.5-pro +``` + +## 컨텍스트 윈도우 관리 + +### MCP 서버 최적화 + +각 활성 MCP 서버는 컨텍스트 토큰을 소비합니다. 모범 사례: + +- 프로젝��당 10개 미만의 MCP 서버 활성화 +- 사용하지 않는 서버는 프로젝트 설정에서 비활성화 +- `mcp-configs/`에서 프로젝트별 MCP 설정 사용 + +### 세션 관리 + +- 관련 없는 작업은 새 세션에서 시작 +- 컨텍스트 집약적 작업 전에 `/checkpoint`으로 상태 저장 +- `/sessions`으��� 과거 세션을 확인하고 재개 + +## 스킬 로딩 최적화 + +스킬은 참조될 때 온디맨드로 로드됩니다. 최적화 방법: + +1. **구체적으로**: 필요한 스킬만 참조 +2. **핵심 스킬 사용**: `coding-standards`, `backend-patterns`, `tdd-workflow`로 대부분 커버 +3. **니치 스킬은 나중에**: 해당 언어로 작업할 때만 언어별 스킬 로드 + +## 훅 런타임 제어 + +오버헤드를 줄이기 위해 실행되는 훅을 제어하세요: + +```bash +# 최소 훅 (가장 빠름) +export ECC_HOOK_PROFILE=minimal + +# 표준 훅 (권장) +export ECC_HOOK_PROFILE=standard + +# 특정 훅 비활성화 +export ECC_DISABLED_HOOKS="hook-id-1,hook-id-2" +``` + +## 실용적 팁 + +| 상황 | 조치 | +|------|------| +| 대규모 코드베이스 리뷰 | 대상 에이전트 사용 (전체 리뷰 대신 `@go-reviewer`) | +| 반복적인 빌드 수정 | 언어별 리졸버 사용 (일반 대신 `/go-build`) | +| 문서 업데이트 | 수동 프롬프트 대신 `/update-docs` 사용 | +| 아키텍처 결정 | 명확한 범위 경계와 함께 `@architect` 사용 | + +## 토큰 효율을 위한 지속적 학습 + +`/learn` 커맨드는 세션에서 패턴을 추출하여 재사용 가능한 스킬로 저장합니다. 향후 세션에서 컨텍스트를 다시 설명할 필요가 줄어듭니다: + +```bash +/learn # 현재 세션에서 패턴 추출 +/evolve # 인스팅트를 효율적인 스킬로 클러스터링 +``` From fc6e9ea56c640d3e0e153491bdba9f73f3bae4af Mon Sep 17 00:00:00 2001 From: Jamkris Date: Wed, 8 Apr 2026 14:02:53 +0900 Subject: [PATCH 18/24] refactor: remove automatic compaction suggestions to keep tool execution silent --- scripts/hooks/suggest-compact.js | 9 +-------- tests/hooks/hooks.test.js | 8 +++----- 2 files changed, 4 insertions(+), 13 deletions(-) diff --git a/scripts/hooks/suggest-compact.js b/scripts/hooks/suggest-compact.js index 9a665c4..2f94e03 100644 --- a/scripts/hooks/suggest-compact.js +++ b/scripts/hooks/suggest-compact.js @@ -28,8 +28,6 @@ runHook('StrategicCompact', async () => { // or session ID from environment const sessionId = process.env.GEMINI_SESSION_ID || process.ppid || 'default'; const counterFile = path.join(getTempDir(), `gemini-tool-count-${sessionId}`); - const threshold = parseInt(process.env.COMPACT_THRESHOLD || '50', 10); - let count = 1; // Read existing count or start at 1 @@ -41,11 +39,6 @@ runHook('StrategicCompact', async () => { // Save updated count writeFile(counterFile, String(count)); - // Suggest compact only at key milestones (threshold and intervals) - if (count === threshold) { - console.error(`[Hint] ${threshold} tool calls reached - consider /compact if transitioning phases`); - } else if (count > threshold && count % 25 === 0) { - console.error(`[Hint] ${count} tool calls - good checkpoint for /compact if context is stale`); - } + // Counter tracked silently — compaction is user-initiated }); diff --git a/tests/hooks/hooks.test.js b/tests/hooks/hooks.test.js index 169d191..0a4b0eb 100644 --- a/tests/hooks/hooks.test.js +++ b/tests/hooks/hooks.test.js @@ -197,7 +197,7 @@ async function runTests() { fs.unlinkSync(counterFile); })) passed++; else failed++; - if (await asyncTest('suggests compact at threshold', async () => { + if (await asyncTest('runs silently at threshold', async () => { const sessionId = 'test-threshold-' + Date.now(); const counterFile = path.join(os.tmpdir(), `gemini-tool-count-${sessionId}`); @@ -209,10 +209,8 @@ async function runTests() { COMPACT_THRESHOLD: '50' }); - assert.ok( - result.stderr.includes('50 tool calls reached'), - 'Should suggest compact at threshold' - ); + assert.strictEqual(result.code, 0, 'Should exit cleanly'); + assert.strictEqual(result.stderr, '', 'Should produce no output at threshold'); // Cleanup fs.unlinkSync(counterFile); From 51540876df4d54e054a781b617e8cd69ab679511 Mon Sep 17 00:00:00 2001 From: Jamkris Date: Wed, 8 Apr 2026 14:11:39 +0900 Subject: [PATCH 19/24] feat: add project style guide and configuration files to .gemini directory --- .gemini/config.yaml | 20 ++++++++++++ .gemini/styleguide.md | 72 +++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 92 insertions(+) create mode 100644 .gemini/config.yaml create mode 100644 .gemini/styleguide.md diff --git a/.gemini/config.yaml b/.gemini/config.yaml new file mode 100644 index 0000000..4b810ad --- /dev/null +++ b/.gemini/config.yaml @@ -0,0 +1,20 @@ +pull_request_opened: + summary: true + code_review: true + help: false + include_drafts: false + ignore_patterns: + - '**/*.lock' + - '**/package-lock.json' + - '**/node_modules/**' + - 'examples/**' + +code_review: + disable: false + comment_severity_threshold: HIGH + max_review_comments: 8 + +have_fun: false + +memory_config: + disabled: false diff --git a/.gemini/styleguide.md b/.gemini/styleguide.md new file mode 100644 index 0000000..cd4edba --- /dev/null +++ b/.gemini/styleguide.md @@ -0,0 +1,72 @@ +# Code Review Style Guide + +## Project Context + +This is a **Gemini CLI extension** (`everything-gemini-code`) — not a typical application. +The codebase consists of: + +- **Shell scripts** (`scripts/`) — Node.js utilities and bash installers +- **TOML commands** (`commands/`) — Gemini CLI slash commands +- **Markdown skills** (`skills/`) — AI workflow definitions (SKILL.md) +- **Markdown agents** (`agents/`) — Subagent definitions with frontmatter +- **Markdown docs** (`docs/`) — Multilingual documentation (en, ko-KR, zh-CN) +- **JSON hooks** (`hooks/`) — Gemini CLI automation triggers + +## JavaScript / Node.js + +- Target Node.js 20+. Use CommonJS (`require`), not ESM. +- No `console.log` in hook scripts — hooks must run silently on success. +- Use `process.exit(0)` on hook errors to avoid blocking the CLI. +- Prefer `const` over `let`. Never use `var`. +- Functions should be under 50 lines. Files should be under 400 lines. +- Use `assert` module for tests (custom test runner, not Jest/Mocha). + +## Shell Scripts + +- Use `set -e` at the top of all bash scripts. +- Quote all variables: `"$VAR"` not `$VAR`. +- Check file/directory existence before operations. +- Support both macOS and Linux (no GNU-only flags). + +## TOML Commands + +- Every command must have a non-empty `description` field. +- The `prompt` field should include usage examples and related commands. +- Agent references use `@agent-name` format. + +## Markdown Skills (SKILL.md) + +- Must start with YAML frontmatter (`---` block) containing `name` and `description`. +- Must have a `## When to Use` section (not "When to Activate" or "When to Apply"). +- Keep under 800 lines. + +## Markdown Agents + +- Must have YAML frontmatter with `tools` field. +- Tool names must use Gemini format: `read_file`, `run_shell_command`, `write_file`. +- No `model` field (Gemini CLI does not support it). + +## Documentation + +- Main README.md (English) stays at root. All other docs live under `docs/{lang}/`. +- Every doc file must have a language switcher line at the top. +- Supported languages: English (`docs/en/`), Korean (`docs/ko-KR/`), Chinese (`docs/zh-CN/`). +- Internal links must use relative paths. No absolute GitHub URLs for internal docs. + +## Testing + +- Tests use a custom runner (`tests/run-all.js`). Output must include `Passed: N` and `Failed: N`. +- New library modules in `scripts/lib/` must have corresponding test files in `tests/lib/`. +- Hook integration tests live in `tests/hooks/`. + +## CI / GitHub Actions + +- Pin third-party actions to commit SHA (e.g., `uses: action@ # v2`). +- First-party GitHub actions (`actions/*`) can use version tags (`@v4`). +- Reusable workflows in `.github/workflows/reusable-*.yml` must be called by `ci.yml`. + +## What NOT to Flag + +- Emoji usage in markdown docs is intentional — do not flag. +- Long TOML `prompt` fields are expected — do not flag line length. +- Skills referencing `~/.gemini/` paths are correct — do not suggest `~/.claude/`. From 4768158511501a1a2b7a3cd8aec7cd89d6b9c787 Mon Sep 17 00:00:00 2001 From: Jamkris Date: Wed, 8 Apr 2026 14:13:13 +0900 Subject: [PATCH 20/24] chore: update code review severity threshold to MEDIUM in config --- .gemini/config.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.gemini/config.yaml b/.gemini/config.yaml index 4b810ad..b873807 100644 --- a/.gemini/config.yaml +++ b/.gemini/config.yaml @@ -11,7 +11,7 @@ pull_request_opened: code_review: disable: false - comment_severity_threshold: HIGH + comment_severity_threshold: MEDIUM max_review_comments: 8 have_fun: false From b7630d9b8aaad0c707522edb0db030b9443bd150 Mon Sep 17 00:00:00 2001 From: Jamkris Date: Wed, 8 Apr 2026 14:13:49 +0900 Subject: [PATCH 21/24] chore: rename /plan command to /ecc-plan and update agent reference documentation --- commands/ecc-plan.toml | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/commands/ecc-plan.toml b/commands/ecc-plan.toml index 89b9206..11a29ae 100644 --- a/commands/ecc-plan.toml +++ b/commands/ecc-plan.toml @@ -13,7 +13,7 @@ This command invokes the **planner** agent to create a comprehensive implementat ## When to Use -Use `/plan` when: +Use `/ecc-plan` when: - Starting a new feature - Making significant architectural changes - Working on complex refactoring @@ -34,7 +34,7 @@ The planner agent will: ## Example Usage ``` -User: /plan I need to add real-time notifications when markets resolve +User: /ecc-plan I need to add real-time notifications when markets resolve Agent (planner): # Implementation Plan: Real-Time Market Resolution Notifications @@ -107,6 +107,5 @@ After planning: ## Related Agents -This command invokes the `planner` agent located at: -`~/.gemini/agents/planner.md` +This command invokes the `@planner` agent. ''' From 318b74c14dd1418dc4e4d559469c7024cfcc12bc Mon Sep 17 00:00:00 2001 From: Jamkris Date: Wed, 8 Apr 2026 14:14:04 +0900 Subject: [PATCH 22/24] refactor: rename /docs command to /ecc-docs for consistency --- commands/ecc-docs.toml | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/commands/ecc-docs.toml b/commands/ecc-docs.toml index 1f65ace..963172e 100644 --- a/commands/ecc-docs.toml +++ b/commands/ecc-docs.toml @@ -1,10 +1,10 @@ -description = '/docs' +description = '/ecc-docs' prompt = ''' --- description: Look up current documentation for a library or topic via Context7. --- -# /docs +# /ecc-docs ## Purpose @@ -13,10 +13,10 @@ Look up up-to-date documentation for a library, framework, or API and return a s ## Usage ``` -/docs [library name] [question] +/ecc-docs [library name] [question] ``` -Use quotes for multi-word arguments so they are parsed as a single token. Example: `/docs "Next.js" "How do I configure middleware?"` +Use quotes for multi-word arguments so they are parsed as a single token. Example: `/ecc-docs "Next.js" "How do I configure middleware?"` If library or question is omitted, prompt the user for: 1. The library or product name (e.g. Next.js, Prisma, Supabase). From 4d58871b2b4d0617a73acd2f28fe39ca2b09617d Mon Sep 17 00:00:00 2001 From: Jamkris Date: Wed, 8 Apr 2026 14:14:30 +0900 Subject: [PATCH 23/24] refactor: simplify session-start hook by removing unused dependencies and redundant initialization logic --- scripts/hooks/session-start.js | 18 ++---------------- 1 file changed, 2 insertions(+), 16 deletions(-) diff --git a/scripts/hooks/session-start.js b/scripts/hooks/session-start.js index c59a039..6573250 100644 --- a/scripts/hooks/session-start.js +++ b/scripts/hooks/session-start.js @@ -12,30 +12,16 @@ const { getGeminiDir, getSessionsDir, getLearnedSkillsDir, - findFiles, ensureDir, log } = require('../lib/utils'); -const { getPackageManager } = require('../lib/package-manager'); -const { listAliases } = require('../lib/session-aliases'); const { runHook } = require('../lib/hook-utils'); runHook('SessionStart', async () => { - const sessionsDir = getSessionsDir(); - const learnedDir = getLearnedSkillsDir(); - // Ensure directories exist - ensureDir(sessionsDir); - ensureDir(learnedDir); - - // Initialize recent sessions, learned skills, and aliases (silent) - findFiles(sessionsDir, '*-session.tmp', { maxAge: 7 }); - findFiles(learnedDir, '*.md'); - listAliases({ limit: 5 }); - - // Detect package manager (silent) - getPackageManager(); + ensureDir(getSessionsDir()); + ensureDir(getLearnedSkillsDir()); // Command shims: only needed for manual installs (no extension). // When the extension is installed, Gemini CLI loads commands directly From 2a3bba4aa0e6d5a58c0ac37f2e03fd766dea5aaa Mon Sep 17 00:00:00 2001 From: Jamkris Date: Wed, 8 Apr 2026 14:17:07 +0900 Subject: [PATCH 24/24] chore: bump version to 1.2.3 --- .gemini-plugin/plugin.json | 2 +- gemini-extension.json | 2 +- package.json | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/.gemini-plugin/plugin.json b/.gemini-plugin/plugin.json index b36cdd3..7205b6c 100644 --- a/.gemini-plugin/plugin.json +++ b/.gemini-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "everything-gemini-code", - "version": "1.2.2", + "version": "1.2.3", "description": "Complete collection of battle-tested Gemini CLI configurations - agents, skills, hooks, and rules evolved over 10+ months of intensive daily use", "author": { "name": "Jamkris", diff --git a/gemini-extension.json b/gemini-extension.json index 15e8653..daf5029 100644 --- a/gemini-extension.json +++ b/gemini-extension.json @@ -1,6 +1,6 @@ { "name": "everything-gemini-code", - "version": "1.2.2", + "version": "1.2.3", "description": "Complete collection of Gemini CLI configurations adapted from everything-gemini-code - agents, skills, hooks, and rules", "author": { "name": "Jamkris", diff --git a/package.json b/package.json index eb5fbcf..af11cc2 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "everything-gemini-code", - "version": "1.2.2", + "version": "1.2.3", "private": true, "description": "Battle-tested Gemini CLI configurations", "author": "Jamkris",