IDSAAS Tools（独立 Skill）

本 Skill 提供与 idsaas-tools MCP 相同的功能，不依赖任何 MCP。通过执行 scripts/ 目录下的 CLI 完成操作。当前 Skill 直接使用 tcl-cli idsaas，不再维护本地兼容 CLI。

前置条件

环境要求：本机需要可执行 tcl-cli

安装 tcl-cli 时请使用公司镜像：https://nexus10.tclking.com/nexus/repository/npm/
安装命令：npm i -g @tcljs/tcl-cli --registry=https://nexus10.tclking.com/nexus/repository/npm/
Skill 初始化执行 npm run setup 时，会自动检查 tcl-cli idsaas；如果未安装，会自动按上述命令安装

首次使用需登录：执行 tcl-cli idsaas login
默认环境：由 tcl-cli idsaas 维护

执行方式

所有命令直接通过 tcl-cli idsaas 执行：

tcl-cli idsaas <command> [--arg value]

常用工作流

1. 流水线部署上线

tcl-cli idsaas get-pipeline-list --projectPath <项目路径>
tcl-cli idsaas get-build-list --pipelineId <上一步的id>
tcl-cli idsaas submit-to-prod --buildId <上一步的buildId>

2. 用户角色管理

tcl-cli idsaas get-role-list
tcl-cli idsaas get-user-role --userId <工号>
tcl-cli idsaas add-roles --userIdList 工号1,工号2 --roleId <角色ID>
tcl-cli idsaas remove-roles --userId <工号> --roleIds 新角色ID列表

3. 菜单同步

tcl-cli idsaas get-project-list
tcl-cli idsaas sync-menu --projectPath <项目路径> --route <路由> --name <菜单名> --projectId <id> --appId <appId>

4. API 文档同步

tcl-cli idsaas get-api-doc-list --appId <应用ID>
tcl-cli idsaas sync-api --appId <应用ID> --path <API路径> --name <接口名>

5. 查询某用户在指定环境的权限

tcl-cli idsaas get-user-info --search <姓名> --baseURL <环境URL>
tcl-cli idsaas get-user-role --userId <工号> --baseURL <环境URL>

命令速查

login：无
set-credentials：无（交互式）
get-env-url：无
get-user-info：--search
get-user-role：--userId
get-role-list：--search、--pageNum、--pageSize
get-project-list：--baseURL
get-menu-list：--projectId、--baseURL
get-pipeline-list：--projectPath 或 --projectName、--reserved
get-build-list：--pipelineId
submit-to-prod：--buildId
get-api-doc-list：--appId、--type
get-api-doc-detail：--appId、--path
add-roles：--userIdList、--roleId
remove-roles：--userId、--roleIds
sync-api：--appId、--path、--name
sync-menu：--projectPath、--route、--name、--projectId、--appId
sync-button：--projectPath、--route、--name、--projectId、--appId

实现说明

所有认证、请求、菜单/API/流水线逻辑均由 tcl-cli idsaas 提供
Skill 仓库本身只保留说明文档与最小入口配置
npm run setup 会自动检查并安装缺失的 tcl-cli

注意事项

userId 指工号（employeeId）
projectPath 与 projectName 二选一，如 cms-launcher 或 Launcher-CMS
reserved：前端/服务/web/api/all，默认「前端」
流水线相关行为由 tcl-cli idsaas 控制
登录失效时重新执行 tcl-cli idsaas login

分享给他人使用

安装：npx skills add git@gitlab09.tclking.com:group-front/skills.git --skill idsaas-tools -a cursor -g -y
或手动：复制 idsaas-tools 到 .agents/skills/ 或 ~/.cursor/skills/
首次使用：确认本机可执行 tcl-cli idsaas --help，然后 tcl-cli idsaas login

详细参数

见 references/reference.md。