mcpField
P
pi-extension-authoring

pi-extension-authoring

github.com/romiluz13开发20110 次安装28 周前更新
代码仓库

关于 pi-extension-authoring

用于编写 Pi 编码 Agent 扩展的指导技能，依据 pi-mono 文档和源码，涵盖扩展能力、资源顺序、TUI 集成及自定义提供方。

主要功能

  1. 01扩展工具、命令、主题和提示词
  2. 02技能路径扩展及顺序说明
  3. 03TUI 组件集成指引
  4. 04自定义提供方注册模式
  5. 05基于文档和示例的工作流程

适用场景

  1. 01规划新的 Pi 扩展
  2. 02说明技能资源的优先顺序
  3. 03添加扩展界面或自定义提供方

MCP 相关

该技能提醒不要假定 Pi 核心支持 MCP；可通过扩展选择性添加 MCP 支持。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/romiluz13/pi-agent-skills --skill pi-extension-authoring

安装后在 Claude Code 中输入/pi-extension-authoring确认已加载。

附带文件references/CORPUS.md

详细介绍

Pi 扩展编写

所有回答都必须以以下 pi-mono/ 文件为依据。

依据

  1. pi-mono/packages/coding-agent/docs/extensions.md — 功能、生命周期、模式。
  2. pi-mono/packages/coding-agent/examples/extensions/README.md — 可运行示例索引。
  3. pi-mono/packages/coding-agent/src/core/resource-loader.ts — extendResources() 会在现有的 lastSkillPaths 之后通过 mergePaths 追加路径（较晚的路径会在名称冲突时让位于较早的路径，除非名称不同）。
  4. pi-mono/packages/coding-agent/src/core/agent-session.ts — 扩展命令与排队提示词；技能展开钩子。
  5. pi-mono/packages/coding-agent/docs/tui.md — 扩展 TUI 组件与 @mariozechner/pi-tui 的集成：Component 渲染约定、覆盖层模式、扩展上下文中的输入处理。
  6. pi-mono/packages/coding-agent/docs/custom-provider.md — 用于代理、OAuth/SSO、自定义 API 和自定义模型定义的 registerProvider()。

不变量

  • 扩展可以注册工具、命令、主题、提示词和额外的技能路径；确切的 API 范围由文档和示例模块定义——请从 docs/extensions.md 入手，不要依赖记忆。
  • 动态资源发现模式位于 pi-mono/packages/coding-agent/examples/extensions/ 下（例如，示例 README 中的 dynamic-resources/ 条目）。

工作流

  • 新建扩展：阅读 docs/extensions.md，克隆最相近的 examples/extensions/ 模板，然后在 pi-mono 内工作时遵循项目的 AGENTS.md。
  • 扩展提供的技能：追踪 resource-loader.ts 中的 extendResources 和 mergePaths，说明用户、项目和软件包技能之间的顺序关系。
  • 扩展 TUI：阅读 docs/tui.md，了解扩展上下文中的 Component 渲染约定；结合 pi-tui 技能了解库级 API。
  • 通过扩展使用自定义提供方：参阅 pi-mono/packages/coding-agent/docs/custom-provider.md，了解 registerProvider() 的 OAuth 流程和代理模式（以 pi-cli-workspace 为依据）。

反模式

  • 不要声称核心支持 MCP；MCP 支持可通过扩展实现（参见 coding-agent README 中的理念）。

评论

支持 Markdown