superpowers-mcp 6.4.7 → 6.4.8

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.
Files changed (61) hide show
  1. package/README.es.md +19 -3
  2. package/README.hi.md +19 -3
  3. package/README.ja.md +19 -3
  4. package/README.ko.md +19 -3
  5. package/README.md +20 -4
  6. package/README.pt-BR.md +19 -3
  7. package/README.zh-TW.md +19 -3
  8. package/docs/maintainers/upstream-sync.md +4 -0
  9. package/docs/skill-compositions.es.md +1 -1
  10. package/docs/skill-compositions.hi.md +1 -1
  11. package/docs/skill-compositions.ja.md +1 -1
  12. package/docs/skill-compositions.ko.md +1 -1
  13. package/docs/skill-compositions.md +1 -1
  14. package/docs/skill-compositions.pt-BR.md +1 -1
  15. package/docs/skill-compositions.zh-TW.md +1 -1
  16. package/out/server.js +147 -109
  17. package/out/setup-runner.js +50 -37
  18. package/out/setup.js +50 -37
  19. package/package.json +6 -5
  20. package/scripts/copy-skills.js +65 -6
  21. package/scripts/install.ps1 +11 -2
  22. package/scripts/install.sh +7 -1
  23. package/scripts/run-tests.js +126 -13
  24. package/scripts/setup.js +100 -11
  25. package/scripts/upstream-drift.js +31 -8
  26. package/skills/brainstorming/SKILL.md +24 -2
  27. package/skills/brainstorming/builder-check-prompt.md +23 -0
  28. package/skills/brainstorming/scripts/helper.js +2 -1
  29. package/skills/brainstorming/scripts/server.cjs +38 -10
  30. package/skills/brainstorming/scripts/start-server.ps1 +7 -3
  31. package/skills/brainstorming/scripts/start-server.sh +30 -6
  32. package/skills/brainstorming/scripts/stop-server.ps1 +10 -4
  33. package/skills/brainstorming/scripts/stop-server.sh +16 -10
  34. package/skills/diagnosing-superpowers/SKILL.md +6 -3
  35. package/skills/diagnosing-superpowers/references/github-issues.md +3 -3
  36. package/skills/diagnosing-superpowers/templates/issue.md +23 -4
  37. package/skills/executing-plans/SKILL.md +18 -12
  38. package/skills/executing-plans/scripts/task-done +14 -5
  39. package/skills/executing-plans/scripts/task-done.ps1 +34 -12
  40. package/skills/executing-plans/scripts/task-start +16 -4
  41. package/skills/executing-plans/scripts/task-start.ps1 +9 -4
  42. package/skills/requesting-code-review/SKILL.md +1 -1
  43. package/skills/subagent-driven-development/SKILL.md +24 -15
  44. package/skills/subagent-driven-development/re-review-prompt.md +1 -1
  45. package/skills/subagent-driven-development/scripts/review-package +23 -17
  46. package/skills/subagent-driven-development/scripts/review-package.ps1 +41 -27
  47. package/skills/subagent-driven-development/scripts/sdd-repo +44 -0
  48. package/skills/subagent-driven-development/scripts/sdd-repo.ps1 +74 -0
  49. package/skills/subagent-driven-development/scripts/sdd-workspace +20 -11
  50. package/skills/subagent-driven-development/scripts/sdd-workspace.ps1 +38 -27
  51. package/skills/subagent-driven-development/scripts/task-brief +74 -11
  52. package/skills/subagent-driven-development/scripts/task-brief.ps1 +89 -17
  53. package/skills/subagent-driven-development/task-reviewer-prompt.md +2 -4
  54. package/skills/systematic-debugging/SKILL.md +2 -2
  55. package/skills/writing-skills/render-graphs.js +4 -3
  56. package/skills/brainstorming/spec-document-reviewer-prompt.md +0 -50
  57. package/skills/systematic-debugging/CREATION-LOG.md +0 -119
  58. package/skills/systematic-debugging/test-academic.md +0 -14
  59. package/skills/systematic-debugging/test-pressure-1.md +0 -58
  60. package/skills/systematic-debugging/test-pressure-2.md +0 -68
  61. package/skills/systematic-debugging/test-pressure-3.md +0 -69
package/README.es.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  [English](README.md) | [繁體中文](README.zh-TW.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [Español](README.es.md) | [Português (BR)](README.pt-BR.md) | [हिन्दी](README.hi.md)
4
4
 
5
- [![Versión](https://img.shields.io/badge/version-6.4.7-blue.svg)](https://github.com/Poseidoncode/superpowers-mcp)
5
+ [![Versión](https://img.shields.io/badge/version-6.4.8-blue.svg)](https://github.com/Poseidoncode/superpowers-mcp)
6
6
  [![Licencia](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
7
7
 
8
8
  Este documento resume la información y las instrucciones de uso para empaquetar las habilidades (skills) de Superpowers y el sistema de flujos de trabajo autónomos en un servidor **Model Context Protocol (MCP)** independiente, de alto rendimiento y seguro.
@@ -22,7 +22,7 @@ Este documento resume la información y las instrucciones de uso para empaquetar
22
22
  | Función del protocolo | Elementos / Cantidad | Descripción |
23
23
  | :--- | :--- | :--- |
24
24
  | **Tools** | `list_skills`, `read_skill` | Descubre, busca y carga las instrucciones completas y listas de verificación de cada skill bajo demanda. |
25
- | **Prompts** | 9 Native Prompts | `session-start`, `feature-pipeline`, `structured-debug`, `skill-composition`, `sdd-implementer`, `sdd-task-reviewer`, `sdd-re-review`, `spec-reviewer`, `plan-reviewer` |
25
+ | **Prompts** | 9 Native Prompts | `session-start`, `feature-pipeline`, `structured-debug`, `skill-composition`, `sdd-implementer`, `sdd-task-reviewer`, `sdd-re-review`, `builder-check`, `plan-reviewer` |
26
26
  | **Resources** | 15 Skill URIs + 1 Guide | `skill://superpowers/<skill-name>` además de `guide://superpowers/skill-compositions` |
27
27
 
28
28
  ### Conversar con el agente de IA (uso básico)
@@ -88,6 +88,9 @@ Selecciona tu cliente y ejecuta el comando correspondiente en tu terminal:
88
88
  & ([scriptblock]::Create((irm https://raw.githubusercontent.com/Poseidoncode/superpowers-mcp/main/scripts/install.ps1))) -Target cursor
89
89
  ```
90
90
 
91
+ > [!IMPORTANT]
92
+ > **Seguridad**: el servidor MCP no tiene autenticación a nivel de aplicación (modelo de confianza stdio local). Los instaladores por tubería `curl`/`irm` siguen la rama mutable `main`; prefiera clonar el repositorio y ejecutar `./scripts/install.sh` / `.\scripts\install.ps1`, o fije un tag de release. Los directorios `SKILLS_PATH` personalizados se tratan como instrucciones de agente de confianza. Detalles en [`SECURITY.md`](SECURITY.md).
93
+
91
94
  #### Opciones avanzadas:
92
95
  - `--dry-run`: Muestra los cambios sin escribir en disco.
93
96
  - `--remove`: Elimina de forma segura la configuración de Superpowers del cliente seleccionado.
@@ -179,7 +182,20 @@ Para ayudarte a elegir el skill adecuado, hemos estructurado los 15 skills a lo
179
182
 
180
183
  ## 🆕 Novedades recientes
181
184
 
182
- ### v6.4.7 (versión actual)
185
+ ### v6.4.8 (última versión)
186
+
187
+ - **Límites de respuesta al cliente MCP**: el cuerpo inline de las skills se limita a **20 KB** en `read_skill`, `list_skills`, resources y la guía de compositions para que un `SKILL.md` enorme no agote el contexto del agente (`tests/client_truncation_test.js`).
188
+ - **Detección de reemplazo del directorio raíz** (`EROOTCHANGED`): se registra el inode del directorio de skills al arrancar; si `SKILLS_PATH` se sustituye sin reiniciar el servidor MCP, listados y lecturas en caliente fallan de forma segura con aviso de reinicio (edge-cases Test 15).
189
+ - **Higiene de errores hacia el cliente**: `read_skill`, plantillas de prompt y la guía de compositions devuelven errores MCP genéricos; las rutas del sistema de archivos solo van a `stderr` (mcp_coverage Test 3c).
190
+ - **Modelo de confianza y cadena de suministro**: threat model en [SECURITY.md](SECURITY.md), avisos de instalación en el README, notificaciones de confianza en `stderr` al iniciar el servidor y advertencias en instaladores por tubería/registry.
191
+ - **Correcciones de caché de skills**: `forceReload` descarta cuerpos en caché antes del rescan sin perder la huella del directorio; el presupuesto de caché usa longitud en bytes UTF-8.
192
+ - **Helpers SDD más seguros y portables**: fallan de forma segura fuera de un worktree de Git, resuelven las rutas respecto al worktree en ejecución y, cuando está disponible, permiten elegir otro checkout con `-C DIR`. Los helpers que registran una base requieren un `HEAD` de Git resoluble (crea primero un commit inicial). Se mantienen las variantes de PowerShell.
193
+ - **Resúmenes de tarea más fiables**: los ID aceptan segmentos alfanuméricos separados por puntos (con al menos un dígito); si un bloque de código sin cerrar puede truncar el resumen, la extracción falla de forma segura.
194
+ - **Paquete de skills más limpio**: los fixtures de presión de systematic-debugging y su registro de creación se trasladaron a `tests/`, con una prueba estructural que evita incluirlos en las skills instaladas.
195
+ - **Mejores informes de problemas**: `diagnosing-superpowers` exige el contexto de quien informa y un resumen escrito por una persona, rechaza los textos de marcador de posición y usa la plantilla upstream actual `bug_report.md`.
196
+ - Verificación (ejecución local): `npm run build` pasó. `npm test` no está verde: pasaron 15/23 suites, 7 suites de PowerShell se omitieron porque `pwsh` no está disponible y `tests/setup_test.js` tuvo 3 fallos (69 pruebas pasaron). Consulta los casos fallidos en [CHANGELOG.md](CHANGELOG.md); la suite completa no pasó en esta ejecución.
197
+
198
+ ### v6.4.7
183
199
 
184
200
  - **Escaneo completo de seguridad del proyecto (2026-10-09)**: `src/*.ts`, el servidor companion de brainstorming, `scripts/`, `esbuild.js`, integridad del empaquetado npm y del lockfile, higiene de secretos y permisos, y todas las suites automatizadas. Controles base reverificados limpios — 0 `eval` / `new Function` / `innerHTML` / `document.write` / `shell: true` en el código distribuido, `child_process` solo por argv, 0 secretos hardcodeados, 0 archivos world-writable versionados (detalles en [SECURITY.md](SECURITY.md)).
185
201
  - **`--remove` podría reportar éxito mientras sobrevivía una entrada MCP activa** (CWE-459, reproducido por ejecución): TOML conserva todas las tablas de array `[[mcp_servers.superpowers]]` salvo la última y deja huérfana `[[mcp_servers.superpowers.env]]`; JSON solo limpia la primera clave raíz que contiene una entrada `superpowers`; la eliminación en YAML es un no-op sobre un mapa de flujo poblado `superpowers: {…}`. Por tanto, un `command` elegido por quien llama sigue auto-lanzándose tras una desinstalación que reportó éxito.
package/README.hi.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  [English](README.md) | [繁體中文](README.zh-TW.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [Español](README.es.md) | [Português (BR)](README.pt-BR.md) | [हिन्दी](README.hi.md)
4
4
 
5
- [![संस्करण](https://img.shields.io/badge/version-6.4.7-blue.svg)](https://github.com/Poseidoncode/superpowers-mcp)
5
+ [![संस्करण](https://img.shields.io/badge/version-6.4.8-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 skills लाइब्रेरी और स्वायत्त वर्कफ़्लो सिस्टम को एक स्वतंत्र, उच्च-प्रदर्शन और सुरक्षित **Model Context Protocol (MCP)** सर्वर के रूप में पैकेज करने की जानकारी और उपयोग निर्देशों का सारांश है।
@@ -22,7 +22,7 @@
22
22
  | प्रोटोकॉल सुविधा | आइटम / संख्या | विवरण |
23
23
  | :--- | :--- | :--- |
24
24
  | **Tools** | `list_skills`, `read_skill` | माँग पर हर skill के पूर्ण निर्देश और चेकलिस्ट खोजें, पढ़ें और लोड करें। |
25
- | **Prompts** | 9 Native Prompts | `session-start`, `feature-pipeline`, `structured-debug`, `skill-composition`, `sdd-implementer`, `sdd-task-reviewer`, `sdd-re-review`, `spec-reviewer`, `plan-reviewer` |
25
+ | **Prompts** | 9 Native Prompts | `session-start`, `feature-pipeline`, `structured-debug`, `skill-composition`, `sdd-implementer`, `sdd-task-reviewer`, `sdd-re-review`, `builder-check`, `plan-reviewer` |
26
26
  | **Resources** | 15 Skill URIs + 1 Guide | `skill://superpowers/<skill-name>` तथा `guide://superpowers/skill-compositions` |
27
27
 
28
28
  ### AI एजेंट से बातचीत (बुनियादी उपयोग)
@@ -88,6 +88,9 @@ ChatWise और Cherry Studio में मैन्युअल इम्पो
88
88
  & ([scriptblock]::Create((irm https://raw.githubusercontent.com/Poseidoncode/superpowers-mcp/main/scripts/install.ps1))) -Target cursor
89
89
  ```
90
90
 
91
+ > [!IMPORTANT]
92
+ > **सुरक्षा**: MCP सर्वर में एप्लिकेशन-स्तर प्रमाणीकरण नहीं है (स्थानीय stdio विश्वास मॉडल)। पाइप किए गए `curl`/`irm` इंस्टॉलर परिवर्तनशील `main` का अनुसरण करते हैं; रिपॉज़िटरी clone करके `./scripts/install.sh` / `.\scripts\install.ps1` चलाएँ, या release टैग पिन करें। कस्टम `SKILLS_PATH` निर्देशिकाएँ पूर्णतः विश्वसनीय agent निर्देश मानी जाती हैं। विवरण: [`SECURITY.md`](SECURITY.md).
93
+
91
94
  #### उन्नत फ़्लैग:
92
95
  - `--dry-run`: डिस्क पर लिखे बिना बदलावों का पूर्वावलोकन करें।
93
96
  - `--remove`: लक्षित क्लाइंट से Superpowers कॉन्फ़िगरेशन सुरक्षित रूप से हटाएँ।
@@ -179,7 +182,20 @@ systematic-debugging ➔ using-git-worktrees ➔ dispatching-parallel-agents ➔
179
182
 
180
183
  ## 🆕 हाल के अपडेट
181
184
 
182
- ### v6.4.7 (नवीनतम)
185
+ ### v6.4.8 (नवीनतम)
186
+
187
+ - **MCP क्लाइंट प्रतिक्रिया सीमा**: `read_skill`, `list_skills`, स्किल resources और compositions guide के इनलाइन बॉडी **20 KB** पर सीमित, ताकि एक विशाल `SKILL.md` एजेंट संदर्भ न खत्म करे (`tests/client_truncation_test.js`).
188
+ - **स्किल रूट बदलाव पहचान** (`EROOTCHANGED`): स्टार्टअप पर स्किल डायरेक्टरी inode ट्रैक; MCP सर्वर रीस्टार्ट के बिना `SKILLS_PATH` बदलने पर हॉट-पाथ लिस्ट/रीड fail-closed और रीस्टार्ट संकेत (edge-cases Test 15).
189
+ - **क्लाइंट-फेसिंग त्रुटि स्वच्छता**: `read_skill`, प्रॉम्प्ट टेम्पलेट और compositions guide सामान्य MCP त्रुटि लौटाते हैं; फ़ाइलसिस्टम पथ केवल `stderr` पर (mcp_coverage Test 3c).
190
+ - **विश्वास मॉडल और सप्लाई चेन**: [SECURITY.md](SECURITY.md) threat model, README इंस्टॉल कॉलआउट, सर्वर स्टार्ट पर stderr विश्वास सूचनाएँ, पाइप/registry इंस्टॉल चेतावनियाँ।
191
+ - **स्किल कैश सुधार**: `forceReload` रीस्कैन से पहले बॉडी कैश हटाता है, डायरेक्टरी फ़िंगरप्रिंट बनाए रखता है; कैश बजट UTF-8 बाइट लंबाई पर।
192
+ - **ज़्यादा सुरक्षित और portable SDD helpers**: Git worktree के बाहर local helpers fail closed होते हैं, paths को चल रहे worktree के आधार पर resolve करते हैं, और जहाँ समर्थित हो वहाँ `-C DIR` से दूसरा checkout चुना जा सकता है। Base दर्ज करने वाले helpers के लिए resolvable Git `HEAD` ज़रूरी है (पहले initial commit करें)। PowerShell variants समर्थित बने रहते हैं।
193
+ - **ज़्यादा विश्वसनीय task brief**: task ID में अक्षर-अंक वाले segments और dot-separated हिस्से हो सकते हैं (कम-से-कम एक अंक आवश्यक); brief को काट सकने वाली unclosed code fence मिलने पर extraction fail closed होता है।
194
+ - **साफ़ skill packaging**: systematic-debugging pressure fixtures और उनका creation log `tests/` में ले जाए गए; structural regression check उन्हें installed skills में शामिल होने से रोकता है।
195
+ - **बेहतर issue reports**: `diagnosing-superpowers` filer context और मानव-लिखित summary मांगता है, placeholder summary अस्वीकार करता है, और upstream के मौजूदा `bug_report.md` template का उपयोग करता है।
196
+ - स्थानीय सत्यापन: `npm run build` पास हुआ। `npm test` पूरी तरह पास नहीं हुआ: 23 में से 15 suites पास हुईं, `pwsh` उपलब्ध न होने से 7 PowerShell suites skip हुईं, और `tests/setup_test.js` में 3 failures थे (69 tests पास हुए)। असफल मामलों के लिए [CHANGELOG.md](CHANGELOG.md) देखें; इस परीक्षण में पूरी suite पास नहीं हुई।
197
+
198
+ ### v6.4.7
183
199
 
184
200
  - **पूर्ण प्रोजेक्ट सुरक्षा स्कैन (2026-10-09)**: `src/*.ts`, brainstorming companion सर्वर, `scripts/`, `esbuild.js`, npm पैकेजिंग व लॉकफ़ाइल अखंडता, रहस्य/अनुमति स्वच्छता, और हर स्वचालित सूट। आधार नियंत्रण पुनः सत्यापित और स्वच्छ — शिप किए गए स्रोत में `eval` / `new Function` / `innerHTML` / `document.write` / `shell: true` 0, `child_process` केवल argv द्वारा, 0 हार्डकोडेड रहस्य, 0 world-writable ट्रैक की गई फ़ाइलें (विवरण [SECURITY.md](SECURITY.md) में)।
185
201
  - **`--remove` सफलता की सूचना दे सकता था जबकि एक सक्रिय MCP प्रविष्टि बची रहती थी** (CWE-459, निष्पादन द्वारा पुनरुत्पादित): TOML अंतिम `[[mcp_servers.superpowers]]` array table को छोड़कर बाकी सभी रखता है और `[[mcp_servers.superpowers.env]]` को अनाथ कर देता है; JSON केवल पहली root key को साफ़ करता है जिसमें `superpowers` प्रविष्टि हो; भरे हुए flow map `superpowers: {…}` पर YAML हटाना no-op रहता है। इसलिए कॉलर-चयनित `command` सफलता की सूचना देने वाली अनइंस्टॉल के बाद भी स्वतः लॉन्च होता रह सकता है।
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) | [Español](README.es.md) | [Português (BR)](README.pt-BR.md) | [हिन्दी](README.hi.md)
4
4
 
5
- [![バージョン](https://img.shields.io/badge/version-6.4.7-blue.svg)](https://github.com/Poseidoncode/superpowers-mcp)
5
+ [![バージョン](https://img.shields.io/badge/version-6.4.8-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)** サーバーにパッケージ化した使用説明書です。
@@ -22,7 +22,7 @@
22
22
  | プロトコル機能 | 項目 / 数量 | 説明 |
23
23
  | :--- | :--- | :--- |
24
24
  | **Tools** | `list_skills`, `read_skill` | 全スキルの指示書とチェックリストをオンデマンドで探索・検索・読み込み。 |
25
- | **Prompts** | 9 個のネイティブ Prompts | `session-start`, `feature-pipeline`, `structured-debug`, `skill-composition`, `sdd-implementer`, `sdd-task-reviewer`, `sdd-re-review`, `spec-reviewer`, `plan-reviewer` |
25
+ | **Prompts** | 9 個のネイティブ Prompts | `session-start`, `feature-pipeline`, `structured-debug`, `skill-composition`, `sdd-implementer`, `sdd-task-reviewer`, `sdd-re-review`, `builder-check`, `plan-reviewer` |
26
26
  | **Resources** | 15 個の Skill URI + 1 ガイド | `skill://superpowers/<skill-name>` と `guide://superpowers/skill-compositions` |
27
27
 
28
28
  ### AI エージェントとの対話(基本操作)
@@ -88,6 +88,9 @@ ChatWise、Cherry Studio は手動インポートが必要です。[デスクト
88
88
  & ([scriptblock]::Create((irm https://raw.githubusercontent.com/Poseidoncode/superpowers-mcp/main/scripts/install.ps1))) -Target cursor
89
89
  ```
90
90
 
91
+ > [!IMPORTANT]
92
+ > **セキュリティ**: MCP サーバーにはアプリケーションレベルの認証はありません(ローカル stdio の信頼モデル)。パイプ経由の `curl`/`irm` インストーラは可変の `main` を追跡します。リポジトリを clone して `./scripts/install.sh` / `.\scripts\install.ps1` を実行するか、release タグを固定してください。カスタム `SKILLS_PATH` 内のスキルはすべて信頼された agent 指示として扱われます。詳細は [`SECURITY.md`](SECURITY.md)。
93
+
91
94
  #### 主な高度なオプション:
92
95
  - `--dry-run`:ディスクに書き込まず、変更内容をプレビューします。
93
96
  - `--remove`:指定ターゲットから Superpowers 設定を安全に削除します。
@@ -180,7 +183,20 @@ systematic-debugging ➔ using-git-worktrees ➔ dispatching-parallel-agents ➔
180
183
 
181
184
  ## 🆕 最近の更新
182
185
 
183
- ### v6.4.7(最新)
186
+ ### v6.4.8(最新)
187
+
188
+ - **MCP クライアント向けレスポンス上限**:`read_skill`、`list_skills`、スキル resource、compositions guide のインライン本文を **20 KB** に制限し、巨大な 1 つの `SKILL.md` がエージェントのコンテキストを枯渇させないようにした(`tests/client_truncation_test.js`)。
189
+ - **スキルルート差し替え検知**(`EROOTCHANGED`):起動時にスキルディレクトリの inode を記録。MCP サーバーを再起動せず `SKILLS_PATH` が置き換わった場合、ホットパスの一覧・読み取りは fail-closed で再起動を促す(edge-cases Test 15)。
190
+ - **クライアント向けエラーの衛生**:`read_skill`、プロンプトテンプレート、compositions guide は汎用 MCP エラーのみ返し、ファイルシステムのパスは `stderr` のみ(mcp_coverage Test 3c)。
191
+ - **信頼モデルとサプライチェーン**:[SECURITY.md](SECURITY.md) の threat model、README のインストール注意、起動時の stderr 信頼通知、パイプ/registry 経由インストールの警告。
192
+ - **スキルキャッシュ修正**:`forceReload` は再スキャン前に本文キャッシュを破棄しつきディレクトリ指紋は保持。キャッシュ予算は UTF-8 バイト長で計算。
193
+ - **より安全で移植性の高い SDD ヘルパー**:Git worktree の外では安全側に停止し、実行中の worktree を基準にパスを解決します。対応するヘルパーでは `-C DIR` で別の checkout を指定できます。ベースを記録するヘルパーには解決可能な Git `HEAD` が必要なため、新しいリポジトリでは先に初回コミットを作成してください。PowerShell 版も引き続きサポートします。
194
+ - **より信頼できるタスクブリーフ**:タスク ID は英数字のセグメントをドットで連結した形式(少なくとも 1 桁の数字を含む)に対応し、未閉じのコードフェンスによりブリーフが切り詰められる場合は抽出を安全側に停止します。
195
+ - **スキルパッケージの整理**:systematic-debugging の負荷テスト用 fixture と作成記録を `tests/` に移し、インストール対象の skills に混入しないことを構造テストで確認します。
196
+ - **より適切な問題報告**:`diagnosing-superpowers` は報告者の状況と人が記述した要約を必須とし、placeholder の要約を拒否して、upstream の最新 `bug_report.md` テンプレートを使用します。
197
+ - 検証(ローカル実行):`npm run build` は成功しました。`npm test` は全件成功していません。23 スイート中 15 スイートが成功し、`pwsh` がないため PowerShell スイート 7 件はスキップ、`tests/setup_test.js` では 3 件失敗しました(同ファイル内の 69 件は成功)。失敗ケースは [CHANGELOG.md](CHANGELOG.md) を参照してください。この実行ではテストスイート全体の成功を確認できていません。
198
+
199
+ ### v6.4.7
184
200
 
185
201
  - **プロジェクト全体のセキュリティスキャン(2026-10-09)**:`src/*.ts`、brainstorming コンパニオンサーバー、`scripts/`、`esbuild.js`、npm パッケージングとロックファイルの完全性、秘密情報/パーミッションの衛生、およびすべての自動テストスイートを対象。ベースラインの統制を再検証しクリーン——出荷ソース中の `eval` / `new Function` / `innerHTML` / `document.write` / `shell: true` は 0、`child_process` は argv のみ、ハードコードされた秘密情報 0、追跡対象のワールドライタブルファイル 0(詳細は [SECURITY.md](SECURITY.md))。
186
202
  - **`--remove` は有効な MCP エントリが残ったまま成功を報告し得た**(CWE-459、実行による再現):TOML は最後の `[[mcp_servers.superpowers]]` 配列テーブル以外のすべてを残し、`[[mcp_servers.superpowers.env]]` を孤立させる;JSON は `superpowers` エントリを保持する最初のルートキーだけを消去する;YAML の削除は、内容のあるフローマップ `superpowers: {…}` では no-op に留まる。呼び出し側が指定した `command` はしたがって、成功を報告したアンインストールの後も自動起動し続ける。
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) | [Español](README.es.md) | [Português (BR)](README.pt-BR.md) | [हिन्दी](README.hi.md)
4
4
 
5
- [![Version](https://img.shields.io/badge/version-6.4.7-blue.svg)](https://github.com/Poseidoncode/superpowers-mcp)
5
+ [![Version](https://img.shields.io/badge/version-6.4.8-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)** 서버로 패키징한 사용 지침을 요약한 것입니다.
@@ -22,7 +22,7 @@
22
22
  | 프로토콜 기능 | 포함 항목 / 수량 | 설명 |
23
23
  | :--- | :--- | :--- |
24
24
  | **Tools** | `list_skills`, `read_skill` | 전체 스킬 지침과 체크리스트를 온디맨드로 탐색, 검색 및 로드합니다. |
25
- | **Prompts** | 9개의 네이티브 Prompts | `session-start`, `feature-pipeline`, `structured-debug`, `skill-composition`, `sdd-implementer`, `sdd-task-reviewer`, `sdd-re-review`, `spec-reviewer`, `plan-reviewer` |
25
+ | **Prompts** | 9개의 네이티브 Prompts | `session-start`, `feature-pipeline`, `structured-debug`, `skill-composition`, `sdd-implementer`, `sdd-task-reviewer`, `sdd-re-review`, `builder-check`, `plan-reviewer` |
26
26
  | **Resources** | 15개 Skill URI + 1개 가이드 | `skill://superpowers/<skill-name>` 및 `guide://superpowers/skill-compositions` |
27
27
 
28
28
  ### AI 에이전트와 대화하기 (기본 사용법)
@@ -88,6 +88,9 @@ ChatWise, Cherry Studio는 수동 가져오기가 필요합니다. [데스크톱
88
88
  & ([scriptblock]::Create((irm https://raw.githubusercontent.com/Poseidoncode/superpowers-mcp/main/scripts/install.ps1))) -Target cursor
89
89
  ```
90
90
 
91
+ > [!IMPORTANT]
92
+ > **보안**: MCP 서버에는 애플리케이션 수준 인증이 없습니다(로컬 stdio 신뢰 모델). 파이프로 실행하는 `curl`/`irm` 설치 스크립트는 변경 가능한 `main`을 따릅니다. 저장소를 clone한 뒤 `./scripts/install.sh` / `.\scripts\install.ps1`을 사용하거나 release 태그를 고정하세요. 사용자 지정 `SKILLS_PATH`의 모든 스킬은 신뢰된 agent 지시로 처리됩니다. 자세히는 [`SECURITY.md`](SECURITY.md).
93
+
91
94
  #### 유용한 고급 옵션:
92
95
  - `--dry-run`: 디스크에 쓰지 않고 변경될 파일과 내용을 미리 확인합니다.
93
96
  - `--remove`: 지정된 대상 Harness에서 Superpowers 설정을 안전하게 제거합니다.
@@ -178,7 +181,20 @@ systematic-debugging ➔ using-git-worktrees ➔ dispatching-parallel-agents ➔
178
181
 
179
182
  ## 🆕 최근 업데이트
180
183
 
181
- ### v6.4.7 (최신)
184
+ ### v6.4.8 (최신)
185
+
186
+ - **MCP 클라이언트 응답 한도**: `read_skill`, `list_skills`, 스킬 resource, compositions guide에 반환되는 인라인 스킬 본문을 **20 KB**로 제한해 하나의 큰 `SKILL.md`가 agent 컨텍스트를 고갈시키지 않도록 함 (`tests/client_truncation_test.js`).
187
+ - **스킬 루트 교체 감지** (`EROOTCHANGED`): 시작 시 스킬 디렉터리 inode를 추적. MCP 서버를 재시작하지 않고 `SKILLS_PATH`가 바뀌면 핫 경로 목록/읽기가 fail-closed로 재시작을 안내 (edge-cases Test 15).
188
+ - **클라이언트 오류 위생**: `read_skill`, 프롬프트 템플릿, compositions guide는 일반 MCP 오류만 반환하고 파일 시스템 경로는 `stderr`에만 기록 (mcp_coverage Test 3c).
189
+ - **신뢰 모델 및 공급망**: [SECURITY.md](SECURITY.md) threat model, README 설치 안내, 서버 시작 시 stderr 신뢰 알림, 파이프/registry 설치 경고.
190
+ - **스킬 캐시 수정**: `forceReload`가 재스캔 전 본문 캐시를 비우면서 디렉터리 지문은 유지. 캐시 예산은 UTF-8 바이트 길이 사용.
191
+ - **더 안전하고 이식성 높은 SDD 헬퍼**: Git worktree 밖에서는 fail closed하고, 실행 중인 worktree를 기준으로 경로를 해석하며, 지원되는 헬퍼에서는 `-C DIR`로 다른 checkout을 지정할 수 있습니다. 기준점을 기록하는 헬퍼는 해석 가능한 Git `HEAD`가 필요하므로 새 저장소에서는 먼저 초기 commit을 만들어야 합니다. PowerShell 버전도 계속 지원합니다.
192
+ - **더 신뢰할 수 있는 task brief**: task ID는 영숫자 세그먼트를 점으로 구분한 형식(숫자 최소 1개 포함)을 지원하며, 닫히지 않은 코드 펜스 때문에 brief가 잘릴 수 있으면 추출을 fail closed합니다.
193
+ - **깔끔한 skill 패키징**: systematic-debugging 압력 테스트 fixture와 생성 기록을 `tests/`로 옮겼고, 구조적 회귀 검사를 통해 설치된 skills에 포함되지 않도록 했습니다.
194
+ - **개선된 이슈 보고**: `diagnosing-superpowers`는 신고자 맥락과 사람이 작성한 요약을 요구하고 placeholder 요약을 거부하며, upstream의 최신 `bug_report.md` 템플릿을 사용합니다.
195
+ - 로컬 검증: `npm run build`는 통과했습니다. `npm test`는 전체 통과하지 못했습니다. 23개 스위트 중 15개 통과, `pwsh`가 없어 PowerShell 스위트 7개는 건너뛰었고, `tests/setup_test.js`에서 3개 실패했습니다(같은 파일의 테스트 69개는 통과). 실패 항목은 [CHANGELOG.md](CHANGELOG.md)를 참고하세요. 이번 실행에서는 전체 테스트 스위트가 통과하지 않았습니다.
196
+
197
+ ### v6.4.7
182
198
 
183
199
  - **전체 프로젝트 보안 스캔 (2026-10-09)**: `src/*.ts`, brainstorming 컴패니언 서버, `scripts/`, `esbuild.js`, npm 패키징 및 lockfile 무결성, 비밀/권한 위생, 그리고 모든 자동화 스위트. 기준 통제 재검증 결과 클린 — 출하 소스 내 `eval` / `new Function` / `innerHTML` / `document.write` / `shell: true` 0건, `child_process`는 argv 전용, 하드코딩된 비밀 0건, world-writable 추적 파일 0건 (자세한 내용은 [SECURITY.md](SECURITY.md)).
184
200
  - **`--remove`가 성공을 보고했는데도 살아 있는 MCP 항목이 남을 수 있음** (CWE-459, 실행으로 재현): TOML은 마지막 `[[mcp_servers.superpowers]]` 배열 테이블을 제외한 모든 테이블을 유지하고 `[[mcp_servers.superpowers.env]]`를 고아 상태로 남김; JSON은 `superpowers` 항목을 담은 첫 번째 루트 키만 비움; YAML 제거는 채워진 flow map `superpowers: {…}`에 대해 무동작임. 따라서 호출자가 선택한 `command`는 성공을 보고한 제거 이후에도 계속 자동 실행될 수 있음.
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) | [Español](README.es.md) | [Português (BR)](README.pt-BR.md) | [हिन्दी](README.hi.md)
4
4
 
5
- [![Version](https://img.shields.io/badge/version-6.4.7-blue.svg)](https://github.com/Poseidoncode/superpowers-mcp)
5
+ [![Version](https://img.shields.io/badge/version-6.4.8-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.
@@ -22,7 +22,7 @@ This document summarizes the information and usage instructions for packaging th
22
22
  | Protocol Feature | Items / Count | Description |
23
23
  | :--- | :--- | :--- |
24
24
  | **Tools** | `list_skills`, `read_skill` | Discover, search, and load full skill instructions and checklists on demand. |
25
- | **Prompts** | 9 Native Prompts | `session-start`, `feature-pipeline`, `structured-debug`, `skill-composition`, `sdd-implementer`, `sdd-task-reviewer`, `sdd-re-review`, `spec-reviewer`, `plan-reviewer` |
25
+ | **Prompts** | 9 Native Prompts | `session-start`, `feature-pipeline`, `structured-debug`, `skill-composition`, `sdd-implementer`, `sdd-task-reviewer`, `sdd-re-review`, `builder-check`, `plan-reviewer` |
26
26
  | **Resources** | 15 Skill URIs + 1 Guide | `skill://superpowers/<skill-name>` plus `guide://superpowers/skill-compositions` |
27
27
 
28
28
  ### Chatting with the AI Agent (Basic Usage)
@@ -88,6 +88,9 @@ Select your client and run the corresponding command in your terminal:
88
88
  & ([scriptblock]::Create((irm https://raw.githubusercontent.com/Poseidoncode/superpowers-mcp/main/scripts/install.ps1))) -Target cursor
89
89
  ```
90
90
 
91
+ > [!IMPORTANT]
92
+ > **Security**: The MCP server has no application-level auth (local stdio trust model). Piped `curl`/`irm` installers track the mutable `main` branch; prefer cloning the repo and running `./scripts/install.sh` / `.\scripts\install.ps1`, or pin a release tag. Custom `SKILLS_PATH` directories are fully trusted as agent instructions. Details: [`SECURITY.md`](SECURITY.md).
93
+
91
94
  #### Advanced Flags:
92
95
  - `--dry-run`: Preview changes without writing to disk.
93
96
  - `--remove`: Safely remove Superpowers configuration from the targeted client.
@@ -179,7 +182,20 @@ To help you choose the right skill, we have structured all 15 skills across the
179
182
 
180
183
  ## 🆕 Recent Updates
181
184
 
182
- ### v6.4.7 (Latest)
185
+ ### v6.4.8 (Latest)
186
+
187
+ - **MCP client response budgets**: Inline skill bodies are capped at **20 KB** for `read_skill`, `list_skills`, skill resources, and the compositions guide so one huge `SKILL.md` cannot exhaust agent context (`tests/client_truncation_test.js`).
188
+ - **Skills root swap detection** (`EROOTCHANGED`): the skills directory inode is tracked at startup; if `SKILLS_PATH` is replaced without restarting the MCP server, hot-path listing and reads fail closed with a restart hint (edge-cases Test 15).
189
+ - **Client-facing error hygiene**: `read_skill`, prompt templates, and the compositions guide return generic MCP errors; filesystem paths stay on `stderr` only (mcp_coverage Test 3c).
190
+ - **Trust & supply-chain docs**: [SECURITY.md](SECURITY.md) threat model, README install callouts, stderr trust notices on server start, and installer warnings for piped/registry setup.
191
+ - **Skills cache fixes**: `forceReload` drops cached bodies before rescan without losing the directory fingerprint; content-cache limits use UTF-8 byte length.
192
+ - **Safer SDD helper selection**: local helpers now fail closed outside a Git worktree, resolve paths against the executing worktree, and support `-C DIR` where available. Helpers that record a base require a resolvable `HEAD` (initialize the repository with a commit first). PowerShell variants remain supported.
193
+ - **More reliable task briefs**: task IDs support alphanumeric segments separated by dots (with at least one digit), while an unclosed code fence that could truncate a brief causes extraction to fail closed.
194
+ - **Cleaner skill packaging**: systematic-debugging pressure fixtures and their creation log moved under `tests/`, with a structural regression check keeping them out of installed skills.
195
+ - **Better issue reports**: `diagnosing-superpowers` requires filer context and a human-authored summary, rejects placeholder summaries, and uses the current upstream `bug_report.md` template.
196
+ - Verification (local run): `npm run build` passed. `npm test` is not green: 15/23 suites passed, 7 PowerShell suites were skipped because `pwsh` is unavailable, and `tests/setup_test.js` had 3 failures (69 passed). See [CHANGELOG.md](CHANGELOG.md) for the failing cases; the full test suite did not pass in this run.
197
+
198
+ ### v6.4.7
183
199
 
184
200
  - **Full project security scan (2026-10-09)**: `src/*.ts`, the brainstorming companion server, `scripts/`, `esbuild.js`, npm packaging and lockfile integrity, secret/permission hygiene, and every automated suite. Baseline controls re-verified clean — 0 `eval` / `new Function` / `innerHTML` / `document.write` / `shell: true` in shipped source, `child_process` argv-only, 0 hardcoded secrets, 0 world-writable tracked files (details in [SECURITY.md](SECURITY.md)).
185
201
  - **`--remove` could report success while a live MCP entry survived** (CWE-459, reproduced by execution): TOML keeps all but the last `[[mcp_servers.superpowers]]` array table and orphans `[[mcp_servers.superpowers.env]]`; JSON clears only the first root key holding a `superpowers` entry; YAML removal is a no-op on a populated flow map `superpowers: {…}`. A caller-chosen `command` therefore keeps auto-launching after an uninstall that reported success.
@@ -188,7 +204,7 @@ To help you choose the right skill, we have structured all 15 skills across the
188
204
  - **`[MODEL]` is no longer dropped for `sdd-task-reviewer` / `sdd-re-review`** (found by this scan, fixed here): both templates spelled that slot `model: [MODEL — REQUIRED: …]`, which carries no literal token, so the caller's `model` value reached the rendered prompt **zero** times and the new diagnostic could not see it. Both now use `model: [MODEL]` plus a `#` comment, matching `implementer-prompt.md`, and are pinned by two fail-without / pass-with assertions.
189
205
  - **CodeQL `js/polynomial-redos` #9/#10 closed — the YAML managed-entry matcher was quadratic** (reproduced by execution): `managedEntryPattern` put an optional `{…}` group between two `\s*` runs, so any line it could not complete made the engine retry every split of that whitespace run. No exotic payload is needed — `superpowers:` + a long space run + **one stray character** is an ordinary malformed config line, and a 200 KB line cost **18.3 s** in a single match, stalling `setup`. Replaced by `managedEntryIndent()`, a single-pass scanner: **18.3 s → 0.08 ms**. The accepted-line set is provably unchanged (a **300 030**-line differential fuzz against the removed regex found **0** mismatches), the three sibling patterns were measured linear and left alone, and two new `tests/setup_test.js` cases pin both the timing and the exact accepted set (verified fail-on-vulnerable / pass-on-fixed).
190
206
  - **Packaging hardening targets**: `npm pack` does not rebuild (`prepublishOnly` is publish-only and `out/` is gitignored, so a packed tarball ships on-disk `out/*.js` unreviewed — the build belongs in `prepack`); and `files: ["scripts"]` ships the installer, which prefers a co-located `setup.js`.
191
- - Verification: `npm test` green **10/10 suites**, PowerShell suite **128/128**, `npx tsc --noEmit` clean, `npm run build` ok, `npm audit` **0** vulnerabilities, `npm run drift` 0 (regression floor re-measured at **398 assertions**: Node.js 238 + Bash 32 + PowerShell 128).
207
+ - Verification: `npm test` green **13/13 suites** (on Windows, symlink-dependent cases need Developer Mode / `SeCreateSymbolicLinkPrivilege` or they report as skips), PowerShell suite **128/128**, `npx tsc --noEmit` clean, `npm run build` ok, `npm audit` **0** vulnerabilities, `npm run drift` 0 (regression floor re-measured at **398 assertions**: Node.js 238 + Bash 32 + PowerShell 128).
192
208
 
193
209
  ### v6.4.6
194
210
 
package/README.pt-BR.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  [English](README.md) | [繁體中文](README.zh-TW.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [Español](README.es.md) | [Português (BR)](README.pt-BR.md) | [हिन्दी](README.hi.md)
4
4
 
5
- [![Versão](https://img.shields.io/badge/version-6.4.7-blue.svg)](https://github.com/Poseidoncode/superpowers-mcp)
5
+ [![Versão](https://img.shields.io/badge/version-6.4.8-blue.svg)](https://github.com/Poseidoncode/superpowers-mcp)
6
6
  [![Licença](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
7
7
 
8
8
  Este documento resume as informações e instruções de uso para empacotar as skills do Superpowers e o sistema de fluxos de trabalho autônomos em um servidor **Model Context Protocol (MCP)** independente, de alta performance e seguro.
@@ -22,7 +22,7 @@ Este documento resume as informações e instruções de uso para empacotar as s
22
22
  | Recurso do protocolo | Itens / Quantidade | Descrição |
23
23
  | :--- | :--- | :--- |
24
24
  | **Tools** | `list_skills`, `read_skill` | Descubra, pesquise e carregue as instruções completas e checklists de cada skill sob demanda. |
25
- | **Prompts** | 9 Native Prompts | `session-start`, `feature-pipeline`, `structured-debug`, `skill-composition`, `sdd-implementer`, `sdd-task-reviewer`, `sdd-re-review`, `spec-reviewer`, `plan-reviewer` |
25
+ | **Prompts** | 9 Native Prompts | `session-start`, `feature-pipeline`, `structured-debug`, `skill-composition`, `sdd-implementer`, `sdd-task-reviewer`, `sdd-re-review`, `builder-check`, `plan-reviewer` |
26
26
  | **Resources** | 15 Skill URIs + 1 Guide | `skill://superpowers/<skill-name>` além de `guide://superpowers/skill-compositions` |
27
27
 
28
28
  ### Conversando com o agente de IA (uso básico)
@@ -88,6 +88,9 @@ Selecione seu cliente e execute o comando correspondente no terminal:
88
88
  & ([scriptblock]::Create((irm https://raw.githubusercontent.com/Poseidoncode/superpowers-mcp/main/scripts/install.ps1))) -Target cursor
89
89
  ```
90
90
 
91
+ > [!IMPORTANT]
92
+ > **Segurança**: o servidor MCP não tem autenticação em nível de aplicativo (modelo de confiança stdio local). Instaladores por pipe `curl`/`irm` seguem o branch mutável `main`; prefira clonar o repositório e executar `./scripts/install.sh` / `.\scripts\install.ps1`, ou fixe uma tag de release. Diretórios `SKILLS_PATH` personalizados são tratados como instruções confiáveis do agente. Detalhes em [`SECURITY.md`](SECURITY.md).
93
+
91
94
  #### Flags avançadas:
92
95
  - `--dry-run`: Mostra as mudanças sem gravar no disco.
93
96
  - `--remove`: Remove com segurança a configuração do Superpowers do cliente selecionado.
@@ -179,7 +182,20 @@ Para ajudar você a escolher a skill certa, estruturamos as 15 skills ao longo d
179
182
 
180
183
  ## 🆕 Novidades recentes
181
184
 
182
- ### v6.4.7 (atual)
185
+ ### v6.4.8 (atual)
186
+
187
+ - **Limites de resposta ao cliente MCP**: corpos inline de skills limitados a **20 KB** em `read_skill`, `list_skills`, resources e o guia de compositions para que um `SKILL.md` enorme não esgote o contexto do agente (`tests/client_truncation_test.js`).
188
+ - **Detecção de troca da raiz de skills** (`EROOTCHANGED`): o inode do diretório de skills é registrado na inicialização; se `SKILLS_PATH` for substituído sem reiniciar o servidor MCP, listagens e leituras em caminho quente falham de forma segura com aviso de reinício (edge-cases Test 15).
189
+ - **Higiene de erros ao cliente**: `read_skill`, templates de prompt e o guia de compositions retornam erros MCP genéricos; caminhos do sistema de arquivos ficam apenas em `stderr` (mcp_coverage Test 3c).
190
+ - **Modelo de confiança e cadeia de suprimentos**: threat model em [SECURITY.md](SECURITY.md), avisos de instalação no README, notificações de confiança em `stderr` na inicialização e alertas nos instaladores via pipe/registry.
191
+ - **Correções de cache de skills**: `forceReload` descarta corpos em cache antes do rescan sem perder a impressão digital do diretório; o orçamento de cache usa comprimento em bytes UTF-8.
192
+ - **Helpers SDD mais seguros e portáveis**: falham de forma segura fora de um worktree Git, resolvem caminhos com base no worktree em execução e, quando disponível, permitem selecionar outro checkout com `-C DIR`. Helpers que registram uma base exigem um `HEAD` Git resolvível (crie um commit inicial primeiro). As variantes PowerShell continuam compatíveis.
193
+ - **Task briefs mais confiáveis**: IDs aceitam segmentos alfanuméricos separados por pontos (com pelo menos um dígito); se um bloco de código não fechado puder truncar o brief, a extração falha de forma segura.
194
+ - **Pacote de skills mais limpo**: fixtures de pressão de systematic-debugging e seu registro de criação foram movidos para `tests/`, com uma verificação estrutural para impedir que sejam incluídos nas skills instaladas.
195
+ - **Relatos de problemas melhores**: `diagnosing-superpowers` exige o contexto de quem relata e um resumo escrito por uma pessoa, rejeita resumos de placeholder e usa o template upstream atual `bug_report.md`.
196
+ - Verificação (execução local): `npm run build` passou. `npm test` não está totalmente verde: 15/23 suites passaram, 7 suites PowerShell foram ignoradas porque `pwsh` não está disponível e `tests/setup_test.js` teve 3 falhas (69 testes passaram). Consulte os casos em [CHANGELOG.md](CHANGELOG.md); a suíte completa não passou nesta execução.
197
+
198
+ ### v6.4.7
183
199
 
184
200
  - **Varredura completa de segurança do projeto (2026-10-09)**: `src/*.ts`, o servidor companion de brainstorming, `scripts/`, `esbuild.js`, integridade do empacotamento npm e do lockfile, higiene de segredos/permissões e todas as suítes automatizadas. Controles de base reverificados limpos — 0 `eval` / `new Function` / `innerHTML` / `document.write` / `shell: true` no código distribuído, `child_process` somente por argv, 0 segredos hardcodados, 0 arquivos rastreados world-writable (detalhes em [SECURITY.md](SECURITY.md)).
185
201
  - **`--remove` poderia reportar sucesso enquanto uma entrada MCP viva sobrevivia** (CWE-459, reproduzido por execução): o TOML mantém todas as tabelas de array `[[mcp_servers.superpowers]]` exceto a última e deixa órfã `[[mcp_servers.superpowers.env]]`; o JSON limpa apenas a primeira chave raiz que contém uma entrada `superpowers`; a remoção em YAML é um no-op sobre um mapa de fluxo populado `superpowers: {…}`. Assim, um `command` escolhido pelo chamador continua sendo iniciado automaticamente após uma desinstalação que reportou sucesso.
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) | [Español](README.es.md) | [Português (BR)](README.pt-BR.md) | [हिन्दी](README.hi.md)
4
4
 
5
- [![版本](https://img.shields.io/badge/version-6.4.7-blue.svg)](https://github.com/Poseidoncode/superpowers-mcp)
5
+ [![版本](https://img.shields.io/badge/version-6.4.8-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)** 伺服器之相關資訊與使用說明。
@@ -22,7 +22,7 @@
22
22
  | 協議功能 | 包含項目 / 數量 | 說明 |
23
23
  | :--- | :--- | :--- |
24
24
  | **Tools (工具)** | `list_skills`, `read_skill` | 依需求隨時探索、搜尋並載入技能完整內容與操作規範。 |
25
- | **Prompts (提示詞)** | 9 個原生 Prompts | `session-start`, `feature-pipeline`, `structured-debug`, `skill-composition`, `sdd-implementer`, `sdd-task-reviewer`, `sdd-re-review`, `spec-reviewer`, `plan-reviewer` |
25
+ | **Prompts (提示詞)** | 9 個原生 Prompts | `session-start`, `feature-pipeline`, `structured-debug`, `skill-composition`, `sdd-implementer`, `sdd-task-reviewer`, `sdd-re-review`, `builder-check`, `plan-reviewer` |
26
26
  | **Resources (資源)** | 15 項技能 URI + 1 項指南 | `skill://superpowers/<skill-name>`,以及 `guide://superpowers/skill-compositions` |
27
27
 
28
28
  ### 與 AI Agent 對話(基礎操作)
@@ -88,6 +88,9 @@ ChatWise 與 Cherry Studio 需手動匯入,請見[桌面版匯入指南](docs/
88
88
  & ([scriptblock]::Create((irm https://raw.githubusercontent.com/Poseidoncode/superpowers-mcp/main/scripts/install.ps1))) -Target cursor
89
89
  ```
90
90
 
91
+ > [!IMPORTANT]
92
+ > **安全性**:MCP 伺服器無應用層認證(本地 stdio 信任模型)。透過管道執行的 `curl`/`irm` 安裝腳本會追蹤可變的 `main` 分支;建議 clone 後執行 `./scripts/install.sh` / `.\scripts\install.ps1`,或固定 release tag。自訂 `SKILLS_PATH` 目錄內的所有技能內容均視為可信的 agent 指令。詳見 [`SECURITY.md`](SECURITY.md)。
93
+
91
94
  #### 常用進階參數:
92
95
  - `--dry-run`:預覽即將修改的檔案與配置內容,不實際寫入磁碟。
93
96
  - `--remove`:從指定目標 Harness 安全移除 Superpowers 配置。
@@ -178,7 +181,20 @@ systematic-debugging ➔ using-git-worktrees ➔ dispatching-parallel-agents ➔
178
181
 
179
182
  ## 🆕 最近更新
180
183
 
181
- ### v6.4.7(最新版)
184
+ ### v6.4.8(最新版)
185
+
186
+ - **MCP 客戶端回應上限**:`read_skill`、`list_skills`、技能資源與 compositions guide 的內嵌技能正文上限為 **20 KB**,避免單一巨大 `SKILL.md` 撐爆 agent 上下文(`tests/client_truncation_test.js`)。
187
+ - **技能根目錄替換偵測**(`EROOTCHANGED`):啟動時記錄技能目錄 inode;若未重啟 MCP 即替換 `SKILLS_PATH`,熱路徑清單與讀取會 fail-closed 並提示重啟(edge-cases Test 15)。
188
+ - **客戶端錯誤訊息去敏感化**:`read_skill`、prompt 模板與 compositions guide 僅回傳泛化 MCP 錯誤;檔案系統路徑僅寫入 `stderr`(mcp_coverage Test 3c)。
189
+ - **信任與供應鏈文件**:[SECURITY.md](SECURITY.md) 威脅模型、README 安裝提示、伺服器啟動時的 stderr 信任說明,以及管道/registry 安裝警告。
190
+ - **技能快取修復**:`forceReload` 在重掃前清除正文快取且保留目錄指紋;快取預算改以 UTF-8 位元組計算。
191
+ - **更安全的 SDD 輔助腳本**:本機輔助腳本在 Git worktree 外會 fail closed、以實際執行中的 worktree 為路徑基準,並於支援的腳本使用 `-C DIR` 選擇其他 checkout。需要記錄基準版本的輔助腳本要求 `HEAD` 可解析(請先在 Repository 建立初始 commit)。PowerShell 版本仍持續支援。
192
+ - **更可靠的 task brief**:Task ID 支援含數字的英數字串與點分段格式;若未閉合的 code fence 可能導致 brief 被截斷,擷取程序會 fail closed。
193
+ - **更乾淨的技能打包內容**:systematic-debugging 壓力測試 fixtures 與建立紀錄已移至 `tests/`,並新增結構性回歸檢查,避免它們被打包進已安裝的 skills。
194
+ - **更完整的錯誤回報**:`diagnosing-superpowers` 要求填寫回報者背景與人工撰寫的摘要、拒絕 placeholder 摘要,並使用上游目前的 `bug_report.md` 範本。
195
+ - 本機驗證:`npm run build` 通過。`npm test` 尚未全綠:23 個測試套件中 15 個通過,7 個 PowerShell 套件因環境未安裝 `pwsh` 而跳過,`tests/setup_test.js` 有 3 個失敗(另有 69 個測試通過)。失敗項目詳見 [CHANGELOG.md](CHANGELOG.md);此次執行的完整測試套件尚未全數通過。
196
+
197
+ ### v6.4.7
182
198
 
183
199
  - **完整專案安全性掃描(2026-10-09)**:`src/*.ts`、brainstorming companion server、`scripts/`、`esbuild.js`、npm 打包與 lockfile 完整性、密鑰/權限衛生,以及所有自動化測試套件。基準控管重新驗證為乾淨——發佈程式碼中 `eval` / `new Function` / `innerHTML` / `document.write` / `shell: true` 為 0、`child_process` 僅用 argv、0 硬編碼密鑰、0 全域可寫的受追蹤檔案(詳見 [SECURITY.md](SECURITY.md))。
184
200
  - **`--remove` 可能在仍有存活的 MCP 項目時回報成功**(CWE-459,已以實際執行重現):TOML 會保留除最後一個 `[[mcp_servers.superpowers]]` 陣列表之外的所有項目,並使 `[[mcp_servers.superpowers.env]]` 淪為孤兒;JSON 只清除第一個含有 `superpowers` 項目的根層 key;YAML 移除對已填滿的 flow map `superpowers: {…}` 是無動作。因此呼叫端自選的 `command` 在回報成功的解除安裝之後,仍會持續自動啟動。
@@ -35,6 +35,10 @@ npm run drift:record -- --ignore <skill>
35
35
 
36
36
  Do not refresh the baseline before reviewing and importing the changes. Doing so would mark unseen upstream changes as handled.
37
37
 
38
+ ## Fork-Specific Additions
39
+
40
+ Prefer changes the fork can own outright: new MCP/server integrations, helper scripts, references, maintainer docs, and regression tests. Avoid editing upstream-tracked `SKILL.md` bodies just to mirror upstream or to carry generic advice. When a local packaging/runtime constraint requires changing an upstream-tracked file, keep the patch narrow, explain why it is fork-specific, preserve fork-only files (including PowerShell twins), and pin the behavior with tests. Do not remove upstream files or re-record their baseline merely to make the drift report green; record explicit adoption or non-adoption decisions after review.
41
+
38
42
  ## Safety Checks
39
43
 
40
44
  `npm test` fails when an imported upstream file is deleted or when a shipped skill loses its upstream lineage.
@@ -182,7 +182,7 @@ Cuando el agente controlador despacha un subagente de tarea:
182
182
  | **`sdd-implementer`** | `brief_file`, `task_name`, ... | Plantilla de prompt de subagente implementador de tareas SDD. |
183
183
  | **`sdd-task-reviewer`** | `brief_file`, `report_file`, `review_file`, ... | Plantilla de prompt revisor de spec y calidad por tarea SDD. |
184
184
  | **`sdd-re-review`** | `brief_file`, `review_file`, `previous_findings`, ... | Plantilla de re-revisor SDD de alcance de ronda de corrección. |
185
- | **`spec-reviewer`** | `spec_file` | Plantilla de prompt revisor adversarial de specs de diseño. |
185
+ | **`builder-check`** | `design_file, domain` | Prompt de verificación del diseño aprobado desde la óptica del constructor. |
186
186
  | **`plan-reviewer`** | `plan_file`, `spec_file` | Plantilla de prompt revisor adversarial de planes de implementación. |
187
187
 
188
188
  ---
@@ -182,7 +182,7 @@ flowchart LR
182
182
  | **`sdd-implementer`** | `brief_file`, `task_name`, ... | SDD कार्य कार्यान्वयनकर्ता subagent prompt टेम्पलेट। |
183
183
  | **`sdd-task-reviewer`** | `brief_file`, `report_file`, `review_file`, ... | SDD प्रति-कार्य spec व गुणवत्ता समीक्षक prompt टेम्पलेट। |
184
184
  | **`sdd-re-review`** | `brief_file`, `review_file`, `previous_findings`, ... | SDD सुधार-राउंड सीमित पुनः-समीक्षक prompt टेम्पलेट। |
185
- | **`spec-reviewer`** | `spec_file` | प्रतिकूल डिज़ाइन spec समीक्षक prompt टेम्पलेट। |
185
+ | **`builder-check`** | `design_file, domain` | स्वीकृत डिज़ाइन की बिल्डर-दृष्टि जाँच prompt: योजना से पहले बचे प्रश्नों की सूची। |
186
186
  | **`plan-reviewer`** | `plan_file`, `spec_file` | प्रतिकूल कार्यान्वयन योजना समीक्षक prompt टेम्पलेट। |
187
187
 
188
188
  ---
@@ -185,7 +185,7 @@ flowchart LR
185
185
  | **`sdd-implementer`** | `brief_file`, `task_name`, ... | SDD タスク実装サブエージェント用プロンプト。 |
186
186
  | **`sdd-task-reviewer`** | `brief_file`, `report_file`, `review_file`, ... | SDD 単一タスクレビュー用プロンプト。 |
187
187
  | **`sdd-re-review`** | `brief_file`, `review_file`, `previous_findings`, ... | SDD 修正ラウンド差分レビュー用プロンプト。 |
188
- | **`spec-reviewer`** | `spec_file` | 設計仕様書レビュー用プロンプト。 |
188
+ | **`builder-check`** | `design_file, domain` | 承認済み設計をビルダー視点で検証し、計画前に残る質問を洗い出すプロンプト。 |
189
189
  | **`plan-reviewer`** | `plan_file`, `spec_file` | 実装計画書レビュー用プロンプト。 |
190
190
 
191
191
  ---
@@ -185,7 +185,7 @@ flowchart LR
185
185
  | **`sdd-implementer`** | `brief_file`, `task_name`, ... | SDD 태스크 구현 서브에이전트 프롬프트. |
186
186
  | **`sdd-task-reviewer`** | `brief_file`, `report_file`, `review_file`, ... | SDD 단일 태스크 검토 서브에이전트 프롬프트. |
187
187
  | **`sdd-re-review`** | `brief_file`, `review_file`, `previous_findings`, ... | SDD 수정 라운드 차분 검토 프롬프트. |
188
- | **`spec-reviewer`** | `spec_file` | 설계 스펙 검토 프롬프트. |
188
+ | **`builder-check`** | `design_file, domain` | 승인된 설계를 빌더 관점에서 검증하고 계획 전 남은 질문을 정리하는 프롬프트. |
189
189
  | **`plan-reviewer`** | `plan_file`, `spec_file` | 구현 계획 검토 프롬프트. |
190
190
 
191
191
  ---
@@ -182,7 +182,7 @@ When the controller agent dispatches a task subagent:
182
182
  | **`sdd-implementer`** | `brief_file`, `task_name`, ... | SDD task implementer subagent prompt template. |
183
183
  | **`sdd-task-reviewer`** | `brief_file`, `report_file`, `review_file`, ... | SDD per-task spec & quality reviewer prompt template. |
184
184
  | **`sdd-re-review`** | `brief_file`, `review_file`, `previous_findings`, ... | SDD fix-round scoped re-reviewer prompt template. |
185
- | **`spec-reviewer`** | `spec_file` | Adversarial design specification reviewer prompt template. |
185
+ | **`builder-check`** | `design_file, domain` | Fresh-eyes builder check prompt: a builder reads the approved design and lists what they'd still need to ask. |
186
186
  | **`plan-reviewer`** | `plan_file`, `spec_file` | Adversarial implementation plan reviewer prompt template. |
187
187
 
188
188
  ---
@@ -182,7 +182,7 @@ Quando o agente controlador despacha um subagente de tarefa:
182
182
  | **`sdd-implementer`** | `brief_file`, `task_name`, ... | Template de prompt de subagente implementador de tarefas SDD. |
183
183
  | **`sdd-task-reviewer`** | `brief_file`, `report_file`, `review_file`, ... | Template de prompt revisor de spec e qualidade por tarefa SDD. |
184
184
  | **`sdd-re-review`** | `brief_file`, `review_file`, `previous_findings`, ... | Template de re-revisor SDD de escopo da rodada de correção. |
185
- | **`spec-reviewer`** | `spec_file` | Template de prompt revisor adversarial de specs de design. |
185
+ | **`builder-check`** | `design_file, domain` | Prompt de verificação do design aprovado pela ótica do construtor. |
186
186
  | **`plan-reviewer`** | `plan_file`, `spec_file` | Template de prompt revisor adversarial de planos de implementação. |
187
187
 
188
188
  ---
@@ -185,7 +185,7 @@ flowchart LR
185
185
  | **`sdd-implementer`** | `brief_file`, `task_name`, ... | SDD 任務實作子代理 Prompt |
186
186
  | **`sdd-task-reviewer`** | `brief_file`, `report_file`, `review_file`, ... | SDD 單一任務審查子代理 Prompt |
187
187
  | **`sdd-re-review`** | `brief_file`, `review_file`, `previous_findings`, ... | SDD 修復輪次局部覆審子代理 Prompt |
188
- | **`spec-reviewer`** | `spec_file` | 對抗式設計規格審查子代理 Prompt |
188
+ | **`builder-check`** | `design_file, domain` | 以建造者視角審查已核准設計的 Prompt:列出規劃前仍需釐清的問題 |
189
189
  | **`plan-reviewer`** | `plan_file`, `spec_file` | 對抗式實作計畫審查子代理 Prompt |
190
190
 
191
191
  ---