Question 1

Claude Codeでpw-testrailおよびpw-browserstack MCPサーバーに「Failed to connect - CONNECTION_CLOSED」と表示される問題を修正する方法

Accepted Answer

`pw` プラグインを **v2.12.0 以降** にアップグレードしてください。v2.9.0 では、`.mcp.json` が `pw-testrail` と `pw-browserstack` を自動的に起動しますが、これらの `@modelcontextprotocol/sdk` 依存関係がインストールされないため、`ERR_MODULE_NOT_FOUND` および永続的な `CONNECTION_CLOSED` エラーが発生します。v2.12.0 ではこれらのサーバーが `integrations/mcp-servers.example.json` に移動されたため、すべてのユーザーでエラーが発生しなくなりました。

TestRail または BrowserStack との統合が必要な場合は、明示的にオプトインしてください：

```sh
cd "$CLAUDE_PLUGIN_ROOT/integrations/testrail-mcp"
npm install

cd "$CLAUDE_PLUGIN_ROOT/integrations/browserstack-mcp"
npm install
```

次に、`integrations/mcp-servers.example.json` をプラグインの `.mcp.json` にコピーまたはマージし、必要な `TESTRAIL_*` または `BROWSERSTACK_*` 環境変数を設定して、Claude Code を再起動してください。

v2.9.0 での即時の回避策は、使用していない `pw-testrail` と `pw-browserstack` のエントリを `.mcp.json` から削除するか、使用する前に各統合ディレクトリで `npm install` を実行することです。

Question 2

Claude Code の PostToolUse フックで発生する './hooks/error-capture.sh: No such file or directory' エラーを修正する方法

Accepted Answer

フックコマンドはプラグインルートではなく、セッションの現在の作業ディレクトリから実行されるため、cwd相対パスは解決できません。`engineering-team/self-improving-agent/hooks/hooks.json` で、`"command": "./hooks/error-capture.sh"` を次のように置き換えてください:

```json
"command": "\"${CLAUDE_PLUGIN_ROOT}/hooks/error-capture.sh\""
```

`${CLAUDE_PLUGIN_ROOT}` はインストールされたプラグインディレクトリを指し、エスケープされた引用符によりスペースを含むプラグインパスに対応できます。一貫性を保つため、プラグインの `settings.json` のインストール例およびスクリプトヘッダーコメント内の同じ相対パスも更新してください。

Question 3

PythonでUnicodeEncodeError: 'charmap'コーデックが罫線文字や'≥'文字をWindowsのcp1252でエンコードできない問題を修正する方法

Accepted Answer

Windows コンソールは cp1252 を使用しており、`╔`、`═`、`≥` などの文字をエンコードできません。スクリプトを実行する前に、Python を UTF-8 モードで起動してください：

- コマンド プロンプト：
  ```cmd
  set PYTHONUTF8=1
  python your_script.py
  ```
- PowerShell：
  ```powershell
  $env:PYTHONUTF8="1"
  python your_script.py
  ```

今後のコマンド プロンプト セッションで恒久的に有効にするには：
```cmd
setx PYTHONUTF8 1
```

アプリケーション レベルで修正するには、Unicode 出力を表示する前に、各 CLI エントリ ポイントの先頭付近に次のコードを追加してください：
```python
import sys

if hasattr(sys.stdout, "reconfigure"):
    sys.stdout.reconfigure(encoding="utf-8", errors="replace")
if hasattr(sys.stderr, "reconfigure"):
    sys.stderr.reconfigure(encoding="utf-8", errors="replace")
```

`errors="replace"` は、`UnicodeEncodeError` を発生させる代わりに、サポートされていない文字を置き換えることでクラッシュを防ぎます。Python 3.7 以降では、UTF-8 モードと `reconfigure()` がサポートされています。利用可能な場合は、影響を受けるスクリプト向けの cp1252 強化修正を含むリリースに更新してください。

Question 4

write-a-skill のチェック 1「Description includes triggers」が、有効な SKILL.md の説明で失敗するのはなぜですか？

Accepted Answer

これは claude-skills v2.13.0 で修正された既知の誤検出(false-positive)バグです(PR #1013、#1038 経由でマージ)。`skill_review_checklist_runner.py` には2つの根本原因がありました。(1) フロントマターのパーサーが bare な `>` と `|` の YAML ブロックスカラーにしかマッチしないため、チョンピング/インデント指示子(`>-`、`>+`、`|-`、`|2`)を使って記述された description があると、関数が指示子そのものを description として返してしまい、トリガーチェックが通らなくなっていました。(2) トリガーパターンが固定の2語リスト(`use when`、`invoke before` など)であり、'Use whenever'、'This skill should be used when'、'Use this before'、'Load before' のような有効なフレーズが拒否されていました。修正方法: v2.13.0+ にアップグレードしてください。このバージョンでは `re.fullmatch(r"[>|][0-9]*[-+]?|[>|][-+]?[0-9]*", val)` によってすべてのブロックスカラーのバリアントをパースし、固定リストを動詞+キューの正規表現(動詞: use/used/invoke/apply/run/load/fire/trigger;キュー: when/whenever/before/after/during/while/at the start of/on every)に置き換えています。古いバージョンでの回避策: フロントマターでは `>-` の代わりに bare な `>` を使用し、トリガーは正確に 'use when/for/before/during/after/while' または 'invoke when/before/after' というフレーズで記述してください。

Question 5

CHANGELOG.md に誤ったカウンターデルタ (X → Y) が含まれていても、なぜ derive_counters.py --check はパスするのですか？

Accepted Answer

v2.13.0より前のバージョンでは、`scripts/derive_counters.py --check` は5つの指定されたファイル(README.md、CLAUDE.mdの見出し行、marketplace.json、mkdocs.yml、.codex-plugin/plugin.json)内の絶対合計値のみを検証していました。CHANGELOG.mdを読み取ることはなく、CLAIM_PATTERNSも`X → Y`形式の差分クレームではなく絶対合計値にのみマッチしていたため、変更履歴に`skills 999 → 1234`のような捏造された差分があってもCIがグリーンでパスしていました。v2.13.0で修正されました(PR #1010経由、#1038を通じてマージ):このゲートはCHANGELOG.mdを読み取り、差分パターン(`A → B`および`A -> B`)を認識し、右辺(B)が導出された値と等しいことを検証するようになりました。v2.13.0以降にアップグレードしてください: https://github.com/alirezarezvani/claude-skills/releases/tag/v2.13.0。注:提案されていた`--write`自動生成モード(オプション3)は実装されておらず、別のissueとして起票される可能性があります。

claude-skills

概要

README プレビュー

FAQ (5)

同类型项目

tensorflow

superpowers

everything-claude-code

flutter