railway-projects

Railway 项目管理

列出、切换和配置 Railway 项目。

适用场景

• 用户询问“显示我的所有项目”或“我有哪些项目”
• 用户询问跨工作区的项目
• 用户询问“我有哪些工作区”
• 用户想切换到其他项目
• 用户询问如何重命名项目
• 用户想启用/禁用 PR 部署
• 用户想将项目设为公开或私有
• 用户询问项目设置

列出项目

railway list --json 的输出可能非常大。请在子 Agent 中运行，并且只返回必要字段：

• 项目：id、name
• 工作区：id、name
• 服务：name（可选；用户需要了解服务情况时提供）

railway list --json

提取并返回简明摘要，不要返回完整 JSON。

列出工作区

railway whoami --json

返回用户信息，包括该用户所属的所有工作区。

切换项目

将其他项目关联到当前目录：

railway link -p <project-id-or-name>

也可以通过交互方式操作：

railway link

切换后，使用 railway-status 技能查看项目详情。

更新项目

通过 GraphQL API 修改项目设置。

获取项目 ID

railway status --json

从响应中提取 project.id。

更新 Mutation

bash <<'SCRIPT'
${CLAUDE_PLUGIN_ROOT}/skills/lib/railway-api.sh \
  'mutation updateProject($id: String!, $input: ProjectUpdateInput!) {
    projectUpdate(id: $id, input: $input) { name prDeploys isPublic botPrEnvironments }
  }' \
  '{"id": "PROJECT_ID", "input": {"name": "new-name"}}'
SCRIPT

ProjectUpdateInput 字段

字段	类型	描述
name	String	项目名称
description	String	项目描述
isPublic	Boolean	将项目设为公开/私有
prDeploys	Boolean	启用/禁用 PR 部署
botPrEnvironments	Boolean	启用 Dependabot/Renovate PR 环境

示例

重命名项目：

${CLAUDE_PLUGIN_ROOT}/skills/lib/railway-api.sh '<mutation>' '{"id": "uuid", "input": {"name": "new-name"}}'

启用 PR 部署：

${CLAUDE_PLUGIN_ROOT}/skills/lib/railway-api.sh '<mutation>' '{"id": "uuid", "input": {"prDeploys": true}}'

将项目设为公开：

${CLAUDE_PLUGIN_ROOT}/skills/lib/railway-api.sh '<mutation>' '{"id": "uuid", "input": {"isPublic": true}}'

更新多个字段：

${CLAUDE_PLUGIN_ROOT}/skills/lib/railway-api.sh '<mutation>' '{"id": "uuid", "input": {"name": "new-name", "prDeploys": true}}'

组合使用

• 查看项目详情：使用 railway-status 技能
• 创建新项目：使用 railway-new 技能
• 管理环境：使用 railway-environment 技能

错误处理

未通过身份验证

Not authenticated. Run `railway login` first.

没有项目

No projects found. Create one with `railway init`.

权限被拒绝

You don't have permission to modify this project. Check your Railway role.

未找到项目

Project "foo" not found. Run `railway list` to see available projects.