Pi工具Skill pi-tools

---

名称: pi-tools 描述: 查看和管理已同步到 Dex 的 Pi 构建扩展。显示可用工具、命令和同步状态。

Pi 工具

查看和管理已同步到 Dex 的 Pi 构建扩展。

参数

• $ACTION: 要执行的操作（可选，默认为 list）
  • list - 显示所有同步的 Pi 扩展及其工具
  • sync - 强制重新同步 Pi 扩展
  • status - 显示同步状态和注册表信息
  • show [extension] - 显示特定扩展的详细信息

---

工作流程

步骤 1: 检查注册表

读取 Pi 扩展注册表位于 .claude/pi-extensions-registry.json。

if [ -f ".claude/pi-extensions-registry.json" ]; then
  echo "找到注册表"
else
  echo "尚未同步任何 Pi 扩展"
fi

步骤 2: 执行操作

如果 $ACTION == list 或未指定操作:

显示所有同步的扩展:

## Pi 扩展

| 扩展 | 工具 | 命令 | 最后修改 |
|-----------|-------|----------|---------------|
| [名称]    | [数量] | [数量] | [日期]      |

### 可用工具

**[扩展名称]:**
- `工具名称` - 描述
- `工具名称_2` - 描述

**[扩展名称-2]:**
- ...

如果 $ACTION == sync:

1. 手动运行同步钩子:

   node .claude/hooks/pi-extensions-sync.cjs
   

2. 报告变化:

   • 新增扩展
   • 更新扩展
   • 移除扩展

如果 $ACTION == status:

显示同步元数据:

• 最后同步时间戳
• 扩展数量
• 注册表文件位置
• 生成技能位置

如果 $ACTION == show [extension]:

读取生成的技能文件:

cat ".claude/skills/pi-generated/pi-[extension]/SKILL.md"

显示完整详细信息:

• 描述
• 所有工具及参数
• 所有命令
• 源文件位置

---

输出格式

列表视图

## 同步到 Dex 的 Pi 扩展

**最后同步:** 2026-02-03T12:00:00Z

### dex-mcp-bridge

*将 Pi 桥接到 Dex 的 MCP 服务器，用于任务和日历管理*

**工具:**
- `dex_task` - 管理任务（创建、完成、列表、建议）
- `dex_calendar` - 访问日历事件（今天、即将到来、列表）

**命令:**
- `/dex-tasks` - 列出当前任务
- `/dex-today` - 显示今天的事件

---

运行 `/pi-tools sync` 从 .pi/extensions/ 刷新

状态视图

## Pi 扩展状态

**注册表:** .claude/pi-extensions-registry.json
**技能:** .claude/skills/pi-generated/
**源:** .pi/extensions/

**统计:**
- 扩展: 1
- 总工具: 2
- 总命令: 2

**最后同步:** 2026-02-03T12:00:00Z

**同步触发:**
- SessionStart 钩子（自动）
- `/pi-tools sync`（手动）

---

集成说明

同步工作原理

1. SessionStart 钩子 运行 pi-extensions-sync.cjs
2. 扫描 .pi/extensions/*.ts 寻找 TypeScript 文件
3. 解析每个文件以提取:
   • JSDoc 描述
   • pi.registerTool() 调用
   • pi.registerCommand() 调用
4. 在 .claude/skills/pi-generated/ 生成技能存根
5. 更新注册表元数据
6. 输出摘要到会话上下文

技能命名

Pi 扩展技能以 pi: 前缀区分自原生 Dex 技能:

• pi:dex-mcp-bridge - MCP 桥接扩展
• pi:custom-tool - 自定义扩展

生成的技能文件夹使用 pi- 前缀:

• .claude/skills/pi-generated/pi-dex-mcp-bridge/SKILL.md

何时使用 Pi vs Dex

使用 Pi 工具当:

• 在 Pi 环境中工作
• 需要直接工具执行
• 构建新扩展

使用 Dex 上下文当:

• 规划涉及 Pi 能力的工作
• 记录可用工具
• 与 Dex 知识交叉引用

---

边缘情况

• 没有 .pi/extensions/ 目录: 静默 - Pi 未配置
• 空扩展目录: 报告“未找到 Pi 扩展”
• 解析错误: 跳过格式错误的文件，报告警告
• 删除扩展: 清理孤立的技能存根