用途:本技能面向 Railcode 组织的管理操作,通过 Railcode CLI 处理应用访问与所有权、成员与系统角色、自定义角色与细粒度授权、连接器、查询、分析与日志等事务。管理命令作用于登录时保存的组织,可在任意目录运行,无需应用或 railcode.json。
必要准备:在回答 Railcode 管理问题或运行 railcode 命令前,先更新技能与 CLI 并确认 npm 已发布版本:npx skills add Railcode-HQ/railcode-skills;npm install -g railcode@latest;railcode --version;npm view railcode version。若 npm 不可达,应说明无法验证最新版本。该指引核对的是 CLI 0.1.28;CLI 自 0.1.28 起会在主版本内自更新,但仅在交互式终端,代理会话为非交互式,仍需显式 npm 安装。
工作流:先用 railcode login 认证并确认组织范围;变更前先用对应读取命令查看现状(apps show/access、members list、roles list/grants/effective/catalog、connections list、connector list --admin/native、query list、analytics、logs),需要机器可读结果时用 --json,引用歧义时优先 UUID。变更时只改指定资源并保持最小权限,如授予具体资源而非 *、优先保存查询、限制服务连接器 HTTP 方法、避免凭据进入 shell 历史;未经用户要求不得删除、移除成员、转移所有权、撤销访问或轮换凭据。变更后重复读取以验证有效状态。
能力边界:members list 任何成员可读,成员变更需管理员权限;应用列表/显示/访问按可见性,set-access/transfer/archive/unarchive/delete 需管理权。CLI 不能创建成员,新成员需通过 Web 应用邀请流程加入。apps delete 不可逆,会移除部署与应用数据;apps archive 是可逆替代,应用继续运行。app kv / app files 读写已部署应用记录与文件,需 owner 授权或 app:manage_any。roles materialize 会将通配符展开为显式行。403 是权限边界,不应绕过。
反馈:可使用隐藏命令 railcode agent-feedback,支持 --message、--file 或 stdin,类别含 bug、friction、suggestion、praise、other,需已登录,CLI 0.3.3 起可用,不支持时返回 Unknown command。
限制:上述命令、权限与行为均以资料为准;未提供的收费、价格、平台支持等细节暂未提供。