Question 1

如何修复 pw-testrail 和 pw-browserstack MCP 服务器在 Claude Code 中显示 "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 上，可立即采用的变通方法是：从 `.mcp.json` 中移除未使用的 `pw-testrail` 和 `pw-browserstack` 条目，或在使用它们之前先在每个集成目录中运行 `npm install`。

Question 2

如何修复 Claude Code PostToolUse hook 报出的 './hooks/error-capture.sh: No such file or directory' 错误？

Accepted Answer

hook 命令从会话的当前工作目录运行,而非插件根目录,因此相对于 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' codec 无法在 Windows cp1252 上编码 box-drawing 或 '≥' 字符?

Accepted Answer

Windows 控制台正在使用 cp1252，它无法编码 ╔、═ 或 ≥ 等字符。请在执行脚本之前以 UTF-8 模式运行 Python：

- Command Prompt：
  set PYTHONUTF8=1
  python your_script.py
- PowerShell：
  $env:PYTHONUTF8="1"
  python your_script.py

若要使其对以后的 Command Prompt 会话永久生效：
setx PYTHONUTF8 1

对于应用程序级的修复，请在每个 CLI 入口点的顶部附近、打印 Unicode 输出之前添加以下代码：
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 中修复的已知误报 bug（PR #1013，经由 #1038 合入）。`skill_review_checklist_runner.py` 中存在两个根本原因：(1) frontmatter 解析器只匹配裸 `>` 和 `|` YAML 块标量，因此使用 chomping/缩进指示符（`>-`、`>+`、`|-`、`|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）。旧版本的临时变通方案：在 frontmatter 中使用裸 `>` 而非 `>-`，并将触发措辞严格写成 '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` 只验证五个指定文件中的绝对总数（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 预览

常见问题 (5)

同类型项目

tensorflow

superpowers

everything-claude-code

flutter