用途:这是一个交互式技能,用于准备开发环境前置条件并配置 Jira 集成。触发词为“setup”“install prerequisites”“configure jira”等。它必须由用户交互使用,不能作为自主技能流水线的子步骤调用,否则会因等待输入而卡住。
主要能力与用法:
- 安装 CLI 工具:运行捆绑脚本 bash "$(dirname "$0")/reference/setup.sh",通过 apt 安装 gh(GitHub CLI)、glab(GitLab CLI)、jq(JSON 处理器),并通过官方安装器 curl -LsSf https://astral.sh/uv/install.sh | sh 安装 uvx。脚本幂等,已安装的会跳过。
- 认证:用 gh auth status 2>&1 和 glab auth status 2>&1 检查状态并展示输出;未认证时提示用户手动运行 gh auth login 或 glab auth login,不自动执行。
- 配置 mcp-atlassian:检查 uvx --version;读取 ~/.config/opencode/opencode.json(不存在视为 {});若已存在 mcp.mcp-atlassian 则跳过。向用户收集 Jira URL(默认 https://jira.dedalus.com/)和凭据:Server/Data Center 用 JIRA_PERSONAL_TOKEN,Cloud 用 JIRA_USERNAME + JIRA_API_TOKEN。将 mcp-atlassian 块合并写入配置,command 为 ["uvx", "mcp-atlassian"],type 为 local,enabled 为 true。最后执行 chmod 600 ~/.config/opencode/opencode.json 保护文件。
- 输出各组件状态汇总,并提示重启 OpenCode 加载新 MCP 配置。
适用场景:Linux(apt)环境,需 bash、curl 和网络。限制:仅支持 apt 包管理器;认证与 Jira 凭据需用户交互提供;不自动执行登录命令;Jira Cloud 与 Server 的凭据字段不同。