用途
本技能用于代表用户管理 SaaS Pegasus 项目:把用户意图翻译为正确的 pegasus CLI 调用。Pegasus 是 Django 样板项目,一个“项目”是一组功能配置(前端框架、认证提供方、计费、AI 等),由构建流水线渲染为真实 Django 代码库。
准备与认证
认证使用来自 saaspegasus.com 的 API 密钥:密钥位于 ~/.pegasus/credentials,或环境变量 $PEGASUS_API_KEY。若未配置,让用户自行运行 pegasus auth,不要猜测或生成密钥。
主要命令 pegasus projects list pegasus projects fields --json pegasus projects fields --for <id> --json pegasus projects show <id> --json pegasus projects create --json [--set k=v ...] [--config-file path] pegasus projects update <id> --json [--set k=v ...] [--config-file path] pegasus projects push <id> 作为智能体检查输出时必须总是加 --json,默认 Rich 表格可能因视口截断。
标准流程
非平凡的创建或更新按此顺序:先取 schema(新建用 fields --json,更新用 fields --for <id> --json),schema 只显示当前上下文可配置的字段,不要硬编码选项;读取 user_tier,用 free < basic < pro < unlimited 判断 min_tier 是否可用,若被限制需先告知用户并确认;构造 payload,可用可重复的 --set key=value,或 --config-file 加载 YAML/JSON,--set 覆盖文件值;调用 create/update。
配置要点 创建时仅 project_name 与 project_slug 必填;project_slug 必须是合法 Python 标识符,小写,无前后下划线,非保留名。pegasus_version 为固定版本或 null(跟最新),不要自行构造版本号。license 为 UUID 字符串,free 传 null。只读字段(id、_pegasus_version、github_username、css_theme)在输入时被忽略。
字段依赖与限制
bundler=vite 强制 include_static_files=false;css_framework 非 tailwind 强制关闭 flowbite 与 shadcn;use_subscriptions=false 清空订阅相关字段;use_teams/use_async 关闭时清空对应示例;docker_mode=full 与 deploy_platform=kamal 都要求 database=postgres。PATCH 是部分更新,未指定字段保持原状。许可证降级若与已开启的 pro 功能冲突会返回 400。创建/更新不生成代码,渲染由 pegasus projects push 完成,构建时校验比创建时更严格。400 错误有两种形态(按字段或带 help_url 的扁平错误),出现 help_url 时应转告用户。