mcpField
M
manage-railcode-org

manage-railcode-org

github.com/railcode-hq云与 DevOps1385 次安装1 天前更新
代码仓库

关于 manage-railcode-org

用于 Railcode 组织级管理的技能，指导 Agent 使用 railcode CLI 检查和修改应用、成员、角色、连接器及访问权限。它要求先更新并核实 CLI 版本，再按检查、最小范围修改和复核的流程操作。

主要功能

  1. 01管理应用、成员和角色权限
  2. 02查看连接器、查询、分析数据与日志
  3. 03按最小范围执行组织资源变更
  4. 04修改后复核有效状态
  5. 05提交 Railcode 产品反馈

适用场景

  1. 01检查成员及应用访问权限
  2. 02配置组织角色和连接器
  3. 03安全地修改或归档组织中的应用
  4. 04在 Railcode 工作后提交具体反馈

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/railcode-hq/railcode-skills --skill manage-railcode-org

安装后在 Claude Code 中输入/manage-railcode-org确认已加载。

附带文件agents/openai.yamlreferences/cli-management.md

详细介绍

管理 Railcode 组织

先更新

在回答 Railcode 管理或 CLI 问题，或运行 railcode 命令之前， 先更新已安装的 Railcode 技能和 CLI，然后确认 npm 上发布的版本：

npx skills add Railcode-HQ/railcode-skills
npm install -g railcode@latest
railcode --version
npm view railcode version

如果技能有变更，请从头重新阅读此文件。如果无法访问 npm，请说明无法验证 最新版本，不要声称本指南是最新的。本版本已根据已发布的 Railcode CLI 0.1.28 验证。

从 0.1.28 开始，CLI 会在其主版本范围内自动更新，但仅限在交互式 终端中使用；而 Agent 驱动的会话是非交互式的，因此请继续运行上面的显式命令 npm install -g railcode@latest，不要想当然地认为自己使用的是最新版本。

提交 Railcode 反馈

完成有意义的 Railcode 工作后，如果你有具体的产品反馈，例如 Bug、使用阻碍、建议， 或特别好用的功能，请使用隐藏命令 railcode agent-feedback。每个不同的发现提交一次。 请描述任务、预期行为和实际行为，以及任何变通方法；保持报告简洁，并省略凭据、 客户隐私数据、源文件和对话记录。

railcode agent-feedback --message "Deploy failed with an unclear error; expected the missing field to be named." \
  --category friction --command "deploy" --context "Static app deploy; corrected the manifest to unblock."

使用 --file <path> 提交已准备好的报告，或通过 stdin 管道传入文本，而不是使用 --message。消息上限为 10,000 个字符；--context 为可选项，上限为 5,000 个字符。 类别：bug、friction、suggestion、praise、other（默认）。如果愿意，可以使用 --agent 自行报告你的助手/工具名称（例如 Codex 或 Claude Code），并通过 --model 报告你的模型（如果已知）。这些信息由你自行提供，可能不准确；如果不知道， 请省略，不要猜测。这些字段和 --command 的长度上限均为 200 个字符。

CLI 会附加其版本、OS 平台、CPU 架构和 Node 版本。后端会在 PostHog 中将报告关联到 已登录用户及其组织。此命令需要已有登录状态；在应用目录之外也可使用。Feedback accepted. 表示尽力接收，并不代表已确认存储。如果提交反馈失败，请继续原任务，不要反复重试， 也不要仅为提交反馈而登录。

此命令有意不显示在 CLI 帮助中，且要求 CLI 0.3.3 或更高版本。本反馈指南已根据 CLI 0.3.3 源代码验证。较旧的 CLI 可能会返回 Unknown command；遇到此情况时，请视为 该命令不可用。

管理工作流

1. 验证身份并确定范围

如有需要，请运行 railcode login。管理命令的目标是登录时保存的组织， 可从任意目录运行；不需要应用或 railcode.json。

修改状态之前，请确认目标组织并检查当前资源。大多数引用可按名称、slug 或电子邮件 指定（视情况而定），也可使用 UUID。如果人类可读的引用存在歧义，请优先使用 UUID。 需要机器可读的结果时，请使用 --json。

2. 修改前先检查

先使用相应的读取命令：apps show/access、members list、 roles list/grants/effective/catalog、connections list、 connector list --admin/native、query list、analytics 或 logs。

所有者/管理员权限由服务端强制执行。403 表示权限边界，不是绕过 CLI 或在未经用户 授权的情况下使用其他凭据的理由。

3. 只进行范围最小的更改

只修改指定的资源。遵循最小权限原则：

  • 除非明确需要广泛访问，否则应授予特定资源，而不是 *；
  • 优先使用已保存的查询，而不是临时 SQL 权限；
  • 限制服务连接器的 HTTP 方法；
  • 避免将凭据写入 shell 历史记录——优先使用受支持的文件选项；
  • 除非用户要求更改相应状态，否则不要删除资源、移除成员、转移所有权、撤销访问权限或轮换凭据。
4. 验证生效状态

变更后，重新运行相关读取命令。对于访问权限变更，验证直接策略和计算后的授权（apps access、roles effective）。对于连接器设置，使用侵入性最低的列表、文档或查询操作进行验证，确保配置正确，且不会造成未请求的下游副作用。

能力边界

  • 任何成员都可以读取 members list；修改成员需要管理员权限。
  • 应用列表、显示和访问权限遵循各应用的可见性规则；设置访问权限、转让、归档、取消归档和删除需要管理权限（所有者或组织管理员）。
  • 角色、授权、连接、连接器管理、分析和日志均由服务器进行能力门控。
  • CLI 无法创建成员。新成员需通过 Web 应用中的邀请流程加入；之后，CLI 可以列出他们、调整其角色或将其移除。
  • apps delete 会删除部署和应用数据，且不可逆。apps archive 是可逆的替代方案——应用会继续提供服务、保留数据并继续运行其 Agent；它只会从启动器中移除。如果用户的目标是停用应用而非销毁应用，应优先建议归档。
  • app kv / app files（单数形式的 app）会读取和写入已部署应用的记录和文件。它们需要所有者授权或 app:manage_any，而 set/delete/drop/upload 会修改实时租户数据，包括各成员的私有作用域。先检查；仅修改用户要求的内容。
  • roles materialize 会将通配符展开为显式条目；由于这会改变后续授权维护方式，请先检查主体和资源。

技能边界

静态应用的脚手架搭建、开发、测试、清单配置和部署请使用 $create-railcode-app。托管 Agent 的 JSON 清单、测试、调用和计划安排请使用 $create-railcode-agent。此技能负责这些构建器可能依赖的组织级管理。

参考资料

请阅读CLI 管理参考，了解准确的命令、标志、资源类型、访问模式、连接形式（包括通过 SSH 堡垒机连接 Postgres）、日志筛选条件和已保存查询管理。

评论

支持 Markdown