@capyup/pi-basic-tools
Pi Agent 核心生产力工具集，提供代码阅读、操作、交互等基础能力。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@capyup/pi-basic-tools。 它的用途是：Pi Agent 核心生产力工具集，提供代码阅读、操作、交互等基础能力。 详细介绍见：https://321skill.com/skills/capyup-pi-basic-tools/ 请根据该页面的说明完成安装。
使用示例
“请使用 repo_map 工具分析当前仓库的目录结构，并总结主要模块。”，它会调用相应工具生成项目地图并为你解读。或者
对AI说：“读取 utils/helper.js 文件中的 formatDate 函数，并为其生成单元测试。”，它会先读取指定代码块，然后基于代码逻辑为你构思测试用例。
介绍
该技能包为 Pi Agent 提供了一套独立的核心生产力工具，旨在解决开发者在代码理解和项目操作中遇到的效率瓶颈。它包含了从代码仓库概览（repo_map）、代码块读取（read_block）、符号大纲（symbol_outline）到执行命令（exec_command）、应用补丁（apply_patch）等一系列原子化操作，并集成了用户交互（ask_user）和网络请求（fetch）等功能。
使用时，开发者可以在 Pi Agent 中直接调用这些工具。例如，通过 repo_map 快速了解项目结构，用 read_block 精读特定代码段，或利用 exec_command 在安全沙箱中运行构建、测试等命令，从而让 AI 助手能更深入、更安全地介入开发流程。
它非常适合需要 Pi Agent 深度参与编码、代码审查、项目熟悉或自动化脚本编写的开发者。无论是处理遗留代码库、进行复杂的重构，还是搭建开发辅助工作流，这套工具都能显著提升人机协作的效率和精度。
建议在熟悉基本命令后，结合 grouped basic-tool UI 进行可视化操作以提升体验。请注意，部分命令（如 exec_command）涉及系统操作，应在理解其影响后于受控环境中使用。内置的 work_checkpoint 功能有助于在长会话中保存进度。
核心特点
这是 Pi 平台官方的核心基础工具集，深度集成且经过优化，提供了从代码结构分析到安全命令执行的一站式原子操作，其 `grouped basic-tool UI` 提供了便捷的可视化操作界面，区别于其他零散或功能单一的工具技能。
注意事项
该技能主要服务于 Pi Agent 生态，不适用于其他 AI 助手平台，且部分高级操作需要用户对命令行和开发流程有基本理解。
常见问题
这个工具集和普通的代码助手有什么区别？
它提供了一套原子化的底层操作能力（如直接读写代码块、执行系统命令），让 AI 能像开发者一样“动手”操作项目，而不仅仅是分析和建议。
exec_command 命令安全吗？
它在受控的沙箱环境中运行，但用户仍需对执行的命令负责，避免运行未知或危险指令。