@yama-lei/pi-profile0.1.0

Pi Profile

从项目的 .pi/profile.json 初始化 npm 插件、skills 和可选的 AGENTS.md，也可让当前 LLM 帮你选择资源、生成清单。

需要 Pi、Node.js 22.19+、npm/npx；Git 来源的 skills 还需要 Git。

安装

pi install npm:@yama-lei/pi-profile

本包只加载 profile 扩展，不自动加载 pi-better-ai、示例清单或其他 skills。

命令

• /profile init [name]：选择全局 JSON 模板，预览确认后生成项目配置并安装；也可以选择通过 LLM 创建。
• /profile sync：读取当前项目的配置，预览确认后安装；修改配置后可再次执行。
• /profile-setup-with-llm [需求描述]：询问工作流、核对资源来源，展示 JSON 并征求批准，可选注册全局模板。没有搜索能力时不会声称已完成检索。

保存和安装都需要交互确认。安装成功后使用 Pi 原生 reload；无 UI 的 print/JSON 模式不会静默安装。

配置

项目清单位于 .pi/profile.json：

{
  "plugins": ["npm:@pi-archimedes/diff", "npm:pi-gpt-search"],
  "skills": [
    {
      "source": "vercel-labs/agent-skills",
      "skills": ["web-design-guidelines"]
    }
  ]
}

• plugins 和 skills 是必填数组，可以为空。plugins 仅接受不带版本的 npm 来源。
• skill 来源支持 owner/repo、HTTPS 和 Git SSH；skill 名称必须明确，不支持通配符。
• 可选 AGENTS.md 字段接受原始 Markdown 的 HTTPS 下载 URL，不接受 GitHub HTML 页面；下载有超时、重定向和 1 MiB 大小限制。
• 未知字段会报错；不要放入 API key 或其他敏感信息。

示例在 profiles/ 中，不会自动注册或安装。示例中的远程 npm、GitHub 和 skill 来源需要可用，并应在使用前核对。

安装范围与保护

npm 插件使用 Pi 的 --local 安装；skills 使用 Skills CLI 的项目 copy 模式；AGENTS.md 下载到项目根目录。

全局模板默认保存在 ~/.pi/agent/profile-templates/（遵循 PI_CODING_AGENT_DIR），只保存 JSON，不保存已安装资源、凭据或运行时设置。

不覆盖已有项目清单或同名模板。已有 skills 和 AGENTS.md 会跳过并报告；冲突的部署符号链接会被拒绝。安装失败不回滚已完成的资源，应修复问题后重试。

本包不是 profile 切换器、隔离沙箱或自动升级服务；不管理 MCP、Git 修订或共享资源存储，也不屏蔽 Pi 原生全局资源及项目可信机制。