pi-finder-subagent
为PI Agent提供本地工作区只读侦察能力的子代理。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-finder-subagent。 它的用途是：为PI Agent提供本地工作区只读侦察能力的子代理。 完整的 Skill 内容见：https://321skill.com/skills/pi-finder-subagent/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我看看当前项目的 `src/utils` 目录下有哪些工具函数文件，并列出 `logger.js` 的主要内容。” 集成了此子代理的 PI Agent 会调用它安全地扫描指定目录，然后将文件列表和 `logger.js` 的代码内容返回给你，作为后续分析或讨论的基础。
介绍
pi-finder-subagent 是一个专为 PI Agent 设计的子代理包，旨在解决 AI 助手无法直接、安全地探索用户本地工作区（包含代码和个人文件）的问题。它作为一个只读的侦察员，允许 PI Agent 在获得用户授权后，浏览指定目录的结构和文件内容，从而获取必要的上下文信息，而无需担心误操作或数据泄露。
使用方式非常简单，开发者或用户只需通过 npm 安装此包，并将其集成到自己的 PI Agent 项目中。当 PI Agent 需要了解本地项目结构、查看特定代码文件或配置文件时，可以调用此子代理来执行安全的只读扫描任务。
这个 Skill 主要适合 PI Agent 的开发者、希望增强其 AI 助手本地文件感知能力的工程师，以及任何需要让 AI 在严格受控环境下访问本地文件以提供更精准协助的用户。它特别适用于那些工作流严重依赖本地代码库和文档的场景。
在使用建议上，请务必注意其“只读”特性，它仅用于信息收集，无法进行任何修改操作。因此，它最适合作为复杂任务（如代码分析、文档整理）的前置信息收集步骤。同时，用户应明确授权扫描的目录范围，以平衡便利性与隐私安全。
核心特点
核心区别在于其明确的“只读”和“子代理”定位，专为 PI Agent 生态设计，提供安全、可控的本地文件系统侦察能力，而非通用的文件操作工具或独立的 AI 应用。
注意事项
不适合需要直接编辑、创建或删除文件的操作场景。
常见问题
pi-finder-subagent 能修改我的文件吗？
不能，它是一个严格的只读工具，仅用于浏览和收集信息。
这个包需要和特定的 AI 一起用吗？
是的，它是专为集成到 PI Agent 中而设计的子代理包。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pi-finder-subagent/raw/index.md 读取 pi-finder-subagent 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pi-finder-subagent/raw/index.md（查看排版版本）