代理相关

此仓库包含我在各个项目中使用的技能和扩展。请注意，我经常会针对特定的代码库对这些内容进行微调，因此在复用之前可能需要做一些小调整。

它已在 npm 上以 mitsupi 的名义发布，供与 Pi 包管理器一起使用。

技能

所有技能都位于 skills 文件夹中：

• /anachb - 查询奥地利公共交通（VOR AnachB）的发车信息、路线及中断情况。
• /apple-mail - 搜索并读取 Apple Mail 的本地存储，提取附件。
• /commit - 使用简洁的 Conventional Commits 风格主题创建 Git 提交。
• /frontend-design - 设计并实现具有特色的前端界面。
• /ghidra - 使用 Ghidra 的无头分析工具对二进制文件进行逆向工程。
• /github - 使用 gh CLI 与 GitHub 进行交互（问题、PR、工作流、API）。
• /google-workspace - 通过本地辅助脚本访问 Google Workspace API。
• /librarian - 在 ~/.cache/checkouts 中缓存并刷新远程 Git 仓库。
• /mermaid - 使用 Mermaid CLI 工具创建并验证 Mermaid 图表。
• /native-web-search - 触发原生网络搜索，并提供简明摘要和来源 URL。
• /oebb-scotty - 通过 ÖBB Scotty API 规划奥地利铁路行程。
• /openscad - 创建并渲染 OpenSCAD 模型，导出 STL 文件。
• /pi-share - 从 shittycodingagent.ai/buildwithpi/pi.dev 等 URL 加载并解析会话记录。
• /sentry - 获取并分析 Sentry 中的问题、事件、事务及日志。
• /summarize - 通过 uvx markitdown 将文件或 URL 转换为 Markdown 格式，并进行摘要总结。
• /tmux - 通过快捷键和窗格输出抓取来操作 tmux 会话。
• /update-changelog - 更新变更日志，记录重要的用户可见变更。
• /uv - 使用 uv 进行 Python 依赖管理及脚本执行。
• /web-browser - 通过 Chrome/Chromium CDP 实现浏览器自动化。

Pi 编码代理扩展

Pi 编码代理的自定义扩展位于 pi-extensions 文件夹中：

• answer.ts - 交互式 TUI，用于逐一回答问题。
• btw.ts - 简单的 /btw 侧边聊天浮窗，关闭时可选择将摘要注入主聊天。
• context.ts - 上下文分解（扩展、技能、AGENTS.md/CLAUDE.md）+ 令牌使用情况，包括已加载技能的高亮显示。
• control.ts - 会话控制助手（列出可控制的会话等）。
• files.ts - 统一的文件浏览器，显示 Git 状态、会话引用，并提供显示、打开、编辑和差异比较等操作。
• split-fork.ts - /split-fork 命令，用于将当前会话分支到右侧 Ghostty 分割中的新 pi 进程。
• go-to-bed.ts - 午夜后的安全防护机制，需明确确认后方可执行。
• loop.ts - 快速迭代编码的提示循环，可选自动继续功能。
• multi-edit.ts - 替换内置的 edit 工具，支持批量 multi 编辑和 Codex 风格的 patch 功能，包含预检验证。
• notify.ts - 当代理完成任务时发送原生桌面通知。
• prompt-editor.ts - 编辑器内提示模式选择器，具备持久化、历史记录、配置和快捷键功能。
• review.ts - 代码审查命令（工作树、PR 风格的差异、提交记录、自定义指令，可选修复循环）。
• session-breakdown.ts - TUI，用于分析 7/30/90 天的会话及成本，并显示使用情况图表。
• todos.ts - 待办事项管理扩展，采用文件存储并配有 TUI。
• uv.ts - 用于基于 uv 的 Python 工作流的辅助工具。
• whimsical.ts - 将默认的思考消息替换为随机的奇思妙想语句。

Pi 编码代理主题

自定义主题位于 pi-themes 文件夹中：

• nightowl.json - 受猫头鹰启发的主题。

公共服务命令

这些命令文件在使用前需要进行定制。它们位于 plumbing-commands 文件夹中：

• /make-release - 自动化仓库发布流程，包含版本管理。

拦截命令

命令包装器位于 intercepted-commands 文件夹中：

• pip
• pip3
• poetry
• python
• python3

Agent Stuff 快速上手指南

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统: macOS 或 Linux (部分技能如 apple-mail 仅限 macOS)。
• Node.js & npm: 用于安装核心包。
• Pi Coding Agent: 本项目专为 Pi 智能体框架设计，需已安装并配置好 Pi 环境。
• 基础工具依赖:
  • git: 版本控制。
  • uv: Python 包管理及脚本执行（推荐）。
  • gh: GitHub CLI。
  • tmux: 终端复用器。
  • chrome/chromium: 用于浏览器自动化技能。
  • 其他特定技能依赖（如 ghidra, openscad, mermaid-cli 等）需根据实际需求单独安装。

注意：部分技能针对特定仓库进行了微调，复用前可能需要根据本地路径或 API 密钥进行少量配置调整。

安装步骤

本项目通过 npm 发布为 mitsupi 包，以便与 Pi 的包加载器协同工作。

1. 使用 npm 安装核心包：

   npm install -g mitsupi
   

2. 克隆源码（可选，用于自定义技能）： 如果您需要修改技能或查看扩展源码，建议克隆仓库：

   git clone https://github.com/mitsupi/agent-stuff.git
   cd agent-stuff
   

3. 配置 Pi 加载器： 确保您的 Pi 配置文件（通常在 ~/.pi/config.json 或项目根目录的 AGENTS.md / CLAUDE.md 中）已指向安装的 mitsupi 包或本地技能目录 (skills) 和扩展目录 (pi-extensions)。

基本使用

安装完成后，技能将自动集成到 Pi Coding Agent 会话中。您可以通过自然语言指令直接调用。

1. 调用技能 (Skills)

在 Pi 对话中直接描述需求，Agent 会自动匹配对应的技能。

• 示例：创建 Git 提交

  请使用 conventional commits 风格为当前的更改创建一个简洁的提交信息。
  

  (触发 /commit 技能)

• 示例：查询奥地利公共交通

  查询从 Vienna 到 Salzburg 明天的火车班次。
  

  (触发 /oebb-scotty 或 /anachb 技能)

• 示例：生成 Mermaid 图表

  画一个流程图，展示用户登录系统的过程。
  

  (触发 /mermaid 技能)

• 示例：管理 Python 依赖

  使用 uv 安装 requests 库并运行当前脚本。
  

  (触发 /uv 技能)

2. 使用扩展命令 (Extensions)

部分扩展提供了特定的 slash 命令，可在对话中直接使用：

• 代码审查：

  /review
  

  (启动代码审查流程，支持工作区差异、PR 风格对比等)

• 多文件编辑：

  /multi-edit
  

  (启用批量编辑模式，支持 Codex 风格的 patch)

• 会话分支：

  /split-fork
  

  (将当前会话分支到右侧 Ghostty 分割窗口的一个新 Pi 进程中)

• 待办事项管理：

  /todos
  

  (打开基于文件的待办事项管理器 TUI)

3. 拦截命令 (Intercepted Commands)

项目包含对常用命令的包装器（位于 intercepted-commands），旨在优化 Pi 对这些工具的调用行为。当 Agent 执行以下命令时，会自动应用增强逻辑：

• pip / pip3
• poetry
• python / python3

无需额外操作，直接在对话中让 Agent 执行相关命令即可生效。