Pugi

让你的编码 Agent 向 Pugi 说明需求，构建、设计、保护并发布你的应用。

pugi.io  |   文档  |   支持  |   定价

Pugi 是 AI 产品团队，能将简单的需求说明变成已上线并经过测试的应用。这些是为它准备的 Agent Skills。将它们安装到 Claude Code、Codex、Cursor 或任何支持读取 Agent Skills 格式的 Agent 中，你的 Agent 就能向 Pugi 说明需求，让它构建并交付应用、设计应用、从模板开始、为应用打造品牌和网站、检查并修复安全问题，以及发布应用。

安装

Claude Code

claude plugin marketplace add pugi-io/skills
claude plugin install pugi@pugi

在会话中也可以使用相同的命令：/plugin marketplace add pugi-io/skills 和 /plugin install pugi@pugi。然后，这些技能会以 /pugi:<skill> 的形式运行（例如 /pugi:pugi-publish）；任务符合条件时，Claude Code 也会自动调用它们。

如果不使用插件，请将技能文件夹复制到你的技能目录：

git clone https://github.com/pugi-io/skills pugi-skills
mkdir -p ~/.claude/skills
cp -r pugi-skills/skills/* ~/.claude/skills/        # or .claude/skills/ in a project

Codex

git clone https://github.com/pugi-io/skills pugi-skills
mkdir -p ~/.agents/skills && cp -r pugi-skills/skills/* ~/.agents/skills/

Codex 会从仓库中的 .agents/skills/（从工作目录向上直到仓库根目录）以及用户目录下的 ~/.agents/skills/ 读取技能。要使用内置安装程序安装单个技能：

$skill-installer install https://github.com/pugi-io/skills/tree/main/skills/pugi-publish

该仓库也采用开放 Agent Plugins 格式作为插件（根目录中的 plugin.json，Codex 设置位于 extensions.com.openai 下），并保留 .codex-plugin/plugin.json 作为备用，同时在 .agents/plugins/marketplace.json 中提供市场文件：

codex plugin marketplace add pugi-io/skills

重启 Codex，让它加载新技能。每项技能都包含一个 agents/openai.yaml，其中有显示名称和默认提示词。

Cursor

git clone https://github.com/pugi-io/skills pugi-skills
mkdir -p ~/.cursor/skills && cp -r pugi-skills/skills/* ~/.cursor/skills/

Cursor 会从项目中的 .cursor/skills/ 和 .agents/skills/，以及用户目录下的 ~/.cursor/skills/ 和 ~/.agents/skills/ 加载 Agent Skills。它也会读取 .claude/skills/ 和 .codex/skills/。

该仓库也按照 https://github.com/cursor/plugin-template 的规范，组织为一个独立的 Cursor 插件：根目录中的 .cursor-plugin/plugin.json 包含 name、description、version 和 author，技能位于 skills/ 中。目前尚未加入 Cursor Marketplace。

其他 Agent

每项技能都是一个文件夹，包含一个 SKILL.md（YAML 前置元数据和 Markdown 内容）以及可选的 scripts/。将 skills/<name>/ 复制到你的 Agent 加载技能的目录即可。

技能

技能	功能	是否需要付费计划？
pugi-build	撰写一份优质简报并启动 Pugi 构建：从想法到项目的快捷路径。使用 pugi build（CLI）或 app.pugi.io	使用你计划中的额度和点数
pugi-sdlc	管理完整的交付流程：计划、计划审批、构建、测试、安全扫描、预览审批和上线，并提供 JSON 状态。使用 pugi sdlc（CLI）或 app.pugi.io	使用你计划中的额度和点数
pugi-artifacts	获取项目文档（简报、BRD、PRD、用户流程、模型图、规范、测试计划），然后阅读、预览和修改这些文档。使用 pugi artifacts（CLI）或 Delivery bundle 视图	使用你计划中的额度
pugi-design	在 Design 模式下绘制或修改应用设计，并将其应用到代码中。可保存 Pugi 设计文件，供之后导入 Figma（目前还没有公开的导入插件）	编辑需要 Founder 计划或更高等级。所有计划均可查看
pugi-start-from-template	从 app.pugi.io/templates 的 31 个起始模板之一启动项目，或使用 pugi scaffold 在本地创建起始模板	不需要，所有计划均可用，但受计划的项目数量限制
pugi-logo	在 logo.pugi.io 获取企业 Logo 概念和品牌套件，然后将套件接入网站	不需要，下载需免费登录
pugi-brand-to-site	将 logo.pugi.io 品牌转化为同一品牌下的新网站	不需要，所有计划均可用。构建会使用计划中的额度
pugi-security-check	使用内置脚本和 pugi.io/security/audit 检查线上网站或代码仓库是否泄露密钥、缺少安全标头、使用不安全的 Cookie、公开源映射文件或提交了 .env 文件	不需要，脚本和网页检查均免费
pugi-fix-security	让 Pugi 修复检查结果（“Let Pugi fix all”）并再次检查，可在 app.pugi.io 或通过 pugi.io/security/audit 使用	不需要，所有计划均可用。免费版每天的检查次数有限
pugi-deploy-repo	导入现有 GitHub 仓库（来自 Lovable、Bolt、v0 或其他来源）并发布，可通过 app.pugi.io 上的 Import from GitHub，或使用 git clone + pugi publish	不需要，所有计划均可导入，并可发布到 pugi.app 地址
pugi-publish	将文件夹发布到可访问的 *.pugi.app 地址并启用 HTTPS，然后连接你自己的域名。使用 pugi publish（CLI）或 Publish 面板	发布到 pugi.app 地址不需要付费。能否使用自己的域名取决于计划

如何选择：pugi-build 用于启动流程；pugi-sdlc 负责推动流程通过各个关卡并上线；pugi-publish 和 pugi-deploy-repo 用于将你已有的代码发布到线上。计划和限制：pugi.io/pricing。

每项技能都包含一个状态表，标明每个步骤是 可用、目前不可用 还是 即将推出。这些技能只使用当前已上线的功能：pugi CLI（@pugi/cli 1.0.0-alpha.246 或更高版本，这是经过测试的命令版本）和 pugi.io 页面。更多 Agent 工具即将推出；技能会指示 Agent 仅在这些工具出现在其工具列表或 https://pugi.io/llms.txt 中后才使用。

MCP 服务

Pugi 也为 Agent 提供远程 MCP 服务。它已列入官方 MCP Registry，名称为 io.pugi/pugi；其条目是 server.json。

• 地址：https://api.pugi.io/api/agent/v1/mcp（Streamable HTTP）
• 身份验证：Authorization: Bearer pugi_agent_...。使用 POST https://api.pugi.io/api/agent/v1/keys 创建密钥。
• 工具：scan_url（对公开网站进行被动、只读安全检查，评级从 A+ 到 F）、get_balance、buy_credits_link（由用户打开的银行卡结账链接；它本身不会扣款）、publish_status。

详情、价格和限额：pugi.io/agents.md。

如何让你掌控全局

• 花费前先征求同意。 每个会构建或消耗额度的步骤都会等待你的确认。Pugi 编写的计划由你审批，只有你批准后才会开始构建。
• 发布前先征求同意。 在你批准预览或确认执行 pugi publish 之前，任何内容都不会上线。
• 覆盖前先征求同意。 pugi scaffold 只会写入缺失的文件，并列出跳过的文件。只有在你提出要求时，技能才会使用会覆盖文件的 --force。
• 更改 DNS 前先征求同意。 更改 DNS 会转移域名流量，因此技能会向你显示当前记录和新记录，并等待你的确认。scripts/check-domain.sh 只会读取 DNS 和 HTTPS 返回的信息。
• 只在调用时运行，并在需要时运行。 在 Codex 中，主要操作可能消耗额度、发布内容或更改项目的技能会设置 allow_implicit_invocation: false，因此只有在你调用时才会运行，例如 $pugi-publish。只有 pugi-security-check 和 pugi-logo 可能自行启动。
• 绝不输出机密信息。 pugi publish 只会输出环境变量键的名称；pugi-security-check 会报告密钥所在的文件和类型，但绝不会报告其值。

要求

• 对于 CLI 技能（pugi-build、pugi-sdlc、pugi-artifacts、pugi-publish、pugi-deploy-repo）：需要 Node.js 18+、git 和 Pugi 账户。使用 npm i -g @pugi/cli 安装 CLI，并使用 pugi login 登录。登录采用设备授权流程：你需要在浏览器中批准。
• 对于 pugi-security-check：需要 Python 3.8+ 和 git。脚本不会上传任何内容；可选的 MCP 工具 scan_url 会将 URL 发送给 Pugi。
• 对于控制台技能（pugi-design、pugi-start-from-template、pugi-brand-to-site、pugi-fix-security、pugi-logo）：需要浏览器。pugi-design 需要 Founder 计划或更高等级。

仓库布局

.
├── .claude-plugin/
│   ├── plugin.json          Claude Code plugin manifest
│   └── marketplace.json     Claude Code marketplace (one plugin: this repo)
├── plugin.json              Agent Plugins manifest (Codex reads extensions.com.openai)
├── .codex-plugin/plugin.json  Codex fallback manifest
├── .agents/plugins/marketplace.json
├── .cursor-plugin/plugin.json
├── server.json              MCP Registry entry for the Pugi MCP server (io.pugi/pugi)
├── smithery/                Smithery listing text and config schema
├── assets/                  icon, banner, social preview, NOTICE
├── skills/                  one folder per skill: SKILL.md, agents/openai.yaml, optional scripts/
│   ├── pugi-build/  pugi-sdlc/  pugi-artifacts/  pugi-design/
│   ├── pugi-start-from-template/  pugi-logo/  pugi-brand-to-site/
│   ├── pugi-security-check/     scripts/precheck.py
│   ├── pugi-fix-security/  pugi-deploy-repo/
│   └── pugi-publish/            scripts/check-domain.sh
└── scripts/check.sh         Validates front matter and scans this repo for secrets

所有 Agent 的技能格式都相同：每个文件夹中都有一个 SKILL.md。只有插件清单不同，因此每个 Agent 都会在共享的 skills/ 文件夹旁拥有自己的清单。

本仓库遵循的格式

• Agent Skills 规范：https://agentskills.io/specification
• Claude Code 插件清单参考：https://code.claude.com/docs/en/plugins/manifest-reference
• Claude Code 插件市场：https://code.claude.com/docs/en/plugin-marketplaces 和 https://code.claude.com/docs/en/plugins/marketplace-reference
• Codex 技能：https://learn.chatgpt.com/docs/build-skills
• Codex 插件和市场，以及可移植的根目录 plugin.json：https://developers.openai.com/plugins/build/plugins
• Cursor 技能：https://cursor.com/docs/skills
• Cursor 插件：https://cursor.com/docs/plugins，以及 https://github.com/cursor/plugin-template 中的单插件布局

贡献

欢迎在 Issues 中提交 Bug 报告和技能需求。提交拉取请求前，请运行 bash scripts/check.sh。请参阅 CONTRIBUTING.md。

安全

请将漏洞报告发送至 [email protected]，而不要在公开议题中报告。请参阅 SECURITY.md。

支持

关于账户、计划或构建的问题：pugi.io/support 或 [email protected]。开发者文档：docs.pugi.dev。

许可证

这些技能、脚本和文档均采用 MIT 许可证。请参阅 LICENSE。每个技能文件夹都附有一份 LICENSE.txt，因此单独复制技能时也会保留许可证声明。

assets/ 中的图片（icon.png、banner.png 和 social-preview.png）展示了 Pugi 徽标，不受 MIT 许可证约束。仅将这些图片纳入其中，以便插件目录和此页面展示 Pugi 标识；出于此目的，你可以将图片原样重新分发，作为本仓库的一部分。“Pugi”和 Pugi 徽标是 Pugi Inc. 的商标；许可证不授予以其他方式使用这些商标的权利。请参阅 assets/NOTICE。