pp-github-intel

Github Intel — Printing Press CLI

前置条件：安装 CLI

此技能使用 github-intel-pp-cli 二进制文件。**调用此技能中的任何命令前，必须确认 CLI 已安装。**如果尚未安装，请先安装：

1. 使用 Printing Press 安装程序安装。在 macOS/Linux 上，默认将二进制文件安装到 $HOME/.local/bin；在 Windows 上，默认安装到 %LOCALAPPDATA%\Programs\PrintingPress\bin：

   npx -y @mvanhorn/printing-press-library install github-intel --cli-only
   

2. 验证：github-intel-pp-cli --version
3. 确保所报告的安装目录位于将调用此技能的 Agent/运行时的 $PATH 中。

如果 npx 安装失败（没有 Node、处于离线状态等），请改用 Go 直接安装（需要 Go 1.26.6 或更高版本）。此方式会将程序安装到 $GOPATH/bin（默认是 $HOME/go/bin），因此请将该目录添加到 $PATH：

go install github.com/mvanhorn/printing-press-library/library/developer-tools/github-intel/cmd/github-intel-pp-cli@latest

如果安装后 --version 报告 "command not found"，说明运行时无法在 $PATH 中找到二进制文件目录。验证成功前，请勿继续运行此技能的命令。

用于 Agent 研究的公开 GitHub 仓库、发布、搜索和安全公告信号。

不适用此 CLI 的情况

对于需要创建、更新、删除、发布、评论、点赞、邀请、订购、发送消息、预订、购买或更改远程状态的请求，请勿启用此 CLI。此只读 CLI 提供用于检查、导出、同步和分析的命令。

命令参考

advisories — 管理公告

• github-intel-pp-cli advisories — 列出全局安全公告

github-current-intelligence-search — 管理 GitHub 当前情报搜索

• github-intel-pp-cli github-current-intelligence-search — 搜索仓库

repos — 管理仓库

• github-intel-pp-cli repos <owner> <repo> — 获取仓库元数据

查找合适的命令

知道要做什么，但不确定该用哪个命令时，可直接询问 CLI：

github-intel-pp-cli which "<capability in your own words>"

which 会根据自然语言能力查询，从此 CLI 精选的功能索引中找出最匹配的命令。退出代码 0 表示至少找到一个匹配项；退出代码 2 表示没有可信的匹配项——请改用 --help，或使用更具体的查询。

身份验证设置

无需身份验证。

运行 github-intel-pp-cli doctor 以验证设置。

Agent 模式

为任意命令添加 --agent。它会展开为：--json --compact --no-input --no-color --yes。

• 可通过管道传递 — JSON 输出到 stdout，错误输出到 stderr

• 可筛选 — --select 保留部分字段。点分路径可深入嵌套结构；数组会逐元素遍历。对于冗长 API，这是缩小上下文的关键：

  github-intel-pp-cli advisories --agent --select id,name,status
  

• 可预览 — --dry-run 显示请求，但不会发送

• 适合离线使用 — 有本地 SQLite 存储时，同步/搜索命令可以使用该存储

• 非交互式 — 不会提示输入，所有输入都通过标志传入

• 只读 — 请勿将此 CLI 用于创建、更新、删除、发布、评论、点赞、邀请、订购、发送或其他会修改状态的请求

响应封装

从本地存储或 API 读取数据的命令会将输出封装在来源信息中：

{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}

解析 .results 获取数据，并查看 .meta.source 以确认数据来自实时来源还是本地来源。只有在 stdout 连接到终端且未设置任何机器格式标志（--json、--csv、--compact、--quiet、--plain、--select）时，才会将人类可读的 N results (live) 摘要打印到 stderr；通过管道运行、由 Agent 消费以及显式指定格式的运行，stdout 中都只会输出纯 JSON。

Agent 反馈

当你（或 Agent）发现此 CLI 有问题时，请记录下来：

github-intel-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
github-intel-pp-cli feedback --stdin < notes.txt
github-intel-pp-cli feedback list --json --limit 10

条目会存储在本地的 ~/.local/share/github-intel-pp-cli/feedback.jsonl。除非设置了 GITHUB_INTEL_FEEDBACK_ENDPOINT，且同时传入 --send 或将 GITHUB_INTEL_FEEDBACK_AUTO_SEND 设为 true，否则不会发送 POST 请求。默认行为仅保存在本地。

写下让你感到意外的地方，而不是提交错误报告。简短、具体，用一行写清楚：这才是能不断累积价值的部分。

输出交付

每条命令都接受 --deliver <sink>。输出会发送到指定的接收目标，同时也会（或不再）输出到 stdout，因此 Agent 无需手动管道传输即可路由命令结果。支持三种接收目标：

接收目标	效果
stdout	默认；仅写入 stdout
file:<path>	将输出原子写入 <path>（临时文件 + 重命名）
webhook:<url>	将输出正文 POST 到该 URL（--compact 时使用 application/json 或 application/x-ndjson）

不支持的协议会被拒绝，并返回列出支持协议的结构化错误。Webhook 请求失败时会返回非零状态，并在 stderr 中记录 URL 和 HTTP 状态。

命名配置

配置是保存的一组标志值，可在多次调用中重复使用。如果定时 Agent 每次运行都以相同配置调用同一条命令，请使用配置——这就是 HeyGen 的“Beacon”模式。

github-intel-pp-cli profile save briefing --json
github-intel-pp-cli --profile briefing advisories
github-intel-pp-cli profile list --json
github-intel-pp-cli profile show briefing
github-intel-pp-cli profile delete briefing --yes

显式标志始终优先于配置值；配置值优先于默认值。agent-context 会在 available_profiles 下列出所有可用配置，以便 Agent 在运行时发现它们。

退出代码

代码	含义
0	成功
2	用法错误（参数错误）
3	未找到资源
5	API 错误（上游问题）
7	速率受限（等待后重试）
10	配置错误

参数解析

解析 $ARGUMENTS：

1. 为空、为 help 或 --help → 显示 github-intel-pp-cli --help 输出
2. 以 install 开头 → 以 mcp 结尾 → 安装 MCP；否则 → 参见上文的先决条件
3. 其他任何内容 → 直接使用（作为 CLI 命令执行，并带上 --agent）

MCP 服务安装

1. 安装 MCP 服务：

   go install github.com/mvanhorn/printing-press-library/library/developer-tools/github-intel/cmd/github-intel-pp-mcp@latest
   

2. 在 Claude Code 中注册：

   claude mcp add github-intel-pp-mcp -- github-intel-pp-mcp
   

3. 验证：claude mcp list

直接使用

1. 检查是否已安装：which github-intel-pp-cli 如果未找到，则提供安装选项（参见此技能开头的先决条件）。
2. 根据用户查询，从上文的独特功能和命令参考中选择最合适的命令。
3. 使用 --agent 标志执行：

   github-intel-pp-cli <command> [subcommand] [args] --agent
   

4. 如果存在歧义，请查看子命令帮助：github-intel-pp-cli <command> --help。