superpowers-mcp 6.3.4 → 6.3.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.ja.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  [English](README.md) | [繁體中文](README.zh-TW.md) | [日本語](README.ja.md) | [한국어](README.ko.md)
4
4
 
5
- [![バージョン](https://img.shields.io/badge/version-6.3.4-blue.svg)](https://github.com/Poseidoncode/superpowers-mcp)
5
+ [![バージョン](https://img.shields.io/badge/version-6.3.6-blue.svg)](https://github.com/Poseidoncode/superpowers-mcp)
6
6
  [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
7
7
 
8
8
  このドキュメントは、Superpowers スキルライブラリと自律型ワークフローを、独立した高パフォーマンスかつ安全な **Model Context Protocol (MCP)** サーバーにパッケージ化した使用説明書です。
@@ -13,8 +13,8 @@
13
13
 
14
14
  ### サポート環境とエージェントプラットフォーム
15
15
 
16
- - **AI コードエディター & IDE**: **Antigravity (AGY)**、**Cursor**、**VSCode** (GitHub Copilot)、**Devin Desktop**、**MiniMax Code Desktop**、**Codex**。
17
- - **AI デスクトップアプリ & ハーネス**: **Hermes Desktop**、**Kimi Work**。
16
+ - **AI コードエディター & IDE**: **Antigravity (AGY)**、**Cursor**、**VSCode** (GitHub Copilot)、**VSCode Insiders** (GitHub Copilot)、**Devin Desktop**、**Trae**、**Cline**、**Kilo Code**、**Qoder**、**Kiro**、**MiniMax Code Desktop**、**Codex**。
17
+ - **AI デスクトップアプリ & ハーネス**: **Claude Desktop**、**Pi Desktop**、**QwenPaw**、**Hermes Desktop**、**Kimi Work**。
18
18
  - **セルフホスト & ローカル AI プラットフォーム**: **AnythingLLM**、**LibreChat**。
19
19
 
20
20
  ### 提供される MCP 機能
@@ -56,10 +56,17 @@
56
56
  | **Pi Desktop / Pi Agent** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target pi-desktop` | `~/.pi/agent/mcp.json` |
57
57
  | **Cursor** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target cursor` | `~/.cursor/mcp.json` |
58
58
  | **GitHub Copilot (VS Code)** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target copilot` | `Code/User/mcp.json` *(VS Code `servers` 形式)* |
59
+ | **GitHub Copilot (VS Code Insiders)** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target copilot-insiders` | `Code - Insiders/User/mcp.json` *(VS Code `servers` 形式)* |
59
60
  | **Hermes Desktop / Agent** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target hermes` | `~/.hermes/config.yaml` *(Win: `%LOCALAPPDATA%\hermes`)* |
60
61
  | **Kimi Work / Kimi Code** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target kimi` | `~/.kimi-code/mcp.json` |
61
62
  | **Claude Desktop** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target claude` | `Claude/claude_desktop_config.json` |
62
63
  | **Devin Desktop (旧 Windsurf)** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target devin` | `~/.config/devin/mcp_config.json` *(または `windsurf`)* |
64
+ | **QwenPaw (パーソナル AI ワークステーション)** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target qwenpaw` | `~/.qwenpaw/config.json` *(別名: `copaw`)* |
65
+ | **Cline (VS Code / CLI)** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target cline` | `.../saoudrizwan.claude-dev/settings/cline_mcp_settings.json` |
66
+ | **Kilo Code** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target kilo` | `~/.config/kilo/kilo.jsonc` *(自適応 `mcp` 規格)* |
67
+ | **Qoder** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target qoder` | `~/.qoder/settings.json` |
68
+ | **Kiro** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target kiro` | `~/.kiro/settings/mcp.json` |
69
+ | **Trae** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target trae` | `.../Trae/User/mcp.json` *(Trae CN 対応)* |
63
70
 
64
71
  *(Bun を使用する場合は `--bun` を追加可能、例: `npx -y superpowers-mcp setup --target cursor --bun`)*
65
72
 
@@ -168,7 +175,47 @@ systematic-debugging ➔ using-git-worktrees ➔ dispatching-parallel-agents ➔
168
175
 
169
176
  ## 🆕 最近の更新
170
177
 
171
- ### v6.3.4(最新)
178
+ ### v6.3.6(最新)
179
+
180
+ - **極限のパフォーマンス最適化(2倍〜8.1倍の高速化)**:
181
+ - **スキルの並行インデックスと事前キャッシュ**:`SkillsManager.listSkills` を非同期並行ディレクトリ走査(`Promise.all`)とルートパス事前解決キャッシュにアップグレードし、コールドスタート時のインデックス遅延を 4.79ms から 2.35ms に短縮(**2.04倍の高速化**)。
182
+ - **超高速インメモリ Canonical キャッシュ**:`readSkillContent` において物理実パスをキーとする Canonical キャッシュとエイリアスマッピングを導入し、同一スキルの再読み込み時間を 0.013ms から 1.6µs に短縮(**8.1倍の高速化**)。
183
+ - **Frontmatter スライシングと ReDoS 防御**:`parseFrontmatter` においてファイル全体の一括正規表現走査を 64 KB のプレフィックスバッファ切り出しに置き換え、大規模ファイルでの GC 停止と二次関数的 ReDoS リスクを根絶。
184
+ - **JSON パース高速パス**:`stripJsonComments` (`src/setup-runner.ts`) にネイティブ JSON 試行を導入し、コメントのない設定ファイルの読み込み時間を 0.55µs に短縮(**5.1倍の高速化**)。
185
+ - **マルチターゲット並行ビルド**:`esbuild.js` で 4 つの独立アーティファクトを `Promise.all` で並行コンパイルし、ビルド時間を ~50ms に短縮(**~42% 高速化**)。
186
+ - **デュアル Subagent 深度コードレビューと包括的欠陥修正 (FIX ALL)**:
187
+ - **Partial-Read バッファ切り捨て防御**:`SkillsManager.readFileNoFollow` に累積読み込みループ(`while (totalRead < fileSize)`)を実装し、高負荷 I/O や仮想ファイルシステムでの暗黙の Markdown 切り捨てを防止。
188
+ - **Scan Epoch 並行競合シールド**:`listSkills` に単調増加の `scanEpoch` カウンタを導入し、非同期の古いスキャンが最新のキャッシュ状態を上書きするレースコンディションを解消。
189
+ - **Canonical キャッシュ整合性の保証**:実物理パス(`realFilePath`)をマスターキーとし、`canonicalPathMap` でエイリアスを追跡することで、強制リロード時のシンボリックリンクキャッシュ乖離(Cache Drift)を根絶。
190
+ - **システムディレクトリブラックリストの拡張**:`getSafeSkillsPath` に macOS 固有の `/private/etc` および `/private/var` を追加し、特権ディレクトリへのパスエスケープを防止。
191
+ - **設定書き込み時のシンボリックリンク先検証**:`safeWriteConfig` で `fs.lstat` と実パス解決を実施し、機密システム領域へのシンボリックリンク書き込みを拒絕。
192
+ - **厳格な TypeScript と Rule 7 ゼロ欠陥準拠**:未使用のデッドコード(`exists`)を完全削除し、`--noUnusedLocals --noUnusedParameters` に合格。型なし・空の catch ブロックをすべて排除。
193
+ - **自動化テストスイートの拡張と回帰検証**:
194
+ - 85 件のコアユニット/結合テストと 174 件の回帰アサーションが 100% 合格(`setup_test.js` は 33 件すべて合格)。[`SECURITY.md`](SECURITY.md)、[`tests/code_review_report.md`](tests/code_review_report.md)、[`tests/performance_optimization_report.md`](tests/performance_optimization_report.md) を整備。
195
+ - **多言語ドキュメントの同期**:
196
+ - 4 言語すべての README([`README.md`](README.md)、[`README.zh-TW.md`](README.zh-TW.md)、[`README.ja.md`](README.ja.md)、[`README.ko.md`](README.ko.md))でサポート環境一覧、パフォーマンス指標、ワンクリックコマンド表を同期。
197
+
198
+ ### v6.3.5
199
+
200
+ - **7 つの新しい AI エージェント・エディタ環境のワンクリックインストール対応 (`src/setup-runner.ts`, `scripts/install.sh`)**:
201
+ - 構成エンジンを拡張し、合計 15 種類の AI 開発環境に対応:
202
+ - **GitHub Copilot (VS Code Insiders)**:`Code - Insiders/User/mcp.json`(安定版 VS Code との競合を防ぐ物理パス完全分離、エイリアス: `copilot-insiders`, `vscode-insiders`, `code-insiders`, `insiders`, `insider`)
203
+ - **QwenPaw (パーソナル AI アシスタントワークステーション)**:`~/.qwenpaw/config.json`(`copaw` 互換、エイリアス: `qwenpaw`, `copaw`)
204
+ - **Cline (VS Code / CLI)**:`.../saoudrizwan.claude-dev/settings/cline_mcp_settings.json`(エイリアス: `cline`, `claude-dev`)
205
+ - **Kilo Code**:`~/.config/kilo/kilo.jsonc`(自適応 `"mcp"` ルート仕様、エイリアス: `kilo`, `kilocode`)
206
+ - **Qoder**:`~/.qoder/settings.json`(エイリアス: `qoder`)
207
+ - **Kiro**:`~/.kiro/settings/mcp.json`(エイリアス: `kiro`, `kiro-code`)
208
+ - **Trae**:`.../Trae/User/mcp.json`(macOS、Windows、Linux、Trae CN をクロスプラットフォームでサポート)
209
+ - Kilo Code 固有の辞書形式を適応する `"json-mcp"` フォーマットタイプを追加。
210
+ - `runSetup` を介して `harness.defaultConfig` からテンプレートを注入し、Single Source of Truth (SSOT) を確立。
211
+ - **デュアル Subagent によるアーキテクチャおよびコード品質レビュー**:
212
+ - 「アーキテクチャ・セキュリティレビュアー」と「品質・エッジケースレビュアー」の 2 人のエージェントによるレビューを実施。
213
+ - アトミック書き込み(`crypto.randomBytes(8)` + `flag: "wx"`)、シンボリックリンク防御、最小権限(`0o700`/`0o600`)、デフォルトのゼロディスク汚染を完全検証。
214
+ - プロジェクト全体のセキュリティ監査を完了し、[`SECURITY.md`](SECURITY.md) を更新(173 件の自動化アサーション 100% 合格)。
215
+ - **テストスイートの大幅拡充 (`tests/setup_test.js`)**:
216
+ - 単元テストを 21 件から 32 件に拡充(100% 合格)。Claude Desktop、Kimi Work、Hermes Desktop のエンドツーエンドサンドボックステストを追加。
217
+
218
+ ### v6.3.4
172
219
 
173
220
  - **Universal One-Click グローバルセットアップエンジン (`src/setup-runner.ts`, `scripts/`)**:
174
221
  - 8 大主要 AI 環境(Antigravity、Pi Desktop / Pi Agent、Cursor、GitHub Copilot (VS Code)、Hermes Desktop / Agent、Kimi Work / Kimi Code、Claude Desktop、Devin Desktop)向けの依存関係ゼロのワンクリック自動構成。
package/README.ko.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  [English](README.md) | [繁體中文](README.zh-TW.md) | [日本語](README.ja.md) | [한국어](README.ko.md)
4
4
 
5
- [![Version](https://img.shields.io/badge/version-6.3.4-blue.svg)](https://github.com/Poseidoncode/superpowers-mcp)
5
+ [![Version](https://img.shields.io/badge/version-6.3.6-blue.svg)](https://github.com/Poseidoncode/superpowers-mcp)
6
6
  [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
7
7
 
8
8
  이 문서는 Superpowers 스킬 라이브러리와 자율 에이전트 워크플로우를 독립적이고 고성능이며 안전한 **Model Context Protocol (MCP)** 서버로 패키징한 사용 지침을 요약한 것입니다.
@@ -13,8 +13,8 @@
13
13
 
14
14
  ### 지원 환경 및 에이전트 플랫폼
15
15
 
16
- - **AI 코드 편집기 & IDE**: **Antigravity (AGY)**, **Cursor**, **VSCode** (GitHub Copilot), **Devin Desktop**, **MiniMax Code Desktop**, **Codex**.
17
- - **AI 데스크톱 앱 & 에이전트 도구**: **Hermes Desktop**, **Kimi Work**.
16
+ - **AI 코드 편집기 & IDE**: **Antigravity (AGY)**, **Cursor**, **VSCode** (GitHub Copilot), **VSCode Insiders** (GitHub Copilot), **Devin Desktop**, **Trae**, **Cline**, **Kilo Code**, **Qoder**, **Kiro**, **MiniMax Code Desktop**, **Codex**.
17
+ - **AI 데스크톱 앱 & 에이전트 도구**: **Claude Desktop**, **Pi Desktop**, **QwenPaw**, **Hermes Desktop**, **Kimi Work**.
18
18
  - **자체 호스팅 & 로컬 AI 플랫폼**: **AnythingLLM**, **LibreChat**.
19
19
 
20
20
  ### 제공되는 MCP 프로토콜 기능
@@ -56,10 +56,17 @@
56
56
  | **Pi Desktop / Pi Agent** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target pi-desktop` | `~/.pi/agent/mcp.json` |
57
57
  | **Cursor** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target cursor` | `~/.cursor/mcp.json` |
58
58
  | **GitHub Copilot (VS Code)** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target copilot` | `Code/User/mcp.json` *(VS Code `servers` 형식)* |
59
+ | **GitHub Copilot (VS Code Insiders)** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target copilot-insiders` | `Code - Insiders/User/mcp.json` *(VS Code `servers` 형식)* |
59
60
  | **Hermes Desktop / Agent** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target hermes` | `~/.hermes/config.yaml` *(Win: `%LOCALAPPDATA%\hermes`)* |
60
61
  | **Kimi Work / Kimi Code** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target kimi` | `~/.kimi-code/mcp.json` |
61
62
  | **Claude Desktop** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target claude` | `Claude/claude_desktop_config.json` |
62
63
  | **Devin Desktop (구 Windsurf)** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target devin` | `~/.config/devin/mcp_config.json` *(또는 `windsurf`)* |
64
+ | **QwenPaw (개인 AI 워크스테이션)** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target qwenpaw` | `~/.qwenpaw/config.json` *(별칭: `copaw`)* |
65
+ | **Cline (VS Code / CLI)** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target cline` | `.../saoudrizwan.claude-dev/settings/cline_mcp_settings.json` |
66
+ | **Kilo Code** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target kilo` | `~/.config/kilo/kilo.jsonc` *(적응형 `mcp` 규격)* |
67
+ | **Qoder** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target qoder` | `~/.qoder/settings.json` |
68
+ | **Kiro** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target kiro` | `~/.kiro/settings/mcp.json` |
69
+ | **Trae** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target trae` | `.../Trae/User/mcp.json` *(Trae CN 지원)* |
63
70
 
64
71
  *(Bun을 선호하는 경우 `--bun`을 추가할 수 있습니다, 예: `npx -y superpowers-mcp setup --target cursor --bun`)*
65
72
 
@@ -168,7 +175,47 @@ systematic-debugging ➔ using-git-worktrees ➔ dispatching-parallel-agents ➔
168
175
 
169
176
  ## 🆕 최근 업데이트
170
177
 
171
- ### v6.3.4 (최신)
178
+ ### v6.3.6 (최신)
179
+
180
+ - **극한의 성능 최적화 (2배~8.1배 가속)**:
181
+ - **스킬 병렬 인덱싱 및 사전 캐싱**: `SkillsManager.listSkills`를 비동기 병렬 디렉토리 탐색(`Promise.all`)과 루트 경로 사전 확인 캐싱으로 업그레이드하여 콜드 스타트 인덱싱 지연 시간을 4.79ms에서 2.35ms로 단축(**2.04배 속도 향상**).
182
+ - **초고속 인메모리 Canonical 캐시**: `readSkillContent`에 물리 실제 경로 기반 Canonical 캐시 및 별칭 매핑을 도입하여 동일 스킬의 반복 읽기 시간을 0.013ms에서 1.6µs로 단축(**8.1배 속도 향상**).
183
+ - **Frontmatter 슬라이싱 및 ReDoS 방어**: `parseFrontmatter`에서 전체 파일 정규식 스캔을 64 KB 접두사 버퍼 슬라이싱으로 대체하여 대용량 파일에서의 GC 일시 중단 및 2차 ReDoS 위험을 원천 차단.
184
+ - **JSON 파싱 초고속 직통 경로**: `stripJsonComments` (`src/setup-runner.ts`)에 네이티브 JSON 파싱 시도를 도입하여 주석 없는 설정 파일 읽기 속도를 0.55µs로 단축(**5.1배 속도 향상**).
185
+ - **멀티 타깃 병렬 번들러**: `esbuild.js`에서 4개 독립 결과물을 `Promise.all`로 병렬 빌드하여 빌드 시간을 ~50ms로 단축(**~42% 속도 향상**).
186
+ - **듀얼 Subagent 심층 코드 리뷰 및 결함 전면 보강 (FIX ALL)**:
187
+ - **Partial-Read 버퍼 잘림 방어**: `SkillsManager.readFileNoFollow`에 누적 읽기 루프(`while (totalRead < fileSize)`)를 구현하여 높은 디스크 I/O 또는 가상 파일 시스템 환경에서의 무음 Markdown 잘림 방지.
188
+ - **Scan Epoch 동시성 경쟁 쉴드**: `listSkills`에 단조 증가 `scanEpoch` 카운터를 도입하여 비동기 백그라운드 스캔이 최신 캐시 상태를 덮어쓰는 경쟁 조건 제거.
189
+ - **Canonical 캐시 정합성 보장**: 물리 실제 경로(`realFilePath`)를 마스터 키로 사용하고 `canonicalPathMap`으로 별칭을 추적하여 강제 리로드 시 심볼릭 링크 캐시 드리프트(Cache Drift) 완벽 해결.
190
+ - **시스템 디렉토리 블랙리스트 확장**: `getSafeSkillsPath`에 macOS 고유의 `/private/etc` 및 `/private/var`를 추가하여 특권 디렉토리 경로 탈출 공격 방지.
191
+ - **설정 파일 쓰기 시 심볼릭 링크 대상 검증**: `safeWriteConfig`에서 `fs.lstat` 및 실제 경로 해석을 수행하여 민감한 시스템 영역을 가리키는 심볼릭 링크 쓰기 차단.
192
+ - **엄격한 TypeScript 및 Rule 7 무결점 준수**: 미사용 사장 코드(`exists`)를 완전히 제거하여 `--noUnusedLocals --noUnusedParameters` 통과, 모든 타입 미지정/빈 catch 블록 제거.
193
+ - **자동화 회귀 테스트 스위트 확장 및 검증**:
194
+ - 85개 핵심 단위/통합 테스트 및 174개 회귀 어서션 100% 통과(`setup_test.js` 33개 테스트 전체 통과). [`SECURITY.md`](SECURITY.md), [`tests/code_review_report.md`](tests/code_review_report.md), 그리고 [`tests/performance_optimization_report.md`](tests/performance_optimization_report.md) 정비.
195
+ - **다국어 문서 동기화**:
196
+ - 모든 언어의 README([`README.md`](README.md), [`README.zh-TW.md`](README.zh-TW.md), [`README.ja.md`](README.ja.md), [`README.ko.md`](README.ko.md))에서 지원 환경 목록, 성능 지표, 원클릭 명령 표 동기화.
197
+
198
+ ### v6.3.5
199
+
200
+ - **7개 신규 AI 에이전트 및 편집기 환경 원클릭 설치 지원 (`src/setup-runner.ts`, `scripts/install.sh`)**:
201
+ - 구성 엔진을 확장하여 총 15개 AI 개발 환경 지원:
202
+ - **GitHub Copilot (VS Code Insiders)**: `Code - Insiders/User/mcp.json` (안정 버전 VS Code와의 충돌을 원천 방지하는 독립 물리 경로 격리, 별칭: `copilot-insiders`, `vscode-insiders`, `code-insiders`, `insiders`, `insider`)
203
+ - **QwenPaw (개인 AI 어시스턴트 워크스테이션)**: `~/.qwenpaw/config.json` (`copaw` 호환, 별칭: `qwenpaw`, `copaw`)
204
+ - **Cline (VS Code / CLI)**: `.../saoudrizwan.claude-dev/settings/cline_mcp_settings.json` (별칭: `cline`, `claude-dev`)
205
+ - **Kilo Code**: `~/.config/kilo/kilo.jsonc` (적응형 `"mcp"` 루트 사양, 별칭: `kilo`, `kilocode`)
206
+ - **Qoder**: `~/.qoder/settings.json` (별칭: `qoder`)
207
+ - **Kiro**: `~/.kiro/settings/mcp.json` (별칭: `kiro`, `kiro-code`)
208
+ - **Trae**: `.../Trae/User/mcp.json` (macOS, Windows, Linux 및 Trae CN 크로스 플랫폼 지원)
209
+ - Kilo Code 고유의 딕셔너리 구조를 수용하는 `"json-mcp"` 형식 유형 추가.
210
+ - `runSetup`을 통해 `harness.defaultConfig`로부터 템플릿을 주입하여 Single Source of Truth (SSOT) 확립.
211
+ - **듀얼 Subagent 아키텍처 및 품질 코드 리뷰 (Code Review)**:
212
+ - '아키텍처 및 보안 검토자'와 '품질 및 엣지 케이스 검토자' 2개의 전문 에이전트로 리뷰 수행.
213
+ - 원자적 쓰기(`crypto.randomBytes(8)` + `flag: "wx"`), 심볼릭 링크 방어, 최소 권한(`0o700`/`0o600`), 기본 디스크 무오염 원칙 검증 완료.
214
+ - 프로젝트 전반의 보안 감사를 완료하고 [`SECURITY.md`](SECURITY.md) 갱신(173개 자동화 어서션 100% 통과).
215
+ - **테스트 스위트 대폭 확장 (`tests/setup_test.js`)**:
216
+ - 단위 테스트를 21개에서 32개로 확장(100% 통과). Claude Desktop, Kimi Work, Hermes Desktop에 대한 엔드투엔드 샌드박스 테스트 및 별칭 검증 완료.
217
+
218
+ ### v6.3.4
172
219
 
173
220
  - **Universal One-Click 글로벌 설정 엔진 (`src/setup-runner.ts`, `scripts/`)**:
174
221
  - 8대 주요 AI 개발 환경(Antigravity, Pi Desktop / Pi Agent, Cursor, GitHub Copilot (VS Code), Hermes Desktop / Agent, Kimi Work / Kimi Code, Claude Desktop, Devin Desktop)에 대한 무의존성 원클릭 자동 구성 지원.
package/README.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  [English](README.md) | [繁體中文](README.zh-TW.md) | [日本語](README.ja.md) | [한국어](README.ko.md)
4
4
 
5
- [![Version](https://img.shields.io/badge/version-6.3.4-blue.svg)](https://github.com/Poseidoncode/superpowers-mcp)
5
+ [![Version](https://img.shields.io/badge/version-6.3.6-blue.svg)](https://github.com/Poseidoncode/superpowers-mcp)
6
6
  [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
7
7
 
8
8
  This document summarizes the information and usage instructions for packaging the Superpowers skills and autonomous workflow system into an independent, high-performance, and secure **Model Context Protocol (MCP)** server.
@@ -13,8 +13,8 @@ This document summarizes the information and usage instructions for packaging th
13
13
 
14
14
  ### Supported Environments & Harnesses
15
15
 
16
- - **AI Code Editors & IDEs**: **Antigravity (AGY)**, **Cursor**, **VSCode** (GitHub Copilot), **Devin Desktop**, **MiniMax Code Desktop**, **Codex**.
17
- - **AI Desktop Applications & Harnesses**: **Hermes Desktop**, **Kimi Work**.
16
+ - **AI Code Editors & IDEs**: **Antigravity (AGY)**, **Cursor**, **VSCode** (GitHub Copilot), **VSCode Insiders** (GitHub Copilot), **Devin Desktop**, **Trae**, **Cline**, **Kilo Code**, **Qoder**, **Kiro**, **MiniMax Code Desktop**, **Codex**.
17
+ - **AI Desktop Applications & Harnesses**: **Claude Desktop**, **Pi Desktop**, **QwenPaw**, **Hermes Desktop**, **Kimi Work**.
18
18
  - **Local & Self-Hosted AI Platforms**: **AnythingLLM**, **LibreChat**.
19
19
 
20
20
  ### MCP Capabilities Provided
@@ -56,10 +56,17 @@ Select your client and run the corresponding command in your terminal:
56
56
  | **Pi Desktop / Pi Agent** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target pi-desktop` | `~/.pi/agent/mcp.json` |
57
57
  | **Cursor** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target cursor` | `~/.cursor/mcp.json` |
58
58
  | **GitHub Copilot (VS Code)** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target copilot` | `Code/User/mcp.json` *(VS Code `servers` schema)* |
59
+ | **GitHub Copilot (VS Code Insiders)** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target copilot-insiders` | `Code - Insiders/User/mcp.json` *(VS Code `servers` schema)* |
59
60
  | **Hermes Desktop / Agent** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target hermes` | `~/.hermes/config.yaml` *(Win: `%LOCALAPPDATA%\hermes`)* |
60
61
  | **Kimi Work / Kimi Code** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target kimi` | `~/.kimi-code/mcp.json` |
61
62
  | **Claude Desktop** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target claude` | `Claude/claude_desktop_config.json` |
62
63
  | **Devin Desktop (formerly Windsurf)** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target devin` | `~/.config/devin/mcp_config.json` *(or `windsurf`)* |
64
+ | **QwenPaw (Personal Agent Workstation)** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target qwenpaw` | `~/.qwenpaw/config.json` *(aliases: `copaw`)* |
65
+ | **Cline (VS Code / CLI)** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target cline` | `.../saoudrizwan.claude-dev/settings/cline_mcp_settings.json` |
66
+ | **Kilo Code** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target kilo` | `~/.config/kilo/kilo.jsonc` *(native `mcp` schema)* |
67
+ | **Qoder** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target qoder` | `~/.qoder/settings.json` |
68
+ | **Kiro** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target kiro` | `~/.kiro/settings/mcp.json` |
69
+ | **Trae** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target trae` | `.../Trae/User/mcp.json` *(supports Trae CN)* |
63
70
 
64
71
  *(If using Bun, append `--bun` for faster startup, e.g., `npx -y superpowers-mcp setup --target cursor --bun`)*
65
72
 
@@ -168,7 +175,47 @@ To help you choose the right skill, we have structured all 14 skills across the
168
175
 
169
176
  ## 🆕 Recent Updates
170
177
 
171
- ### v6.3.4 (Latest)
178
+ ### v6.3.6 (Latest)
179
+
180
+ - **Extreme Performance Optimization (2x~8.1x Speedup)**:
181
+ - **Parallel Skill Discovery**: Upgraded `SkillsManager.listSkills` to concurrent asynchronous directory traversal (`Promise.all`) combined with pre-resolved root path caching, cutting cold-start skill indexing latency from 4.79ms to 2.35ms (**2.04x speedup**).
182
+ - **High-Velocity In-Memory Canonical Caching**: Introduced canonical realpath-keyed caching with aliasing for `readSkillContent`, dropping repeated skill reads from 0.013ms to 1.6µs (**8.1x speedup**).
183
+ - **Frontmatter Slicing & ReDoS Defense**: Replaced full-document regular expression scans in `parseFrontmatter` with targeted 64 KB prefix buffer slices, eliminating GC pauses and quadratic ReDoS risks on large skill files.
184
+ - **JSON Parsing Fast-Path**: Implemented native JSON trial in `stripJsonComments` (`src/setup-runner.ts`), accelerating non-commented JSON configuration reads to 0.55µs (**5.1x speedup**).
185
+ - **Parallel Multi-Target Bundler**: Replaced sequential builds in `esbuild.js` with `Promise.all` across 4 build targets, reducing build time to ~50ms (**~42% speedup**).
186
+ - **Dual-Subagent Code Review & Comprehensive Quality Hardening (FIX ALL)**:
187
+ - **Partial-Read Buffer Truncation Defense**: Implemented an accumulator loop (`while (totalRead < fileSize)`) in `SkillsManager.readFileNoFollow`, ensuring full buffer delivery under high disk concurrency and slow storage systems.
188
+ - **Scan Epoch Concurrency Shield**: Added a monotonic `scanEpoch` counter in `listSkills` to prevent out-of-order asynchronous reloads from clobbering updated skill catalogs.
189
+ - **Canonical Path Cache Invalidation**: Unified cache indexing on physical canonical paths (`realFilePath`) and linked aliases in `canonicalPathMap`, completely eliminating symlink cache drift during force reloads.
190
+ - **System Blacklist Expansion**: Added macOS `/private/etc` and `/private/var` into `getSafeSkillsPath`, guarding against privilege directory pointer attacks.
191
+ - **Symlink Target Defense in Configuration Writes**: `safeWriteConfig` verifies `fs.lstat` and realpaths before writes, blocking symlinks pointing to sensitive system locations.
192
+ - **Strict TypeScript & Rule 7 Zero-Defect Compliance**: Cleaned up unused dead code (`exists`), enforced clean compilation under `--noUnusedLocals --noUnusedParameters`, and eliminated all unhandled or untyped empty catch blocks.
193
+ - **Automated Regression Suite Expansion**:
194
+ - All 85 core unit/integration tests and 174 regression assertions passing at 100% across all suites (`edge_cases_test.js`, `run_test.js`, `brainstorm_server_test.js`, `prompts_compositions_test.js`, and `setup_test.js` with 33 passed tests). Refreshed [`SECURITY.md`](SECURITY.md), [`tests/code_review_report.md`](tests/code_review_report.md), and [`tests/performance_optimization_report.md`](tests/performance_optimization_report.md).
195
+ - **Multilingual Documentation Alignment**:
196
+ - Synchronized supported harness directories, performance metrics, and one-click commands across all 4 localized READMEs ([`README.md`](README.md), [`README.zh-TW.md`](README.zh-TW.md), [`README.ja.md`](README.ja.md), [`README.ko.md`](README.ko.md)).
197
+
198
+ ### v6.3.5
199
+
200
+ - **7 New AI Agent & Editor Harnesses Support (`src/setup-runner.ts`, `scripts/install.sh`)**:
201
+ - Expanded universal one-click setup engine to support 7 additional AI developer platforms, bringing total coverage to 15 major AI environments:
202
+ - **GitHub Copilot (VS Code Insiders)** (`Code - Insiders/User/mcp.json`, strictly isolated physical configuration path preventing collisions with Stable VS Code, aliases: `copilot-insiders`, `vscode-insiders`, `code-insiders`, `insiders`, `insider`)
203
+ - **QwenPaw** (`~/.qwenpaw/config.json`, backward-compatible with `copaw`)
204
+ - **Cline** (`.../saoudrizwan.claude-dev/settings/cline_mcp_settings.json`, aliases: `cline`, `claude-dev`)
205
+ - **Kilo Code** (`~/.config/kilo/kilo.jsonc` with adaptive `"mcp"` root and array-based command schema, aliases: `kilo`, `kilocode`, `kilo-code`)
206
+ - **Qoder** (`~/.qoder/settings.json`, alias: `qoder`)
207
+ - **Kiro** (`~/.kiro/settings/mcp.json`, aliases: `kiro`, `kiro-code`)
208
+ - **Trae** (`.../Trae/User/mcp.json`, cross-platform support for macOS, Windows, Linux, and Trae CN)
209
+ - Added `"json-mcp"` schema format type to dynamically handle Kilo Code's unique dictionary structure.
210
+ - Enforced Single Source of Truth (SSOT) by wiring `harness.defaultConfig(cmd, args)` directly through `runSetup` into `updateJsonConfig`.
211
+ - **Dual-Subagent Architectural & Code Quality Review**:
212
+ - Dispatched specialized Architectural & Security Reviewer and Quality & Edge-Case Reviewer subagents.
213
+ - Verified atomic writes (`crypto.randomBytes(8)` + `flag: "wx"`), symlink containment, least-privilege permissions (`0o700`/`0o600`), and zero-pollution disk defaults across all 15 harnesses.
214
+ - Completed comprehensive project-wide security review with 173 automated regression test assertions.
215
+ - **Automated Test Suite Expansion (`tests/setup_test.js`)**:
216
+ - Expanded setup regression tests from 21 to 32 tests (100% pass rate), adding end-to-end sandbox creation, aliases, and update assertions for Claude Desktop, Kimi Work, and Hermes Desktop.
217
+
218
+ ### v6.3.4
172
219
 
173
220
  - **Universal One-Click Global Setup Engine (`src/setup-runner.ts`, `scripts/`)**:
174
221
  - One-click zero-dependency configuration for 8 major AI environments: Antigravity, Pi Desktop / Pi Agent, Cursor, GitHub Copilot (VS Code), Hermes Desktop / Agent, Kimi Work / Kimi Code, Claude Desktop, and Devin Desktop.
package/README.zh-TW.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  [English](README.md) | [繁體中文](README.zh-TW.md) | [日本語](README.ja.md) | [한국어](README.ko.md)
4
4
 
5
- [![版本](https://img.shields.io/badge/version-6.3.4-blue.svg)](https://github.com/Poseidoncode/superpowers-mcp)
5
+ [![版本](https://img.shields.io/badge/version-6.3.6-blue.svg)](https://github.com/Poseidoncode/superpowers-mcp)
6
6
  [![授權](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
7
7
 
8
8
  本文檔總結了將 Superpowers 技能庫與自主 Agent 工作流架構打包成獨立、高效能且安全加固的 **Model Context Protocol (MCP)** 伺服器之相關資訊與使用說明。
@@ -13,8 +13,8 @@
13
13
 
14
14
  ### 支援的環境與 Agent 平台
15
15
 
16
- - **AI 程式碼編輯器與 IDE**:**Antigravity (AGY)**、**Cursor**、**VSCode**(GitHub Copilot)、**Devin Desktop**、**MiniMax Code Desktop**、**Codex**。
17
- - **AI 桌面應用與 Agent 工具**:**Hermes Desktop**、**Kimi Work**。
16
+ - **AI 程式碼編輯器與 IDE**:**Antigravity (AGY)**、**Cursor**、**VSCode**(GitHub Copilot)、**VSCode Insiders**(GitHub Copilot)、**Devin Desktop**、**Trae**、**Cline**、**Kilo Code**、**Qoder**、**Kiro**、**MiniMax Code Desktop**、**Codex**。
17
+ - **AI 桌面應用與 Agent 工具**:**Claude Desktop**、**Pi Desktop**、**QwenPaw**、**Hermes Desktop**、**Kimi Work**。
18
18
  - **開源與私有化 AI 平台**:**AnythingLLM**、**LibreChat**。
19
19
 
20
20
  ### 提供之 MCP 協議功能
@@ -56,10 +56,17 @@
56
56
  | **Pi Desktop / Pi Agent** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target pi-desktop` | `~/.pi/agent/mcp.json` |
57
57
  | **Cursor** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target cursor` | `~/.cursor/mcp.json` |
58
58
  | **GitHub Copilot (VS Code)** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target copilot` | `Code/User/mcp.json` *(VS Code `servers` 格式)* |
59
+ | **GitHub Copilot (VS Code Insiders)** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target copilot-insiders` | `Code - Insiders/User/mcp.json` *(VS Code `servers` 格式)* |
59
60
  | **Hermes Desktop / Agent** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target hermes` | `~/.hermes/config.yaml` *(Win: `%LOCALAPPDATA%\hermes`)* |
60
61
  | **Kimi Work / Kimi Code** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target kimi` | `~/.kimi-code/mcp.json` |
61
62
  | **Claude Desktop** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target claude` | `Claude/claude_desktop_config.json` |
62
63
  | **Devin Desktop (原 Windsurf)** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target devin` | `~/.config/devin/mcp_config.json` *(或 `windsurf`)* |
64
+ | **QwenPaw (個人 AI 助理工作站)** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target qwenpaw` | `~/.qwenpaw/config.json` *(相容 `copaw`)* |
65
+ | **Cline (VS Code / CLI)** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target cline` | `.../saoudrizwan.claude-dev/settings/cline_mcp_settings.json` |
66
+ | **Kilo Code** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target kilo` | `~/.config/kilo/kilo.jsonc` *(自適應 `mcp` 規格)* |
67
+ | **Qoder** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target qoder` | `~/.qoder/settings.json` |
68
+ | **Kiro** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target kiro` | `~/.kiro/settings/mcp.json` |
69
+ | **Trae** | macOS / Windows / Linux | `npx -y superpowers-mcp setup --target trae` | `.../Trae/User/mcp.json` *(支援 Trae CN)* |
63
70
 
64
71
  *(若偏好使用 Bun,指令可加上 `--bun`,例如 `npx -y superpowers-mcp setup --target cursor --bun`)*
65
72
 
@@ -168,7 +175,47 @@ systematic-debugging ➔ using-git-worktrees ➔ dispatching-parallel-agents ➔
168
175
 
169
176
  ## 🆕 最近更新
170
177
 
171
- ### v6.3.4 (最新版)
178
+ ### v6.3.6 (最新版)
179
+
180
+ - **極致效能躍升優化 (2x~8.1x 加速)**:
181
+ - **並行技能索引與快取前置**:`SkillsManager.listSkills` 升級為非同步並行目錄遍歷 (`Promise.all`) 搭配根目錄預解析快取,冷啟動技能索引延遲由 4.79ms 銳減至 2.35ms(**2.04x 速度提升**)。
182
+ - **極速記憶體 Canonical 快取**:針對 `readSkillContent` 引入以實體真實路徑為鍵的 Canonical 快取與別名映射機制,二次技能讀取由 0.013ms 驟降至 1.6µs(**8.1x 速度提升**)。
183
+ - **Frontmatter 切片與 ReDoS 防護**:`parseFrontmatter` 改以 64 KB 前綴緩衝區局部切片取代全檔正則匹配,徹底消除大檔案 GC 停頓與二次方 ReDoS 風險。
184
+ - **JSON 解析高速直通路徑**:在 `stripJsonComments` (`src/setup-runner.ts`) 引入原生 JSON 嘗試,無註解設定檔讀取速度提升至 0.55µs(**5.1x 速度提升**)。
185
+ - **並行多目標打包編譯**:`esbuild.js` 採用 `Promise.all` 並行編譯 4 大產物,全專案打包時間降至 ~50ms(**~42% 速度提升**)。
186
+ - **雙子 Subagent 深度 Code Review 與全面缺陷加固 (FIX ALL)**:
187
+ - **Partial-Read 緩衝區截斷防禦**:`SkillsManager.readFileNoFollow` 實作累加式讀取迴圈(`while (totalRead < fileSize)`),杜絕高併發磁碟 I/O 或虛擬檔案系統下的無聲截斷。
188
+ - **Scan Epoch 並發版本防護**:`listSkills` 引入遞增的 `scanEpoch` 代數計數器,防止背景慢速掃描覆寫較新的快取狀態。
189
+ - **Canonical 快取一致性保證**:以實體真實路徑 (`realFilePath`) 為核心鍵值並透過 `canonicalPathMap` 維護別名映射,徹底消除符號連結別名的快取漂移 (Cache Drift)。
190
+ - **系統黑名單防禦擴展**:`getSafeSkillsPath` 補齊 macOS `/private/etc` 與 `/private/var`,杜絕攻擊者透過環境變數逃逸至敏感系統目錄。
191
+ - **設定檔寫入符號連結逃逸防禦**:`safeWriteConfig` 在寫入前透過 `fs.lstat` 與真實路徑解析,嚴格拒絕指向敏感系統路徑的符號連結偽造寫入。
192
+ - **嚴格 TypeScript 與 Rule 7 零瑕疵合規**:徹底清理廢棄死代碼(`exists` 私有方法),全面通過 `--noUnusedLocals --noUnusedParameters`,並消除全專案所有無型別/空白 catch 區塊。
193
+ - **自動化測試套件擴充與基準回歸**:
194
+ - 全套件 85 項核心單元/端到端測試與 174 項回歸斷言 100% 通過(包含 `setup_test.js` 33 項測試全部通過),並產出 [`SECURITY.md`](SECURITY.md)、[`tests/code_review_report.md`](tests/code_review_report.md) 與 [`tests/performance_optimization_report.md`](tests/performance_optimization_report.md)。
195
+ - **多語系文檔全面對齊**:
196
+ - 4 語系 README([`README.md`](README.md)、[`README.zh-TW.md`](README.zh-TW.md)、[`README.ja.md`](README.ja.md)、[`README.ko.md`](README.ko.md))同步支援環境清單、效能指標與一鍵指令表格。
197
+
198
+ ### v6.3.5
199
+
200
+ - **新增 7 款主流 AI 開發環境一鍵安裝 (`src/setup-runner.ts`, `scripts/install.sh`)**:
201
+ - 全域配置引擎支援擴充至 15 款 AI Agent 與 IDE 環境:
202
+ - **GitHub Copilot (VS Code Insiders)**:`Code - Insiders/User/mcp.json`(具備實體路徑完全隔離,避免與正式版 VS Code 互相覆寫,別名 `copilot-insiders`, `vscode-insiders`, `code-insiders`, `insiders`, `insider`)
203
+ - **QwenPaw (個人 AI 助理工作站)**:`~/.qwenpaw/config.json`(相容舊版 `~/.copaw/config.json`,別名 `qwenpaw`, `copaw`)
204
+ - **Cline (VS Code / CLI)**:`.../saoudrizwan.claude-dev/settings/cline_mcp_settings.json`(別名 `cline`, `claude-dev`)
205
+ - **Kilo Code**:`~/.config/kilo/kilo.jsonc`(自適應 `"mcp"` root 與陣列 command 規格,別名 `kilo`, `kilocode`)
206
+ - **Qoder**:`~/.qoder/settings.json`(別名 `qoder`)
207
+ - **Kiro**:`~/.kiro/settings/mcp.json`(別名 `kiro`, `kiro-code`)
208
+ - **Trae**:`.../Trae/User/mcp.json`(跨平台支援 macOS、Windows、Linux 與 Trae CN)
209
+ - 新增 `"json-mcp"` 設定格式型別,精確相容 Kilo Code 特有字典規格。
210
+ - 落實 Single Source of Truth (SSOT),全面由 `runSetup` 透過 `harness.defaultConfig` 動態注入設定範本。
211
+ - **雙子 Subagent 架構與安全品質審查 (Code Review)**:
212
+ - 派出專職「架構與安全性審查員」與「代碼品質與邊界審查員」雙代理審查。
213
+ - 全數驗證原子置換(`crypto.randomBytes(8)` + `flag: "wx"`)、Symlink 邊界防禦、最小目錄權限 `0o700` / 檔案權限 `0o600`,以及全環境預設零磁碟污染原則。
214
+ - 完成專案全面安全掃描與審計,更新 [`SECURITY.md`](SECURITY.md)(173 項自動化回歸斷言 100% 通過)。
215
+ - **自動化測試套件擴充 (`tests/setup_test.js`)**:
216
+ - 單元測試由 21 項大幅擴增至 32 項(100% 通過),補齊 Claude Desktop、Kimi Work 與 Hermes Desktop 的端到端沙盒測試與別名驗證。
217
+
218
+ ### v6.3.4
172
219
 
173
220
  - **Universal One-Click 全域安裝引擎 (`src/setup-runner.ts`, `scripts/`)**:
174
221
  - 支援 8 大主流 AI 開發環境的一鍵零依賴配置:Antigravity、Pi Desktop / Pi Agent、Cursor、GitHub Copilot (VS Code)、Hermes Desktop / Agent、Kimi Work / Kimi Code、Claude Desktop 與 Devin Desktop。