pi-librarian

Pi-librarian

用途

Pi 的 GitHub 研究子 Agent，使用 gh 工作流，在实现前查找并引用相关仓库文件。

路由

• 适用场景：用户要求研究外部 GitHub 仓库、比较实现模式，或在编码前收集有引用依据的仓库证据时使用。
• 不适用场景：仅需发现本地工作区内容，或无需访问 GitHub 时不要使用；请改用 pi-finder-subagent。
• 输出：一份带引用的 GitHub 研究报告，保存至 {artifactDir}/librarian-report.md；以及一份可执行摘要，保存至 {artifactDir}/librarian-summary.md。
• 成功标准：Librarian 返回具体的仓库、带引用的文件路径，以及明确的未知信息／访问限制，为实现决策提供依据。

触发示例

正向

• 请在此请求中使用 pi-librarian 技能。
• 帮我使用 pi-librarian。
• 用户要求研究外部 GitHub 仓库、比较实现模式，或在编码前收集有引用依据的仓库证据时使用。
• Pi-librarian：请提供可执行的结果。

负向

• 仅需发现本地工作区内容，或无需访问 GitHub 时不要使用；请改用 pi-finder-subagent。
• 不要将 pi-librarian 用于无关请求。
• 此请求不属于 pi-librarian 的适用范围。
• 这只是概念讨论，无需使用工具工作流。

参数

名称	类型	必填	说明
query	string	是	要在 GitHub 仓库中研究的内容
repo_hints	string	否	可选的仓库列表提示，例如 owner/repo 对
owner_hints	string	否	可选的所有者／组织提示
max_search_results	number	否	要求 gh 搜索返回的最大结果数

运行时提示词

• 当前运行时提示词长度：1003 个字符。
• 运行时提示词直接定义在 ../pi-librarian.json 中。