依赖说明

使用这个 skill 前，请先让 Agent 跑依赖检查。依赖状态以子仓根目录的 verify_dependencies.py 输出为准；文档只说明它会检查什么。

让 Agent 先做什么

你可以直接这样说：

text

我要使用 gh-issue-comment-monitor，请先检查它的依赖；如果 GitHub 访问凭据或 gh CLI 没准备好，请告诉我缺什么并帮我处理。

检查命令

在 workspace 根目录运行：

powershell

python skills/gh-issue-comment-monitor/verify_dependencies.py

它会检查什么

类型	说明
必需：GitHub 访问身份	检查是否存在 `GITHUB_TOKEN` / `GH_TOKEN`，或本机 `gh` CLI 是否已安装且 `gh auth status` 成功
可选：token 与 `gh` 明细	分别报告 token 是否存在、`gh` 路径和登录状态；不输出 token 值
可选：GitHub API 网络	只有传入 `--check-network` 时才向 `api.github.com` 发送 HEAD 请求，并将可达性纳入必需结果

它不检查监控脚本能否编译、checkpoint / updates 的读写、GitHub Issue 是否存在，也不运行功能性 smoke test。

判断标准

required 全部为 ok: true 表示 GitHub 访问前置条件可用。若缺少 token 或 gh 登录状态，请先让 Agent 配好再执行监控任务。脚本编译、checkpoint 文件读写属于仓库内部健康问题，不作为用户依赖配置展示。

Windows 编码限制

当前 verify_dependencies.py 在调用 gh auth status 时使用 Python 默认文本编码，且最终通过当前 stdout 编码输出 ensure_ascii=False 的 JSON。在 Windows 非 UTF-8 代码页、包含非 ASCII 用户路径，或输出被重定向的环境中，它可能在解码/编码阶段失败，不能保证 stdout 总是一份完整、可直接解析的 JSON。这是已知的代码限制，本文档不声称脚本已修复。

在 Windows 上建议强制 Python UTF-8 模式，保留退出码，并且仅在退出码为 0 后解析输出：

powershell

$env:PYTHONUTF8 = "1"
$json = python -X utf8 skills/gh-issue-comment-monitor/verify_dependencies.py | Out-String
$exitCode = $LASTEXITCODE
if ($exitCode -eq 0) { $result = $json | ConvertFrom-Json }

若需要跨 shell 的稳定机器解析，调用方应显式以 UTF-8 启动子进程、按 UTF-8 解码 stdout，并先检查进程退出码；不要将当前脚本的 stdout 无条件当作 clean JSON。彻底消除该风险仍需修改 verify_dependencies.py 的子进程和输出编码处理。

依赖说明 ​

让 Agent 先做什么 ​

检查命令 ​

它会检查什么 ​