@d3ara1n/pi-model-roles
为PI扩展提供模型角色配置与解析的库
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@d3ara1n/pi-model-roles。 它的用途是：为PI扩展提供模型角色配置与解析的库 完整的 Skill 内容见：https://321skill.com/skills/d3ara1n-pi-model-roles/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“在我的PI扩展里，我需要一个‘代码审查’角色使用Claude 3.5，一个‘创意写作’角色使用GPT-4。” 它会引导你通过该库的配置系统定义这两个角色。之后在代码中，你只需调用 `getModelForRole('代码审查')` 即可获得配置好的Claude模型实例，用于自动审查代码。
介绍
该Skill是一个专为PI（Project IDX）扩展设计的模型角色配置库。它解决了在开发AI驱动的PI扩展时，需要灵活管理和调用不同AI模型（如不同能力、不同提供商的模型）的痛点。通过预定义“命名模型角色”（例如“代码审查专家”、“文档撰写助手”），开发者可以在配置中声明这些角色，并在代码中通过角色名动态解析到具体的Model实例，从而将模型选择逻辑与业务逻辑解耦。
使用方式非常直接：开发者首先在扩展配置中定义模型角色与具体模型（如Claude 3.5 Sonnet, GPT-4）的映射关系；然后在扩展代码中，通过调用该库提供的API，传入角色名称即可获取对应的、已初始化的Model实例，直接用于生成内容或处理请求。这简化了多模型切换和实验的流程。
它非常适合PI扩展的开发者，尤其是那些需要在其扩展中集成多个AI模型、或者希望轻松配置和切换模型以进行A/B测试或功能分发的开发者。对于构建复杂AI工作流的团队，此库能提升配置管理的效率和代码的可维护性。
建议在使用时，将模型角色的定义集中管理，例如放在独立的配置文件中。需要注意的是，该库主要负责模型实例的解析和提供，不包含模型调用本身的具体实现（如处理流式响应、管理对话历史），这部分仍需开发者结合PI的AI SDK或其他客户端库来完成。确保你已熟悉PI扩展的基本开发框架和AI能力集成方式。
核心特点
核心区别在于它专为PI扩展生态设计，提供了“角色-模型”的声明式配置抽象，让开发者能像使用依赖注入一样管理AI模型，而非硬编码模型标识符。这使得在同一个扩展内，根据不同功能场景动态分配不同模型变得非常简单和清晰。
注意事项
该库仅适用于PI扩展开发场景，不适用于通用的Node.js项目或其他AI应用框架。
常见问题
这个库能直接调用AI模型吗？
不能，它只负责根据配置解析并提供Model实例，实际调用需结合PI的AI SDK或其他客户端库。
支持哪些AI模型？
理论上支持任何能在PI扩展中配置和初始化的模型，具体取决于PI平台的支持和您的配置。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/d3ara1n-pi-model-roles/raw/index.md 读取 @d3ara1n/pi-model-roles 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/d3ara1n-pi-model-roles/raw/index.md（查看排版版本）