feat: add Kilo CLI runtime support
This commit is contained in:
@@ -21,7 +21,7 @@
|
||||
|
||||
## 시스템 개요
|
||||
|
||||
GSD는 사용자와 AI 코딩 에이전트(Claude Code, Gemini CLI, OpenCode, Codex, Copilot, Antigravity) 사이에 위치하는 **메타 프롬프팅 프레임워크**입니다. 다음을 제공합니다.
|
||||
GSD는 사용자와 AI 코딩 에이전트(Claude Code, Gemini CLI, OpenCode, Kilo, Codex, Copilot, Antigravity) 사이에 위치하는 **메타 프롬프팅 프레임워크**입니다. 다음을 제공합니다.
|
||||
|
||||
1. **컨텍스트 엔지니어링** — 작업별로 AI에게 필요한 모든 것을 제공하는 구조화된 아티팩트
|
||||
2. **멀티 에이전트 오케스트레이션** — 새로운 컨텍스트 윈도우로 전문화된 에이전트를 생성하는 가벼운 오케스트레이터
|
||||
@@ -108,7 +108,7 @@ GSD는 사용자와 AI 코딩 에이전트(Claude Code, Gemini CLI, OpenCode, Co
|
||||
|
||||
사용자 대면 진입점입니다. 각 파일은 YAML 전문(name, description, allowed-tools)과 워크플로우를 부트스트랩하는 프롬프트 본문을 포함합니다. 명령어는 다음과 같이 설치됩니다.
|
||||
- **Claude Code:** 커스텀 슬래시 명령어 (`/gsd:command-name`)
|
||||
- **OpenCode:** 슬래시 명령어 (`/gsd-command-name`)
|
||||
- **OpenCode / Kilo:** 슬래시 명령어 (`/gsd-command-name`)
|
||||
- **Codex:** Skills (`$gsd-command-name`)
|
||||
- **Copilot:** 슬래시 명령어 (`/gsd:command-name`)
|
||||
- **Antigravity:** Skills
|
||||
@@ -362,6 +362,7 @@ UI-SPEC.md (per phase) ───────────────────
|
||||
|
||||
다른 런타임의 동등한 경로입니다.
|
||||
- **OpenCode:** `~/.config/opencode/` 또는 `~/.opencode/`
|
||||
- **Kilo:** `~/.config/kilo/` 또는 `~/.kilo/`
|
||||
- **Gemini CLI:** `~/.gemini/`
|
||||
- **Codex:** `~/.codex/` (명령어 대신 skills 사용)
|
||||
- **Copilot:** `~/.github/`
|
||||
@@ -425,12 +426,13 @@ UI-SPEC.md (per phase) ───────────────────
|
||||
|
||||
인스톨러(`bin/install.js`, ~3,000줄)는 다음을 처리합니다.
|
||||
|
||||
1. **런타임 감지** — 대화형 프롬프트 또는 CLI 플래그 (`--claude`, `--opencode`, `--gemini`, `--codex`, `--copilot`, `--antigravity`, `--all`)
|
||||
1. **런타임 감지** — 대화형 프롬프트 또는 CLI 플래그 (`--claude`, `--opencode`, `--gemini`, `--kilo`, `--codex`, `--copilot`, `--antigravity`, `--all`)
|
||||
2. **위치 선택** — 전역(`--global`) 또는 로컬(`--local`)
|
||||
3. **파일 배포** — commands, workflows, references, templates, agents, hooks 복사
|
||||
4. **런타임 적응** — 런타임별 파일 내용 변환.
|
||||
- Claude Code: 그대로 사용
|
||||
- OpenCode: 에이전트 전문을 `name:`, `model: inherit`, `mode: subagent`로 변환
|
||||
- OpenCode: 명령어/에이전트를 OpenCode 호환 플랫 명령어 + 서브에이전트 형식으로 변환
|
||||
- Kilo: Kilo 설정 경로로 OpenCode 변환 파이프라인을 재사용
|
||||
- Codex: commands에서 TOML config + skills 생성
|
||||
- Copilot: 도구 이름 매핑 (Read→read, Bash→execute 등)
|
||||
- Gemini: 훅 이벤트 이름 조정 (`PostToolUse` 대신 `AfterTool`)
|
||||
@@ -505,12 +507,13 @@ Runtime Engine (Claude Code / Gemini CLI)
|
||||
|
||||
## 런타임 추상화
|
||||
|
||||
GSD는 통합된 명령어/워크플로우 아키텍처를 통해 6개의 AI 코딩 런타임을 지원합니다.
|
||||
GSD는 통합된 명령어/워크플로우 아키텍처를 통해 여러 AI 코딩 런타임을 지원합니다.
|
||||
|
||||
| 런타임 | 명령어 형식 | 에이전트 시스템 | 설정 위치 |
|
||||
|---------|---------------|--------------|-----------------|
|
||||
| Claude Code | `/gsd:command` | Task 생성 | `~/.claude/` |
|
||||
| OpenCode | `/gsd-command` | Subagent 모드 | `~/.config/opencode/` |
|
||||
| Kilo | `/gsd-command` | Subagent 모드 | `~/.config/kilo/` |
|
||||
| Gemini CLI | `/gsd:command` | Task 생성 | `~/.gemini/` |
|
||||
| Codex | `$gsd-command` | Skills | `~/.codex/` |
|
||||
| Copilot | `/gsd:command` | 에이전트 위임 | `~/.github/` |
|
||||
|
||||
@@ -7,7 +7,7 @@
|
||||
## 명령어 문법
|
||||
|
||||
- **Claude Code / Gemini / Copilot:** `/gsd:command-name [args]`
|
||||
- **OpenCode:** `/gsd-command-name [args]`
|
||||
- **OpenCode / Kilo:** `/gsd-command-name [args]`
|
||||
- **Codex:** `$gsd-command-name [args]`
|
||||
|
||||
---
|
||||
|
||||
@@ -275,7 +275,7 @@ quick 태스크 브랜칭 예시:
|
||||
|
||||
유효한 재정의 값: `opus`, `sonnet`, `haiku`, `inherit`, 또는 완전히 정규화된 모델 ID (예: `"openai/o3"`, `"google/gemini-2.5-pro"`).
|
||||
|
||||
### 비 Claude 런타임 (Codex, OpenCode, Gemini CLI)
|
||||
### 비 Claude 런타임 (Codex, OpenCode, Gemini CLI, Kilo)
|
||||
|
||||
비 Claude 런타임에 GSD를 설치하면 인스톨러가 자동으로 `~/.gsd/defaults.json`에 `resolve_model_ids: "omit"`을 설정합니다. 이로 인해 GSD는 모든 에이전트에 빈 model 파라미터를 반환하며 각 에이전트는 런타임에 설정된 모델을 사용합니다. 기본 사용 시 추가 설정은 필요하지 않습니다.
|
||||
|
||||
@@ -310,7 +310,7 @@ quick 태스크 브랜칭 예시:
|
||||
|----|------|----------|
|
||||
| `false` (기본값) | Claude 별칭 반환 (`opus`, `sonnet`, `haiku`) | 네이티브 Anthropic API를 사용하는 Claude Code |
|
||||
| `true` | 별칭을 전체 Claude 모델 ID로 매핑 (`claude-opus-4-0`) | 전체 ID가 필요한 API를 사용하는 Claude Code |
|
||||
| `"omit"` | 빈 문자열 반환 (런타임이 기본값 선택) | 비 Claude 런타임 (Codex, OpenCode, Gemini CLI) |
|
||||
| `"omit"` | 빈 문자열 반환 (런타임이 기본값 선택) | 비 Claude 런타임 (Codex, OpenCode, Gemini CLI, Kilo) |
|
||||
|
||||
### 프로필 철학
|
||||
|
||||
|
||||
@@ -861,10 +861,10 @@ fix(03-01): correct auth token expiry
|
||||
|
||||
### 36. Multi-Runtime Support
|
||||
|
||||
**목적:** 6가지 다른 AI 코딩 에이전트 런타임에서 GSD를 실행합니다.
|
||||
**목적:** 여러 AI 코딩 에이전트 런타임에서 GSD를 실행합니다.
|
||||
|
||||
**요구사항.**
|
||||
- REQ-RUNTIME-01: Claude Code, OpenCode, Gemini CLI, Codex, Copilot, Antigravity를 지원해야 합니다.
|
||||
- REQ-RUNTIME-01: Claude Code, OpenCode, Gemini CLI, Kilo, Codex, Copilot, Antigravity를 지원해야 합니다.
|
||||
- REQ-RUNTIME-02: 설치 프로그램은 런타임별로 콘텐츠를 변환해야 합니다(도구 이름, 경로, 프론트매터).
|
||||
- REQ-RUNTIME-03: 설치 프로그램은 대화형 및 비대화형(`--claude --global`) 모드를 모두 지원해야 합니다.
|
||||
- REQ-RUNTIME-04: 설치 프로그램은 전역 및 로컬 설치를 모두 지원해야 합니다.
|
||||
@@ -873,12 +873,12 @@ fix(03-01): correct auth token expiry
|
||||
|
||||
**런타임 변환.**
|
||||
|
||||
| 측면 | Claude Code | OpenCode | Gemini | Codex | Copilot | Antigravity |
|
||||
|--------|------------|----------|--------|-------|---------|-------------|
|
||||
| 명령어 | 슬래시 명령어 | 슬래시 명령어 | 슬래시 명령어 | Skills(TOML) | 슬래시 명령어 | Skills |
|
||||
| 에이전트 형식 | Claude native | `mode: subagent` | Claude native | Skills | Tool mapping | Skills |
|
||||
| 훅 이벤트 | `PostToolUse` | N/A | `AfterTool` | N/A | N/A | N/A |
|
||||
| 구성 | `settings.json` | `opencode.json(c)` | `settings.json` | TOML | Instructions | Config |
|
||||
| 측면 | Claude Code | OpenCode | Gemini | Kilo | Codex | Copilot | Antigravity |
|
||||
|--------|------------|----------|--------|-------|-------|---------|-------------|
|
||||
| 명령어 | 슬래시 명령어 | 슬래시 명령어 | 슬래시 명령어 | 슬래시 명령어 | Skills(TOML) | 슬래시 명령어 | Skills |
|
||||
| 에이전트 형식 | Claude native | `mode: subagent` | Claude native | `mode: subagent` | Skills | Tool mapping | Skills |
|
||||
| 훅 이벤트 | `PostToolUse` | N/A | `AfterTool` | N/A | N/A | N/A | N/A |
|
||||
| 구성 | `settings.json` | `opencode.json(c)` | `settings.json` | `kilo.json(c)` | TOML | Instructions | Config |
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -580,7 +580,7 @@ GSD는 프로젝트 설정을 `.planning/config.json`에 저장합니다. `/gsd:
|
||||
- **quality** -- 모든 의사결정 에이전트에 Opus를 사용하고 읽기 전용 검증에 Sonnet을 사용합니다. 할당량이 충분하고 작업이 중요할 때 사용합니다.
|
||||
- **balanced** -- 아키텍처 결정이 이루어지는 계획에만 Opus를 사용하고 나머지는 Sonnet을 사용합니다. 합당한 이유로 기본값입니다.
|
||||
- **budget** -- 코드를 작성하는 모든 것에 Sonnet을 사용하고 조사 및 검증에 Haiku를 사용합니다. 대량 작업이나 덜 중요한 페이즈에 사용합니다.
|
||||
- **inherit** -- 모든 에이전트가 현재 세션 모델을 사용합니다. 동적으로 모델을 전환할 때 (예: OpenCode `/model`) 또는 예상치 못한 API 비용을 방지하기 위해 비Anthropic 공급자 (OpenRouter, 로컬 모델)와 함께 Claude Code를 사용할 때 적합합니다. 비Claude 런타임 (Codex, OpenCode, Gemini CLI)의 경우 설치 프로그램이 자동으로 `resolve_model_ids: "omit"`을 설정합니다 — [비Claude 런타임](#비claude-런타임-codex-opencode-gemini-cli-사용)을 참고하세요.
|
||||
- **inherit** -- 모든 에이전트가 현재 세션 모델을 사용합니다. 동적으로 모델을 전환할 때 (예: OpenCode 또는 Kilo `/model`) 또는 예상치 못한 API 비용을 방지하기 위해 비Anthropic 공급자 (OpenRouter, 로컬 모델)와 함께 Claude Code를 사용할 때 적합합니다. 비Claude 런타임 (Codex, OpenCode, Gemini CLI, Kilo)의 경우 설치 프로그램이 자동으로 `resolve_model_ids: "omit"`을 설정합니다 — [비Claude 런타임](#비claude-런타임-codex-opencode-gemini-cli-kilo-사용)을 참고하세요.
|
||||
|
||||
---
|
||||
|
||||
@@ -723,7 +723,7 @@ cd ~/gsd-workspaces/feature-b
|
||||
|
||||
예산 프로필로 전환하세요: `/gsd:set-profile budget`. 도메인이 익숙하다면 (또는 Claude에게 익숙하다면) `/gsd:settings`에서 조사 및 plan-check 에이전트를 비활성화하세요.
|
||||
|
||||
### 비Claude 런타임 사용 (Codex, OpenCode, Gemini CLI)
|
||||
### 비Claude 런타임 사용 (Codex, OpenCode, Gemini CLI, Kilo)
|
||||
|
||||
비Claude 런타임용으로 GSD를 설치했다면 설치 프로그램이 이미 모든 에이전트가 런타임의 기본 모델을 사용하도록 모델 해석을 구성했습니다. 수동 설정이 필요하지 않습니다. 구체적으로 설치 프로그램은 config에 `resolve_model_ids: "omit"`을 설정하여 GSD가 Anthropic 모델 ID 해석을 건너뛰고 런타임이 자체 기본 모델을 선택하도록 합니다.
|
||||
|
||||
@@ -740,9 +740,9 @@ cd ~/gsd-workspaces/feature-b
|
||||
}
|
||||
```
|
||||
|
||||
설치 프로그램은 Gemini CLI, OpenCode, Codex에 대해 `resolve_model_ids: "omit"`을 자동으로 구성합니다. 비Claude 런타임을 수동으로 설정하는 경우 직접 `.planning/config.json`에 추가하세요.
|
||||
설치 프로그램은 Gemini CLI, OpenCode, Kilo, Codex에 대해 `resolve_model_ids: "omit"`을 자동으로 구성합니다. 비Claude 런타임을 수동으로 설정하는 경우 직접 `.planning/config.json`에 추가하세요.
|
||||
|
||||
전체 설명은 [Configuration Reference](CONFIGURATION.md#non-claude-runtimes-codex-opencode-gemini-cli)를 참고하세요.
|
||||
전체 설명은 [Configuration Reference](CONFIGURATION.md#non-claude-runtimes-codex-opencode-gemini-cli-kilo)를 참고하세요.
|
||||
|
||||
### 비Anthropic 공급자와 함께 Claude Code 사용 (OpenRouter, 로컬)
|
||||
|
||||
|
||||
Reference in New Issue
Block a user